Auf dieser Seite wird beschrieben, wie Sie eine Spanner-Instanzkonfiguration auflisten, erstellen, aktualisieren, löschen und anzeigen. Einige Funktionen für die benutzerdefinierte Instanzkonfiguration sind in der UI der Google Cloud Console nicht verfügbar. Verwenden Sie in diesen Fällen die bereitgestellten Befehle der Google Cloud CLI (gcloud).
Instanzkonfigurationen auflisten
Sie können alle verfügbaren Spanner-Instanzkonfigurationen mit der Google Cloud CLI und Clientbibliotheken 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.
Einfach loslegen (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 einblenden
Sie können die Details jeder Instanzkonfiguration mit der Google Cloud CLI und Clientbibliotheken aufrufen. Wenn Sie eine neue benutzerdefinierte Instanzkonfiguration erstellen, können Sie jeden unter optionalReplicas
aufgeführten Standort als optionales Replikat hinzufügen.
Wenn der gewünschte Speicherort für schreibgeschützte Replikate 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 folgenden Befehl aus, um die Details der eur6
-Basiskonfiguration aufzurufen:
gcloud spanner instance-configs describe eur6
Hier ist eine Beispielausgabe für die 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
Zusätzliche Hinweise zur Verwendung:
baseConfig
(nur für benutzerdefinierte Konfigurationen) verweist auf die Konfiguration der Basisinstanz. Unter Verfügbare regionale Konfigurationen und verfügbare multiregionale Konfigurationen finden Sie Listen von Basisinstanzkonfigurationen, mit denen eine benutzerdefinierte Instanzkonfiguration erstellt werden kann.configType
gibt an, ob diese Instanzkonfiguration eine Basisinstanzkonfiguration oder eine benutzerdefinierte Instanzkonfiguration ist.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.
Einfach loslegen (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 Instanzkonfiguration erstellen und optionale 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 von Basisinstanzkonfigurationen, mit denen eine benutzerdefinierte Instanzkonfiguration erstellt werden kann. Weitere Informationen zur Spanner-Replikation und den Replikattypen 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
Mit der Google Cloud Console können Sie keine eigenständige benutzerdefinierte Instanzkonfiguration erstellen. Informationen zum Erstellen einer Instanz mit schreibgeschützten Replikaten finden Sie unter Instanz mit der benutzerdefinierten Instanzkonfiguration erstellen.
Sie können die Google Cloud CLI und Clientbibliotheken verwenden, um eine eigenständige benutzerdefinierte Instanzkonfiguration 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[:...]
Sie können das Flag --clone-config
verwenden, um eine weitere Basis- oder benutzerdefinierte Instanzkonfiguration bequem zu klonen und gleichzeitig den Standort und den Typ eines bestimmten benutzerdefinierten Replikats zu deklarieren.
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 dauerhafte Kennung, 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 „--Replikats“ verwenden möchten, geben Sie die folgenden Werte an:
BASE-CONFIG
- Der Name der Region der Basisinstanzkonfiguration, auf der Ihre benutzerdefinierte Instanzkonfiguration basiert. Beispiel:
eur6
oderregional-us-central1
. LOCATION
- Der Regionsname der bereitstellenden Ressourcen (Replikate), z. B.
us-east1
. Wenn Sie wissen möchten, welche Standortnamen akzeptiert werden, führen Siegcloud spanner instance-configs describe INSTANCE-CONFIG
aus und sehen Sie sich die Listenreplicas
undoptionalReplicas
an. TYPE
- Der Replikattyp. Wenn Sie wissen möchten, welche entsprechenden Standorte und Replikattypen akzeptiert werden, führen Sie
gcloud spanner instance-configs describe INSTANCE-CONFIG
aus und sehen Sie sich die Listenreplicas
undoptionalReplicas
an. Folgende Typen stehen zur Verfügung:- READ_ONLY
- READ_WRITE
- Zeugnis
- Elemente in der Liste werden durch ":" getrennt.
- Sofern nicht das Flag
--[clone-config]
verwendet wird, müssen beim Erstellen einer benutzerdefinierten Instanzkonfiguration alle Replikat-LOCATION
undTYPE
-Replikate angegeben werden, einschließlich der in der Basiskonfiguration vordefinierten. Weitere Informationen finden Sie unter gcloud instance-configs describe help-text.
Wenn Sie die Flags --clone-config
und --add-replicas
verwenden möchten (verwenden Sie --skip-replicas
nur, wenn es Replikate gibt, die nicht geklont werden sollen), geben Sie die folgenden Werte an:
--clone-config=INSTANCE-CONFIG
Verwenden Sie dieses Flag, um eine weitere Basis- oder benutzerdefinierte Instanzkonfiguration bequem zu klonen und gleichzeitig den Standort und den Typ eines bestimmten benutzerdefinierten Replikats zu deklarieren. Verwenden Sie dann
--add-replicas=location=LOCATION,type=TYPE
, um anzugeben, wo Sie das optionale Replikat hinzufügen möchten.Führen Sie beispielsweise folgenden Befehl aus, um eine benutzerdefinierte Instanzkonfiguration mit zwei schreibgeschützten Replikaten in
us-east1
zu erstellen und gleichzeitig alle anderen Replikatstandorte aus der Basisinstanzkonfigurationeur6
zu kopieren: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
Verwenden Sie dieses Flag, um das Klonen von Replikaten zu überspringen.
Führen Sie beispielsweise folgenden Befehl aus, um eine benutzerdefinierte Instanzkonfiguration mit einem schreibgeschützten Replikat in
us-east4
zu erstellen und dabei alle anderen Replikatspeicherorte aus der Basisinstanzkonfigurationnam3
mit Ausnahme des schreibgeschützten Replikats inus-central1
zu kopieren: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 benutzerdefinierten Instanzkonfiguration 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 Ziffern enthalten.
--validate-only
Prüfen Sie mit diesem Flag, ob die Anfrage erfolgreich ist, bevor Sie sie ausführen.
Führen Sie beispielsweise folgenden Befehl aus, um eine benutzerdefinierte Instanzkonfiguration mit der Basiskonfiguration eur6
und einem zusätzlichen schreibgeschützten Replikat in us-east1
zu erstellen:
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 eine benutzerdefinierte Instanzkonfiguration auch 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.
Einfach loslegen (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 mit einer benutzerdefinierten Instanzkonfiguration erstellen
Sie können eine Instanz mit einer benutzerdefinierten Instanzkonfiguration erstellen.
Console
Folgen Sie der Anleitung unter Instanz erstellen, um eine Instanz mit einer benutzerdefinierten Instanzkonfiguration zu erstellen.
Sie müssen in der Google Cloud Console keine eigenständige benutzerdefinierte Instanzkonfiguration erstellen. Die Instanzkonfiguration wird automatisch beim Erstellen der Instanz erstellt.
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.
Einfach loslegen (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 Replikate Ihrer benutzerdefinierten Instanzkonfiguration nicht ändern oder aktualisieren.
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 Kennung der 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 zu aktualisierenden Schlüssel/Wert-Paare.
- 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 Ziffern enthalten.
Die folgenden Flags und Werte sind optional:
--etag=ETAG
: Mit dem ArgumentETAG
können gleichzeitige Aktualisierungen in einem Read-Modify-Write-Szenario ausgewählt und übersprungen werden.--validate-only
: Mit diesem Flag können Sie prüfen, ob die Anfrage erfolgreich ist, bevor Sie sie ausführen.
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.
Einfach loslegen (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, löschen Sie zuerst eine beliebige Instanz in der Instanzkonfiguration.
gcloud
Verwenden Sie den Befehl gcloud spanner instance-configs delete
und ersetzen Sie dabei CUSTOM-INSTANCE-CONFIG-ID
durch die Konfigurations-ID der benutzerdefinierten Instanz:
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.
Einfach loslegen (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
- Hier erfahren Sie, wie Sie Daten mit Data Manipulation Language (DML) oder der gcloud CLI einfügen, aktualisieren und löschen.
- Weisen Sie der Instanz und ihren Datenbanken IAM-Rollen zu.
- Informieren Sie sich, wie Sie ein Spanner-Schema entwerfen.
- Kontingente und Limits für Spanner.