Menginstal gcloud CLI dan menyiapkan Cloud Spanner API

Halaman ini memandu Anda melakukan langkah-langkah penyiapan yang diperlukan untuk menggunakan Cloud Spanner API dengan Google Cloud CLI, library klien, dan driver Spanner.

Jika Anda ingin menggunakan Spanner dengan Google Cloud Console, lihat Panduan memulai menggunakan konsol.

Sebelum memulai

Mesin pengembangan Anda harus menginstal aplikasi berikut:

• Gcloud CLI, yang mencakup penyiapan Google Cloud CLI (download).

Menyiapkan project Google Cloud

1. Buka halaman Project di Konsol Google Cloud.

   Buka halaman Projects

2. Buat project Google Cloud baru, atau buka project yang sudah ada dengan mengklik nama project.
Penting: Nama yang Anda gunakan harus terdiri dari 4 hingga 30 karakter. Saat Anda mengetik nama tersebut, formulir akan menyarankan project ID yang dapat Anda edit. Panjang project ID yang Anda gunakan harus antara 6 sampai 30 karakter, dengan huruf kecil sebagai karakter pertama. Anda dapat menggunakan tanda hubung, huruf kecil, atau angka untuk karakter yang tersisa, tetapi karakter terakhir tidak boleh berupa tanda hubung. Anda harus mengetahui bahwa beberapa ID resource (seperti project ID) dapat dipertahankan meskipun masa pakai project Anda berakhir. Karena alasan ini, hindari menyimpan informasi sensitif dalam ID resource.
...lihat panduan penamaan

3. Buka jendela terminal, lalu tetapkan project Anda sebagai project default untuk Google Cloud CLI, dengan mengganti MY_PROJECT_ID dengan project ID Anda (bukan nama project Anda):

   gcloud config set project MY_PROJECT_ID

4. Make sure that billing is enabled for your Google Cloud project.

Anda juga dapat mempelajari harga Spanner.

5. Aktifkan Cloud Spanner API untuk project.

   Mengaktifkan Cloud Spanner API

   Catatan: Jika menggunakan akun layanan di project yang berbeda untuk mengakses instance Spanner, Anda harus mengaktifkan Spanner API di kedua project.

Menyiapkan autentikasi dan otorisasi

Spanner menggunakan OAuth 2.0 untuk autentikasi dan otorisasi API.

Untuk menjalankan kode Anda secara lokal selama pengembangan dan pengujian, gunakan Google Cloud CLI beserta Kredensial Default Aplikasi. Di command prompt, jalankan:

gcloud auth application-default login

Setelah Anda melakukan autentikasi menggunakan perintah gcloud auth application-default login, library klien API yang menggunakan kredensial default aplikasi akan otomatis mengambil kredensial yang dibuat. Anda hanya perlu menjalankan perintah sekali per lingkungan pengguna lokal.

Catatan: Penggunaan gcloud auth application-default login cocok untuk pengembangan lokal. Jika Anda sudah siap menggunakan Spanner di lingkungan produksi, pelajari opsi lainnya untuk kredensial di bagian Mendapatkan kredensial untuk alur yang berfokus pada server.

Menjalankan Google Cloud CLI

Setelah menyiapkan lingkungan pengembangan dan autentikasi, jalankan alat command-line gcloud untuk berinteraksi dengan Spanner:

gcloud spanner instance-configs list

Anda akan melihat daftar konfigurasi instance Spanner yang dapat diakses project Anda, termasuk konfigurasi regional dan multi-region. Pelajari hal ini lebih lanjut di Instance.

Anda telah menyelesaikan pengaturan!

Langkah selanjutnya

Pelajari cara menggunakan Library dan driver Klien Cloud untuk membuat instance, database, tabel, dan indeks Spanner. Kemudian, simpan, buat kueri, dan baca data di Spanner.

• Mulai menggunakan Spanner di C++
• Mulai menggunakan Spanner di C#
• Mulai menggunakan Spanner di Go
• Mulai menggunakan Spanner di Java
• Mulai menggunakan Spanner di JDBC
• Mulai menggunakan Spanner di Node.js
• Mulai menggunakan Spanner di PHP
• Mulai menggunakan Spanner di Python
• Mulai menggunakan Spanner di Ruby
• Mulai menggunakan Spanner di REST
• Mulai menggunakan Spanner di gcloud