Membuat dan mengelola tabel

Tabel Bigtable memungkinkan Anda mengatur dan menyimpan data berskala besar untuk workload aplikasi berlatensi rendah. Anda dapat membuat dan mengelola tabel ini menggunakan konsol Google Cloud , Google Cloud CLI, cbt CLI, atau secara terprogram dengan library klien Cloud Bigtable.

Untuk mengetahui informasi selengkapnya tentang cara membuat dan mengelola tampilan tabel yang diotorisasi, lihat tampilan yang diotorisasi.

Sebelum memulai

Jika Anda berencana menggunakan tabel menggunakan alat command line, ikuti langkah-langkah di bagian ini.

1. Instal gcloud CLI.

2. Opsional: Jika Anda berencana menggunakan cbt CLI , ikuti petunjuk di Menginstal cbt CLI , termasuk langkah untuk membuat file .cbtrc.

   Petunjuk cbt CLI di halaman ini mengasumsikan bahwa Anda telah menetapkan project ID dan ID instance di file .cbtrc. Atau, Anda dapat menggunakan flag -project dan -instance untuk menetapkan nilai ini setiap kali Anda menjalankan perintah cbt CLI.

Membuat tabel

Saat membuat tabel, Anda tidak perlu menentukan grup kolom yang akan digunakan dalam tabel. Anda dapat menambahkan atau menghapus grup kolom nanti.

Konsol

Untuk membuat tabel baru dalam instance:

1. Di konsol Google Cloud , buka daftar instance Bigtable.

   Buka daftar instance

2. Klik instance yang tabelnya ingin Anda lihat.

3. Klik Tables di panel kiri.

   Halaman Tables menampilkan daftar tabel dalam instance.

4. Klik Create table.

5. Masukkan ID tabel untuk tabel.

6. Opsional: Tambahkan grup kolom.

   Anda dapat menambahkan kolom sekarang atau nanti. Tabel harus memiliki setidaknya satu grup kolom sebelum Anda dapat menulis data ke tabel tersebut atau membaca aliran data perubahan darinya.

7. Opsional, edisi Enterprise Plus: Untuk menggunakan perincian stempel waktu mikrodetik, pilih Use microsecond timestamps.

8. Opsional: Aktifkan aliran data perubahan untuk tabel. Sebelum mengaktifkan aliran data perubahan, pastikan Anda memahami implikasinya, termasuk peningkatan biaya penyimpanan dan persyaratan penggunaan profil aplikasi. Untuk mengetahui informasi selengkapnya, lihat Ringkasan aliran perubahan.

   1. Pilih Aktifkan aliran perubahan.

   2. Di kolom Retention time, masukkan angka dari 1 hingga 7 untuk menentukan jumlah hari penyimpanan data aliran perubahan.

9. Opsional: Jika Anda tidak ingin Bigtable membuat cadangan harian tabel, hapus centang pada kotak Enable automated backup. Untuk informasi selengkapnya, lihat Menggunakan pencadangan otomatis.

10. Opsional: Aktifkan akses tidak sering untuk tabel sebagai bagian dari penyimpanan bertingkat (Pratinjau):

    1. Pilih Enable tiered storage.

    2. Di kolom Age threshold, masukkan jumlah hari setelah Bigtable memindahkan data dari penyimpanan SSD ke penyimpanan akses jarang. Angka harus 30 atau lebih besar.

11. Opsional, edisi Enterprise Plus: Secara default, pencadangan harian dibuat di semua cluster dalam instance tabel. Untuk memilih cluster tempat Bigtable harus membuat cadangan harian tabel, pilih lokasi cluster di kolom Select clusters to back up. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi lokasi cluster pencadangan otomatis.

