Membuat instance dan menulis data dengan CLI cbt

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

Dalam panduan memulai ini, Anda melakukan tindakan-tindakan berikut:

  • Menghubungkan ke instance Bigtable.
  • Melakukan tugas administratif dasar.
  • Menulis data ke tabel.
  • Membaca data dari tabel.

Sebelum memulai

  1. 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.
  2. Menginstal Google Cloud CLI.

  3. Untuk initialize gcloud CLI, jalankan perintah berikut: 

    gcloud init

  4. Buat atau pilih project Google Cloud.

    • Membuat project Google Cloud:

      gcloud projects create PROJECT_ID

      Ganti PROJECT_ID dengan nama untuk project Google Cloud 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.

  5. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

  6. Aktifkan API Cloud Bigtable and Cloud Bigtable Admin: 

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

  7. Berikan peran ke Akun Google Anda. Jalankan perintah berikut satu kali untuk setiap peran IAM berikut: roles/bigtable.admin 

    gcloud projects add-iam-policy-binding PROJECT_ID --member="user:EMAIL_ADDRESS" --role=ROLE
    • Ganti PROJECT_ID dengan project ID Anda.
    • Ganti EMAIL_ADDRESS dengan alamat email Anda.
    • Ganti ROLE dengan setiap peran individual.
    8.
  8. Menginstal Google Cloud CLI.

  9. Untuk initialize gcloud CLI, jalankan perintah berikut: 

    gcloud init

  10. Buat atau pilih project Google Cloud.

    • Membuat project Google Cloud:

      gcloud projects create PROJECT_ID

      Ganti PROJECT_ID dengan nama untuk project Google Cloud 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.

  11. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

  12. Aktifkan API Cloud Bigtable and Cloud Bigtable Admin: 

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

  13. Berikan peran ke Akun Google Anda. Jalankan perintah berikut satu kali untuk setiap peran IAM berikut: roles/bigtable.admin 

    gcloud projects add-iam-policy-binding PROJECT_ID --member="user:EMAIL_ADDRESS" --role=ROLE
    • Ganti PROJECT_ID dengan project ID Anda.
    • Ganti EMAIL_ADDRESS dengan alamat email Anda.
    • Ganti ROLE dengan setiap peran individual.
    14.
  14. Jalankan perintah berikut untuk menginstal CLI cbt: 
    gcloud components install cbt

Membuat instance Bigtable

  1. Buka halaman Create instance di konsol Google Cloud.

    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 Wilayah, pilih wilayah di dekat Anda.

  9. Untuk Zone, pilih Any.

  10. Untuk Mode penskalaan node, pilih Alokasi manual.

  11. Untuk Jumlah, pilih 1.

  12. Klik Create untuk membuat instance.

Menghubungkan ke instance

  1. Konfigurasikan cbt CLI untuk menggunakan project dan instance Anda dengan membuat file .cbtrc, yang menggantikan 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 ini:

    project = PROJECT_ID
instance = quickstart-instance

    Sekarang Anda dapat menggunakan CLI cbt dengan instance Anda.

Membaca dan menulis data

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

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

Mungkin ada beberapa sel berstempel waktu di persimpangan baris dan kolom.

  1. Buat tabel bernama my-table.

    cbt createtable my-table

  2. Tampilkan daftar tabel Anda:

    cbt ls

    Perintah akan menampilkan output yang mirip dengan berikut ini:

        my-table

  3. Tambahkan satu grup kolom bernama cf1:

    cbt createfamily my-table cf1

  4. Cantumkan grup kolom Anda:

    cbt ls my-table

    Perintah akan 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 kelompok 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 dengan stempel waktu disimpan untuk kolom yang sama di baris r1.

Pembersihan

Agar tidak menimbulkan biaya pada akun Google Cloud Anda untuk resource yang digunakan dalam panduan memulai ini, hapus instance tersebut. Dengan menghapus file .cbtrc, Anda akan siap untuk mengerjakan project yang berbeda.

  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 selanjutnya