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, Anda harus memahami apa itu profil aplikasi dan cara kerjanya. Secara khusus, pastikan Anda memahami perbedaan antara profil aplikasi standar — profil aplikasi yang dikonfigurasi untuk menggunakan komputasi standar — dan profil aplikasi Data Boost — profil aplikasi yang menggunakan komputasi serverless Data Boost (Pratinjau) 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 menggunakan profil aplikasi standar untuk mengonfigurasi replikasi, Anda juga harus memahami ringkasan replikasi Bigtable, dan sebaiknya tinjau contoh setelan replikasi serta memutuskan setelan yang terbaik untuk kasus penggunaan Anda.

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) pada instance. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses.

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

Membuat profil aplikasi

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

Membuat profil aplikasi standar

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

Konsol

Catatan: Anda tidak dapat mengonfigurasi prioritas permintaan untuk profil aplikasi di Konsol Google Cloud. Sebagai gantinya, gunakan gcloud CLI.

1. Buka daftar instance Bigtable di Konsol Google Cloud.

   Membuka daftar instance

2. Klik instance tempat Anda ingin membuat profil aplikasi.

3. Di panel kiri, klik Application profiles.

4. Klik Create application profile.

5. Masukkan ID profil aplikasi.

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

6. Masukkan deskripsi profil aplikasi.

7. Di bagian Pemilihan rute cluster, pilih perutean cluster tunggal atau perutean multi-cluster. Pelajari lebih lanjut.

8. Jika Anda memilih Cluster tunggal:

   1. Gunakan menu drop-down untuk memilih cluster yang akan dikirimi permintaan.

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

9. Jika Anda memilih Multi-cluster:

   1. Untuk mengarahkan permintaan ke cluster mana pun dalam instance, pilih Cluster mana pun di drop-down Cluster group.
   2. Untuk membatasi perutean permintaan hanya ke beberapa cluster dalam instance (perutean grup cluster), pilih kotak centang untuk setiap cluster yang ingin Anda sertakan dalam grup perutean, lalu klik OK.

10. Klik Create untuk membuat profil aplikasi.

11. Perbarui kode aplikasi Anda untuk terhubung ke Bigtable agar aplikasi dapat menggunakan profil aplikasi baru.

gcloud

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

   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]
   

   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: Mengabaikan peringatan tentang potensi masalah dan konflik dengan profil aplikasi lain.

   • --route-any: Mengaktifkan 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 akan menerima perutean permintaan. 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 akan menjadi tujuan perutean semua permintaan. Flag ini memungkinkan perutean cluster tunggal.

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

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

     Anda tidak dapat menggabungkan tanda ini dengan tanda --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.

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

Membuat profil aplikasi Data Boost

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Untuk membuat profil aplikasi Data Boost — profil aplikasi yang menggunakan komputasi serverless Data Boost — ikuti langkah-langkah berikut. Untuk memastikan beban kerja Anda kompatibel dengan Data Boost, tinjau batasan.

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

   gcloud bigtable instances list
   

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

   gcloud bigtable app-profiles create APP_PROFILE_ID \
       --instance=INSTANCE_ID \
       --data-boost \
       --data-boost-compute-billing-owner=HOST_PAYS \
       --route-to=CLUSTER_ID
   

   Berikan hal berikut:

   • APP_PROFILE_ID: ID permanen untuk profil aplikasi.
   • INSTANCE_ID: ID permanen untuk instance.
   • CLUSTER_ID: ID cluster yang akan menjadi tujuan perutean semua permintaan. Flag ini memungkinkan perutean cluster tunggal.

Terhubung dengan profil aplikasi kustom

Setelah membuat profil aplikasi kustom, Anda dapat memperbarui kode agar aplikasi Anda menggunakan profil aplikasi saat terhubung ke Bigtable.

Contoh berikut menunjukkan cara menentukan profil aplikasi saat aplikasi Anda membuat klien Bigtable dan terhubung ke instance. Ganti [APP_PROFILE_ID] dengan nilai yang sesuai.

C#

var client = BigtableClient.Create(appProfileId: "[APP_PROFILE_ID]");

Go

clientConf := bigtable.ClientConfig{AppProfile:"[APP_PROFILE_ID]"}
client, err = bigtable.NewClientWithConfig(ctx, project, instance, clientConf)

Java HBase

// If using BigtableOptions directly:
optionsBuilder.setAppProfileId("[APP_PROFILE_ID]");

// If using BigtableOptionsFactory:
configuration.set(BigtableOptionsFactory.APP_PROFILE_ID_KEY, "[APP_PROFILE_ID]");

// If using system properties, set "google.bigtable.app_profile.id" to
// "[APP_PROFILE_ID]"

// If using CloudBigtableIO for Cloud Dataflow:
config.withConfiguration(BigtableOptionsFactory.APP_PROFILE_ID_KEY,
                         "[APP_PROFILE_ID]");

Node.js

