Membuat dan mengonfigurasi profil aplikasi

Halaman ini menjelaskan cara membuat dan mengelola profil aplikasi instance Bigtable, atau profil aplikasi. Contoh ini juga menunjukkan cara menggunakan profil aplikasi kustom untuk terhubung ke Bigtable.

Sebelum membaca halaman ini, pahami apa itu profil aplikasi dan cara kerjanya. Khususnya, pastikan Anda memahami perbedaan antara profil aplikasi standar — profil aplikasi yang Anda konfigurasi untuk menggunakan komputasi standar — dan profil aplikasi Data Boost — profil aplikasi yang menggunakan komputasi serverless Data Boost untuk menjalankan tugas baca dengan throughput tinggi. Untuk mengetahui informasi selengkapnya tentang Data Boost dan perbedaannya dengan komputasi menggunakan node cluster yang disediakan, lihat ringkasan Data Boost.

Jika Anda menggunakan profil aplikasi standar untuk mengonfigurasi replikasi, pelajari ringkasan replikasi Bigtable, tinjau contoh setelan replikasi, dan tentukan setelan mana yang paling sesuai untuk kasus penggunaan Anda.

Jika Anda menggunakan profil aplikasi tingkat dalam memori (Pratinjau), pelajari Ringkasan tingkat dalam memori.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk membuat, mengonfigurasi, atau menghapus profil aplikasi, minta administrator untuk memberi Anda peran IAM Bigtable Administrator (roles/bigtable.admin) di instance. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Membuat profil aplikasi

Anda dapat membuat banyak profil aplikasi kustom yang berbeda untuk setiap instance. Gunakan profil aplikasi kustom untuk mengontrol cara setiap aplikasi, atau setiap fungsi berbeda dalam aplikasi, berinteraksi dengan instance. Misalnya, Anda dapat menggunakan satu profil aplikasi untuk aplikasi batch guna mengisolasi trafficnya ke satu cluster, dan Anda dapat menggunakan profil aplikasi lain untuk memberikan ketersediaan tinggi bagi aplikasi lain.

Membuat profil aplikasi standar

Untuk membuat profil aplikasi standar, ikuti langkah-langkah berikut:

Konsol

  1. Buka daftar instance Bigtable di konsol Google Cloud .

    Buka daftar instance

  2. Klik instance tempat Anda ingin membuat profil aplikasi.

  3. Di panel kiri, klik Profil aplikasi.

  4. Klik Buat profil aplikasi.

  5. Pilih Standard.

  6. Klik Berikutnya.

  7. Masukkan ID profil aplikasi.

    ID profil aplikasi adalah ID permanen untuk profil aplikasi. Aplikasi Anda memberikan ID ini saat terhubung ke Bigtable.

  8. Masukkan deskripsi profil aplikasi.

  9. Di bagian Perutean cluster, pilih perutean cluster tunggal atau perutean multi-cluster. Pelajari lebih lanjut.

  10. Jika Anda memilih Single-cluster:

    1. Di daftar Cluster, pilih cluster untuk merutekan permintaan.

    2. Jika Anda perlu mengaktifkan transaksi baris tunggal, centang kotak Izinkan transaksi baris tunggal.

  11. Jika Anda memilih Multi-cluster:

    1. Di daftar Cluster group, untuk merutekan permintaan ke cluster mana pun di instance, pilih Any cluster.
    2. Untuk membatasi perutean permintaan hanya ke beberapa cluster dalam instance (perutean grup cluster), pilih setiap cluster yang ingin Anda sertakan dalam grup perutean, lalu klik OKE.
    3. Untuk merutekan permintaan baca dan tulis baris tunggal ke cluster tertentu berdasarkan row key permintaan, pilih Aktifkan afinitas baris.

  12. Di bagian Pilih prioritas pemilihan rute, tetapkan prioritas pemilihan rute untuk permintaan Anda dengan memilih salah satu opsi berikut:

    • Tinggi: gunakan untuk permintaan yang sensitif terhadap latensi
    • Medium: digunakan untuk permintaan tujuan umum
    • Rendah: gunakan untuk tugas latar belakang atau operasi yang kurang mendesak

  13. Untuk membuat profil aplikasi, klik Buat.

  14. Perbarui kode aplikasi Anda untuk terhubung ke Bigtable sehingga menggunakan profil aplikasi baru.

