Kostenlose Spanner-Testinstanz und Beispielanwendung erstellen

In dieser Kurzanleitung erfahren Sie, wie Sie eine kostenlose Spanner-Testinstanz und eine Beispielanwendung verwenden. Weitere Informationen finden Sie in der Übersicht über kostenlose Testinstanzen von Spanner.

Jetzt kostenlos testen

Eine 90-tägige kostenlose Spanner-Testinstanz ist für alle Nutzer mit einem Google-Konto verfügbar, die Cloud Billing in ihrem Projekt aktiviert haben. Ihnen werden keine Kosten in Rechnung gestellt, es sei denn, Sie führen ein Upgrade Ihrer Testinstanz auf eine kostenpflichtige Instanz durch.

Sie können eine kostenlose Testinstanz über die Google Cloud Console oder die Google Cloud CLI erstellen.

Hinweis

Google Cloud Console

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

    Spanner aufrufen

  2. Wählen Sie ein Google Cloud -Projekt aus oder erstellen Sie eines, falls noch nicht geschehen.

  3. Wenn Cloud Billing bereits für Ihr Projekt aktiviert ist, fahren Sie mit dem nächsten Abschnitt Kostenlose Testinstanz erstellen fort.

    Wenn Cloud Billing für Ihr Projekt nicht aktiviert ist, verknüpfen Sie ein vorhandenes Cloud-Rechnungskonto oder erstellen Sie ein neues Cloud-Rechnungskonto. Google verwendet diese Zahlungsinformationen, um deine Identität zu bestätigen. Ihre Spanner-Instanz wird Ihnen nur in Rechnung gestellt, wenn Sie Ihr Cloud-Rechnungskonto explizit auf ein kostenpflichtiges Konto upgraden und Ihre kostenlose Spanner-Testinstanz auf eine kostenpflichtige Instanz upgraden.

    a. Klicken Sie auf Zur Abrechnung.

    b. Klicken Sie dann auf Rechnungskonto verknüpfen.

    c. Folgen Sie der Anleitung unter Rechnungskonto erstellen und verknüpfen Sie es dann mit Ihrem Projekt.

    d. Nachdem Sie Cloud Billing für Ihr Projekt aktiviert haben, rufen Sie die Seite Spanner auf.

    Spanner aufrufen

    e. Klicken Sie auf Kostenlose Instanz erstellen und fahren Sie im nächsten Abschnitt mit Kostenlose Testinstanz erstellen fort.

  4. Optional: Wenn Sie zuvor eine Spanner-Instanz im Projekt erstellt haben, wird die folgende Seite Spanner-Instanzen angezeigt.

    Klicken Sie auf Kostenlose Instanz erstellen.

gcloud

  1. Installieren Sie die Google Cloud CLI.

  2. Konfigurieren Sie die gcloud CLI für die Verwendung Ihrer föderierten Identität.

    Weitere Informationen finden Sie unter Mit Ihrer föderierten Identität in der gcloud CLI anmelden.

  3. Führen Sie den folgenden Befehl aus, um die gcloud CLI zu initialisieren: 

    gcloud init

  4. Google Cloud -Projekt erstellen oder auswählen.

    Erforderliche Rollen zum Auswählen oder Erstellen eines Projekts

    • Projekt auswählen: Für die Auswahl eines Projekts ist keine bestimmte IAM-Rolle erforderlich. Sie können jedes Projekt auswählen, für das Ihnen eine Rolle zugewiesen wurde.
    • Projekt erstellen: Zum Erstellen eines Projekts benötigen Sie die Rolle „Project Creator“ (roles/resourcemanager.projectCreator), die die Berechtigung resourcemanager.projects.create enthält. Informationen zum Zuweisen von Rollen

    • Erstellen Sie ein Projekt in Google Cloud :

      gcloud projects create PROJECT_ID

      Ersetzen Sie PROJECT_ID durch einen Namen für das Google Cloud -Projekt, das Sie erstellen.

    • Wählen Sie das von Ihnen erstellte Projekt Google Cloud aus:

      gcloud config set project PROJECT_ID

      Ersetzen Sie PROJECT_ID durch den Namen Ihres Projekts in Google Cloud .

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

  6. Erstellen Sie lokale Authentifizierungsdaten für Ihr Nutzerkonto: 

    gcloud auth application-default login

    Wenn ein Authentifizierungsfehler zurückgegeben wird, prüfen Sie, ob Sie sich mit Ihrer föderierten Identität in der gcloud CLI angemeldet haben.

