Membangun kueri di konsol

Anda dapat membuat kueri dan melihat data Bigtable menggunakan builder kueri Bigtable Studio. Builder kueri adalah formulir interaktif di Konsol Google Cloud yang dapat Anda gunakan untuk membuat kueri, menjalankannya pada tabel, lalu melihat hasilnya di konsol.

Builder kueri Bigtable Studio memungkinkan Anda menggunakan pemilih drop-down untuk menentukan kombinasi klausa kueri tanpa perlu menulis aplikasi atau menggunakan CLI. Saat Anda menjalankan kueri, konsol akan melakukan panggilan ke Bigtable Data API, yang menampilkan data yang sesuai dengan kueri Anda.

Dokumen ini menjelaskan cara menggunakan pembuat kueri dan menawarkan tips untuk mengoptimalkan kueri Anda. Sebelum membaca halaman ini, Anda harus sudah memahami ringkasan Bigtable.

Kueri yang dijalankan di builder kueri memiliki harga dan kuota yang sama dengan kueri lainnya yang dikirim ke tabel.

Kapan harus menggunakan pembuat kueri

Kemampuan untuk melakukan kueri data Bigtable di konsol Google Cloud akan sangat membantu saat Anda perlu melakukan hal berikut:

Dapatkan representasi visual skema tabel Anda dengan cepat.
Memastikan bahwa data tertentu telah berhasil ditulis.
Memvalidasi integritas data selama migrasi.
Men-debug masalah data yang mungkin terjadi.
Lihat pratinjau hasil yang ditampilkan oleh kombinasi klausa tertentu sebelum menggunakannya dalam kode Anda. Hal ini dapat sangat membantu bagi pengguna baru BigQuery serta pengguna berpengalaman yang tidak ingin menggunakan CLI cbt.

Sebelum memulai

Untuk mendapatkan izin yang diperlukan untuk menggunakan pembuat kueri, minta administrator untuk memberi Anda peran IAM Bigtable Reader (roles/bigtable.reader) di project tersebut. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses.

Peran yang telah ditetapkan ini berisi izin yang diperlukan untuk menggunakan pembuat kueri. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk menggunakan pembuat kueri:

bigtable.tables.get
bigtable.instances.get
bigtable.appProfiles.list
bigtable.tables.list
bigtable.tables.readRows

Anda mung juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaanlainnya.

Jika tidak memiliki tabel untuk dikueri, Anda dapat membuat tabel pengujian kecil dan menjalankan kueri pada tabel tersebut.

Membuka builder kueri

Saat Anda membuka builder kueri, kueri default akan dijalankan dan ditampilkan untuk tabel pertama menurut abjad di instance. Kueri default dijalankan menggunakan profil aplikasi default, dan hingga 100 baris ditampilkan.

Buka daftar instance Bigtable di Konsol Google Cloud.

Membuka daftar instance
Klik nama instance yang berisi tabel yang ingin Anda buat kuerinya.
Di panel navigasi, klik Bigtable Studio. Halaman Bigtable Studio akan terbuka dalam mode builder kueri. Panel Explorer menyediakan daftar tabel dalam instance, dan panel Query results yang menampilkan hasil kueri default.
Opsional: Ciutkan panel Penjelajah untuk memperbesar panel pembuat kueri.

Format tampilan data

Hasil pembuat kueri ditampilkan dalam tabel. Judul dan kolom pertama adalah Row key. Judul yang tersisa masing-masing mewakili kolom dalam tabel Bigtable, yang dinyatakan sebagai kelompok kolom dan penentu kolom yang dipisahkan dengan titik dua. Misalnya, judul cell_plan: data_plan_01gb menunjukkan bahwa nilai dalam kolom tersebut berasal dari kolom data_plan_01gb dalam kelompok kolom cell_plan.

drop-down

Hanya nilai terbaru untuk kolom yang ditampilkan. Stempel waktu disembunyikan secara default, tetapi Anda dapat mengklik tombol untuk menampilkannya.

Pilih tabel

Gunakan drop-down Tabel untuk memilih ID tabel yang ingin Anda kueri.

