Umgebung einrichten

Auf dieser Seite werden die Einrichtungsschritte beschrieben, 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, lesen Sie die Kurzanleitung zur Verwendung der Console.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, um die Berechtigungen zu erhalten, die Sie zur Verwendung von und Interaktion mit Spanner-Datenbanken benötigen:

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

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 Ihren Projektnamen): 

    gcloud config set project MY_PROJECT_ID

  4. Prüfen Sie, ob die Abrechnung für Ihr Google Cloud Projekt aktiviert ist.

    5. Sie können sich auch über die Spanner-Preise informieren.

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

    Cloud Spanner API aktivieren

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

Authentifizierung einrichten

Wählen Sie die Tabs für die Art und Weise aus, wie Sie auf die API zugreifen möchten:

Console

Wenn Sie über die Google Cloud Console auf Google Cloud -Dienste und -APIs zugreifen, müssen Sie die Authentifizierung nicht einrichten.

gcloud

Installieren Sie die Google Cloud CLI. Initialisieren Sie die Google Cloud CLI nach der Installation mit dem folgenden Befehl: 

gcloud init

Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

Führen Sie den folgenden Befehl aus, um die gcloud CLI so einzurichten, dass die Authentifizierung bei Google APIs über die Identitätsübernahme des Dienstkontos anstelle Ihrer Nutzeranmeldedaten erfolgt: 

gcloud config set auth/impersonate_service_account SERVICE_ACCT_EMAIL

Weitere Informationen finden Sie unter Identitätsübernahme des Dienstkontos.

Terraform

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

  1. Installieren Sie die Google Cloud CLI.

  2. Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

  3. Wenn Sie eine lokale Shell verwenden, erstellen Sie lokale Authentifizierungsdaten für Ihr Nutzerkonto: 

    gcloud auth application-default login

    Wenn Sie Cloud Shell verwenden, müssen Sie das nicht tun.

    Wenn ein Authentifizierungsfehler zurückgegeben wird und Sie einen externen Identitätsanbieter (IdP) verwenden, prüfen Sie, ob Sie sich mit Ihrer föderierten Identität in der gcloud CLI angemeldet haben.

Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.

Clientbibliotheken

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

  1. Installieren Sie die Google Cloud CLI.

  2. Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

  3. Wenn Sie eine lokale Shell verwenden, erstellen Sie lokale Authentifizierungsdaten für Ihr Nutzerkonto: 

    gcloud auth application-default login

    Wenn Sie Cloud Shell verwenden, ist dies nicht erforderlich.

    Wenn ein Authentifizierungsfehler zurückgegeben wird und Sie einen externen Identitätsanbieter (IdP) verwenden, prüfen Sie, ob Sie sich mit Ihrer föderierten Identität in der gcloud CLI angemeldet haben.

Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.

Führen Sie den folgenden Befehl aus, um die lokale ADC-Datei so einzurichten, dass die Authentifizierung bei Google APIs über die Identitätsübernahme des Dienstkontos anstelle Ihrer Nutzeranmeldedaten erfolgt: 

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

Weitere Informationen finden Sie unter Identitätsübernahme des Dienstkontos.

REST

Wenn Sie die REST API in einer lokalen Entwicklungsumgebung verwenden möchten, verwenden Sie die Anmeldedaten, die Sie der gcloud CLI bereitstellen.

    Installieren Sie die Google Cloud CLI.

    Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

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

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

Google Cloud CLI ausführen

Nachdem Sie Ihre Entwicklungsumgebung und die Authentifizierung eingerichtet haben, können Sie mit dem gcloud-Befehlszeilentool mit Spanner interagieren:

gcloud spanner instance-configs list

Sie sollten eine Liste der Spanner-Instanzkonfigurationen sehen, auf die Ihr Projekt zugreifen kann, einschließlich regionaler, biregionaler 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 Cloud Spanner-Instanz, ‑Datenbank, ‑Tabellen und ‑Indizes erstellen. Speichern, fragen Sie dann Daten in Spanner ab und lesen Sie sie.