const bigtable = new Bigtable({appProfileId: '[APP_PROFILE_ID]'});

Python

from google.cloud import bigtable

client = bigtable.Client(project=project_id)
instance = client.instance(instance_id)
table = bigtable.table.Table(table_id, instance, '[APP_PROFILE_ID]')

Memperbarui profil aplikasi

Anda dapat melihat profil aplikasi instance dan memperbarui setelannya kapan saja. Bigtable memperingatkan Anda tentang update yang dapat menyebabkan perubahan perilaku yang tidak terduga.

Penting: Perubahan pada profil aplikasi akan langsung diterapkan, dan perubahan tersebut berlaku untuk aplikasi apa pun yang menggunakan profil aplikasi tersebut. Jika Anda perlu membuat perubahan yang tidak boleh langsung diterapkan, buat profil aplikasi baru, dan update aplikasi Anda untuk menggunakan profil aplikasi baru agar dapat terhubung ke Bigtable.

Untuk melihat cara mengupdate profil aplikasi dari standar ke Data Boost atau Boost Data ke standar, lihat Mengonversi profil aplikasi.

Memperbarui profil aplikasi standar

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

Konsol

Catatan: Anda tidak dapat mengonfigurasi prioritas permintaan untuk profil aplikasi di Konsol Google Cloud. Sebagai gantinya, gunakan gcloud CLI.

1. Buka daftar instance Bigtable di Konsol Google Cloud.

   Membuka daftar instance

2. Di kolom Profil aplikasi, klik profil aplikasi yang ingin Anda lihat atau perbarui.

   Jika tidak melihat profil aplikasi yang ingin diedit, Anda dapat melihat daftar lengkap dengan mengklik nama instance, lalu mengklik Application profiles di panel kiri.

3. Perbarui setelan sesuai kebutuhan, lalu klik Simpan, atau klik Batal untuk keluar tanpa menyimpan.

gcloud

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

   gcloud bigtable instances list
   

2. Jika Anda tidak tahu ID profil aplikasi, gunakan perintah bigtable app-profiles list untuk melihat daftar profil aplikasi instance:

   gcloud bigtable app-profiles list --instance=INSTANCE_ID
   

   Ganti INSTANCE_ID dengan ID permanen untuk instance.

3. (Opsional) Gunakan perintah bigtable app-profiles describe untuk melihat setelan profil aplikasi:

   gcloud bigtable app-profiles describe APP_PROFILE_ID \
       --instance=INSTANCE_ID
   

   Berikan hal berikut:

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

4. Gunakan perintah bigtable app-profiles update untuk memperbarui setelan profil aplikasi:

   gcloud bigtable app-profiles update 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]
   

   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: Mengabaikan peringatan tentang potensi masalah dan konflik dengan profil aplikasi lain.

   • --route-any: Mengaktifkan 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 akan menerima perutean permintaan. 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 akan menjadi tujuan perutean semua permintaan. Flag ini memungkinkan perutean cluster tunggal.

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

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

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

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

Memperbarui profil aplikasi Data Boost

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Untuk mengupdate cluster yang digunakan untuk membaca profil aplikasi Data Boost, ikuti langkah-langkah berikut:

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

   gcloud bigtable instances list
   

2. Jika Anda tidak tahu ID profil aplikasi, gunakan perintah bigtable app-profiles list untuk melihat daftar profil aplikasi instance:

   gcloud bigtable app-profiles list --instance=INSTANCE_ID
   

   Ganti INSTANCE_ID dengan ID permanen untuk instance.

3. (Opsional) Gunakan perintah bigtable app-profiles describe untuk melihat setelan profil aplikasi:

   gcloud bigtable app-profiles describe APP_PROFILE_ID \
       --instance=INSTANCE_ID
   

   Berikan hal berikut:

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

4. Gunakan perintah beta bigtable app-profiles update untuk memperbarui setelan profil aplikasi:

   gcloud beta bigtable app-profiles update APP_PROFILE_ID \
       --instance=INSTANCE_ID \
       --route-to=CLUSTER_ID
   

   Berikan hal berikut:

   • APP_PROFILE_ID: ID permanen untuk profil aplikasi.
   • INSTANCE_ID: ID permanen untuk instance.
   • CLUSTER_ID: ID cluster baru yang akan dibaca

Mengonversi profil aplikasi

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Anda dapat mengonversi profil aplikasi standar menjadi profil aplikasi Data Boost, atau mengonversi profil aplikasi Data Boost menjadi profil aplikasi standar. Sebelum mengonversi profil aplikasi, tinjau panduan di Perubahan profil aplikasi.

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

   gcloud bigtable instances list
   

2. Jika Anda tidak tahu ID profil aplikasi, gunakan perintah bigtable app-profiles list untuk melihat daftar profil aplikasi instance:

   gcloud bigtable app-profiles list --instance=INSTANCE_ID
   

   Ganti INSTANCE_ID dengan ID permanen untuk instance.

