Halaman ini diterjemahkan oleh Cloud Translation API.

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 yang dimaksud dengan 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 untuk menjalankan tugas baca throughput tinggi. Untuk informasi selengkapnya tentang Data Boost dan perbedaannya dengan komputasi yang 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 Anda harus meninjau contoh setelan replikasi dan memutuskan setelan mana yang paling cocok untuk kasus penggunaan Anda.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna 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 yang 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

Buka daftar instance Bigtable di konsol Google Cloud.

Buka daftar instance
Klik instance tempat Anda ingin membuat profil aplikasi.
Di panel kiri, klik Profil aplikasi.
Klik Create application profile.
Pilih Standar.
Klik Berikutnya.
Masukkan ID profil aplikasi.

ID profil aplikasi adalah ID permanen untuk profil aplikasi. Aplikasi Anda memberikan ID ini saat terhubung ke Bigtable.
Masukkan deskripsi profil aplikasi.
Di bagian Cluster routing, pilih pemilihan rute cluster tunggal atau pemilihan rute multi-cluster. Pelajari lebih lanjut.
Jika Anda memilih Single-cluster:
1. Gunakan drop-down untuk memilih cluster yang akan merutekan permintaan.
2. Jika Anda perlu mengaktifkan transaksi baris tunggal, centang kotak Izinkan transaksi baris tunggal.
Jika Anda memilih Multi-cluster:
1. Untuk merutekan permintaan ke cluster mana pun dalam instance, pilih Cluster mana pun di drop-down Grup cluster.
2. Untuk membatasi perutean permintaan hanya ke beberapa cluster dalam instance (perutean grup cluster), centang kotak untuk setiap cluster yang ingin Anda sertakan dalam grup perutean, lalu klik OK.
Klik Create untuk membuat profil aplikasi.
Perbarui kode aplikasi Anda untuk terhubung ke Bigtable sehingga menggunakan profil aplikasi baru.

gcloud

Jika Anda tidak mengetahui ID instance, gunakan perintah bigtable instances list untuk melihat daftar instance project Anda:
```
gcloud bigtable instances list
```
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: Mengabaikan peringatan tentang potensi masalah dan konflik dengan profil aplikasi lain.
- --route-any: Aktifkan pemilihan rute 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 menjadi tujuan 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 semua permintaan. Flag ini mengaktifkan pemilihan rute 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 rute afinitas baris di profil aplikasi.
  
  Anda tidak dapat menggabungkan flag ini dengan flag --route-to atau --transactional-writes.
Perbarui kode aplikasi Anda untuk terhubung ke Bigtable agar menggunakan profil aplikasi baru.

Membuat profil aplikasi Data Boost

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

Konsol

Buka daftar instance Bigtable di konsol Google Cloud.

Buka daftar instance
Klik instance tempat Anda ingin membuat profil aplikasi.
Di panel kiri, klik Profil aplikasi.
Klik Create application profile.
Pilih Data Boost.
Klik Berikutnya.
Masukkan ID profil aplikasi.

ID profil aplikasi adalah ID permanen untuk profil aplikasi. Aplikasi Anda memberikan ID ini saat terhubung ke Bigtable.
Masukkan deskripsi profil aplikasi.
Di bagian Cluster routing, pilih cluster tujuan pemilihan rute permintaan.
Klik Create app profile untuk membuat profil aplikasi.
Perbarui kode aplikasi Anda untuk terhubung ke Bigtable agar menggunakan profil aplikasi baru.

gcloud

Jika Anda tidak mengetahui ID instance, gunakan perintah bigtable instances list untuk melihat daftar instance project Anda:
```
gcloud bigtable instances list
```
Gunakan perintah gcloud 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 semua permintaan. Flag ini mengaktifkan pemilihan rute cluster tunggal.

Menghubungkan dengan profil aplikasi kustom

Setelah membuat profil aplikasi kustom, Anda dapat memperbarui kode sehingga aplikasi 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)

HBase Java

// 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 apa pun yang mungkin menyebabkan perubahan perilaku yang tidak terduga.

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

Memperbarui profil aplikasi standar

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

Konsol

Buka daftar instance Bigtable di konsol Google Cloud.

Buka daftar instance
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 Profil aplikasi di panel kiri.
Perbarui setelan sesuai kebutuhan, lalu klik Simpan, atau klik Batal untuk keluar tanpa menyimpan.

gcloud