Opsional: Menentukan profil aplikasi

Anda dapat menggunakan profil aplikasi yang dibuat khusus untuk digunakan dengan pembuat kueri. Hal ini dapat berguna, misalnya, saat Anda ingin mengisolasi traffic kueri menggunakan cluster yang berbeda dengan yang digunakan oleh aplikasi utama Anda.

Untuk menggunakan profil aplikasi yang berbeda guna menjalankan kueri berikutnya, ikuti langkah-langkah berikut.

Klik Tambahkan ke kueri.
Klik Change app profile (default). Drop-down baru akan ditampilkan.
Gunakan drop-down App profile dan pilih dari daftar profil aplikasi instance.

Untuk membaca selengkapnya tentang keuntungan menggunakan profil aplikasi yang berbeda untuk beban kerja yang berbeda, lihat Tentang profil aplikasi . Untuk mempelajari cara membuat profil aplikasi, lihat Membuat dan mengonfigurasi profil aplikasi .

Jika tabel Anda berada dalam instance yang menggunakan replikasi, konfigurasikan profil aplikasi Anda untuk membaca dari cluster yang paling dekat dengan Anda.

Menambahkan klausa ke kueri, lalu menjalankannya

Setelah Anda memilih tabel dan profil aplikasi, tambahkan klausa ke kueri. Lihat bagian berikutnya untuk mengetahui detail tentang klausul yang tersedia.
Setelah menambahkan semua klausa, klik Run.
Lihat hasilnya.

Klausul kueri

Anda menggunakan pembuat kueri untuk menambahkan klausa ke kueri. Saat Anda menjalankan kueri, builder kueri akan membuat dan mengirim permintaan baca ke tabel Anda. Untuk mempelajari permintaan baca lebih lanjut, lihat Bacaan.

Baris kunci, rentang kunci baris, dan klausa awalan kunci baris menentukan baris yang diambil dari penyimpanan. Ekspresi reguler kunci baris, kolom, dan klausa rentang waktu menambahkan filter ke permintaan baca yang dihasilkan. Filter yang digunakan di pembuat kueri bekerja sama seperti saat Anda menggunakannya di library klien. Untuk mengetahui detail tentang filter Bigtable dan pengaruhnya terhadap performa, lihat Filter dan Menggunakan filter .

Tentukan kunci baris

Untuk mengambil satu baris dari tabel, berikan nilai kunci baris. Anda dapat menambahkan beberapa klausa kunci baris.

Klik Tambahkan ke kueri.
Di menu drop-down, pilih Kunci baris.
Masukkan nilai yang tepat dari kunci baris yang ingin Anda lihat nilainya.

Menentukan rentang kunci baris

Untuk mengambil rentang baris dari tabel, tentukan kunci baris awal dan akhir. Bigtable menyimpan data dalam urutan leksikografis berdasarkan baris kunci.

Klik Tambahkan ke kueri.
Di menu drop-down, pilih Baris kunci rentang.
Masukkan kunci baris awal lengkap.
Masukkan kunci baris akhir yang lengkap.

Menentukan awalan kunci baris

Untuk mengambil hanya baris yang kunci barisnya diawali dengan kumpulan karakter tertentu, filter menurut awalan kunci baris. Awalan kunci baris adalah N karakter pertama dari kunci baris. Berdasarkan konvensi, sering kali ada hashtag, pipa, atau simbol lain di antara awalan dan bagian lainnya dari row key.

Klik Tambahkan ke kueri.
Di menu drop-down, pilih Awalan kunci baris.
Masukkan awalan kunci baris. Anda tidak perlu memasukkan simbol karakter pengganti.

Filter menurut ekspresi reguler kunci baris

Untuk mendapatkan hanya baris yang nilai kunci barisnya cocok dengan ekspresi reguler yang ditentukan, gunakan filter ekspresi reguler kunci baris. Untuk performa yang lebih baik, tambahkan rentang kunci baris atau klausa awalan kunci baris ke kueri sebelum menambahkan filter ekspresi reguler kunci baris. Untuk panduan tentang cara menulis ekspresi reguler, lihat Ekspresi reguler kunci baris.