Kostenlose Testinstanz erstellen

Google Cloud Console

In den folgenden Schritten wird erläutert, wie Sie eine kostenlose Testinstanz mit derGoogle Cloud -Console erstellen.

Führen Sie auf der Seite Kostenlose Testinstanz erstellen die folgenden Schritte aus:

  1. Geben Sie den Instanznamen ein, der in der Google Cloud Console angezeigt werden soll. Die Instanz muss innerhalb Ihres Google Cloud -Projekts eindeutig sein.
  2. Geben Sie die Instanz-ID ein, um Ihre Instanz dauerhaft zu identifizieren. Die Instanz-ID muss außerdem innerhalb Ihres Google Cloud -Projekts eindeutig sein. Sie können die Instanz-ID später nicht mehr ändern.

  3. Wählen Sie im Drop-down-Menü Region einen Konfigurationsstandort aus.

    Die Instanzkonfiguration bestimmt den geografischen Standort, an dem Ihre Instanz gespeichert und repliziert wird. Sie können eine kostenlose Testinstanz in einer der regionalen Instanzkonfigurationen von Spanner erstellen. Eine vollständige Liste aller verfügbaren Instanzkonfigurationen finden Sie unter Regionale, Dual-Region- und multiregionale Konfigurationen.

  4. Klicken Sie auf Kostenlose Instanz erstellen.

    Nachdem Sie Ihre kostenlose Testinstanz erstellt haben, erstellt Spanner eine Beispieldatenbank, mit der Sie die Spanner-Funktionen kennenlernen können. Weitere Informationen finden Sie unter Kostenlose Testinstanzen von Spanner – Übersicht.

gcloud

Verwenden Sie den Befehl gcloud spanner instances create, um eine Instanz für den kostenlosen Testzeitraum zu erstellen.

gcloud spanner instances create INSTANCE_ID \
   --instance-type=free-instance --config=INSTANCE_CONFIG \
   --description=INSTANCE_DESCRIPTION

Ersetzen Sie Folgendes:

  • INSTANCE_ID: eine permanente Kennung, die innerhalb Ihres Google Cloud -Projekts eindeutig ist. Sie können die Instanz-ID später nicht mehr ändern.

  • INSTANCE_CONFIG: eine permanente Kennung Ihrer Instanzkonfiguration, die den geografischen Standort der Instanz definiert. Sie können eine kostenlose Testinstanz in einer der regionalen Instanzkonfigurationen von Cloud Spanner erstellen:

  • INSTANCE_DESCRIPTION: der Name, der für die Instanz in derGoogle Cloud Console angezeigt werden soll. Der Instanzname muss innerhalb IhresGoogle Cloud -Projekts eindeutig sein.

Wenn Sie beispielsweise eine Instanz im kostenlosen Testzeitraum mit dem Namen trial-instance und dem Anzeigenamen Trial Instance mit der regionalen Instanzkonfiguration regional-us-east5 erstellen möchten, führen Sie Folgendes aus:

gcloud spanner instances create trial-instance --config=regional-us-east5 \
  --instance-type=free-instance --description="Trial Instance"

Nachdem Sie Ihre Instanz für den kostenlosen Testzeitraum erstellt haben, werden Sie aufgefordert, sich weiter mit Spanner vertraut zu machen. Dazu können Sie ein Schritt-für-Schritt-Tutorial starten, in dem Sie erfahren, wie Sie eine Datenbank mit einer Beispielanwendung erstellen. Weitere Informationen finden Sie unter Erste Schritte mit einer Beispielanwendung.

