Membuat kueri di konsol
Anda dapat membuat kueri dan melihat data Bigtable menggunakan query builder Bigtable Studio. Builder kueri adalah formulir interaktif di konsol Google Cloud yang memungkinkan Anda 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 cocok 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 pembuat kueri tunduk pada harga dan kuota yang sama seperti kueri lainnya yang dikirim ke tabel.
Kapan harus menggunakan pembuat kueri
Kemampuan untuk membuat kueri data Bigtable di konsol Google Cloud akan berguna saat Anda perlu melakukan hal berikut:
- Dapatkan representasi visual skema tabel dengan cepat.
- Verifikasi bahwa data tertentu berhasil ditulis.
- Memvalidasi integritas data selama migrasi.
- Men-debug kemungkinan masalah data.
- Lihat pratinjau hasil yang ditampilkan oleh kombinasi klausa tertentu sebelum
Anda menggunakannya dalam kode. Hal ini dapat sangat membantu pengguna Bigtable baru serta pengguna berpengalaman yang tidak ingin menggunakan CLI
cbt.
Sebelum memulai
Untuk mendapatkan izin yang diperlukan guna menggunakan pembuat kueri,
minta administrator untuk memberi Anda
peran IAM Bigtable Reader (roles/bigtable.reader) pada project.
Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.
Peran yang telah ditentukan ini berisi izin yang diperlukan untuk menggunakan pembuat kueri. Untuk melihat izin yang benar-benar diperlukan, luaskan 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 mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.
Jika tidak memiliki tabel untuk dikueri, Anda dapat membuat tabel pengujian kecil dan menjalankan kueri terhadap tabel tersebut.
Membuka pembuat kueri
Saat Anda membuka pembuat kueri, kueri default akan dijalankan dan ditampilkan untuk tabel pertama secara alfabetis dalam instance. Kueri default dijalankan menggunakan profil aplikasi default, dan hingga 100 baris ditampilkan.
Buka daftar instance Bigtable di konsol Google Cloud.
Klik nama instance yang berisi tabel yang ingin Anda buat kueri.
Di panel navigasi, klik Bigtable Studio. Halaman Bigtable Studio akan terbuka dalam mode pembuat kueri. Panel Explorer menyediakan daftar tabel dalam instance, dan panel Query results 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
Kunci baris. Setiap judul yang tersisa mewakili kolom dalam
tabel Bigtable, yang dinyatakan sebagai grup kolom dan penentu
kolom yang dipisahkan oleh titik dua. Misalnya, judul
cell_plan: data_plan_01gb menunjukkan bahwa nilai dalam kolom tersebut berasal dari
kolom data_plan_01gb dalam grup kolom cell_plan.
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 buat kueri.
Opsional: Tentukan 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 dengan menggunakan cluster yang berbeda dengan yang digunakan oleh aplikasi utama Anda.
Untuk menggunakan profil aplikasi lain guna menjalankan kueri berikutnya, ikuti langkah-langkah berikut.
- Klik Tambahkan ke kueri.
- Klik Ubah profil aplikasi (default). Drop-down baru akan ditampilkan.
- Gunakan drop-down Profil aplikasi dan pilih dari daftar profil aplikasi instance.
Untuk membaca lebih lanjut tentang keuntungan menggunakan profil aplikasi yang berbeda untuk workload 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 secara geografis dengan Anda.
Menambahkan klausa ke kueri, lalu menjalankannya
- Setelah memilih tabel dan profil aplikasi, tambahkan klausa ke kueri. Lihat bagian berikutnya untuk mengetahui detail klausul yang tersedia.
- Setelah menambahkan semua klausa, klik Jalankan.
- Lihat hasilnya.
Klausa kueri
Anda menggunakan builder kueri untuk menambahkan klausa ke kueri. Saat Anda menjalankan kueri, pembuat kueri akan membuat dan mengirim permintaan baca ke tabel Anda. Untuk mempelajari permintaan baca lebih lanjut, lihat Pembacaan.
Klausa kunci baris, rentang kunci baris, dan awalan kunci baris menentukan baris yang diambil dari penyimpanan. Klausa rentang waktu, kolom, dan ekspresi reguler kunci baris menambahkan filter ke permintaan baca yang dihasilkan. Filter yang Anda gunakan di pembuat kueri berfungsi sama seperti saat Anda menggunakannya di library klien. Untuk mengetahui detail tentang filter Bigtable dan pengaruh penggunaannya terhadap performa, lihat Filter dan Menggunakan filter .
Menentukan 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 kunci baris yang tepat yang nilainya ingin Anda lihat.
Menentukan rentang kunci baris
Untuk mengambil rentang baris dari tabel, tentukan kunci baris awal dan akhir. Bigtable menyimpan data dalam urutan leksikografis berdasarkan kunci baris.
- Klik Tambahkan ke kueri.
- Di menu drop-down, pilih Rentang kunci baris.
- Masukkan kunci baris awal yang lengkap.
- Masukkan kunci baris akhir yang lengkap.
Menentukan awalan kunci baris
Untuk hanya mengambil baris yang kunci barisnya dimulai dengan kumpulan karakter tertentu, filter menurut awalan kunci baris. Awalan kunci baris adalah N karakter pertama dari kunci baris. Secara umum, sering kali ada hashtag, pipa, atau simbol lainnya di antara awalan dan kunci baris lainnya.
- Klik Tambahkan ke kueri.
- Di menu drop-down, pilih Prefix kunci baris.
- Masukkan awalan kunci baris. Anda tidak perlu memasukkan simbol karakter pengganti apa pun.
Memfilter menurut ekspresi reguler kunci baris
Untuk hanya mendapatkan 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 Anda menambahkan filter ekspresi reguler kunci baris. Untuk panduan dalam membuat ekspresi reguler, lihat Ekspresi reguler kunci baris.
- Klik Tambahkan ke kueri.
- Di menu drop-down, pilih Row key regex.
- Masukkan ekspresi reguler yang menggunakan sintaksis re2
Memfilter menurut kolom
Untuk menentukan satu atau beberapa kolom yang akan disertakan dalam kueri, tambahkan klausa columns, dengan memilih keluarga kolom dan penentu kolom untuk setiap kolom yang ingin Anda filter. Permintaan baca yang dihasilkan saat Anda menambahkan klausa ini menyertakan filter ekspresi reguler keluarga kolom dan filter rentang kolom .
- Klik Tambahkan ke kueri.
- Di menu drop-down, pilih Columns.
- Klik di kolom Kolom. Daftar grup kolom akan ditampilkan.
- Klik ID grup kolom. Daftar penentu kolom akan ditampilkan.
- Klik penentu kolom.
Memfilter menurut rentang waktu
Untuk hanya mengambil 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 akhir.
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]
- DD/MM/YYYY
- TTTT/BB/HH
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 Batas.
- 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 yang terpotong akan ditampilkan, dianotasi dengan jumlah karakter yang tidak ditampilkan.
- Maksimal 100 kolom — Bigtable menampilkan 100 kolom pertama di setiap baris yang cocok dengan kueri. Grup kolom tidak disimpan dalam urutan tertentu, tetapi kolom diurutkan secara leksikografis dalam grup kolomnya.
- Maksimum 1.000 baris — Builder kueri menampilkan maksimum 1.000 baris data pertama yang cocok dengan kueri Anda.
- Base64 — Bigtable berupaya sebaik mungkin untuk menampilkan data yang dienkode Base64 secara akurat, tetapi hasilnya tidak dijamin. Jika tidak dapat menampilkan data dalam sel, Bigtable akan menampilkan ukuran nilai sel dalam byte.
Data lama — Anda hanya dapat mengambil sel (atau versi) terbaru di kolom yang Anda kueri. Untuk mengetahui detail tentang konsep ini, lihat Model penyimpanan Bigtable dan Konsep umum
Data serialisasi — Data yang disimpan sebagai buffering protokol tidak ditampilkan dengan benar dalam hasil kueri. Data JSON didukung dengan lebih baik, tetapi tidak dijamin akan 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 Anda gunakan, bukan stempel waktu, selama Anda menentukannya sebagai mikrodetik. Untuk memahami alasan data tabel Anda mungkin menggunakan stempel waktu buatan, lihat Stempel waktu