Auf dieser Seite wird beschrieben, wie Sie Datenplatzierungen in Spanner erstellen und verwalten.
Weitere Informationen zur Funktionsweise der Geopartitionierung finden Sie in der Übersicht über die Geopartitionierung.
Routing-Metadaten verwalten
Wenn Ihre Anwendung Daten lesen oder schreiben muss, verwendet Spanner Routing-Metadaten, um die Server zu finden, die die erforderlichen Zeilen enthalten.
Die Wahl des Speicherorts für Routing-Metadaten hängt davon ab, ob die meisten Clientanfragen Daten innerhalb derselben Region oder außerhalb der Region betreffen und ob Sie eine multiregionale Konfiguration verwenden. Die Einstellungen für Routing-Metadaten wirken sich auf die Latenz aus und können nach dem Erstellen von Placements nicht mehr geändert werden.
Die Option per_placement_routing_metadata bestimmt, wo Routing-Metadaten gemäß den folgenden Einstellungen gespeichert werden:
TRUE: Wenn dieser Wert aufTRUEgesetzt ist, befinden sich die Routing-Metadaten in derselben Instanzpartition wie die Daten. Routing-Metadaten werden nach Region fragmentiert. Dadurch wird die Latenz für Datenanfragen innerhalb der Region reduziert (d. h. der Client und die angeforderten Nutzerdaten befinden sich in derselben Region), sodass Spanner keine Aufrufe außerhalb der Region für das Routing von Metadaten durchführen muss. Diese Einstellung kann jedoch die Latenz für Anfragen außerhalb der Region, für negative Suchvorgänge, bei denen keine Platzierungszeilen vorhanden sind, und für Abfragen, die einen globalen Index erfordern, erhöhen.Wir empfehlen diese Einstellung, wenn Sie davon ausgehen, dass die meisten Anfragen für Nutzerdaten innerhalb derselben Region wie der Client gestellt werden und Ihre Standardpartition keine Lese-/Schreib- oder schreibgeschützten Regionen hat, die sich am selben Ort wie alle Ihre Instanzpartitionen befinden.
FALSE: Routing-Metadaten werden in der Standardpartition zentralisiert.Wir empfehlen diese Einstellung, wenn Sie davon ausgehen, dass Clients häufig Daten außerhalb der Region abrufen, z. B. ein Client in der EU-Region, der Daten für Nutzer in den USA abruft.
Diese Einstellung ist auch dann sinnvoll, wenn Ihre Standardinstanzpartition eine multiregionale Konfiguration verwendet, die Lese-/Schreib- oder Lesezugriff-Regionen bereitstellt, die sich am selben Standort wie alle Ihre Instanzpartitionen befinden. Bei dieser Einstellung wird ein Replikat der vollständigen Routing-Metadaten mit jedem Replikat der Standardinstanzpartition gespeichert. Daher haben alle Regionen mit Instanzpartitionen ein Replikat der Routing-Metadaten. So können sowohl Anfragen innerhalb als auch außerhalb der Region Routing-Metadaten lokal abrufen.
Legen Sie die Option per_placement_routing_metadata fest.
Die Option per_placement_routing_metadata akzeptiert boolesche Werte. Wenn diese Option auf TRUE gesetzt ist, befinden sich die Routing-Metadaten in derselben Instanzpartition wie die Daten. Wenn FALSE, befinden sich die Routing-Metadaten in der Standard-Instanzpartition.
Wenn Sie die Option per_placement_routing_metadata festlegen möchten, aktualisieren Sie Ihr Datenbankschema.
Informationen zu anderen Möglichkeiten, ein Schema zu aktualisieren, z. B. Clientbibliotheken oder die REST und RPC APIs, finden Sie unter Schemaaktualisierungen vornehmen.
Wählen Sie eine der folgenden Optionen aus:
Console
Rufen Sie in der Google Cloud Console die Seite Instanzen auf.
Wählen Sie die Instanz mit den vom Nutzer erstellten Instanzpartitionen aus.
Wählen Sie die Datenbank aus, für die Sie Routing-Metadaten festlegen möchten.
Klicken Sie im Navigationsmenü auf Spanner Studio.
Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder verwenden Sie den leeren Editor-Tab.
Geben Sie die DDL-Anweisung für
ALTER DATABASE(GoogleSQL, PostgreSQL) ein:GoogleSQL
ALTER DATABASE `DATABASE_NAME` SET OPTIONS (per_placement_routing_metadata = METADATA_BOOLEAN);Ersetzen Sie Folgendes:
DATABASE_NAME: der Name Ihrer DatenbankMETADATA_BOOLEAN: derper_placement_routing_metadata-Wert. WennTRUE, befinden sich die Routing-Metadaten in derselben Instanzpartition wie die Daten. WennFALSE, befinden sich die Routing-Metadaten in der Standardinstanzpartition.
PostgreSQL
ALTER DATABASE "DATABASE_NAME" SET spanner.per_placement_routing_metadata = METADATA_BOOLEAN;Ersetzen Sie Folgendes:
DATABASE_NAME: der Name Ihrer DatenbankMETADATA_BOOLEAN: derper_placement_routing_metadata-Wert. WennTRUE, befinden sich die Routing-Metadaten in derselben Instanzpartition wie die Daten. WennFALSE, befinden sich die Routing-Metadaten in der Standardinstanzpartition.
Klicken Sie auf Ausführen.
gcloud
Verwenden Sie gcloud spanner databases ddl update, um die Option per_placement_routing_metadata mit der Google Cloud CLI festzulegen:
GoogleSQL
gcloud spanner databases ddl update DATABASE_NAME \
--instance=INSTANCE_ID \
--ddl='ALTER DATABASE `DATABASE_NAME`
SET OPTIONS (per_placement_routing_metadata = METADATA_BOOLEAN)'
Ersetzen Sie Folgendes:
DATABASE_NAME: der Name Ihrer DatenbankINSTANCE_ID: die ID Ihrer Cloud Spanner-Instanz.METADATA_BOOLEAN: derper_placement_routing_metadata-Wert. WennTRUE, befinden sich die Routing-Metadaten in derselben Instanzpartition wie die Daten. WennFALSE, befinden sich die Routing-Metadaten in der Standardinstanzpartition.
PostgreSQL
gcloud spanner databases ddl update DATABASE_NAME \
--instance=INSTANCE_ID \
--ddl='ALTER DATABASE "DATABASE_NAME"
SET spanner.per_placement_routing_metadata = METADATA_BOOLEAN'
Ersetzen Sie Folgendes:
DATABASE_NAME: der Name Ihrer DatenbankINSTANCE_ID: die ID Ihrer Cloud Spanner-Instanz.METADATA_BOOLEAN: derper_placement_routing_metadata-Wert. WennTRUE, befinden sich die Routing-Metadaten in derselben Instanzpartition wie die Daten. WennFALSE, befinden sich die Routing-Metadaten in der Standardinstanzpartition.
Datenplatzierung erstellen
Nachdem Sie die Partitionen und Datenbanken Ihrer Spanner-Instanz erstellt und die Option per_placement_routing_metadata festgelegt haben, erstellen Sie Ihre Platzierung.
Console
Rufen Sie in der Google Cloud Console die Seite Instanzen auf.
Wählen Sie die Instanz mit den vom Nutzer erstellten Instanzpartitionen aus.
Wählen Sie die Datenbank aus, in der Sie Daten partitionieren möchten.
Klicken Sie im Navigationsmenü auf Spanner Studio.
Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder verwenden Sie den leeren Editor-Tab.
Geben Sie die DDL-Anweisung
CREATE PLACEMENT(GoogleSQL, PostgreSQL) ein.Sie können beispielsweise Folgendes ausführen, um eine Platzierungstabelle
europeplacementin der Instanzpartitioneurope-partitionzu erstellen:GoogleSQL
CREATE PLACEMENT europeplacement OPTIONS (instance_partition="europe-partition");PostgreSQL
CREATE PLACEMENT europeplacement WITH (instance_partition='europe-partition');Optional: Sie können auch den Bereich Objekt-Explorer verwenden, um Ihre Placement-Objekte aufzurufen, danach zu suchen und mit ihnen zu interagieren. Weitere Informationen finden Sie unter Daten untersuchen.
Klicken Sie auf Ausführen.
gcloud
Verwenden Sie gcloud spanner databases ddl update, um eine Platzierung mit dem gcloud CLI-Befehl zu erstellen.
Erstellen Sie beispielsweise eine Platzierung in der Instanzpartition europe-partition:
GoogleSQL
gcloud spanner databases ddl update example-db \
--instance=test-instance \
--ddl="CREATE PLACEMENT europeplacement OPTIONS (instance_partition='europe-partition')"
PostgreSQL
gcloud spanner databases ddl update example-db \
--instance=test-instance \
--ddl="CREATE PLACEMENT europeplacement WITH (instance_partition='europe-partition')"
Standard-Leader für ein Placement festlegen
Sie können die standardmäßige führende Region einer Platzierung festlegen, wenn sich ihr Standort in einer multiregionalen Region befindet. Die neue Leader-Region muss eine der beiden Lese-/Schreibregionen innerhalb des multiregionalen Speicherorts sein. Weitere Informationen finden Sie in den Tabellen Verfügbare multiregionale Konfigurationen.
Wenn Sie keine Leader-Region festlegen, wird für die Platzierung die Standard-Leader-Region verwendet, die durch den Standort angegeben ist. Eine Liste der führenden Regionen für jeden multiregionalen Standort finden Sie in den Tabellen Verfügbare multiregionale Konfigurationen. Die standardmäßige führende Region ist mit einem L gekennzeichnet. Die Standard-Leader-Region von nam8 ist beispielsweise Los Angeles (us-west2). In der folgenden Anleitung wird erläutert, wie Sie sie auf Oregon (us-west1) festlegen.
Console
Rufen Sie in der Google Cloud Console die Seite Instanzen auf.
Wählen Sie die Instanz mit den vom Nutzer erstellten Instanzpartitionen aus.
Wählen Sie die Datenbank aus, in der Sie Daten partitionieren möchten.
Klicken Sie im Navigationsmenü auf Spanner Studio.
Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder verwenden Sie den leeren Editor-Tab.
Geben Sie die DDL-Anweisung
CREATE PLACEMENT(GoogleSQL, PostgreSQL) ein.Sie können beispielsweise Folgendes ausführen, um eine Platzierungstabelle
nam8placementin der Instanzpartitionnam8-partitionmit dem Standard-Leader-Standortus-west1zu erstellen:GoogleSQL
CREATE PLACEMENT `nam8placement` OPTIONS (instance_partition="nam8-partition", default_leader="us-west1");PostgreSQL
CREATE PLACEMENT nam8placement WITH (instance_partition='nam8-partition', default_leader='us-west1');Optional: Sie können auch den Bereich Objekt-Explorer verwenden, um Ihre Placement-Objekte aufzurufen, danach zu suchen und mit ihnen zu interagieren. Weitere Informationen finden Sie unter Daten untersuchen.
Klicken Sie auf Ausführen.
gcloud
Verwenden Sie gcloud spanner databases ddl update, um eine Platzierung mit dem gcloud CLI-Befehl zu erstellen.
Erstellen Sie beispielsweise eine Platzierungstabelle nam8placement in der Instanzpartition nam8-partition, wobei der Standard-Leader-Standort auf us-west1 festgelegt ist:
GoogleSQL
gcloud spanner databases ddl update example-db \
--instance=test-instance \
--ddl="CREATE PLACEMENT nam8placement \
OPTIONS (instance_partition='nam8-partition', default_leader='us-west1')"
PostgreSQL
gcloud spanner databases ddl update example-db \
--instance=test-instance \
--ddl="CREATE PLACEMENT nam8placement WITH (instance_partition='nam8-partition', default_leader='us-west1')"
Datenplatzierung löschen
Bevor Sie ein Placement löschen, müssen Sie alle Zeilendaten aus dem Placement entfernen. Anschließend können Sie die Google Cloud Console oder die gcloud CLI verwenden, um die Platzierung zu löschen.
Console
- Klicken Sie im Navigationsmenü auf Spanner Studio.
- Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder verwenden Sie den leeren Editor-Tab.
Geben Sie die DDL-Anweisung für
DROP PLACEMENT(GoogleSQL, PostgreSQL) ein.Sie können beispielsweise Folgendes ausführen, um die Platzierungstabelle
europeplacementzu löschen:GoogleSQL
DROP PLACEMENT europeplacement;PostgreSQL
DROP PLACEMENT europeplacement;
gcloud
Verwenden Sie gcloud spanner databases ddl update, um eine Platzierung mit dem gcloud CLI-Befehl zu löschen.
Beispiel für das Löschen des Placements europeplacement:
gcloud spanner databases ddl update example-db \
--instance=test-instance \
--ddl="DROP PLACEMENT europeplacement"
Fehler beim Platzieren von Drops
Wenn das Placement verwendet wird, schlägt der Vorgang DROP PLACEMENT mit einer Fehlermeldung wie der folgenden fehl: „Anweisung fehlgeschlagen: Placement PLACEMENT_NAME kann nicht gelöscht werden, da es von der Placement-Tabelle PLACEMENT_TABLE_NAME verwendet wird.“ Wenn dieser Fehler auftritt, führen Sie die folgenden Schritte aus:
- Ändern Sie Ihre Anwendung so, dass keine Zeilen mehr mit der Platzierung eingefügt oder aktualisiert werden, die Sie löschen möchten.
Entweder:
Verschieben Sie vorhandene Platzierungszeilen, die die zu löschende Platzierung verwenden, mit einer partitionierten DML-Anweisung wie der folgenden in eine andere Platzierung:
UPDATE PLACEMENT_TABLE_NAME SET LOCATION = NEW_PLACEMENT_NAME WHERE LOCATION = ORIGINAL_PLACEMENT_NAME;Löschen Sie die Platzierungszeilen mit einer partitionierten DML-Anweisung wie der folgenden:
DELETE FROM PLACEMENT_TABLE_NAME WHERE LOCATION = ORIGINAL_PLACEMENT_NAME;Die vorherigen platzierungsspezifischen DML-Anweisungen funktionieren nur mit partitionierter DML. Sie schlagen wie reguläre DML-Anweisungen fehl. Weitere Informationen finden Sie unter Einschränkungen. Sie können auch die Mutation API verwenden, um Platzierungszeilen zu verschieben oder zu löschen.
DROP PLACEMENT-Vorgang abbrechen
Sie können einen DROP PLACEMENT-Vorgang jederzeit abbrechen, bevor der Vorgang mit langer Ausführungszeit die Platzierung vollständig aus dem Datenbankschema löscht. Informationen zum Abrufen der ID des Vorgangs mit langer Ausführungszeit, um den Status zu prüfen oder den Vorgang abzubrechen, finden Sie unter Vorgänge mit langer Ausführungszeit verwalten und beobachten.
Tabelle mit einem Platzierungsschlüssel erstellen
Console
- Klicken Sie im Navigationsmenü auf Spanner Studio.
- Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder verwenden Sie den leeren Editor-Tab.
Geben Sie die DDL-Anweisung
CREATE TABLE(GoogleSQL, PostgreSQL) ein.Sie können beispielsweise eine Tabelle
Singerserstellen, die einen Platzierungsschlüssel zum Partitionieren von Sängerdaten verwendet:GoogleSQL
CREATE TABLE Singers ( SingerId INT64 NOT NULL, SingerName STRING(MAX) NOT NULL, ... Location STRING(MAX) NOT NULL PLACEMENT KEY ) PRIMARY KEY (SingerId);PostgreSQL
CREATE TABLE Singers ( SingerId bigint PRIMARY KEY, SingerName varchar(1024), ... Location varchar(1024) NOT NULL PLACEMENT KEY );
gcloud
Verwenden Sie zum Erstellen einer Tabelle gcloud spanner databases ddl update.
Sie können beispielsweise eine Tabelle Singers erstellen, die einen Platzierungsschlüssel zum Partitionieren von Sängerdaten verwendet:
GoogleSQL
gcloud spanner databases ddl update example-db \
--instance=test-instance \
--ddl="CREATE TABLE Singers ( SingerId INT64 NOT NULL, SingerName STRING(MAX) NOT NULL, Location STRING(MAX) NOT NULL PLACEMENT KEY ) PRIMARY KEY (SingerId);"
PostgreSQL
gcloud spanner databases ddl update example-db \
--instance=test-instance \
--ddl="CREATE TABLE Singers ( SingerId bigint PRIMARY KEY, SingerName varchar(1024), Location varchar(1024) NOT NULL PLACEMENT KEY );"
Tabelle mit einem Platzierungsschlüssel bearbeiten
Sie können einen Platzierungsschlüssel nicht aus einer Tabelle entfernen. Sie können einer Tabelle auch keinen Platzierungsschlüssel hinzufügen, nachdem sie erstellt wurde. Sie können jedoch die DDL-Anweisung ALTER TABLE (GoogleSQL, PostgreSQL) verwenden, um andere Felder in der Tabelle zu ändern, z. B. durch Hinzufügen und Löschen von Schlüsselspalten, die nicht für die Platzierung verwendet werden.
Tabelle mit einem Platzierungsschlüssel löschen
Bevor Sie eine Tabelle mit einem Platzierungsschlüssel löschen, müssen Sie Folgendes tun:
- Löschen Sie alle Zeilen in der Placement-Tabelle.
- Warten Sie, bis die
version_retention_periodfür die Datenbank abgeschlossen ist. Weitere Informationen finden Sie unter Wiederherstellung zu einem bestimmten Zeitpunkt. Führen Sie dann die folgenden Schritte aus:
Console
- Klicken Sie im Navigationsmenü auf Spanner Studio.
- Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder verwenden Sie den leeren Editor-Tab.
Geben Sie die DDL-Anweisung
DROP TABLE(GoogleSQL, PostgreSQL) ein.Löschen Sie beispielsweise die Tabelle
Singers:DROP TABLE Singers;
gcloud
Verwenden Sie gcloud spanner databases ddl update, um eine Tabelle zu löschen.
Löschen Sie beispielsweise die Tabelle Singers:
gcloud spanner databases ddl update example-db \
--instance=test-instance \
--ddl="DROP TABLE Singers"
Zeile in eine Platzierungstabelle einfügen
Console
- Klicken Sie im Navigationsmenü auf Spanner Studio.
- Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder verwenden Sie den leeren Editor-Tab.
Geben Sie die DDL-Anweisung
INSERT INTO(GoogleSQL, PostgreSQL) ein.Fügen Sie beispielsweise den Sänger Marc Richards zur Tabelle
Singershinzu und partitionieren Sie ihn ineuropeplacement:INSERT INTO Singers(SingerId, SingerName, Location) VALUES (1, 'Marc Richards', 'europeplacement')
gcloud
Verwenden Sie gcloud spanner rows insert, um Daten in eine Tabelle zu schreiben.
Fügen Sie beispielsweise den Sänger Marc Richards zur Tabelle Singers hinzu und partitionieren Sie ihn in europeplacement:
gcloud spanner rows insert --table=Singers --database=example-db \
--instance=test-instance --data=SingerId=1,SingerName='Marc Richards',Location='europeplacement'
Zeile in einer Platzierungstabelle aktualisieren
Console
- Klicken Sie im Navigationsmenü auf Spanner Studio.
- Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder verwenden Sie den leeren Editor-Tab.
Verwenden Sie DML oder Mutationen, um Daten in einer Platzierungstabelle zu aktualisieren.
Aktualisieren Sie beispielsweise den Namen von
singerid=1in der TabelleSingersaufCatalina Smith:UPDATE Singers s SET s.name='Catalina Smith' WHERE s.id=1;
gcloud
Verwenden Sie gcloud spanner rows update, um Daten in einer Platzierungstabelle zu aktualisieren.
Aktualisieren Sie beispielsweise den Namen von singerid=1 in der Tabelle Singers auf Catalina Smith:
gcloud spanner rows update --table=Singers --database=example-db \
--instance=test-instance --data=SingerId=1,SingerName='Catalina Smith'
Zeile in einer Platzierungstabelle verschieben
Console
- Erstellen Sie eine neue Instanzpartition und -platzierung, falls Sie das noch nicht getan haben.
- Klicken Sie im Navigationsmenü auf Spanner Studio.
- Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder verwenden Sie den leeren Editor-Tab.
Verwenden Sie DML oder Mutationen, um Daten in die neue Instanzpartition zu verschieben.
Verschieben Sie beispielsweise
singerid=1in der TabelleSingersnachasiaplacement:UPDATE Singers s SET s.location='asiaplacement' WHERE s.id=1;
gcloud
Nachdem Sie die Instanzpartition und die Platzierung erstellt haben, in die Sie Ihre Daten verschieben möchten, verwenden Sie gcloud spanner rows update.
Verschieben Sie beispielsweise singerid=1 in der Tabelle Singers nach asiaplacement:
gcloud spanner rows update --table=Singers --database=example-db \
--instance=test-instance --data=SingerId=1,Location='asiaplacement'
Zeile in einer Platzierungstabelle löschen
Console
- Klicken Sie im Navigationsmenü auf Spanner Studio.
- Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder verwenden Sie den leeren Editor-Tab.
Verwenden Sie DML oder Mutationen, um Daten zu löschen.
Löschen Sie beispielsweise
singerid=1in der TabelleSingers:DELETE FROM Singers s WHERE s.id=1;
gcloud
Verwenden Sie zum Löschen von Daten gcloud spanner rows delete.
Löschen Sie beispielsweise singerid=1 in der Tabelle Singers:
gcloud spanner rows delete --table=Singers --database=example-db \
--instance=test-instance --keys=1
Daten in einer Platzierungstabelle abfragen
Console
- Klicken Sie im Navigationsmenü auf Spanner Studio.
- Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder verwenden Sie den leeren Editor-Tab.
Führen Sie die Abfrage aus.
Fragen Sie beispielsweise die Tabelle
Singersab:SELECT * FROM Singers s WHERE s.SingerId=1;
gcloud
Verwenden Sie zum Abfragen von Daten gcloud spanner databases execute-sql.
Fragen Sie beispielsweise die Tabelle Singers ab:
gcloud spanner databases execute-sql example-db \
--instance=test-instance \
--sql='SELECT * FROM Singers s WHERE s.SingerId=1'