Membuat instance dan menulis data dengan cbt CLI

Jika sedang mempelajari Bigtable, Anda dapat mempelajari panduan memulai cepat untuk memahami dasar-dasar yang akan Anda gunakan dalam skala besar di lingkungan produksi.

Dalam panduan memulai ini, Anda akan melakukan tindakan berikut:

• Hubungkan ke instance Bigtable.
• Lakukan tugas administratif dasar.
• Menulis data ke tabel.
• Membaca data dari tabel.

Sebelum memulai

Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.
Instal Google Cloud CLI.
Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.
Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut:
gcloud init
Buat atau pilih Google Cloud project.
Peran yang diperlukan untuk memilih atau membuat project
• Pilih project: Memilih project tidak memerlukan peran IAM tertentu—Anda dapat memilih project mana pun yang telah diberi peran.
• Membuat project: Untuk membuat project, Anda memerlukan peran Pembuat Project (roles/resourcemanager.projectCreator), yang berisi izin resourcemanager.projects.create. Pelajari cara memberikan peran.
Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.
• Buat Google Cloud project:

  gcloud projects create PROJECT_ID

  Ganti PROJECT_ID dengan nama untuk Google Cloud project yang Anda buat.

• Pilih project Google Cloud yang Anda buat:

  gcloud config set project PROJECT_ID

  Ganti PROJECT_ID dengan nama project Google Cloud Anda.
Verifikasi bahwa penagihan diaktifkan untuk project Google Cloud Anda.
Aktifkan Cloud Bigtable dan Cloud Bigtable Admin API:
Peran yang diperlukan untuk mengaktifkan API
Untuk mengaktifkan API, Anda memerlukan peran IAM Service Usage Admin (roles/serviceusage.serviceUsageAdmin), yang berisi izin serviceusage.services.enable. Pelajari cara memberikan peran.
gcloud services enable bigtable.googleapis.com bigtableadmin.googleapis.com
Memberikan peran ke akun pengguna Anda. Jalankan perintah berikut satu kali untuk setiap peran IAM berikut: roles/bigtable.admin
gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE
Ganti kode berikut:
• PROJECT_ID: Project ID Anda.
• USER_IDENTIFIER: ID untuk akun pengguna Anda. Misalnya, [e-mail].
• ROLE: Peran IAM yang Anda berikan ke akun pengguna Anda.

Instal Google Cloud CLI.

Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut:

gcloud init

Buat atau pilih Google Cloud project.

Peran yang diperlukan untuk memilih atau membuat project

• Pilih project: Memilih project tidak memerlukan peran IAM tertentu—Anda dapat memilih project mana pun yang telah diberi peran.
• Membuat project: Untuk membuat project, Anda memerlukan peran Pembuat Project (roles/resourcemanager.projectCreator), yang berisi izin resourcemanager.projects.create. Pelajari cara memberikan peran.

Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

• Buat Google Cloud project:

  gcloud projects create PROJECT_ID

  Ganti PROJECT_ID dengan nama untuk Google Cloud project yang Anda buat.

• Pilih project Google Cloud yang Anda buat:

  gcloud config set project PROJECT_ID

  Ganti PROJECT_ID dengan nama project Google Cloud Anda.

Verifikasi bahwa penagihan diaktifkan untuk project Google Cloud Anda.

Aktifkan Cloud Bigtable dan Cloud Bigtable Admin API:

Peran yang diperlukan untuk mengaktifkan API

Untuk mengaktifkan API, Anda memerlukan peran IAM Service Usage Admin (roles/serviceusage.serviceUsageAdmin), yang berisi izin serviceusage.services.enable. Pelajari cara memberikan peran.

gcloud services enable bigtable.googleapis.com bigtableadmin.googleapis.com

Memberikan peran ke akun pengguna Anda. Jalankan perintah berikut satu kali untuk setiap peran IAM berikut: roles/bigtable.admin

gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE

Ganti kode berikut:

• PROJECT_ID: Project ID Anda.
• USER_IDENTIFIER: ID untuk akun pengguna Anda. Misalnya, [e-mail].
• ROLE: Peran IAM yang Anda berikan ke akun pengguna Anda.
1. Jalankan perintah berikut untuk menginstal cbt CLI :

   gcloud components install cbt

