Menyiapkan lingkungan Anda

Halaman ini memandu Anda melalui 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 konsol Google Cloud , lihat Panduan memulai menggunakan konsol.

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 ada dengan mengklik nama project.
  3. Buka jendela terminal, dan 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.

  5. Anda juga dapat mempelajari harga Spanner.
  6. Aktifkan Cloud Spanner API untuk project.

    Mengaktifkan Cloud Spanner API

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

Menyiapkan autentikasi

Select the tabs for how you plan to access the API:

Console

When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

gcloud

Install the Google Cloud CLI, then initialize it by running the following command:

gcloud init

Untuk menyiapkan gcloud CLI agar menggunakan peniruan akun layanan untuk mengautentikasi ke Google API, alih-alih kredensial pengguna Anda, jalankan perintah berikut:

gcloud config set auth/impersonate_service_account SERVICE_ACCT_EMAIL

Untuk informasi selengkapnya, lihat Peniruan akun layanan.

Terraform

Untuk menggunakan kode Terraform di lingkungan pengembangan lokal, instal dan lakukan inisialisasi gcloud CLI, lalu siapkan Kredensial Default Aplikasi dengan kredensial pengguna Anda.

  1. Install the Google Cloud CLI.
  2. To initialize the gcloud CLI, run the following command:

    gcloud init
  3. If you're using a local shell, then create local authentication credentials for your user account:

    gcloud auth application-default login

    You don't need to do this if you're using Cloud Shell.

Untuk informasi selengkapnya, lihat Set up authentication for a local development environment.

Library klien

Untuk menggunakan library klien di lingkungan pengembangan lokal, instal dan lakukan inisialisasi gcloud CLI, lalu siapkan Kredensial Default Aplikasi dengan kredensial pengguna Anda.

  1. Install the Google Cloud CLI.
  2. To initialize the gcloud CLI, run the following command:

    gcloud init
  3. If you're using a local shell, then create local authentication credentials for your user account:

    gcloud auth application-default login

    You don't need to do this if you're using Cloud Shell.

Untuk informasi selengkapnya, lihat Set up authentication for a local development environment.

Untuk menyiapkan file ADC lokal agar menggunakan peniruan akun layanan untuk mengautentikasi ke Google API, alih-alih kredensial pengguna Anda, jalankan perintah berikut:

gcloud auth application-default login --impersonate-service-account=SERVICE_ACCT_EMAIL

Untuk informasi selengkapnya, lihat Peniruan akun layanan.

REST

Untuk menggunakan REST API di lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.

    Install the Google Cloud CLI, then initialize it by running the following command:

    gcloud init

Untuk informasi selengkapnya, lihat Mengautentikasi untuk menggunakan REST dalam dokumentasi autentikasi Google Cloud .

Anda dapat menggunakan peniruan akun layanan guna membuat token akses untuk permintaan REST API. Untuk informasi selengkapnya, lihat Akun layanan yang ditiru identitasnya.

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 oleh project Anda, termasuk konfigurasi regional, dual-region, dan multi-region. Untuk mengetahui informasi selengkapnya, lihat Ringkasan instance.

Anda telah menyelesaikan penyiapan.

Langkah selanjutnya

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