Kostenlose Spanner-Testinstanz und Beispielanwendung erstellen

Hinweis :Eine Spanner-Testinstanz unterstützt Funktionen der Standard Edition und der Enterprise Edition, z. B. KNN-Vektordistanzfunktionen, Volltextsuche und 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.

Mit einer kostenlosen Testinstanz starten

Eine kostenlose 90-tägige Spanner-Testinstanz ist für alle Nutzer mit einem Google-Konto verfügbar, in deren Projekt die Cloud-Abrechnung aktiviert ist. Kosten entstehen Ihnen erst dann, wenn Sie ein Upgrade Ihrer Testinstanz auf eine kostenpflichtige Instanz durchführen.

Sie können eine Instanz für den kostenlosen Testzeitraum mit der Google Cloud -Konsole oder der Google Cloud CLI erstellen.

Hinweis :Sie können nur eine Instanz im kostenlosen Testzeitraum pro Projektlebenszyklus und maximal fünf Instanzen im 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 Sie dies noch nicht getan haben.

3. Wenn die Cloud-Abrechnung für Ihr Projekt bereits aktiviert ist, fahren Sie mit dem nächsten Abschnitt Instanz für den kostenlosen Testzeitraum 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 Ihre Identität zu bestätigen. Ihrer Spanner-Instanz werden keine Kosten in Rechnung gestellt, sofern Sie nicht ausdrücklich ein Upgrade Ihres Cloud-Rechnungskonto auf ein kostenpflichtiges Konto durchführen und ein Upgrade Ihrer kostenlosen Spanner-Testinstanz auf eine kostenpflichtige Instanz durchführen.

   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 kostenlosen 90-Tage-Testzeitraum mit einem Guthaben von 300 $, der ein kostenloses Cloud Billing-Guthaben von 300 $zur Bezahlung von Google Cloud-Ressourcen bietet. Die Spanner-Testinstanz ist zusätzlich zum Google Cloud -Testguthaben in Höhe von 300 $, und Sie müssen kein kostenloses Cloud Billing-Guthaben verwenden, um eine Testinstanz zu erstellen.

   c. Folgen Sie der Anleitung zum Erstellen eines Rechnungskontos 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 mit dem nächsten Abschnitt 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 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

Erstellen Sie ein Google Cloud Projekt oder wählen Sie eines aus.

Rollen, die zum Auswählen oder Erstellen eines Projekts erforderlich sind

• 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 „Projektersteller“ (roles/resourcemanager.projectCreator), die die Berechtigung resourcemanager.projects.create enthält. Weitere 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.

• So erstellen Sie ein Google Cloud -Projekt:

  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 Google Cloud Projekt aus:

  gcloud config set project PROJECT_ID

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

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

Wenn Sie eine lokale Shell verwenden, erstellen Sie lokale Anmeldedaten zur Authentifizierung 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.

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

Erstellen Sie ein Google Cloud Projekt oder wählen Sie eines aus.

Rollen, die zum Auswählen oder Erstellen eines Projekts erforderlich sind

• 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 „Projektersteller“ (roles/resourcemanager.projectCreator), die die Berechtigung resourcemanager.projects.create enthält. Weitere 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.

• So erstellen Sie ein Google Cloud -Projekt:

  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 Google Cloud Projekt aus:

  gcloud config set project PROJECT_ID

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

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

Wenn Sie eine lokale Shell verwenden, erstellen Sie lokale Anmeldedaten zur Authentifizierung 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.

Instanz für kostenlosen Testzeitraum erstellen

Google Cloud Console