Jika Anda tidak mengetahui ID instance, gunakan perintah bigtable instances list untuk melihat daftar instance project Anda:
```
gcloud bigtable instances list
```
Jika Anda tidak mengetahui 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.
(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.
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] \
    [--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: Mengabaikan peringatan tentang potensi masalah dan konflik dengan profil aplikasi lain.
- --route-any: Aktifkan pemilihan rute 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 menjadi tujuan 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 semua permintaan. Flag ini mengaktifkan pemilihan rute 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.
- --priority=PRIORITY: Tingkat prioritas yang digunakan profil aplikasi. Nilai yang diterima adalah PRIORITY_HIGH, PRIORITY_MEDIUM, atau PRIORITY_LOW.

Memperbarui profil aplikasi Data Boost

Untuk memperbarui cluster yang dibaca oleh profil aplikasi Data Boost, ikuti langkah-langkah berikut:

Konsol

Buka daftar instance Bigtable di konsol Google Cloud.

Buka daftar instance
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 Profil aplikasi di panel kiri.
Pilih cluster baru yang akan menjadi tujuan traffic, lalu klik Simpan.

gcloud

Jika Anda tidak mengetahui ID instance, gunakan perintah bigtable instances list untuk melihat daftar instance project Anda:
```
gcloud bigtable instances list
```
Jika Anda tidak mengetahui 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.
(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.
Gunakan perintah gcloud 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

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.

Mengonversi dari standar ke Data Boost

Sebelum Anda mengupdate profil aplikasi dari komputasi serverless standar (node yang disediakan untuk komputasi) ke komputasi serverless Data Boost, periksa metrik kelayakan Data Boost. Anda juga harus mengetahui Batasan Peningkatan Data.

Konsol

Buka daftar instance Bigtable di konsol Google Cloud.

Buka daftar instance
Di kolom Profil aplikasi, klik profil aplikasi yang ingin Anda perbarui.

Jika tidak melihat profil aplikasi yang ingin diedit, Anda dapat melihat daftar lengkap dengan mengklik nama instance, lalu mengklik Profil aplikasi di panel kiri.
Pilih Data Boost.
Pilih cluster tujuan permintaan.
Klik Simpan.

gcloud

Jika Anda tidak mengetahui ID instance, gunakan perintah bigtable instances list untuk melihat daftar instance project Anda:
```
gcloud bigtable instances list
```
Jika Anda tidak mengetahui 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.
(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.
Gunakan perintah gcloud beta bigtable app-profiles update untuk mengonversi profil aplikasi dari standar menjadi Data Boost:
```
gcloud bigtable app-profiles 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 semua permintaan. Flag ini mengaktifkan pemilihan rute cluster tunggal.

Mengonversi dari Data Boost ke standar

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

Konsol

Buka daftar instance Bigtable di konsol Google Cloud.

Buka daftar instance
Di kolom Profil aplikasi, klik profil aplikasi yang ingin Anda perbarui.

Jika tidak melihat profil aplikasi yang ingin diedit, Anda dapat melihat daftar lengkap dengan mengklik nama instance, lalu mengklik Profil aplikasi di panel kiri.
Pilih Standar.
Klik Berikutnya.
Opsional: Edit deskripsi profil aplikasi.
Di bagian Cluster routing, pilih pemilihan rute cluster tunggal atau pemilihan rute multi-cluster. Pelajari lebih lanjut.
Jika Anda memilih Single-cluster:
1. Gunakan drop-down untuk memilih cluster yang akan merutekan permintaan.
2. Jika Anda perlu mengaktifkan transaksi baris tunggal, centang kotak Izinkan transaksi baris tunggal.
Jika Anda memilih Multi-cluster:
1. Untuk merutekan permintaan ke cluster mana pun dalam instance, pilih Cluster mana pun di drop-down Grup cluster.
2. Untuk membatasi perutean permintaan hanya ke beberapa cluster dalam instance (perutean grup cluster), centang kotak untuk setiap cluster yang ingin Anda sertakan dalam grup perutean, lalu klik OK.
Klik Simpan.

gcloud

Jika Anda tidak mengetahui ID instance, gunakan perintah bigtable instances list untuk melihat daftar instance project Anda:
```
gcloud bigtable instances list
```
Jika Anda tidak mengetahui 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.
(Opsional) Gunakan perintah bigtable app-profiles describe untuk melihat setelan profil aplikasi:
```
gcloud bigtable app-profiles describe APP_PROFILE_ID \
    --instance=INSTANCE_ID
```

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

gcloud 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: Aktifkan pemilihan rute 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 menjadi tujuan 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 semua permintaan. Flag ini mengaktifkan pemilihan rute 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.

Menghapus profil aplikasi

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

Untuk menghapus profil aplikasi kustom:

Konsol

Buka daftar instance Bigtable di konsol Google Cloud.

Buka daftar instance
Klik instance yang berisi profil aplikasi yang ingin Anda hapus.
Di panel kiri, klik Profil aplikasi.
Buka menu tindakan lainnya , lalu klik Hapus profil aplikasi. Dialog konfirmasi akan muncul.
Ikuti petunjuk dalam dialog konfirmasi, lalu klik Delete.

gcloud

Jika Anda tidak mengetahui ID instance, gunakan perintah bigtable instances list untuk melihat daftar instance project Anda:
```
gcloud bigtable instances list
```
Jika Anda tidak mengetahui 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.
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.