Statistik tabel

Bigtable menyediakan statistik tabel — metadata tentang tabel — yang memberi Anda informasi ringkasan tentang tabel, seperti jumlah baris atau jumlah rata-rata sel per kolom.

Dokumen ini menjelaskan statistik tabel dan menjelaskan cara mendapatkannya menggunakan Google Cloud CLI. Sebelum membaca halaman ini, Anda harus memahami model penyimpanan Bigtable dan memahami praktik terbaik desain skema dan pengumpulan sampah.

Statistik tabel memberikan visibilitas ke dalam tabel Bigtable. Metrik ini dapat berguna saat Anda memecahkan masalah terkait performa atau penyimpanan, atau saat Anda ingin menentukan sumber biaya penyimpanan. Laporan ini juga dapat membantu Anda menentukan apakah Anda menyimpan lebih banyak data daripada yang diperlukan.

Presisi yang diharapkan

Saat mengambil statistik tabel untuk tabel, data yang Anda dapatkan adalah perkiraan – statistik tabel mencerminkan status tabel di salah satu cluster instance Anda sejak pemadatan terbaru.

Kumpulan lengkap statistik tabel tidak tersedia hingga setelah pengompresian awal, yang biasanya terjadi sekitar seminggu setelah tabel dibuat. Statistik tabel akurat sejak pemadatan terbaru, yang mungkin terjadi seminggu yang lalu.

Kolom statistik tabel

Permintaan untuk statistik tabel akan menampilkan kolom berikut. Detail dan contohnya ada di bagian berikutnya.

Kolom statistik tabel Nama API Deskripsi
Jumlah baris row_count Jumlah baris dalam tabel. Untuk mengetahui detailnya, lihat Jumlah baris.
Jumlah rata-rata kolom per baris average_columns_per_row Jumlah rata-rata kolom di setiap baris untuk seluruh tabel. Untuk mengetahui detail dan contohnya, lihat Rata-rata jumlah kolom per baris
Jumlah rata-rata sel per kolom average_cells_per_column Jumlah rata-rata sel yang disimpan di semua kolom di semua baris. Untuk mengetahui detailnya, lihat Rata-rata jumlah sel per kolom.
Data logis dalam byte logical_data_bytes Jumlah ruang yang digunakan tabel. Untuk mengetahui detailnya, lihat Data logika dalam byte.

Statistik tabel juga menyertakan kolom berikut untuk setiap grup kolom dalam tabel.

Bidang statistik keluarga kolom Nama API Deskripsi
Jumlah rata-rata kolom per baris average_columns_per_row Jumlah rata-rata kolom per baris dalam grup kolom. Untuk mengetahui detail dan contohnya, lihat Rata-rata jumlah kolom per baris.
Jumlah rata-rata sel per kolom average_cells_per_column Jumlah sel di setiap kolom, yang dirata-ratakan di semua baris yang memiliki kolom dalam grup kolom. Untuk mengetahui detail dan contohnya, lihat Rata-rata jumlah sel per kolom.
Data logis dalam byte logical_data_bytes Jumlah ruang yang digunakan grup kolom. Untuk mengetahui detailnya, lihat Data logika dalam byte.

Detail kolom statistik tabel

Jumlah baris

Jumlah baris adalah jumlah baris dalam tabel. Setiap baris diidentifikasi oleh kunci barisnya.

Jumlah rata-rata kolom per baris

Untuk mendapatkan jumlah rata-rata kolom per baris untuk tabel, Bigtable menghitung jumlah kolom di seluruh tabel dan membagi nilai tersebut dengan jumlah baris dalam tabel.

Sebagai contoh, perhatikan tabel berikut. Baris pertama memiliki tiga kolom, dan baris kedua memiliki dua kolom.

Row key Grup kolom family-A Grup kolom family-B
kunci baris 1 family-A:qualifier-W family-A:qualifier-X family-B:qualifier-Y
kunci baris 2 family-A:qualifier-W family-B:qualifier-Z

Tabel memiliki lima kolom dan dua baris, sehingga jumlah rata-rata kolom per baris adalah 2.5.

Statistik tabel ini memberi Anda gambaran umum tentang apakah tabel Anda tinggi dan sempit (beberapa kolom per baris) atau pendek dan lebar (banyak kolom di setiap baris).

Jumlah rata-rata sel per kolom

Untuk mendapatkan jumlah rata-rata sel per kolom untuk tabel, Bigtable mengambil jumlah total sel yang disimpan dalam tabel dan membaginya dengan jumlah kolom dalam tabel.