In den folgenden Schritten wird beschrieben, wie Sie eine Instanz für den kostenlosen Testzeitraum über dieGoogle Cloud -Konsole 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 einmalig sein.
2. Geben Sie die Instanz-ID ein, um Ihre Instanz dauerhaft zu identifizieren. Die Instanz-ID darf im Google Cloud -Projekt ebenfalls nur einmal vorkommen. 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 legt fest, an welchem geografischen Standort die Instanz gespeichert und repliziert wird. Sie können eine Instanz im kostenlosen Testzeitraum in einer beliebigen der regionalen Instanzkonfigurationen 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 Instanz für den kostenlosen Testzeitraum erstellt haben, erstellt Spanner eine Beispieldatenbank, mit der Sie die Spanner-Funktionen kennenlernen können. Weitere Informationen finden Sie unter Übersicht über Testzeitrauminstanzen.

gcloud

Verwenden Sie zum Erstellen einer Instanz für den kostenlosen Testzeitraum den Befehl gcloud spanner instances create.

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 in Ihrem Google Cloud Projekt nur einmal vorkommen darf. 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 von Cloud Spanner erstellen:

• INSTANCE_DESCRIPTION: Der Name, der in derGoogle Cloud -Konsole für die Instanz angezeigt werden soll. Der Instanzname darf innerhalb IhresGoogle Cloud -Projekts nur einmal vorkommen.

Wenn Sie beispielsweise eine kostenlose Testinstanz 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, 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 Erste Schritte mit einer Beispielanwendung.

Mit einer Beispieldatenbank beginnen

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 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 veranschaulichen verschiedene Spanner-Funktionen und -Leistungsmerkmale.

Erste Schritte mit einer Beispielanwendung

Spanner bietet auch eine Open-Source-Beispielanwendung, die Ihnen den Einstieg in die kostenlose Spanner-Testinstanz erleichtert. Die Beispielanwendung besteht aus einem gRPC-Backend-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 Einrichten eines Standardprojekts Google Cloud , das Aktivieren der Cloud Spanner API und das Einrichten von OAuth 2.0 zum Abrufen von Anmeldedaten für die Authentifizierung zur Verwendung der Cloud Spanner API.

   Führen Sie den Befehl gcloud auth application-default login aus, um die lokale Entwicklungsumgebung mit Anmeldedaten für die Authentifizierung einzurichten.

2. Führen Sie den Befehl gcloud spanner samples run aus, um die Beispielanwendung herunterzuladen und den Back-End-gRPC-Dienst und den Arbeitslastgenerator für die angegebene 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 in eine Spanner-Datenbank importieren. Dazu können Sie eine CSV-Datei, eine MySQL-Dumpdatei oder eine PostgreSQL-Dumpdatei verwenden. 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.

   Cloud Spanner-Instanzen aufrufen

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 der Primärschlüssel. Der Wert ist für eine Spalte, die kein Primärschlüssel ist, auf 0 festgelegt. 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 gcloud alpha spanner databases import-Referenz.

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

5. Klicken Sie auf Importieren.

6. Spanner öffnet Cloud Shell und fügt einen Befehl ein, mit dem das Spanner-Migrations-Tool 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

In den folgenden Schritten wird beschrieben, wie Sie ein Upgrade Ihrer Testinstanz durchfü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 Testinstanz.

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

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

5. Wählen Sie Ihre 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

   Im Bereich Zusammenfassung finden Sie eine Beschreibung der Compute- und Speicherkosten für die ausgewählte kostenpflichtige Instanz mit Upgrade.

6. Klicken Sie auf Speichern, um das Upgrade Ihrer Testinstanz durchzuführen.

gcloud

Wenn Sie ein Upgrade Ihrer Testinstanz auf eine kostenpflichtige Enterprise-Version mit derselben Instanzkonfiguration durchführen 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 Instanz für den kostenlosen Testzeitraum erstellen, nachdem Sie Ihre erste Instanz für den kostenlosen Testzeitraum gelöscht haben. Sie können eine kostenlose Testinstanz pro Projektlebenszyklus 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
• Details zu den Preisen für Cloud Spanner nach dem kostenlosen Testzeitraum finden Sie auf der Seite „Preise“.