gcloud

  1. Jika Anda tidak mengetahui ID instance, gunakan perintah bigtable instances list untuk melihat daftar instance project Anda: 

    gcloud bigtable instances list

  2. Gunakan perintah bigtable app-profiles create untuk membuat profil aplikasi:

    gcloud bigtable app-profiles create APP_PROFILE_ID \
    --instance=INSTANCE_ID \
    [--description=DESCRIPTION] \
    [--force] \
    [--route-any] \
    [--restrict-to=CLUSTER_ID_1, CLUSTER_ID_2...] \
    [--route-to=CLUSTER_ID] \
    [--transactional-writes] \
    [--priority=PRIORITY] \
    [--row-affinity]

    Berikan hal berikut:

    • APP_PROFILE_ID: ID permanen untuk profil aplikasi.
    • INSTANCE_ID: ID permanen untuk instance.

    Perintah ini menerima flag opsional berikut:

    • --description=DESCRIPTION: Deskripsi mendetail tentang profil aplikasi.
    • --force: Abaikan peringatan tentang potensi masalah dan konflik dengan profil aplikasi lain.

    • --route-any: Aktifkan perutean multi-cluster untuk merutekan permintaan ke cluster yang tersedia.

      Anda tidak dapat menggabungkan flag ini dengan flag --route-to atau --transactional-writes.

    • --restrict-to=CLUSTER_ID_1, CLUSTER_ID_2...: Daftar cluster yang permintaannya harus dirutekan. Gunakan opsi ini jika Anda ingin merutekan permintaan hanya ke beberapa cluster dalam instance.

      Anda tidak dapat menggabungkan flag ini dengan flag --route-to atau --transactional-writes.

    • --route-to=CLUSTER_ID: ID cluster yang harus dituju oleh semua permintaan. Flag ini mengaktifkan perutean cluster tunggal.

      Anda tidak dapat menggabungkan flag ini dengan flag --route-any.

    • --transactional-writes: Aktifkan transaksi baris tunggal di profil aplikasi.

      Anda tidak dapat menggabungkan flag ini dengan flag --route-any atau --restrict-to.

    • --priority=PRIORITY: Tingkat prioritas yang harus digunakan profil aplikasi. Nilai yang diterima adalah PRIORITY_HIGH, PRIORITY_MEDIUM, atau PRIORITY_LOW.

    • --row-affinity: Aktifkan pemilihan rute afinitas baris di profil aplikasi.

      Anda tidak dapat menggabungkan flag ini dengan flag --route-to atau --transactional-writes.

  3. Perbarui kode aplikasi Anda untuk terhubung ke Bigtable sehingga menggunakan profil aplikasi baru.

Membuat profil aplikasi tingkat dalam memori

Untuk membuat profil aplikasi di cluster dengan tingkat dalam memori diaktifkan, ikuti langkah-langkah berikut:

Konsol

  1. Buka daftar instance Bigtable di konsol Google Cloud .

    Buka daftar instance

  2. Klik instance tempat Anda ingin membuat profil aplikasi.

  3. Di panel kiri, klik Profil aplikasi.

  4. Klik Buat profil aplikasi.

  5. Pilih Tingkat dalam memori.

  6. Klik Berikutnya.

  7. Masukkan ID profil aplikasi.

    ID profil aplikasi adalah ID permanen untuk profil aplikasi. Aplikasi Anda memberikan ID ini saat terhubung ke Bigtable.

  8. Masukkan deskripsi profil aplikasi.

  9. Di bagian Cluster routing, pilih cluster dengan tingkat dalam memori yang diaktifkan.

    Cluster tingkat dalam memori harus menggunakan perutean cluster tunggal.

  10. Jika Anda perlu mengaktifkan transaksi baris tunggal, pilih Izinkan transaksi baris tunggal.

  11. Di bagian Pilih prioritas pemilihan rute, tetapkan prioritas pemilihan rute untuk permintaan Anda dengan memilih salah satu opsi berikut:

    • Tinggi: gunakan untuk permintaan yang sensitif terhadap latensi
    • Medium: digunakan untuk permintaan tujuan umum
    • Rendah: gunakan untuk tugas latar belakang atau operasi yang kurang mendesak

  12. Klik Create untuk membuat profil aplikasi.

  13. Perbarui kode aplikasi Anda untuk terhubung ke Bigtable sehingga menggunakan profil aplikasi baru.

gcloud

  1. Jika Anda tidak mengetahui ID instance, gunakan perintah bigtable instances list untuk melihat daftar instance project Anda: 

    gcloud bigtable instances list

  2. Gunakan perintah gcloud beta bigtable app-profiles create untuk membuat profil aplikasi:

    gcloud beta bigtable app-profiles create APP_PROFILE_ID \
    --instance=INSTANCE_ID \
    --route-to=CLUSTER_ID \
    --use-memory-layer \
    [--description=DESCRIPTION] \
    [--transactional-writes] \
    [--priority=PRIORITY]

    Berikan hal berikut:

    • APP_PROFILE_ID: ID permanen untuk profil aplikasi.
    • INSTANCE_ID: ID permanen untuk instance.

    Perintah ini menerima flag opsional berikut:

    • --route-to=CLUSTER_ID: ID cluster yang harus dituju oleh semua permintaan. Flag ini mengaktifkan perutean cluster tunggal.
    • --use-memory-layer: Merutekan permintaan dengan profil aplikasi ini ke tingkat dalam memori. Flag ini terbatas pada edisi Enterprise Plus dan perutean cluster tunggal.
    • --description=DESCRIPTION: Deskripsi mendetail tentang profil aplikasi.
    • --transactional-writes: Aktifkan transaksi baris tunggal di profil aplikasi.
    • --priority=PRIORITY: Tingkat prioritas permintaan yang dikirim menggunakan profil aplikasi. Nilai yang diterima adalah PRIORITY_HIGH, PRIORITY_MEDIUM, atau PRIORITY_LOW. Prioritas permintaan tidak memengaruhi permintaan yang memenuhi syarat untuk tingkat dalam memori.