Membuat tabel pengujian

Halaman ini menjelaskan langkah-langkah membuat tabel Bigtable kecil yang dapat Anda gunakan untuk menguji cuplikan kode. Tabel ini berisi data deret waktu untuk smartphone dan tablet.

Petunjuk ini menggunakan Google Cloud Console dan cbt CLI, antarmuka command line yang dibuat khusus untuk Bigtable.

Sebelum memulai

Sebelum membuat tabel pengujian, selesaikan prasyarat berikut.

Menyiapkan autentikasi

Anda dapat menggunakan sampel gcloud CLI di halaman ini dari salah satu lingkungan pengembangan berikut:

  • Cloud Shell: Untuk menggunakan terminal online dengan gcloud CLI yang sudah disiapkan, aktifkan Cloud Shell.

    Di bagian bawah halaman ini, sesi Cloud Shell akan dimulai dan menampilkan perintah command line. Perlu waktu beberapa detik hingga sesi dimulai.

  • Shell lokal: Untuk menggunakan gcloud CLI di lingkungan pengembangan lokal, instal dan initialize gcloud CLI.

Untuk informasi tentang cara menyiapkan autentikasi bagi lingkungan produksi, lihat Siapkan Kredensial Default Aplikasi untuk kode yang berjalan di Google Cloud.

Memberikan peran IAM

Untuk mendapatkan izin yang diperlukan untuk membuat tabel pengujian, minta administrator untuk memberi Anda peran IAM Bigtable Administrator (roles/bigtable.admin) di project Anda. 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.

Instal CLI cbt

Jalankan perintah berikut untuk menginstal CLI cbt:

  gcloud components install cbt

Membuat instance

Dalam project pilihan Anda, buat instance pengujian untuk menyimpan tabel pengujian Anda. Tabelnya kecil, jadi Anda hanya memerlukan instance satu node.

  1. Buka halaman Create instance di konsol Google Cloud.

    Membuat instance

  2. Untuk Instance name, masukkan Test instance.

  3. Untuk Instance ID, masukkan test-instance.

  4. Untuk Storage type, pilih SSD.

  5. Untuk Cluster ID, masukkan test-instance-c1.

  6. Untuk Wilayah, pilih wilayah di dekat Anda.

  7. Untuk Zone, pilih zona di region yang Anda pilih.

  8. Di bagian Nodes, masukkan 1.

  9. 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 = test-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 = test-instance

    Sekarang Anda dapat menggunakan CLI cbt dengan instance Anda.

Membuat tabel pengujian

  1. Buat tabel bernama test-table yang memiliki dua grup kolom. Untuk setiap grup kolom, tetapkan kebijakan pembersihan sampah memori guna mempertahankan maksimum 2 sel per kolom:

       cbt createtable test-table "families=stats_summary:maxversions=2,stats_detail:maxversions=2,cell_plan:maxversions=2"

  2. Cantumkan grup kolom:

       cbt ls test-table

    Terminal menampilkan output yang mirip dengan berikut ini:

        Family Name       GC Policy
    -----------       ---------
    stats_detail        versions() > 2
    stats_summary       versions() > 2
    cell_plan           versions() > 2