12. Opsional: Untuk mengonfigurasi skema kunci baris, pilih Define row key schema, lalu lakukan hal berikut:

    1. Dalam daftar Encoding, pilih jenis encoding untuk skema row key Anda.

    2. Jika Anda memilih DelimitedBytes, di kolom Delimiter, masukkan pemisah yang memisahkan segmen di row key yang ada. Nilai defaultnya adalah simbol hash (#).

    3. Di kolom Segment, masukkan nama untuk segmen, seperti device_type.

    4. Dalam daftar Type, pilih jenis data segmen row key.

    5. Bergantung pada jenis data yang dipilih, dalam daftar Byte encoding, biarkan jenis encoding default segmen row key atau ubah.

    6. Opsional: jika segmen kunci baris Anda memiliki lebih dari satu bagian, klik Add row key segment untuk menambahkan kolom tambahan.

13. Klik Create.

gcloud

Untuk membuat tabel, jalankan perintah berikut. Lihat gcloud bigtable instances tables create untuk mengetahui daftar lengkap opsi.

gcloud bigtable instances tables create TABLE_ID \
    --instance=INSTANCE_ID \
    --project=PROJECT_ID \
    --column-families=COLUMN-FAMILIES

Ganti kode berikut:

• TABLE_ID: ID unik untuk tabel baru
• INSTANCE_ID: ID instance
• PROJECT_ID: project yang akan berisi tabel baru
• COLUMN-FAMILIES: daftar nama grup kolom yang dipisahkan koma. Anda dapat menambahkan lebih banyak grup kolom nanti.

Opsional:

• Untuk melindungi tabel dari penghapusan, tambahkan perintah dengan --deletion-protection. Jika Anda tidak menerapkan setelan ini, tabel dapat dihapus. Anda juga dapat secara eksplisit mengizinkan penghapusan tabel dengan menambahkan --no-deletion-protection.

• Untuk mengaktifkan aliran data perubahan untuk tabel, tentukan periode retensi untuk data aliran data perubahan. Sebelum mengaktifkan aliran data perubahan, pastikan Anda memahami implikasinya, termasuk peningkatan biaya penyimpanan dan persyaratan penggunaan profil aplikasi. Untuk mengetahui informasi selengkapnya, lihat Ringkasan aliran perubahan.

  --change-stream-retention-period=RETENTION_PERIOD
  

  Ganti RETENTION_PERIOD dengan durasi waktu Bigtable harus mempertahankan data aliran perubahan untuk tabel. Waktu harus antara satu hingga tujuh hari. Satuan yang dapat diterima adalah hari (d), jam (h), menit (m), dan detik (s). Contoh: 48h atau 6d

• Agar Bigtable membuat cadangan harian tabel Anda dan mempertahankan setiap cadangan selama periode retensi default tujuh hari, gunakan flag --enable-automated-backup saat Anda membuat tabel.

  gcloud bigtable instances tables create TABLE_ID \
      --instance=INSTANCE_ID \
      --project=PROJECT_ID \
      --column-families=COLUMN-FAMILIES \
      --enable-automated-backup
  

  Untuk mengonfigurasi periode retensi yang berbeda, gunakan flag --automated-backup-retention-period, bukan flag --enable-automated-backup, dan berikan nilai hingga 90 hari. Nilai harus dinyatakan sebagai angka dengan satuan m, h, atau d (menit, jam, atau hari), seperti 15d untuk 15 hari.

  Edisi Enterprise Plus: Secara default, pencadangan harian dibuat di semua cluster dalam instance tabel. Untuk mengonfigurasi lokasi cluster tempat Bigtable harus membuat cadangan harian tabel, gunakan flag --automated-backup-locations, bukan flag --enable-automated-backup. Berikan daftar lokasi cluster yang dipisahkan koma, tempat pencadangan otomatis harus diaktifkan. Contoh: us-central1-a,us-east1-b,europe-west1-c.

  Catatan: Jika periode retensi kustom dan lokasi pencadangan otomatis dikonfigurasi untuk tabel Anda, pastikan untuk menggunakan kedua flag untuk mengubah konfigurasi tabel nanti, meskipun Anda hanya mengubah salah satu parameter. Jika tidak, parameter lainnya akan direset ke nilai default.

• Untuk mengaktifkan akses jarang sebagai bagian dari penyimpanan bertingkat (Pratinjau), gunakan flag
  --tiered-storage-infrequent-access-older-than dan ganti AGE_THRESHOLD dengan nilai minimal 30 hari. Unit yang dapat diterima adalah hari (d), jam (h), menit (m), dan detik (s). Contoh: 32d atau 32d12h.

  gcloud beta bigtable instances tables create TABLE_ID \
      --instance=INSTANCE_ID \
      --project=PROJECT_ID \
      --tiered-storage-infrequent-access-older-than=AGE_THRESHOLD
  

• Untuk mengonfigurasi perincian stempel waktu untuk tabel, gunakan flag --timestamp-granularity dan ganti TIMESTAMP_GRANULARITY dengan tingkat presisi. Presisi defaultnya adalah milidetik dan nilainya adalah MILLIS. Jika Anda ingin tabel menerima stempel waktu dengan presisi mikrodetik, tetapkan nilainya ke MICROS. Stempel waktu presisi mikrodetik hanya tersedia untuk instance di edisi Enterprise Plus.

  gcloud bigtable instances tables create TABLE_ID \
      --instance=INSTANCE_ID \
      --project=PROJECT_ID \
      --column-families=COLUMN-FAMILIES \
      --timestamp-granularity=TIMESTAMP_GRANULARITY
  

cbt

Gunakan perintah berikut, dengan mengganti TABLE_NAME dengan nama tabel Anda. Anda tidak dapat menggunakan cbt CLI untuk membuat tabel dengan aliran data perubahan yang diaktifkan.

cbt createtable TABLE_ID

Opsional: Untuk membuat grup kolom agregat dalam tabel, tambahkan nama grup kolom dengan jenis agregasi. Berikut ini membuat grup kolom gabungan dengan kebijakan pembersihan sampah memori never.

cbt createtable TABLE_ID families=FAMILY_NAME:never:TYPE

Ganti kode berikut:

• TABLE_ID: ID unik untuk tabel baru
• FAMILY_NAME: : daftar nama grup kolom yang dipisahkan koma. Anda dapat menambahkan lebih banyak grup kolom nanti.
• TYPE: jenis agregat. Harus berupa intsum, intmin, intmax, atau inthll.

Untuk opsi lainnya, lihat Membuat tabel dalam referensi CLI cbt.

Jika Anda tidak sengaja menghapus tabel, jangan mencoba membuat tabel yang dihapus secara manual. Gunakan perintah gcloud CLI bigtable instances tables undelete untuk memulihkan tabel.

Opsional: Memisahkan tabel berdasarkan row key

Poin Penting: Anda hanya dapat menentukan pemisahan tabel saat membuat tabel baru, dan pemisahan yang ditentukan tersebut akan tetap ada selama sekitar 24 jam.

Untuk mengoptimalkan performa, Bigtable terus membagi tabel di beberapa node, mendistribusikan jumlah data yang disimpan di setiap node secara merata, dan menjaga baris yang sering diakses tetap tersebar jika memungkinkan. Proses berkelanjutan ini bersifat otomatis.

Saat membuat tabel baru, Anda dapat menentukan pemisahan tabel awal. Bigtable memisahkan tabel pada kunci baris yang Anda berikan. Jika ruang kunci terlalu besar, Bigtable akan membagi tabel lebih lanjut. Pembagian awal dipertahankan selama sekitar 24 jam setelah pembuatan tabel selesai. Anda dapat memberikan hingga 100 row key tempat pemisahan awal akan terjadi.

Misalnya, Anda dapat menetapkan baris tertentu untuk memisahkan tabel terlebih dahulu jika Anda akan menulis banyak baris ke tabel.

Pra-pemisahan tabel tidaklah penting, tetapi bermanfaat karena memberikan informasi kepada Bigtable tentang kemungkinan lokasi beban dan jejak data saat tabel dibuat. Pra-pemisahan mencegah Bigtable harus memisahkan tabel dan menyeimbangkan kembali beban sekaligus saat data masuk.

Konsol

Anda tidak dapat memisahkan baris terlebih dahulu saat membuat tabel menggunakan konsolGoogle Cloud .

gcloud

Untuk memisahkan tabel berdasarkan row key, jalankan perintah berikut. Lihat gcloud bigtable instances tables create untuk mengetahui daftar lengkap opsi.

gcloud bigtable instances tables create TABLE_ID\
    --instance=INSTANCE_ID \
    --project=PROJECT_ID \
    --column-families=COLUMN-FAMILIES \
    --splits=SPLITS

Ganti kode berikut:

• TABLE_ID: ID unik untuk tabel baru
• INSTANCE_ID: ID instance
• PROJECT_ID: project yang akan berisi tabel baru
• COLUMN-FAMILIES: daftar nama grup kolom yang dipisahkan koma. Anda dapat menambahkan lebih banyak grup kolom nanti.
• SPLITS: row key tempat tabel harus dibagi pada awalnya—misalnya, 10,20.

cbt

Untuk melakukan pra-pemisahan tabel berdasarkan row key, gunakan sintaksis berikut untuk membuat tabel. Ganti [TABLE_NAME] dengan nama tabel dan [SPLITS] dengan daftar awalan kunci baris yang dipisahkan koma untuk digunakan dalam pra-pemisahan.

```none
cbt createtable [TABLE_NAME] splits=[SPLITS]
```

Misalnya, untuk melakukan pra-pemisahan tabel my-table pada row key yang diawali dengan 10 dan 20:

```none
cbt createtable my-table splits=10,20
```

Mengubah grup kolom dalam tabel

Anda dapat menambahkan grup kolom saat membuat tabel atau ke tabel yang sudah ada. Jika tabel tidak mengaktifkan proteksi dari penghapusan, Anda dapat menghapus grup kolom dalam tabel.

Menambahkan grup kolom

Konsol

Menambahkan grup kolom ke tabel baru

1. Di panel Create table, untuk setiap grup kolom yang ingin Anda tambahkan, klik Add a column family.

2. Di kolom Column family name, masukkan ID unik untuk grup kolom.

3. Pilih jenis grup kolom:

   • Standard: membuat grup kolom standar yang dikelola oleh kebijakan pembersihan sampah memori.
   • Aggregate: membuat grup kolom yang otomatis menggabungkan data pada waktu penulisan. Anda dapat mengonfigurasi kebijakan pembersihan sampah memori khusus untuk agregasi guna mengelola kebijakan retensi data, seperti bucket waktu.

4. Jika Anda memilih Aggregate, di kolom Aggregator, pilih salah satu opsi berikut:

   • Jumlah: menggabungkan jumlah semua nilai sel.
   • Min: menggabungkan nilai sel minimum.
   • Max: menggabungkan nilai sel maksimum.
   • HyperLogLog: menggabungkan perkiraan kardinalitas nilai sel.

5. Tetapkan kebijakan pembersihan sampah memori untuk grup kolom.

6. Klik Done.

Menambahkan grup kolom ke tabel yang ada

1. Di konsol Google Cloud , buka daftar instance Bigtable.

   Buka daftar instance

2. Klik instance yang tabelnya ingin Anda lihat.

3. Klik Tables di panel kiri.

   Halaman Tables menampilkan daftar tabel dalam instance.

4. Klik Edit untuk tabel yang ingin Anda ubah.

5. Untuk setiap grup kolom yang ingin Anda tambahkan, lakukan hal berikut:

   1. Klik Tambahkan grup kolom.
   2. Di kolom Column family name, masukkan ID unik untuk grup kolom.

   3. Pilih jenis grup kolom:

      • Standard: membuat grup kolom standar yang dikelola oleh kebijakan pembersihan sampah memori.
      • Aggregate: membuat grup kolom yang otomatis menggabungkan data pada waktu penulisan. Anda dapat mengonfigurasi kebijakan pembersihan sampah memori khusus untuk agregasi guna mengelola kebijakan retensi data, seperti bucket waktu.

   4. Jika Anda memilih Aggregate, di kolom Aggregator, pilih salah satu opsi berikut:

      • Jumlah: menggabungkan jumlah semua nilai sel.
      • Min: menggabungkan nilai sel minimum.
      • Max: menggabungkan nilai sel maksimum.
      • HyperLogLog: menggabungkan perkiraan kardinalitas nilai sel.

   5. Tetapkan kebijakan pembersihan sampah memori untuk grup kolom.

   6. Klik Done.

6. Klik Save.

gcloud

Anda tidak dapat menggunakan gcloud CLI untuk menambahkan grup kolom ke tabel.

cbt

Untuk menambahkan grup kolom ke tabel, gunakan perintah berikut:

cbt createfamily TABLE_ID FAMILY_NAME

Misalnya, untuk menambahkan grup kolom cf1 dan cf2 ke tabel my-table:

cbt createfamily my-table cf1
cbt createfamily my-table cf2

Opsional: Untuk menambahkan grup kolom agregat ke tabel, tambahkan nama grup kolom dengan jenis agregasi. Berikut ini membuat tabel yang memiliki grup kolom gabungan dengan kebijakan pembersihan sampah memori never.

cbt createfamily TABLE_ID FAMILY_NAME:never:TYPE

Ganti kode berikut:

• TABLE_ID: ID tabel
• FAMILY_NAME: : daftar nama grup kolom yang dipisahkan koma. Anda dapat menambahkan lebih banyak grup kolom nanti.
• TYPE: jenis agregasi. Harus berupa intsum, intmin, intmax, atau inthll.

Menghapus grup kolom

Anda dapat menghapus grup kolom dalam tabel yang tidak mengaktifkan proteksi dari penghapusan.

Peringatan: Saat menghapus grup kolom, Anda juga menghapus data yang disimpan dalam grup kolom tersebut. Penghapusan grup kolom tidak dapat diurungkan.

Konsol

1. Di konsol Google Cloud , buka daftar instance Bigtable.

   Buka daftar instance

2. Klik instance yang tabelnya ingin Anda lihat.

3. Klik Tables di panel kiri.

   Halaman Tables menampilkan daftar tabel dalam instance.

4. Klik Edit untuk tabel yang ingin Anda ubah.

5. Untuk setiap grup kolom yang ingin Anda hapus, selesaikan langkah-langkah berikut:

   1. Arahkan kursor ke baris untuk grup kolom yang ingin Anda hapus.
   2. Klik .

6. Klik Simpan.

7. Untuk mengonfirmasi bahwa Anda memahami bahwa penghapusan grup kolom bersifat permanen dan semua data dalam grup kolom akan dihapus, ketik "Delete column families" di kolom teks.

8. Klik Konfirmasi.

gcloud

Anda tidak dapat menggunakan gcloud CLI untuk menghapus grup kolom dari tabel.

cbt

Untuk menghapus grup kolom dari tabel, gunakan perintah berikut, dengan mengganti [TABLE_NAME] dengan nama tabel dan [FAMILY_NAME] dengan nama grup kolom:

cbt deletefamily [TABLE_NAME] [FAMILY_NAME]

Misalnya, untuk menghapus grup kolom cf2 dari tabel my-table:

cbt deletefamily my-table cf2

Melihat daftar tabel

Konsol

Untuk melihat daftar tabel dalam instance:

1. Di konsol Google Cloud , buka daftar instance Bigtable.

   Buka daftar instance

2. Klik instance yang tabelnya ingin Anda lihat.

3. Klik Tables di panel kiri.

   Halaman Tables menampilkan daftar tabel dalam instance.

   • Klik panah di samping ID tabel untuk meluaskan daftar replikasi tabel.
   • Klik View Metrics di samping nama tabel untuk melihat data insight sistem untuk tabel tersebut.

gcloud

Untuk melihat daftar tabel, jalankan perintah gcloud bigtable instances tables list.

gcloud bigtable instances tables list --instances=INSTANCE_IDS

Ganti kode berikut:

• INSTANCE_IDS: daftar ID instance yang dipisahkan koma.

cbt

Untuk melihat daftar tabel dalam instance, jalankan perintah berikut:

    cbt ls INSTANCE_ID

Ganti kode berikut:

• INSTANCE_ID: ID permanen untuk instance.

C++

Untuk mempelajari cara menginstal dan menggunakan library klien untuk Bigtable, lihat library klien Bigtable.

Untuk melakukan autentikasi ke Bigtable, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

namespace cbt = ::google::cloud::bigtable;
namespace cbta = ::google::cloud::bigtable_admin;
using ::google::cloud::StreamRange;
[](cbta::BigtableTableAdminClient admin, std::string const& project_id,
   std::string const& instance_id) {
  std::string instance_name = cbt::InstanceName(project_id, instance_id);

  google::bigtable::admin::v2::ListTablesRequest r;
  r.set_parent(instance_name);
  r.set_view(google::bigtable::admin::v2::Table::NAME_ONLY);

  StreamRange<google::bigtable::admin::v2::Table> tables =
      admin.ListTables(std::move(r));
  for (auto& table : tables) {
    if (!table) throw std::move(table).status();
    std::cout << table->name() << "\n";
  }
}

C#

Untuk mempelajari cara menginstal dan menggunakan library klien untuk Bigtable, lihat library klien Bigtable.

Untuk melakukan autentikasi ke Bigtable, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

// Lists tables in intance.
// Initialize request argument(s).
ListTablesRequest request = new ListTablesRequest
{
    ParentAsInstanceName = s_instanceName
};
try
{
    // Make the request.
    PagedEnumerable<ListTablesResponse, Table> response = bigtableTableAdminClient.ListTables(request);

}
catch (Exception ex)
{
    Console.WriteLine($"Error listing tables {ex.Message}");
}

Java

Untuk mempelajari cara menginstal dan menggunakan library klien untuk Bigtable, lihat library klien Bigtable.

Untuk melakukan autentikasi ke Bigtable, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

// Lists tables in the current instance.
try {
  String parent = "projects/" + projectId + "/instances/" + instanceId;
  ListTablesRequest request = ListTablesRequest.newBuilder().setParent(parent).build();
  for (Table table : adminClient.listTables(request).iterateAll()) {
    System.out.println(table.getName());
  }
} catch (NotFoundException e) {
  System.err.println("Failed to list tables from a non-existent instance: " + e.getMessage());
}

Node.js

Untuk mempelajari cara menginstal dan menggunakan library klien untuk Bigtable, lihat library klien Bigtable.

Untuk melakukan autentikasi ke Bigtable, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

// List tables in current project
const [tables] = await adminClient.listTables({parent: instance.name});
tables.forEach(table => {
  console.log(table.name);
});

PHP

Untuk mempelajari cara menginstal dan menggunakan library klien untuk Bigtable, lihat library klien Bigtable.

Untuk melakukan autentikasi ke Bigtable, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

use Google\Cloud\Bigtable\Admin\V2\Client\BigtableInstanceAdminClient;
use Google\Cloud\Bigtable\Admin\V2\Client\BigtableTableAdminClient;
use Google\Cloud\Bigtable\Admin\V2\ListTablesRequest;

/**
 * List tables in an instance
 *
 * @param string $projectId The Google Cloud project ID
 * @param string $instanceId The ID of the Bigtable instance
 */
function list_tables(
    string $projectId,
    string $instanceId
): void {
    $instanceAdminClient = new BigtableInstanceAdminClient();
    $tableAdminClient = new BigtableTableAdminClient();

    $instanceName = $instanceAdminClient->instanceName($projectId, $instanceId);

    printf('Listing Tables:' . PHP_EOL);
    $listTablesRequest = (new ListTablesRequest())
        ->setParent($instanceName);
    $tables = $tableAdminClient->listTables($listTablesRequest)->iterateAllElements();
    $tables = iterator_to_array($tables);
    if (empty($tables)) {
        print('No table exists.' . PHP_EOL);
        return;
    }
    foreach ($tables as $table) {
        print($table->getName() . PHP_EOL);
    }
}

Python

Untuk mempelajari cara menginstal dan menggunakan library klien untuk Bigtable, lihat library klien Bigtable.

Untuk melakukan autentikasi ke Bigtable, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

tables = instance.list_tables()
print("Listing tables in current project...")
if tables != []:
    for tbl in tables:
        print(tbl.table_id)
else:
    print("No table exists in current project...")

Ruby

Untuk mempelajari cara menginstal dan menggunakan library klien untuk Bigtable, lihat library klien Bigtable.

Untuk melakukan autentikasi ke Bigtable, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

# instance_id = "my-instance"
bigtable.tables(instance_id).all.each do |t|
  puts "Table: #{t.name}"
end

Melihat informasi tentang tabel

Konsol

Untuk melihat informasi tentang tabel:

1. Di konsol Google Cloud , buka daftar instance Bigtable.

   Buka daftar instance

2. Klik instance yang tabelnya ingin Anda lihat.

3. Klik Tables di panel kiri.

   Halaman Tables menampilkan daftar tabel dalam instance. Untuk setiap tabel, konsol Google Cloud menampilkan jumlah cluster tempat tabel disimpan, status tabel, pemakaian penyimpanan, dan ID untuk setiap cadangan tabel saat ini. Untuk tabel dengan penyimpanan bertingkat (Pratinjau) yang diaktifkan, Anda dapat melihat pemanfaatan penyimpanan SSD dan pemanfaatan penyimpanan akses jarang.

4. Untuk melihat nama grup kolom untuk tabel, klik . Untuk menutup panel Edit table, klik Cancel.

5. Untuk melihat detail tambahan tentang tabel, termasuk metrik tingkat tabel dan status replikasi, klik nama tabel.

gcloud

Untuk melihat informasi tentang tabel, jalankan perintah gcloud bigtable instances tables describe.

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

Ganti kode berikut:

• TABLE_ID: ID unik tabel
• INSTANCE_ID: ID instance

cbt

Anda dapat menggunakan cbt CLI untuk mendapatkan daftar grup kolom yang ada dalam tabel.

Gunakan perintah berikut, dengan mengganti [TABLE_NAME] dengan nama tabel:

cbt ls [TABLE_NAME]

Menetapkan kebijakan pembersihan sampah memori

Kebijakan pembersihan sampah memori memberi tahu Bigtable data mana yang harus disimpan dan data mana yang harus ditandai untuk dihapus. Anda menetapkan kebijakan pembersihan sampah memori di tingkat grup kolom saat membuat tabel atau nanti.

Saat membuat grup kolom, Anda dapat menentukan jumlah sel yang ingin dipertahankan di setiap kolom dalam grup kolom tersebut. Jika Anda tidak menentukan setelan ini, Bigtable akan menggunakan salah satu setelan default berikut:

• Jika Anda membuat grup kolom dengan klien HBase Cloud Bigtable untuk Java atau shell HBase, atau alat lain yang menggunakan klien HBase untuk Java, Bigtable hanya mempertahankan 1 sel untuk setiap persimpangan baris atau kolom dalam grup kolom. Setelan default ini konsisten dengan HBase.

• Jika Anda membuat grup kolom menggunakan konsol Google Cloud , library klien lainnya, atau cbt CLI , Bigtable akan mempertahankan jumlah sel yang tak terbatas di setiap kolom.

Lihat Mengonfigurasi kebijakan pembersihan sampah memori untuk mengetahui petunjuk mendetail tentang cara melihat, menetapkan, dan memperbarui kebijakan pembersihan sampah memori.

Mencadangkan dan memulihkan tabel

Untuk mengetahui petunjuk tentang cara mencadangkan tabel dan memulihkan dari cadangan ke tabel baru, lihat Mengelola cadangan.

Jika telah mengaktifkan pencadangan otomatis saat membuat tabel, Anda dapat mengubah konfigurasi pencadangan otomatis untuk tabel guna mengaktifkan atau menonaktifkan pencadangan otomatis, atau mengubah periode retensi hingga 90 hari. Untuk mengetahui informasi selengkapnya, lihat Menggunakan pencadangan otomatis.

Mengaktifkan, menonaktifkan, atau mengonfigurasi aliran data perubahan

Untuk mengetahui petunjuk tentang tugas-tugas berikut, lihat Mengonfigurasi aliran data perubahan.

• Mengaktifkan aliran data perubahan pada tabel yang ada
• Menonaktifkan aliran data perubahan
• Memperbarui periode retensi untuk aliran data perubahan

Menghapus tabel

Menghapus tabel juga akan menghapus semua tampilan tabel yang diizinkan. Jika ada tampilan yang diotorisasi dari tabel mengaktifkan proteksi dari penghapusan, Anda tidak dapat menghapus tabel. Anda juga tidak dapat menghapus tabel yang memiliki tampilan terwujud berkelanjutan berdasarkan tabel tersebut.

Peringatan: Saat menghapus tabel, Anda juga akan menghapus data yang disimpan dalam tabel tersebut.

Konsol

1. Di konsol Google Cloud , buka daftar instance Bigtable.

   Buka daftar instance

2. Klik instance yang tabelnya ingin Anda lihat.

3. Klik Tables di panel kiri.

   Halaman Tables menampilkan daftar tabel dalam instance.

4. Klik untuk tabel yang ingin Anda hapus.

5. Klik Hapus.

6. Untuk mengonfirmasi bahwa Anda memahami bahwa tindakan ini akan menghapus tabel dari semua cluster dalam instance dan bahwa Anda hanya memiliki waktu tujuh hari untuk membatalkan penghapusan tabel, ketik ID tabel di kotak Delete table.

7. Klik Hapus.

gcloud

1. Untuk menghapus tabel, jalankan perintah gcloud bigtable instances tables delete.

   gcloud bigtable instances tables delete TABLE_ID --instance=INSTANCE_ID
   

   Ganti kode berikut:

   • TABLE_ID: ID unik tabel
   • INSTANCE_ID: ID instance

2. Di terminal, masukkan y untuk mengonfirmasi penghapusan tabel.

cbt

Untuk menghapus tabel, gunakan perintah berikut, dengan mengganti [TABLE_NAME] dengan nama tabel:

cbt deletetable [TABLE_NAME]

Membatalkan penghapusan tabel

Jika tidak sengaja menghapus tabel, Anda dapat menggunakan perintah gcloud CLI bigtable instances tables undelete untuk membatalkan penghapusan, atau memulihkan tabel. Jangan mencoba membuat ulang tabel yang dihapus secara manual.

Untuk membatalkan penghapusan tabel, jalankan perintah berikut di terminal:

gcloud bigtable instances tables undelete TABLE_ID --instance=INSTANCE_ID

Ganti kode berikut:

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

Saat Anda membatalkan penghapusan tabel, Bigtable akan otomatis mengaktifkan proteksi dari penghapusan untuk tabel tersebut.

Batasan berikut berlaku:

• Kemampuan untuk membatalkan penghapusan tabel tersedia selama sekitar tujuh hari sejak tabel dihapus.
• Anda tidak dapat membatalkan penghapusan tabel menggunakan konsol Google Cloud , library klien Cloud Bigtable, atau cbt CLI.
• Anda tidak dapat membatalkan penghapusan tabel dari instance yang telah dihapus.
• Anda tidak dapat membatalkan penghapusan tabel yang mengaktifkan CMEK.
• Jika Anda mendowngrade instance ke edisi Enterprise, Anda tidak dapat membatalkan penghapusan tabel dengan perincian stempel waktu mikrodetik. Untuk membatalkan penghapusan tabel, instance harus dalam edisi Enterprise Plus.
• Saat Anda membatalkan penghapusan tabel, Bigtable tidak akan memulihkan binding kebijakan IAM yang mendetail ke tabel yang dihapus.

Anda dapat memeriksa status operasi undelete di log audit.

Mengubah proteksi dari penghapusan

Anda dapat mengaktifkan atau menonaktifkan proteksi dari penghapusan untuk tabel jika Anda adalah entitas utama dalam peran yang menyertakan izin bigtable.tables.update, seperti roles/bigtable.admin. Proteksi dari penghapusan mencegah penghapusan tabel, semua grup kolom dalam tabel, dan instance yang berisi tabel.

Mengaktifkan proteksi dari penghapusan untuk tabel tidak akan mengaktifkannya untuk tampilan yang diotorisasi dari tabel. Demikian pula, menonaktifkan perlindungan penghapusan tabel tidak akan menonaktifkannya untuk tampilan tabel yang diotorisasi. Anda harus memperbarui tabel virtual yang diizinkan secara terpisah.

Konsol

1. Di konsol Google Cloud , buka daftar instance Bigtable.

   Buka daftar instance

2. Klik instance yang tabelnya ingin Anda lihat.

3. Klik Tables di panel kiri.

   Halaman Tables menampilkan daftar tabel dalam instance.

4. Klik di samping ID tabel.

5. Untuk mengaktifkan proteksi dari penghapusan, klik Prevent deletion. Untuk menonaktifkan proteksi dari penghapusan, klik Enable deletion. Hanya opsi yang valid yang terlihat.

gcloud

Untuk mengaktifkan proteksi dari penghapusan untuk tabel, jalankan perintah gcloud bigtable instances table update:

```sh
gcloud bigtable instances tables update TABLE_ID \
    --instance=INSTANCE_ID \
    --deletion-protection
```

Untuk menonaktifkan proteksi dari penghapusan untuk tabel, jalankan perintah berikut:

```sh
gcloud bigtable instances tables update TABLE_ID \
    --instance=INSTANCE_ID \
    --no-deletion-protection
```

Ganti kode berikut:

+ TABLE_ID: the unique identifier for the table
+ INSTANCE_ID: the ID of the instance

cbt

Anda tidak dapat menggunakan cbt CLI untuk mengaktifkan atau menonaktifkan perlindungan penghapusan.

Mengubah batas usia penyimpanan akses jarang

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Anda dapat mengubah batas usia akses jarang yang merupakan bagian dari penyimpanan bertingkat kapan saja.

Konsol

1. Di konsol Google Cloud , buka daftar instance Bigtable.

   Buka daftar instance

2. Klik instance yang tabelnya ingin Anda lihat.

3. Klik Tables di panel kiri.

   Halaman Tables menampilkan daftar tabel dalam instance.

4. Klik Edit untuk tabel yang ingin Anda ubah.

5. Di kolom Age threshold, masukkan jumlah hari baru setelah Bigtable memindahkan data dari penyimpanan SSD ke penyimpanan akses tidak sering. Angka harus 30 atau lebih besar.

gcloud

Untuk mengubah batas usia penyimpanan akses jarang, jalankan perintah gcloud beta bigtable instances tables update dengan flag --tiered-storage-infrequent-access-older-than:

    gcloud beta bigtable instances tables update TABLE_ID \
        --instance=INSTANCE_ID \
        --project=PROJECT_ID \
        --tiered-storage-infrequent-access-older-than=AGE_THRESHOLD

Ganti kode berikut:

• TABLE_ID: ID untuk tabel yang ingin Anda update.
• INSTANCE_ID: ID instance.
• PROJECT_ID: project yang berisi tabel yang ingin Anda update.
• AGE_THRESHOLD: batas usia, yang harus minimal 30 hari. Satuan yang dapat diterima adalah hari (d), jam (h), menit (m), dan detik (s). Contoh: dari 32d sebelumnya menjadi 33d.

Menonaktifkan penyimpanan akses jarang

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Anda dapat menonaktifkan akses jarang dari penyimpanan bertingkat kapan saja. Akibatnya, Bigtable memindahkan semua data di penyimpanan akses jarang ke penyimpanan SSD. Sebelum menonaktifkan penyimpanan akses jarang, pastikan Anda memahami implikasi biaya.

Konsol

1. Di konsol Google Cloud , buka daftar instance Bigtable.

   Buka daftar instance

2. Klik instance yang tabelnya ingin Anda lihat.

3. Klik Tables di panel kiri.

   Halaman Tables menampilkan daftar tabel dalam instance.

4. Klik Edit untuk tabel yang ingin Anda ubah.

5. Hapus centang pada kotak Enable tiered storage.

6. Klik Simpan.

gcloud

Untuk menonaktifkan penyimpanan akses jarang, gunakan perintah gcloud beta bigtable instances tables update dengan flag --clear-tiered-storage-config:

    gcloud beta bigtable instances tables update TABLE_ID \
        --instance=INSTANCE_ID \
        --project=PROJECT_ID \
        --clear-tiered-storage-config

Ganti kode berikut:

• TABLE_ID: ID untuk tabel yang ingin Anda update
• INSTANCE_ID: ID instance
• PROJECT_ID: project yang berisi tabel yang ingin Anda update

Langkah berikutnya

• Pelajari cara mengimpor dan mengekspor data ke dan dari tabel Anda.