Umgebung einrichten

Auf dieser Seite werden Sie durch die Einrichtungsschritte geführt, die erforderlich sind, um die Cloud Spanner API mit der Google Cloud CLI, den Clientbibliotheken und den Spanner-Treibern zu verwenden.

Wenn Sie Spanner mit der Google Cloud -Konsole verwenden möchten, lesen Sie den Artikel Schnellstart mit der Konsole.

Google Cloud -Projekt einrichten

  1. Rufen Sie in der Google Cloud -Console die Seite Projekte auf.

    Zur Seite "Projekte"

  2. Erstellen Sie ein neues Google Cloud -Projekt oder öffnen Sie ein vorhandenes Projekt, indem Sie auf den Projektnamen klicken.

  3. Öffnen Sie ein Terminalfenster und legen Sie Ihr Projekt als Standardprojekt für die Google Cloud CLI fest. Dazu ersetzen Sie MY_PROJECT_ID durch Ihre Projekt-ID (nicht durch den Projektnamen): 

    gcloud config set project MY_PROJECT_ID

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

    5. Weitere Informationen zu Spanner-Preisen

  5. Aktivieren Sie die Cloud Spanner API für das Projekt.

    Cloud Spanner API aktivieren

    Hinweis: Wenn Sie für den Zugriff auf Ihre Spanner-Instanz ein Dienstkonto in einem anderen Projekt verwenden, müssen Sie die Spanner API in beiden Projekten aktivieren.

Authentifizierung einrichten

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

Führen Sie den folgenden Befehl aus, um die gcloud CLI so einzurichten, dass die Authentifizierung bei Google APIs anstelle Ihrer Nutzeranmeldedaten erfolgt: 

gcloud config set auth/impersonate_service_account SERVICE_ACCT_EMAIL

Weitere Informationen finden Sie unter Identitätswechsel für Dienstkonten.

Terraform

Wenn Sie Terraform-Code in einer lokalen Entwicklungsumgebung verwenden möchten, installieren und initialisieren Sie die gcloud CLI und richten dann die Standardanmeldedaten für Anwendungen mit Ihren Nutzeranmeldedaten ein.

  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.

Weitere Informationen unter Set up authentication for a local development environment.

Clientbibliotheken

Zur Verwendung von Clientbibliotheken in einer lokalen Entwicklungsumgebung installieren und initialisieren Sie die gcloud CLI und richten dann die Standardanmeldedaten für Anwendungen mit Ihren Nutzeranmeldedaten ein.

  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.

Weitere Informationen unter Set up authentication for a local development environment.

Führen Sie den folgenden Befehl aus, um Ihre lokale ADC-Datei so einzurichten, dass sie sich bei Google APIs anstelle Ihrer Nutzeranmeldedaten authentifiziert: 

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

Weitere Informationen finden Sie unter Identitätswechsel für Dienstkonten.

REST

Verwenden Sie die von der gcloud CLI bereitgestellten Anmeldedaten, um die REST API in einer lokalen Entwicklungsumgebung zu verwenden.

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

    gcloud init

Weitere Informationen finden Sie unter Für die Verwendung von REST authentifizieren in der Dokumentation zur Google Cloud-Authentifizierung.

Sie können die Identitätsübertragung für ein Dienstkonto verwenden, um ein Zugriffstoken für REST API-Anfragen zu generieren. Weitere Informationen finden Sie unter Identitätsübernahme des Dienstkontos.

Google Cloud CLI ausführen

Sie haben die Entwicklungsumgebung und die Authentifizierung eingerichtet. Führen Sie nun das gcloud-Befehlszeilentool zur Interaktion mit Spanner aus:

gcloud spanner instance-configs list

Sie sollten nun eine Liste der Spanner-Instanzkonfigurationen, auf die das Projekt Zugriff hat, sehen können. Dazu gehören regionale, biregionale und multiregionale Konfigurationen. Weitere Informationen finden Sie in der Übersicht über Instanzen.

Sie haben die Einrichtung abgeschlossen.

Nächste Schritte

Informationen zum Erstellen einer Spanner-Instanz, ‑Datenbank, ‑Tabellen und ‑Indexe mit den Cloud-Clientbibliotheken und ‑Treibern Speichern und lesen Sie dann Daten in Spanner und rufen Sie sie ab.