C# hello world
Contoh kode ini adalah aplikasi "halo dunia" yang ditulis dalam C#. Contoh ini mengilustrasikan cara menyelesaikan tugas-tugas berikut:
- Menyiapkan autentikasi
- Menghubungkan ke instance Bigtable
- Membuat tabel baru.
- Tulis data ke tabel.
- Baca kembali data.
- Hapus tabel.
Menyiapkan autentikasi
Untuk menggunakan contoh .NET di halaman ini dalam lingkungan pengembangan lokal, instal dan lakukan inisialisasi gcloud CLI, lalu siapkan Kredensial Default Aplikasi dengan kredensial pengguna Anda.
-
Instal Google Cloud CLI.
-
Konfigurasi gcloud CLI agar menggunakan identitas gabungan Anda.
Untuk mengetahui informasi selengkapnya, lihat Login ke gcloud CLI dengan identitas gabungan Anda.
-
Buat kredensial autentikasi lokal untuk akun pengguna Anda:
gcloud auth application-default login
Jika error autentikasi ditampilkan, pastikan Anda telah login ke gcloud CLI dengan identitas gabungan Anda.
Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Menjalankan contoh
Kode ini berkomunikasi dengan Bigtable menggunakan library C# Admin API dan C# Data API di Google Cloud Client Libraries for .NET.
Untuk menjalankan program contoh ini, ikuti
petunjuk Contoh Bigtable.NET di GitHub.
Selesaikan langkah-langkah Build and Run dan Quick Start untuk membuat resource yang dapat Anda gunakan di aplikasi Halo Dunia. Pastikan Anda mengedit file
HelloWorld.cs untuk menambahkan nama resource yang Anda buat.
Menggunakan Library Klien Cloud dengan Bigtable
Aplikasi contoh terhubung ke Bigtable dan menunjukkan beberapa operasi sederhana.
Menghubungkan ke Bigtable
Untuk memulai, buat dua objek klien yang dapat Anda gunakan untuk terhubung ke Bigtable. C# Admin API BigtableTableAdminClient membantu Anda membuat dan menghapus instance dan tabel. Data API C# BigtableClient membantu Anda membaca dan menulis data tabel.
Membuat tabel
Panggil metode CreateTable() di class BigtableTableAdminClient untuk
membuat objek Table yang menyimpan salam "halo
dunia". Tabel ini memiliki satu grup kolom yang mempertahankan satu versi dari setiap nilai.
Menulis baris ke tabel
Gunakan array string s_greetings[], yang berisi tiga sapaan sederhana, sebagai
sumber data untuk ditulis ke tabel. Pertama, tulis satu baris ke tabel
menggunakan MutateRow(). Kemudian, lakukan loop pada array lainnya untuk membuat objek MutateRowsRequest yang berisi entri untuk setiap ucapan. Buat permintaan untuk menulis semua
entri sekaligus dengan MutateRows(). Kemudian, lakukan loop
melalui respons yang ditampilkan untuk memeriksa kode status setiap entri guna memastikan
penulisannya berhasil.
Membuat filter
Sebelum membaca data yang Anda tulis, buat filter untuk membatasi data yang ditampilkan Bigtable. Filter ini memberi tahu Bigtable untuk hanya menampilkan versi terbaru dari setiap nilai, meskipun tabel berisi sel lama yang memenuhi syarat untuk pengumpulan sampah, tetapi belum dihapus.
Membaca baris berdasarkan row key-nya
Gunakan metode ReadRow(), dengan meneruskan filter
yang baru saja Anda buat, untuk mendapatkan satu versi setiap nilai dalam baris tersebut.
Memindai semua baris tabel
Panggil metode ReadRows(), dengan meneruskan filter, untuk mendapatkan semua baris dalam tabel. Karena Anda meneruskan filter,
Bigtable hanya menampilkan satu versi setiap nilai.
Menghapus tabel
Hapus tabel dengan metode DeleteTable().
Menggabungkan semuanya
Berikut contoh kode lengkap tanpa komentar.