gcloud CLI installieren und Cloud Spanner API einrichten

Auf dieser Seite werden Sie durch die Einrichtungsschritte geführt, die für die Verwendung der Cloud Spanner API mit der Google Cloud CLI, Clientbibliotheken und Spanner-Treibern erforderlich sind.

Wenn Sie Spanner mit der Google Cloud Console verwenden möchten, finden Sie weitere Informationen unter Kurzanleitung: Console verwenden.

Hinweise

Auf dem Entwicklungscomputer muss Folgendes installiert sein:

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. Ersetzen Sie dabei MY_PROJECT_ID durch Ihre Projekt-ID (nicht den Projektnamen):

    gcloud config set project MY_PROJECT_ID
  4. Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.

  5. Informationen zu den Spanner-Preisen
  6. Aktivieren Sie die Cloud Spanner API für das Projekt.

    Cloud Spanner API aktivieren

    Hinweis: Wenn Sie über ein Dienstkonto in einem anderen Projekt auf Ihre Spanner-Instanz zugreifen, müssen Sie die Spanner API in beiden Projekten aktivieren.

Authentifizierung und Autorisierung einrichten

Spanner verwendet OAuth 2.0 für die API-Authentifizierung und -Autorisierung.

Wenn Sie Ihren Code während der Entwicklung und des Tests lokal ausführen möchten, verwenden Sie die Google Cloud CLI zusammen mit Standardanmeldedaten für Anwendungen. Führen Sie über eine Eingabeaufforderung Folgendes aus:

gcloud auth application-default login

Nachdem Sie sich mit dem Befehl gcloud auth application-default login authentifiziert haben, übernehmen API-Clientbibliotheken, die die Standardanmeldedaten für Anwendungen verwenden, automatisch die erstellten Anmeldedaten. Sie müssen diesen Befehl in jeder lokalen Nutzerumgebung nur einmal ausführen.

Google Cloud CLI ausführen

Sie haben die Entwicklungsumgebung und Authentifizierung eingerichtet. Führen Sie nun das gcloud-Befehlszeilentool aus, um mit Spanner zu interagieren:

gcloud spanner instance-configs list

Es sollte eine Liste der Spanner-Instanzkonfigurationen angezeigt werden, auf die Ihr Projekt zugreifen kann, einschließlich regionaler, dualer und multiregionaler Konfigurationen. Weitere Informationen finden Sie in der Übersicht über Instanzen.

Sie haben die Einrichtung abgeschlossen.

Nächste Schritte

Hier erfahren Sie, wie Sie mit den Cloud-Clientbibliotheken und -Treibern eine Spanner-Instanz, eine Datenbank, Tabellen und Indexe erstellen. Speichern, abfragen und lesen Sie dann Daten in Spanner.