Erste Schritte mit einer Beispieldatenbank

Nachdem Sie Ihre kostenlose Testinstanz über die Google Cloud Console erstellt haben, erstellt Cloud Spanner eine Beispieldatenbank, mit der Sie die Cloud Spanner-Funktionen kennenlernen können.

Sie können über die Google Cloud Console auf die Beispieldatenbank zugreifen.

Google Cloud Console

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

    Zur Seite "VM-Instanzen"

  2. Klicken Sie auf den Namen der kostenlosen Testinstanz.

  3. Klicken Sie auf den Namen der Beispieldatenbank.

Sie können sich die Tabellen und Daten in der Beispieldatenbank ansehen. Sie können auch auf der Spanner Studio-Seite auf gespeicherte Abfragen zugreifen und sie ansehen. Die gespeicherten Abfragen zeigen verschiedene Spanner-Funktionen und -Möglichkeiten.

Erste Schritte mit einer Beispielanwendung

Cloud Spanner bietet auch eine Open-Source-Beispielanwendung, die Ihnen den Einstieg in die kostenlose Cloud Spanner-Testinstanz erleichtert. Die Beispielanwendung besteht aus einem gRPC-Backend-Dienst, der von einer Spanner-Datenbank unterstützt wird, und einem Arbeitslastgenerator, der Traffic an den Dienst weiterleitet.

Sie können mit der gcloud CLI auf die Beispielanwendung zugreifen.

gcloud

  1. Führen Sie die Schritte unter gcloud einrichten aus. Dazu gehören das Erstellen und Festlegen eines Standardprojekts in Google Cloud , das Aktivieren der Cloud Spanner API und das Einrichten von OAuth 2.0, um Authentifizierungsdaten für die Verwendung der Cloud Spanner API zu erhalten.

    Führen Sie den Befehl gcloud auth application-default login aus, um Ihre lokale Entwicklungsumgebung mit Authentifizierungsdaten einzurichten.

  2. Führen Sie den Befehl gcloud spanner samples run aus, um die Beispielanwendung herunterzuladen und den gRPC-Backend-Dienst und den Arbeitslastgenerator für die Beispielanwendung zu starten:

    gcloud spanner samples run APPNAME --instance-id INSTANCE_ID

  3. Weitere Informationen und eine Liste anderer verfügbarer Befehle für die Beispielanwendung finden Sie in der Dokumentation zur gcloud CLI.

Importieren Sie eigene Daten

Sie können Ihre eigenen Daten mithilfe einer CSV-Datei, einer MySQL-Dumpdatei oder einer PostgreSQL-Dumpdatei in eine Cloud Spanner-Datenbank importieren. Sie können eine lokale Datei mit Cloud Storage oder direkt aus einem Cloud Storage-Bucket hochladen. Für das Hochladen einer lokalen Datei mit Cloud Storage können Gebühren anfallen.

Wenn Sie eine CSV-Datei verwenden, müssen Sie auch eine separate JSON-Datei hochladen, die das Datenbankschema enthält.

