Baca contoh

Library klien Cloud Bigtable memberikan kemampuan untuk membaca data dari tabel. Halaman ini memberikan contoh setiap jenis permintaan baca dalam beberapa bahasa. Untuk mengetahui ringkasannya, lihat Pembacaan.

Library klien Python untuk Bigtable menawarkan dua API, asyncio dan API sinkron. Jika aplikasi Anda bersifat asinkron, gunakan asyncio.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna membaca data dari tabel, minta administrator untuk memberi Anda peran IAM Bigtable reader (roles/bigtable.reader) di tabel. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Membaca satu baris

Contoh kode berikut menunjukkan cara mendapatkan satu baris data menggunakan row key.

func readRow(w io.Writer, projectID, instanceID string, tableName string) error {
	// projectID := "my-project-id"
	// instanceID := "my-instance-id"
	// tableName := "mobile-time-series"

	ctx := context.Background()
	client, err := bigtable.NewClient(ctx, projectID, instanceID)
	if err != nil {
		return fmt.Errorf("bigtable.NewClient: %w", err)
	}
	defer client.Close()

	tbl := client.Open(tableName)
	rowKey := "phone#4c410523#20190501"
	row, err := tbl.ReadRow(ctx, rowKey)
	if err != nil {
		return fmt.Errorf("could not read row with key %s: %w", rowKey, err)
	}

	printRow(w, row)
	return nil
}