Auf dieser Seite wird beschrieben, wie Sie eine Spanner-Instanzkonfiguration auflisten, erstellen, aktualisieren, löschen und die Details dazu anzeigen. Einige Funktionen zur Konfiguration benutzerdefinierter Instanzen sind in der Google Cloud Console nicht verfügbar. Verwenden Sie in diesen Fällen die bereitgestellten Google Cloud CLI-Befehle (gcloud).
Instanzkonfigurationen auflisten
Mit der Google Cloud CLI und den Clientbibliotheken können Sie alle verfügbaren Spanner-Instanzkonfigurationen auflisten. Eine Liste aller Spanner-Instanzkonfigurationen finden Sie unter Regionale und multiregionale Konfigurationen.
gcloud
Führen Sie den Befehl gcloud spanner instance-configs list
aus:
gcloud spanner instance-configs list
C++
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
C#
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
Go
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
Java
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
Node.js
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
PHP
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
Python
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
Ruby
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
Details zur Instanzkonfiguration anzeigen
Sie können die Details einer beliebigen Instanzkonfiguration mit der Google Cloud CLI und Clientbibliotheken aufrufen. Wenn Sie eine neue Konfiguration für benutzerdefinierte Instanzen erstellen, können Sie jeden unter optionalReplicas
aufgeführten Standort als optionales Replikat hinzufügen.
Wenn der gewünschte Speicherort für das schreibgeschützte Replikat nicht angezeigt wird, können Sie eine neue optionale Region für schreibgeschützte Replikate anfordern.
Weitere Informationen finden Sie unter Benutzerdefinierte Instanzkonfiguration erstellen.
gcloud
Führen Sie den Befehl gcloud spanner instance-configs describe
aus:
gcloud spanner instance-configs describe INSTANCE-CONFIG
Geben Sie folgenden Wert an:
INSTANCE-CONFIG
- Die Instanzkonfiguration, die den geografischen Standort der Instanz definiert und die Replikation von Daten beeinflusst. Beispiel:
eur6
oderus-central1
.
Führen Sie den folgenden Befehl aus, um die Details der eur6
-Basiskonfiguration aufzurufen:
gcloud spanner instance-configs describe eur6
Hier ein Beispiel für die Ausgabe der eur6
-Basiskonfiguration:
configType: GOOGLE_MANAGED
displayName: Europe (Netherlands, Frankfurt)
freeInstanceAvailability: UNSUPPORTED
leaderOptions:
- europe-west3
- europe-west4
name: projects/cloud-spanner-demo/instanceConfigs/eur6
optionalReplicas:
- displayName: South Carolina
labels:
cloud.googleapis.com/country: US
cloud.googleapis.com/location: us-east1
cloud.googleapis.com/region: us-east1
location: us-east1
type: READ_ONLY
- displayName: South Carolina
labels:
cloud.googleapis.com/country: US
cloud.googleapis.com/location: us-east1
cloud.googleapis.com/region: us-east1
location: us-east1
type: READ_ONLY
replicas:
- defaultLeaderLocation: true
location: europe-west4
type: READ_WRITE
- location: europe-west4
type: READ_WRITE
- location: europe-west3
type: READ_WRITE
- location: europe-west3
type: READ_WRITE
- location: europe-west6
type: WITNESS
Weitere Hinweise zur Verwendung:
baseConfig
(nur für benutzerdefinierte Konfigurationen) verweist auf die Basisinstanzkonfiguration. Unter Verfügbare regionale Konfigurationen und Verfügbare multiregionale Konfigurationen finden Sie Listen mit Basisinstanzkonfigurationen, mit denen Sie eine benutzerdefinierte Instanzkonfiguration erstellen können.configType
gibt an, ob es sich bei dieser Instanzkonfiguration um eine Basisinstanzkonfiguration oder eine benutzerdefinierte Instanzkonfiguration handelt.etag
(nur für benutzerdefinierte Konfigurationen) ist eine base64-codierte Stringdarstellung der Konfiguration. Sie wird für die optimistische Gleichzeitigkeitserkennung verwendet.
C++
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
C#
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
Go
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
Java
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
Node.js
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
PHP
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
Python
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
Ruby
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
Benutzerdefinierte Instanzkonfiguration erstellen
Sie können eine benutzerdefinierte regionale oder Multi-Region-Instanzkonfiguration erstellen und optional schreibgeschützte Replikate hinzufügen, um Lesevorgänge zu skalieren und veraltete Lesevorgänge mit niedriger Latenz zu unterstützen. Unter Verfügbare regionale Konfigurationen und Verfügbare multiregionale Konfigurationen finden Sie Listen mit Basisinstanzkonfigurationen, die zum Erstellen einer benutzerdefinierten Instanzkonfiguration verwendet werden können. Sie können keine benutzerdefinierte Konfiguration für eine biregionale Instanz erstellen. Weitere Informationen zur Replikation und zu Replikationstypen in Spanner finden Sie unter Replikation.
Zum Erstellen einer benutzerdefinierten Instanzkonfiguration benötigen Sie die Berechtigung spanner.instanceConfigs.create
. Standardmäßig haben Rollen mit der Berechtigung spanner.instances.create
auch die Berechtigung spanner.instanceConfigs.create
.
Console
Sie können mit der Google Cloud Console keine benutzerdefinierte Instanzkonfiguration erstellen. Verwenden Sie die gcloud CLI oder Clientbibliotheken, um eine Instanz mit schreibgeschützten Replikaten zu erstellen.
gcloud
Führen Sie den Befehl gcloud spanner instance-configs create
aus:
gcloud spanner instance-configs create CUSTOM-INSTANCE-CONFIG-ID \
--display-name=DISPLAY-NAME \
--base-config=BASE-CONFIG \
--labels=KEY=VALUE,[...] \
--replicas=location=LOCATION,type=TYPE[:...]
Mit dem Flag --clone-config
können Sie eine andere Basis- oder benutzerdefinierte Instanzkonfiguration ganz einfach klonen und gleichzeitig den Speicherort und den Typ eines bestimmten benutzerdefinierten Replicas angeben.
gcloud spanner instance-configs create CUSTOM-INSTANCE-CONFIG-ID \
--display-name=DISPLAY-NAME \
--clone-config=INSTANCE-CONFIG \
--labels=KEY=VALUE,[...] \
--add-replicas=location=LOCATION,type=TYPE[:...] \
--skip-replicas=location=LOCATION,type=TYPE[:...]
Geben Sie folgende Werte an:
CUSTOM-INSTANCE-CONFIG-ID
- Eine permanente Kennzeichnung, die in Ihrem Google Cloud-Projekt nur einmal vorkommt. Sie können die Instanzkonfigurations-ID später nicht mehr ändern. Das Präfix
custom-
ist erforderlich, um Namenskonflikte mit Basisinstanzkonfigurationen zu vermeiden. DISPLAY-NAME
- Der Name, der für die benutzerdefinierte Instanzkonfiguration in der Google Cloud Console angezeigt werden soll. Wenn Sie die Flags `--base-config` und `--replicas` verwenden, geben Sie die folgenden Werte an:
BASE-CONFIG
- Der Regionsname der Basisinstanzkonfiguration, auf der die benutzerdefinierte Instanzkonfiguration basiert. Beispiel:
eur6
oderregional-us-central1
. LOCATION
- Der Regionsname der bereitgestellten Ressourcen (Repliken), z. B.
us-east1
. Welche Standortnamen zulässig sind, sehen Sie in den Listenreplicas
undoptionalReplicas
.gcloud spanner instance-configs describe INSTANCE-CONFIG
TYPE
- Der Typ des Replikats. Welche Speicherorte und Replikattypen zulässig sind, sehen Sie in den Listen
replicas
undoptionalReplicas
.gcloud spanner instance-configs describe INSTANCE-CONFIG
Die Typen sind einer der folgenden:- READ_ONLY
- READ_WRITE
- ZEIGNIS
- Die Elemente in der Liste werden durch „:“ getrennt.
- Sofern das Flag
--[clone-config]
nicht verwendet wird, müssen beim Erstellen einer benutzerdefinierten Instanzkonfiguration alle Replikat-LOCATION
undTYPE
angegeben werden, einschließlich der in der Basiskonfiguration vordefinierten. Weitere Informationen finden Sie im Hilfetext zu gcloud instance-configs describe.
Wenn Sie die Flags --clone-config
und --add-replicas
verwenden möchten (--skip-replicas
nur verwenden, wenn es Repliken gibt, die nicht geklont werden sollen), geben Sie die folgenden Werte an:
--clone-config=INSTANCE-CONFIG
Mit diesem Flag können Sie eine andere Basis- oder benutzerdefinierte Instanzkonfiguration klonen und gleichzeitig den Speicherort und den Typ eines bestimmten benutzerdefinierten Replikats angeben. Geben Sie dann mit
--add-replicas=location=LOCATION,type=TYPE
an, wo Sie das optionale Replikat hinzufügen möchten.Wenn Sie beispielsweise eine benutzerdefinierte Instanzkonfiguration mit zwei schreibgeschützten Replikaten in
us-east1
erstellen und alle anderen Replikationsstandorte aus der Basisinstanzkonfigurationeur6
kopieren möchten, führen Sie Folgendes aus:gcloud spanner instance-configs create custom-eur6 --clone-config=eur6 \ --add-replicas=location=us-east1,type=READ_ONLY:location=us-east1,type=READ_ONLY
--skip-replicas=location=LOCATION,type=TYPE
Mit diesem Flag können Sie das Klonen von Replicas überspringen.
Wenn Sie beispielsweise eine benutzerdefinierte Instanzkonfiguration mit einem nur lesbaren Replikat in
us-east4
erstellen und alle anderen Replikationsspeicherorte aus der Basisinstanzkonfigurationnam3
mit Ausnahme des nur lesbaren Replikats inus-central1
kopieren möchten, führen Sie Folgendes aus:gcloud spanner instance-configs create custom-nam3 --clone-config=nam3 \ --add-replicas=location=us-east4,type=READ_ONLY \ --skip-replicas=location=us-central1,type=READ_ONLY
Die folgenden Flags und Werte sind optional:
--labels=KEY=VALUE,[...]
KEY
undVALUE
: Eine Liste von Schlüssel/Wert-Paaren, die der Konfiguration der benutzerdefinierten Instanz hinzugefügt werden sollen.Schlüssel müssen mit einem Kleinbuchstaben beginnen und dürfen nur Bindestriche (-), Unterstriche (_), Kleinbuchstaben und Ziffern enthalten. Werte dürfen nur Bindestriche (-), Unterstriche (_), Kleinbuchstaben und Zahlen enthalten.
--validate-only
Mit diesem Flag können Sie prüfen, ob die Anfrage erfolgreich sein wird, bevor Sie sie ausführen.
Wenn Sie beispielsweise eine benutzerdefinierte Instanzkonfiguration mit der Basiskonfiguration eur6
und einem zusätzlichen schreibgeschützten Replikat in us-east1
erstellen möchten, führen Sie Folgendes aus:
gcloud spanner instance-configs create custom-eur6 \
--display-name="Custom eur6" --clone-config=eur6 \
--add-replicas=location=us-east1,type=READ_ONLY \
Sie können auch eine benutzerdefinierte Instanzkonfiguration ohne das Flag --clone-config
erstellen:
gcloud spanner instance-configs create custom-eur6 \
--display-name="Custom eur6" --base-config=eur6 \
--replicas=location=europe-west4,type=READ_WRITE:location=europe-west3,type=READ_WRITE:location=europe-west4,type=READ_WRITE:location=europe-west3,type=READ_WRITE:location=europe-west6,type=WITNESS:location=us-east1,type=READ_ONLY
Es sollte folgende Ausgabe angezeigt werden:
Creating instance-config...done.
C++
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
C#
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
Go
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
Java
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
Node.js
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
PHP
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
Python
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
Ruby
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
Instanz in einer benutzerdefinierten Instanzkonfiguration erstellen
Sie können eine Instanz in einer benutzerdefinierten Instanzkonfiguration erstellen.
Console
Verwenden Sie die gcloud CLI oder Clientbibliotheken, um eine Instanz in einer benutzerdefinierten Instanzkonfiguration zu erstellen.
gcloud
Nachdem Sie die benutzerdefinierte Instanzkonfiguration erstellt haben, folgen Sie der Anleitung unter Instanz erstellen.
C++
Nachdem Sie die benutzerdefinierte Instanzkonfiguration erstellt haben, folgen Sie der Anleitung unter Instanz erstellen.
C#
Nachdem Sie die benutzerdefinierte Instanzkonfiguration erstellt haben, folgen Sie der Anleitung unter Instanz erstellen.
Go
Nachdem Sie die benutzerdefinierte Instanzkonfiguration erstellt haben, folgen Sie der Anleitung unter Instanz erstellen.
Java
Nachdem Sie die benutzerdefinierte Instanzkonfiguration erstellt haben, folgen Sie der Anleitung unter Instanz erstellen.
Node.js
Nachdem Sie die benutzerdefinierte Instanzkonfiguration erstellt haben, folgen Sie der Anleitung unter Instanz erstellen.
PHP
Nachdem Sie die benutzerdefinierte Instanzkonfiguration erstellt haben, folgen Sie der Anleitung unter Instanz erstellen.
Python
Nachdem Sie die benutzerdefinierte Instanzkonfiguration erstellt haben, folgen Sie der Anleitung unter Instanz erstellen.
Ruby
Nachdem Sie die benutzerdefinierte Instanzkonfiguration erstellt haben, folgen Sie der Anleitung unter Instanz erstellen.
Benutzerdefinierte Instanzkonfiguration aktualisieren
Sie können den Anzeigenamen und die Labels einer benutzerdefinierten Instanzkonfiguration ändern.
Sie können die Repliken Ihrer benutzerdefinierten Instanzkonfiguration nicht ändern oder aktualisieren.
Sie können jedoch eine neue benutzerdefinierte Instanzkonfiguration mit zusätzlichen Replikaten erstellen und Ihre Instanz dann mit den ausgewählten zusätzlichen Replikaten in die neue benutzerdefinierte Instanzkonfiguration verschieben. Wenn sich Ihre Instanz beispielsweise in us-central1
befindet und Sie ein schreibgeschütztes Replikat us-west1
hinzufügen möchten, müssen Sie eine neue benutzerdefinierte Instanzkonfiguration mit us-central1
als Basiskonfiguration erstellen und us-west1
als schreibgeschütztes Replikat hinzufügen. Verschieben Sie dann die Instanz in diese neue benutzerdefinierte Instanzkonfiguration.
gcloud
Führen Sie folgenden gcloud spanner instance-configs update
-Befehl aus:
gcloud spanner instance-configs update CUSTOM-INSTANCE-CONFIG-ID \
--display-name=NEW-DISPLAY-NAME \
--update-labels=KEY=VALUE,[...], \
--etag=ETAG
Geben Sie folgende Werte an:
CUSTOM-INSTANCE-CONFIG-ID
- Eine permanente Kennzeichnung Ihrer benutzerdefinierten Instanzkonfiguration.
Er beginnt mit
custom-
. NEW-DISPLAY-NAME
- Der neue Name, der für die Instanzkonfiguration in der Google Cloud Console angezeigt werden soll.
KEY
undVALUE
- Eine Liste der Schlüssel/Wert-Paare, die aktualisiert werden sollen.
- Schlüssel müssen mit einem Kleinbuchstaben beginnen und dürfen nur Bindestriche (-), Unterstriche (_), Kleinbuchstaben und Ziffern enthalten. Werte dürfen nur Bindestriche (-), Unterstriche (_), Kleinbuchstaben und Zahlen enthalten.
Die folgenden Flags und Werte sind optional:
--etag=ETAG
: Mit dem ArgumentETAG
können Sie gleichzeitige Aktualisierungen in einem Lese-/Ändern-/Schreiben-Szenario auswählen und überspringen.--validate-only
: Mit diesem Flag können Sie vor der Ausführung prüfen, ob die Anfrage erfolgreich sein wird.
Beispiel:
gcloud spanner instance-configs update custom-eur6 \
--display-name="Customer managed europe replicas"
C++
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
C#
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
Go
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
Java
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
Node.js
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
PHP
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
Python
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
Ruby
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
Benutzerdefinierte Instanzkonfiguration löschen
Wenn Sie eine benutzerdefinierte Instanzkonfiguration löschen möchten, müssen Sie zuerst alle Instanzen in der Instanzkonfiguration löschen.
gcloud
Verwenden Sie den Befehl gcloud spanner instance-configs delete
. Ersetzen Sie dabei CUSTOM-INSTANCE-CONFIG-ID
durch die ID der benutzerdefinierten Instanzkonfiguration:
gcloud spanner instance-configs delete CUSTOM-INSTANCE-CONFIG-ID
C++
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
C#
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
Go
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
Java
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
Node.js
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
PHP
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
Python
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
Ruby
Informationen zum Installieren und Verwenden der Clientbibliothek für Spanner finden Sie unter Spanner-Clientbibliotheken.
Nächste Schritte
- Lernen Sie, wie Sie Daten mithilfe von Data Manipulation Language (DML) oder der gcloud CLI einfügen, aktualisieren und löschen.
- Weisen Sie der Instanz und ihren Datenbanken IAM-Rollen zu.
- Weitere Informationen zum Entwerfen eines Spanner-Schemas
- Kontingente und Limits für Spanner