3. (Opsional) Gunakan perintah bigtable app-profiles describe untuk melihat setelan profil aplikasi:

   gcloud bigtable app-profiles describe APP_PROFILE_ID \
       --instance=INSTANCE_ID
   

   Berikan hal berikut:

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

4. Gunakan perintah beta bigtable app-profiles update untuk mengonversi profil aplikasi dari standar ke Data Boost:

   gcloud bigtable app-profile-update APP_PROFILE_ID \
       --instance=INSTANCE_ID \
       --data-boost \
       --data-boost-compute-billing-owner=HOST_PAYS \
       --route-to=CLUSTER_ID
   

   Berikan hal berikut:

   • APP_PROFILE_ID: ID permanen untuk profil aplikasi.
   • INSTANCE_ID: ID permanen untuk instance.
   • CLUSTER_ID: ID cluster yang akan menjadi tujuan perutean semua permintaan. Flag ini memungkinkan perutean cluster tunggal.

Mengonversi profil aplikasi dari standar ke Data Boost

Sebelum Anda memperbarui profil aplikasi dari standar (node yang disediakan untuk komputasi) ke komputasi serverless Data Boost, lihat metrik kelayakan Data Boost.

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

   gcloud bigtable instances list
   

2. Jika Anda tidak tahu ID profil aplikasi, gunakan perintah bigtable app-profiles list untuk melihat daftar profil aplikasi instance:

   gcloud bigtable app-profiles list --instance=INSTANCE_ID
   

   Ganti INSTANCE_ID dengan ID permanen untuk instance.

3. (Opsional) Gunakan perintah bigtable app-profiles describe untuk melihat setelan profil aplikasi:

   gcloud bigtable app-profiles describe APP_PROFILE_ID \
       --instance=INSTANCE_ID
   

   Berikan hal berikut:

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

Mengonversi profil aplikasi dari Data Boost ke standar

Untuk mengubah profil aplikasi dari menggunakan Data Boost (komputasi serverless) ke standar (node yang disediakan untuk komputasi), ikuti langkah-langkah berikut:

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

   gcloud bigtable instances list
   

2. Jika Anda tidak tahu ID profil aplikasi, gunakan perintah bigtable app-profiles list untuk melihat daftar profil aplikasi instance:

   gcloud bigtable app-profiles list --instance=INSTANCE_ID
   

   Ganti INSTANCE_ID dengan ID permanen untuk instance.

3. (Opsional) Gunakan perintah bigtable app-profiles describe untuk melihat setelan profil aplikasi:

   gcloud bigtable app-profiles describe APP_PROFILE_ID \
       --instance=INSTANCE_ID
   

4. Gunakan perintah beta bigtable app-profiles update untuk mengonversi profil aplikasi:

   gcloud beta bigtable app-profiles update APP_PROFILE_ID \
       --instance=INSTANCE_ID \
       --standard \
       [--route-any] \
       [--restrict-to=CLUSTER_ID_1, CLUSTER_ID_2...]
       [--route-to=CLUSTER_ID] \
       [--transactional-writes]
   

Berikan hal berikut:

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

Perintah ini menerima flag opsional berikut:

• --route-any: Mengaktifkan 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 akan menerima perutean permintaan. 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 akan menjadi tujuan perutean semua permintaan. Flag ini memungkinkan perutean cluster tunggal.

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

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

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

Menghapus profil aplikasi

Anda dapat menghapus profil aplikasi kustom instance, tetapi tidak dapat menghapus profil aplikasi default.

Peringatan: Jangan hapus profil aplikasi kustom yang masih digunakan oleh aplikasi. Setelah Anda menghapus profil aplikasi kustom, permintaan apa pun yang menggunakan profil aplikasi tersebut akan gagal.

Untuk menghapus profil aplikasi kustom:

Konsol

1. Buka daftar instance Bigtable di Konsol Google Cloud.

   Membuka daftar instance

2. Klik instance yang berisi profil aplikasi yang ingin Anda hapus.

3. Di panel kiri, klik Application profiles.

4. Buka menu more actions , lalu klik Delete application profile. Dialog konfirmasi akan muncul.

5. Ikuti petunjuk di dialog konfirmasi, lalu klik Delete.

gcloud

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

   gcloud bigtable instances list
   

2. Jika Anda tidak tahu ID profil aplikasi, gunakan perintah bigtable app-profiles list untuk melihat daftar profil aplikasi instance:

   gcloud bigtable app-profiles list --instance=INSTANCE_ID
   

   Ganti INSTANCE_ID dengan ID permanen untuk instance.

3. Gunakan perintah bigtable app-profiles delete untuk menghapus profil aplikasi:

   gcloud bigtable app-profiles delete APP_PROFILE_ID \
       --instance=INSTANCE_ID \
       [--force]
   

   Berikan hal berikut:

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

   Perintah ini menerima flag opsional berikut:

   --force: Mengabaikan peringatan tentang potensi masalah dan konflik dengan profil aplikasi lain.