Membuat instance Bigtable

1. Buka halaman Buat instance di Google Cloud konsol.

   Membuat instance

2. Untuk Instance name, masukkan Quickstart instance.

3. Untuk Instance ID, masukkan quickstart-instance.

4. Klik Lanjutkan.

5. Untuk Storage type, pilih SSD.

6. Klik Lanjutkan.

7. Untuk Cluster ID, masukkan quickstart-instance-c1.

8. Untuk Region, pilih wilayah di dekat Anda.

9. Untuk Zone, pilih Any.

10. Untuk Node scaling mode, pilih Manual allocation.

11. Untuk Jumlah, pilih 1.

12. Klik Buat untuk membuat instance.

Terhubung ke instance

1. Konfigurasi CLI cbt untuk menggunakan project dan instance Anda dengan membuat file .cbtrc, mengganti PROJECT_ID dengan ID untuk project tempat Anda membuat instance Bigtable:

   echo project = PROJECT_ID >> ~/.cbtrc && echo instance = quickstart-instance >> ~/.cbtrc
   

2. Pastikan Anda menyiapkan file .cbtrc dengan benar:

   cat ~/.cbtrc

   Terminal akan menampilkan isi file .cbtrc, yang terlihat mirip dengan berikut:

   project = PROJECT_ID
   instance = quickstart-instance

   Sekarang Anda dapat menggunakan cbt CLI dengan instance Anda.

Membaca dan menulis data

Bigtable menyimpan data dalam tabel, yang berisi baris. Setiap baris diidentifikasi oleh kunci baris.

Data dalam baris diatur ke dalam grup kolom, yang merupakan grup kolom. Penentu kolom mengidentifikasi satu kolom dalam grup kolom.

Dapat ada beberapa sel yang diberi stempel waktu di persimpangan baris dan kolom.

1. Buat tabel bernama my-table.

   cbt createtable my-table

2. Mencantumkan tabel Anda:

   cbt ls

   Perintah ini menampilkan output yang mirip dengan berikut ini:

       my-table

3. Tambahkan satu grup kolom bernama cf1:

   cbt createfamily my-table cf1

4. Mencantumkan grup kolom Anda:

   cbt ls my-table

   Perintah ini menampilkan output yang mirip dengan berikut ini:

       Family Name     GC Policy
       -----------     ---------
       cf1             <never>

5. Tulis nilai test-value1 dan test-value2 ke baris r1, menggunakan grup kolom cf1 dan penentu kolom c1:

   cbt set my-table r1 cf1:c1=test-value1
     cbt set my-table r1 cf1:c1=test-value2
   

6. Gunakan perintah cbt read untuk membaca data yang Anda tambahkan ke tabel:

   cbt read my-table

   Shell akan menampilkan output yang mirip dengan berikut ini:

       ----------------------------------------
       r1
         cf1:c1                                   @ 2023/03/22-06:56:11.323000
           "test-value1"
         cf1:c1                                   @ 2023/03/22-06:56:04.361000
           "test-value2"

   Dua nilai yang diberi stempel waktu disimpan untuk kolom yang sama di baris r1.

   Catatan: Dalam panduan memulai ini, Anda hanya menyetel dua sel,tetapi Bigtable memungkinkan Anda menyetel hingga 10.000 sel dalam satu permintaan penulisan.

Pembersihan

Agar akun Google Cloud Anda tidak dikenai biaya untuk resource yang digunakan dalam panduan memulai ini, hapus instance. Menghapus file .cbtrc membuat Anda siap mengerjakan project lain.

1. Hapus tabel my-table:

   cbt deletetable my-table

2. Hapus instance:

   cbt deleteinstance quickstart-instance

3. Hapus file .cbtrc:

   rm ~/.cbtrc

4. Opsional: Cabut kredensial dari gcloud CLI:

   gcloud auth revoke

Langkah berikutnya

• Selesaikan codelab Bigtable.
• Lihat dokumentasi referensi cbt CLI.
• Lihat contoh kode sumber untuk kasus penggunaan deteksi penipuan.
• Tulis aplikasi Hello World di C#, C++, Go, Java, Node.js, PHP, Python, Ruby, atau menggunakan klien HBase untuk Java.