Isi tabel

  1. Salin perintah berikut ke jendela terminal Anda dan tekan Enter.

       cbt set test-table phone#4c410523#20190501 stats_summary:connected_cell=1 stats_summary:connected_wifi=1 stats_summary:os_build=PQ2A.190405.003 cell_plan:data_plan_01gb=true cell_plan:data_plan_05gb=true
    cbt set test-table phone#4c410523#20190502 stats_summary:connected_cell=1 stats_summary:connected_wifi=1 stats_summary:os_build=PQ2A.190405.004 cell_plan:data_plan_05gb=true
    cbt set test-table phone#4c410523#20190505 stats_summary:connected_cell=0 stats_summary:connected_wifi=1 stats_summary:os_build=PQ2A.190406.000
    cbt set test-table phone#5c10102#20190501 stats_summary:connected_cell=1 stats_summary:connected_wifi=1 stats_summary:os_build=PQ2A.190401.002 cell_plan:data_plan_10gb=true
    cbt set test-table tablet#5c10102#20190502 stats_summary:connected_cell=1 stats_summary:connected_wifi=0 stats_summary:os_build=PQ2A.190406.000 cell_plan:data_plan_10gb=true

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

       cbt read test-table

    Terminal menampilkan output yang mirip dengan berikut ini. Perhatikan bahwa stempel waktu secara otomatis ditetapkan ke sel karena permintaan tulis Anda tidak menyertakan stempel waktu.

        ----------------------------------------
    phone#4c410523#20190501
      cell_plan:data_plan_01gb                 @ 2020/09/23-11:44:10.535000
        "true"
      cell_plan:data_plan_05gb                 @ 2020/09/23-11:44:10.535000
        "true"
      stats_summary:connected_cell             @ 2020/09/23-11:44:10.535000
        "1"
      stats_summary:connected_wifi             @ 2020/09/23-11:44:10.535000
        "1"
      stats_summary:os_build                   @ 2020/09/23-11:44:10.535000
        "PQ2A.190405.003"
    ----------------------------------------
    phone#4c410523#20190502
      cell_plan:data_plan_05gb                 @ 2020/09/23-11:44:11.545000
        "true"
      stats_summary:connected_cell             @ 2020/09/23-11:44:11.545000
        "1"
      stats_summary:connected_wifi             @ 2020/09/23-11:44:11.545000
        "1"
      stats_summary:os_build                   @ 2020/09/23-11:44:11.545000
        "PQ2A.190405.004"
    ----------------------------------------
    phone#4c410523#20190505
    
      stats_summary:connected_cell             @ 2020/09/23-11:44:12.503000
        "0"
      stats_summary:connected_wifi             @ 2020/09/23-11:44:12.503000
        "1"
      stats_summary:os_build                   @ 2020/09/23-11:44:12.503000
        "PQ2A.190406.000"
    ----------------------------------------
    phone#5c10102#20190501
      cell_plan:data_plan_10gb                 @ 2020/09/23-11:44:13.553000
        "true"
      stats_summary:connected_cell             @ 2020/09/23-11:44:13.553000
        "1"
      stats_summary:connected_wifi             @ 2020/09/23-11:44:13.553000
        "1"
      stats_summary:os_build                   @ 2020/09/23-11:44:13.553000
        "PQ2A.190401.002"
    ----------------------------------------
    tablet#5c10102#20190502
      cell_plan:data_plan_10gb                 @ 2020/09/23-11:44:14.480000
        "true"
      stats_summary:connected_cell             @ 2020/09/23-11:44:14.480000
        "1"
      stats_summary:connected_wifi             @ 2020/09/23-11:44:14.480000
        "0"
      stats_summary:os_build                   @ 2020/09/23-11:44:14.480000
             "PQ2A.190406.000"

Menggunakan data pengujian

Anda kini dapat menggunakan test-table di test-instance untuk mencoba cuplikan kode, seperti yang ada di bagian Menggunakan Bigtable dengan Cloud Functions.

Pembersihan

Agar tidak menimbulkan biaya pada akun Google Cloud Anda untuk resource yang dibuat selama langkah-langkah ini, hapus instance segera setelah Anda menyelesaikan pengujian. Dengan menghapus file .cbtrc, Anda akan siap untuk mengerjakan project yang berbeda.

  1. Jika ingin mempertahankan instance tetapi menghapus tabel, Anda dapat menggunakan perintah deletetable:

       cbt deletetable test-table

  2. Jika Anda tidak berencana menggunakan instance untuk pengujian lebih lanjut, hapus instance tersebut. Tindakan ini juga akan menghapus tabel.

       cbt deleteinstance test-instance

  3. Hapus file .cbtrc:

       rm ~/.cbtrc

Langkah selanjutnya