Google Cloud Console

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

    Zu Spanner-Instanzen

  2. Wählen Sie die Instanz aus, in der die Datenbank erstellt werden soll.

  3. Klicken Sie auf Eigene Daten importieren.

  4. Geben Sie die folgenden Werte ein:

    • Wählen Sie den Dateityp aus.

    • Laden Sie die Datei von Ihrem Computer hoch oder wählen Sie einen Cloud Storage-Bucket-Pfad zur Datei aus.

    • (Optional) Wenn Sie eine CSV-Datei verwenden, müssen Sie auch eine separate JSON-Datei mit dem Datenbankschema hochladen. Die JSON-Datei muss die folgende Struktur verwenden, um das Schema zu definieren:

      {
  "name": "COLUMN_NAME",
  "type": "TYPE",
  "notNull": NOT_NULL_VALUE,
  "primaryKeyOrder": PRIMARY_KEY_ORDER
}

      Ersetzen Sie Folgendes:

      • COLUMN_NAME: der Name der Spalte in der Tabelle.

      • TYPE: der Datentyp der Spalte.

      • (Optional) NOT_NULL_VALUE: Gibt an, ob die Spalte Nullwerte speichern kann oder nicht. Gültige Eingaben sind true oder false. Die Standardeinstellung ist false.

      • (Optional): PRIMARY_KEY_ORDER: Bestimmt die Reihenfolge der Primärschlüssel. Legen Sie den Wert für eine Spalte, die kein Primärschlüssel ist, auf 0 fest. Legen Sie den Wert auf eine Ganzzahl fest, z. B. 1 für eine Primärschlüsselspalte. Spalten mit niedrigeren Nummern werden in einem zusammengesetzten Primärschlüssel früher angezeigt.

      In der CSV-Datei wird standardmäßig ein Komma als Feldtrennzeichen und ein Zeilenumbruch als Zeilentrennzeichen erwartet. Weitere Informationen zur Verwendung benutzerdefinierter Trennzeichen finden Sie in der Referenz zu gcloud alpha spanner databases import.

    • Wählen Sie eine neue oder vorhandene Datenbank als Ziel aus.

  5. Klicken Sie auf Importieren.

  6. Cloud Spanner öffnet Cloud Shell und füllt einen Befehl aus, der das Cloud Spanner-Migrationstool installiert und den Befehl gcloud alpha spanner databases import ausführt. Drücken Sie die Taste ENTER, um Daten in Ihre Datenbank zu importieren.

Upgrade einer Instanz für den kostenlosen Testzeitraum durchführen

In den folgenden Schritten wird erläutert, wie Sie ein Upgrade für Ihre kostenlose Testinstanz ausführen.

Google Cloud Console

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

    Zur Seite "VM-Instanzen"

  2. Klicken Sie auf den Namen der kostenlosen Testinstanz.

  3. Klicken Sie auf der Seite Instanzübersicht auf Instanz bearbeiten oder Bearbeiten, um ein Upgrade durchzuführen.

  4. Geben Sie im Feld Instanzname aktualisieren einen passenderen Namen für Ihre kostenpflichtige Instanz ein, falls zutreffend.

  5. Wählen Sie die gewünschte Upgrade-Option aus. Sie können eine der folgenden Optionen auswählen:

    • Zu Enterprise Standard wechseln
    • Nach Ablauf des Testzeitraums automatisch ein Upgrade auf die Vollversion der Enterprise-Version durchführen
    • Später erinnern

    Der Abschnitt Zusammenfassung enthält eine Beschreibung der Rechen- und Speicherkosten für die ausgewählte aktualisierte kostenpflichtige Instanz.

  6. Klicken Sie auf Speichern, um ein Upgrade für Ihre kostenlose Testinstanz durchzuführen.

gcloud

Führen Sie den folgenden gcloud spanner instances update-Befehl aus, um Ihre Instanz im kostenlosen Testzeitraum auf eine kostenpflichtige Enterprise-Version mit derselben Instanzkonfiguration zu aktualisieren:

gcloud spanner instances update INSTANCE_ID --instance-type=provisioned

Instanz löschen

Google Cloud Console

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

    Zur Seite "VM-Instanzen"

  2. Klicken Sie auf den Namen der Instanz, die Sie löschen möchten.

  3. Klicken Sie auf der Seite Instanzübersicht auf Instanz löschen.

  4. Folgen Sie den Anweisungen, um zu bestätigen, dass Sie die Instanz löschen möchten.

  5. Klicken Sie auf Löschen.

gcloud

Verwenden Sie den folgenden gcloud spanner instances delete-Befehl, um die Instanz des kostenlosen Testzeitraums zu löschen:

gcloud spanner instances delete INSTANCE_ID

Nächste Schritte