Bergantung pada desain skema dan kebijakan pembersihan sampah, tabel Anda mungkin memiliki beberapa sel dalam satu kolom, atau mungkin hanya memiliki satu sel. Jumlah sel yang dapat Anda simpan dibatasi oleh batas ukuran data yang diuraikan di halaman Kuota dan batas di bagian Ukuran data dalam tabel.

Jika Anda mendapati bahwa jumlah ini lebih tinggi dari yang Anda harapkan, periksa aturan pembersihan sampah untuk melihat apakah Anda mempertahankan lebih banyak sel daripada yang diperlukan. Anda juga dapat menanyakan apakah skema dan pola tulis Anda harus disesuaikan.

Data logis dalam byte (tabel)

Nilai ini mewakili perkiraan jumlah byte yang akan diperlukan untuk membaca seluruh tabel Anda. Statistik tabel ini memberi Anda gambaran tentang jumlah byte yang disimpan dalam tabel. Mengetahui data logis dalam byte dapat membantu Anda memahami dampak kompresi pada tabel. Misalnya, jika ukuran tabel yang dilaporkan di Cloud Monitoring sama dengan atau lebih besar dari data logis dalam byte untuk tabel, Anda mungkin menyimpan data dalam format yang tidak mudah dikompresi.

Detail kolom statistik keluarga kolom

Statistik tabel untuk tabel mencakup kolom berikut untuk setiap grup kolom dalam tabel.

Jumlah rata-rata kolom per baris

Jumlah ini dihitung dengan mengambil jumlah kolom dalam keluarga kolom dan membagi jumlah tersebut dengan jumlah baris dalam tabel.

Sebagai contoh, perhatikan tabel berikut. Tabel memiliki tiga baris dengan kolom dalam grup kolom family-A dan family-B.

Row key Grup kolom family-A Grup kolom family-B
kunci baris 1 family-A:qualifier-W family-A:qualifier-X family-B:qualifier-Y
kunci baris 2 family-A:qualifier-W
kunci baris 3 family-A:qualifier-W family-A:qualifier-X family-B:qualifier-Y family-B:qualifier-Z

Grup kolom family-A memiliki total lima kolom dalam tabel. Dibagi dengan tiga baris, artinya jumlah rata-rata sel per kolom untuk family-A adalah 1.67 (dibulatkan di sini ke dua tempat desimal).

Grup kolom family-B memiliki total tiga kolom dalam tabel. Jika dibagi dengan tiga baris, jumlah rata-rata kolom per baris untuk family-A adalah 1.

Jumlah rata-rata sel per kolom

Untuk menentukan jumlah rata-rata sel per kolom dalam grup kolom, Bigtable mengambil jumlah semua sel dalam grup kolom di semua baris tabel dan membaginya dengan jumlah baris dalam tabel.

Sebagai contoh, pertimbangkan baris berikut dalam keluarga kolom family-D.

Row key Grup kolom family-D
kunci baris 1 family-D:qualifier-W (3 sel) family-D:qualifier-X (1 sel)
kunci baris 2 family-D:qualifier-X (10 sel)
kunci baris 3 family-D:qualifier-W (7 sel) family-D:qualifier-Y (6 sel)

Jumlah sel dalam grup kolom adalah 3 + 1 + 10 + 7 + 6 = 27. Nilai tersebut dibagi dengan 3 (jumlah baris) berarti grup kolom family-D memiliki rata-rata sel per kolom 9.

Data logis dalam byte (grup kolom)

Data logis dalam byte mencerminkan ruang yang ditempati oleh keluarga kolom. Nilai ini kira-kira adalah jumlah byte yang Anda perlukan untuk membaca semua data dalam keluarga kolom pada saat statistik tabel ditampilkan.

Contoh penggunaan gcloud CLI

Untuk mendapatkan statistik tabel untuk tabel bernama sample-table, gunakan perintah bigtable instances table describe:

gcloud bigtable instances tables describe TABLE_ID \
    --instance=INSTANCE_ID --view stats

Ganti kode berikut:

  • TABLE_ID: ID permanen untuk tabel
  • INSTANCE_ID: ID permanen untuk instance

Outputnya mirip dengan hal berikut ini:

  columnFamilies:
    my-family:
     stats:
       averageCellsPerColumn: 12.34
       averageColumnsPerRow: 56.78
       logicalDataBytes: 314159
  name: projects/my-project/instances/INSTANCE_ID/tables/TABLE_ID
  stats:
    averageCellsPerColumn: 12.34
    averageColumnsPerRow: 56.78
    logicalDataBytes: 314159
    rowCount: 271828

Langkah selanjutnya