Klik Tambahkan ke kueri.
Di menu drop-down, pilih Ekspresi reguler kunci baris.
Masukkan ekspresi reguler yang menggunakan sintaksis re2

Filter menurut kolom

Untuk menentukan satu atau beberapa kolom yang akan disertakan dalam kueri, tambahkan klausa kolom, dengan memilih kelompok kolom dan penentu kolom untuk setiap kolom yang ingin Anda filter. Permintaan baca yang dihasilkan saat Anda menambahkan klausa ini mencakup filter ekspresi reguler jenis kolom dan filter rentang kolom.

Klik Tambahkan ke kueri.
Di menu drop-down, pilih Kolom.
Klik pada bidang Kolom. Daftar grup kolom akan ditampilkan.
Klik ID grup kolom. Daftar penentu kolom ditampilkan.
Klik penentu kolom.

Filter menurut rentang waktu

Untuk mengambil hanya sel dengan stempel waktu dalam rentang tertentu, tambahkan klausa rentang waktu, yang menggunakan filter rentang stempel waktu.

Klik Tambahkan ke kueri.
Di menu drop-down, pilih Rentang waktu.
Masukkan stempel waktu mulai.
Masukkan stempel waktu berakhir.

Berikan stempel waktu dalam salah satu format berikut:

Stempel waktu Unix dalam mikrodetik, seperti 3023483279876000
YYYY-MM-DDThh:mm:ss:ss[z]
YYYY/MM/DD-hh:mm:ss.sss[z]
MM/DD/YYYY
YYYY/MM/DD

T opsional adalah literal yang menunjukkan waktu, dan z opsional menunjukkan waktu UTC, bukan waktu lokal. Untuk mengetahui informasi selengkapnya tentang format stempel waktu, lihat ISO 8601 .

Menentukan batas

Untuk menentukan jumlah maksimum baris yang ditampilkan, tambahkan klausa batas.

Klik Tambahkan ke kueri.
Di menu drop-down, pilih Batasi.
Masukkan angka dari 1 hingga 1,00.

Batasan

Batasan berikut berlaku untuk pembuat kueri.

1.000 karakter per sel — Bigtable menampilkan maksimum 1.000 karakter per sel. Jika sel berisi lebih dari 1.000 karakter, hasil terpotong akan ditampilkan, yang dianotasi dengan jumlah karakter yang tidak ditampilkan.
Maksimum 100 kolom — Bigtable menampilkan 100 kolom pertama di setiap baris yang cocok dengan kueri. Kelompok kolom tidak disimpan dalam urutan tertentu, tetapi kolom diurutkan secara leksikografis dalam kelompok kolomnya.
1.000 row maksimum — Pembuat kueri menampilkan maksimum 1.000 baris data pertama yang cocok dengan kueri Anda.
Base64 — Bigtable melakukan upaya terbaik untuk menampilkan data berenkode Base64 secara akurat, tetapi hasilnya tidak dijamin. Jika Bigtable tidak dapat menampilkan data dalam sel, ukuran nilai sel akan ditampilkan dalam byte.
Data lama — Anda hanya dapat mengambil sel (atau versi) terbaru dalam kolom yang dikueri. Untuk mengetahui detail tentang konsep ini, lihat Model penyimpanan Bigtable dan Konsep umum
Data serial — Data yang disimpan sebagai buffering protokol tidak ditampilkan dengan benar dalam hasil kueri. Data JSON didukung dengan lebih baik, tetapi tidak dijamin terlihat benar.
Stempel waktu buatan — Jika aplikasi Anda menetapkan angka non-stempel waktu ke properti stempel waktu sel saat menulis data ke tabel, Anda dapat menggunakan filter rentang waktu dalam kueri untuk mendapatkan rentang nilai yang digunakan, bukan stempel waktu, selama Anda menentukannya sebagai mikrodetik. Untuk memahami alasan data tabel Anda menggunakan stempel waktu buatan, lihat Stempel waktu