Kostenlose Spanner-Testinstanz und Beispielanwendung erstellen

Hinweis: Eine kostenlose Testinstanz von Cloud Spanner unterstützt Funktionen der Standard-Edition und der Enterprise-Edition, z. B. KNN-Vektordistanzfunktionen, Volltextsuche und Cloud Spanner Graph. Weitere Informationen finden Sie in der Übersicht über Spanner-Versionen.

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.

Kostenlose Testinstanz

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 Instanz für den kostenlosen Testzeitraum mit der Google Cloud Console oder der Google Cloud CLI erstellen.

Hinweis: Sie können nur eine Instanz für den kostenlosen Testzeitraum pro Projektlebenszyklus und maximal fünf Instanzen für den kostenlosen Testzeitraum pro Cloud-Rechnungskonto 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 für Ihr Projekt bereits aktiviert ist, fahren Sie mit dem nächsten Abschnitt Instanz für den kostenlosen Testzeitraum erstellen fort.

   Wenn die Cloud-Abrechnung 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 erst 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.

   Hinweis :Wenn Sie ein neuer Google Cloud -Kunde sind, haben Sie möglicherweise auch Anspruch auf den Google Cloud 90-tägigen kostenlosen Testzeitraum mit einem Cloud Billing-Guthaben in Höhe von 300 $, mit dem Sie für beliebige Google Cloud-Ressourcen bezahlen können. Die Spanner-Testinstanz ist zusätzlich zum Google Cloud -Testguthaben in Höhe von 300 $ verfügbar. Sie müssen kein kostenloses Cloud Billing-Guthaben verwenden, um eine Testinstanz zu erstellen.

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

   d. Nachdem Sie die Cloud-Abrechnung 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 Instanz für kostenlosen Testzeitraum erstellen fort.

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

   Klicken Sie auf Kostenlose Instanz erstellen.

gcloud

Melden Sie sich in Ihrem Google Cloud -Konto an. Wenn Sie mit Google Cloudnoch nicht vertraut sind, erstellen Sie einfach ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

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.

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

gcloud init

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

Hinweis: Wenn Sie die Ressourcen, die Sie in diesem Verfahren erstellen, nicht behalten möchten, erstellen Sie ein Projekt, anstatt ein vorhandenes Projekt auszuwählen. Wenn Sie fertig sind, können Sie das Projekt löschen und dadurch alle mit dem Projekt verknüpften Ressourcen entfernen.

• Erstellen Sie ein Projekt in Google Cloud :

  gcloud projects create PROJECT_ID

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

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

  gcloud config set project PROJECT_ID

  Ersetzen Sie PROJECT_ID durch Ihren Google Cloud Projektnamen.

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

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.

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.

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

gcloud init

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

Hinweis: Wenn Sie die Ressourcen, die Sie in diesem Verfahren erstellen, nicht behalten möchten, erstellen Sie ein Projekt, anstatt ein vorhandenes Projekt auszuwählen. Wenn Sie fertig sind, können Sie das Projekt löschen und dadurch alle mit dem Projekt verknüpften Ressourcen entfernen.

• Erstellen Sie ein Projekt in Google Cloud :

  gcloud projects create PROJECT_ID

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

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

  gcloud config set project PROJECT_ID

  Ersetzen Sie PROJECT_ID durch Ihren Google Cloud Projektnamen.

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

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.

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 auch 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.

   Ihre Instanzkonfiguration bestimmt den geografischen Standort, an dem Ihre Instanz gespeichert und repliziert wird. Sie können eine Instanz im kostenlosen Testzeitraum in einer beliebigen regionalen Instanzkonfiguration von Spanner erstellen. Eine vollständige Liste aller verfügbaren Instanzkonfigurationen finden Sie unter Regionale, biregionale 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 Übersicht über Testzeitraum-Instanzen.

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: die permanente Kennung Ihrer Instanzkonfiguration, die den geografischen Standort der Instanz definiert. Sie können eine Instanz im kostenlosen Testzeitraum in einer der folgenden regionalen Instanzkonfigurationen für 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"

Hinweis :Verwenden Sie die Instanz-ID und nicht den Anzeigenamen, wenn Sie in gcloud CLI-Befehlen auf eine Instanz verweisen.

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

Erste Schritte mit einer Beispieldatenbank

Nachdem Sie Ihre Instanz für den kostenlosen Testzeitraum über die Google Cloud Console erstellt haben, erstellt Spanner eine Beispieldatenbank, mit der Sie die 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 Instanz für den kostenlosen Testzeitraum.

3. Klicken Sie auf den Namen der Beispieldatenbank.

Sie können 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 Backend-gRPC-Dienst, der von einer Spanner-Datenbank unterstützt wird, und einem Workload-Generator, der Traffic an den Dienst sendet.

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

gcloud

1. Führen Sie die unter gcloud einrichten beschriebenen Schritte 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 der anderen verfügbaren Befehle für die Beispielanwendung finden Sie in der gcloud CLI-Dokumentation.

Importieren Sie eigene Daten

Sie können Ihre eigenen Daten mithilfe einer CSV-Datei, einer MySQL-Dumpdatei oder einer PostgreSQL-Dumpdatei in eine Spanner-Datenbank importieren. Sie können eine lokale Datei über 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 mit dem Datenbankschema hochladen.

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 haben, 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 in der Spalte Nullwerte gespeichert werden können. Gültige Eingaben sind true und false. Die Standardeinstellung ist false.

     • (Optional): PRIMARY_KEY_ORDER: Bestimmt die Reihenfolge des Primärschlüssels. 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 ein, mit dem das Spanner-Migrationstool installiert und der Befehl gcloud alpha spanner databases import ausgeführt wird. Drücken Sie die Taste ENTER, um Daten in Ihre Datenbank zu importieren.x

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

In den folgenden Schritten wird beschrieben, wie Sie Ihre Testinstanz upgraden.

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 für den kostenlosen Testzeitraum.

3. Klicken Sie auf der Seite Instanzübersicht auf Instanz bearbeiten oder Zum Aktualisieren bearbeiten.

4. Geben Sie im Feld Instanznamen 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:

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

   Im Abschnitt Zusammenfassung finden Sie eine Beschreibung der Computing- und Speicherkosten für die ausgewählte aktualisierte kostenpflichtige Instanz.

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

gcloud

Wenn Sie Ihre Instanz im kostenlosen Testzeitraum auf eine kostenpflichtige Enterprise-Version mit derselben Instanzkonfiguration upgraden möchten, führen Sie den folgenden gcloud spanner instances update-Befehl aus:

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

Instanz löschen

Achtung: Durch das Löschen einer Instanz werden die Instanz und alle zugehörigen Datenbanken endgültig entfernt. Dieser Vorgang kann nicht rückgängig gemacht werden. Außerdem können Sie keine weitere kostenlose Testinstanz erstellen, nachdem Sie Ihre erste kostenlose Testinstanz gelöscht haben. Sie können während des Projektlebenszyklus eine kostenlose Testinstanz erstellen.

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 für den kostenlosen Testzeitraum zu löschen:

gcloud spanner instances delete INSTANCE_ID

Nächste Schritte

• Weitere Informationen zu kostenlosen Spanner-Testinstanzen
• Weitere Informationen zu Spanner-Instanzen und -Datenbanken
• Informationen zu den Preisen für Cloud Spanner nach dem kostenlosen Testzeitraum finden Sie auf der Preisseite.