Daten-Placements erstellen und verwalten

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 auf TRUE gesetzt 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

  1. Rufen Sie in der Google Cloud Console die Seite Instanzen auf.

    Zur Seite „VM-Instanzen“

  2. Wählen Sie die Instanz mit den vom Nutzer erstellten Instanzpartitionen aus.

  3. Wählen Sie die Datenbank aus, für die Sie Routing-Metadaten festlegen möchten.

  4. Klicken Sie im Navigationsmenü auf Spanner Studio.

  5. Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder verwenden Sie den leeren Editor-Tab.

  6. 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 Datenbank
    • METADATA_BOOLEAN: der per_placement_routing_metadata-Wert. Wenn TRUE, befinden sich die Routing-Metadaten in derselben Instanzpartition wie die Daten. Wenn FALSE, 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 Datenbank
    • METADATA_BOOLEAN: der per_placement_routing_metadata-Wert. Wenn TRUE, befinden sich die Routing-Metadaten in derselben Instanzpartition wie die Daten. Wenn FALSE, befinden sich die Routing-Metadaten in der Standardinstanzpartition.
  7. 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 Datenbank
  • INSTANCE_ID: die ID Ihrer Cloud Spanner-Instanz.
  • METADATA_BOOLEAN: der per_placement_routing_metadata-Wert. Wenn TRUE, befinden sich die Routing-Metadaten in derselben Instanzpartition wie die Daten. Wenn FALSE, 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 Datenbank
  • INSTANCE_ID: die ID Ihrer Cloud Spanner-Instanz.
  • METADATA_BOOLEAN: der per_placement_routing_metadata-Wert. Wenn TRUE, befinden sich die Routing-Metadaten in derselben Instanzpartition wie die Daten. Wenn FALSE, 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

  1. Rufen Sie in der Google Cloud Console die Seite Instanzen auf.

    Instanzen

  2. Wählen Sie die Instanz mit den vom Nutzer erstellten Instanzpartitionen aus.

  3. Wählen Sie die Datenbank aus, in der Sie Daten partitionieren möchten.

  4. Klicken Sie im Navigationsmenü auf Spanner Studio.

  5. Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder verwenden Sie den leeren Editor-Tab.

  6. Geben Sie die DDL-Anweisung CREATE PLACEMENT (GoogleSQL, PostgreSQL) ein.

    Sie können beispielsweise Folgendes ausführen, um eine Platzierungstabelle europeplacement in der Instanzpartition europe-partition zu 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.

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

  1. Rufen Sie in der Google Cloud Console die Seite Instanzen auf.

    Instanzen

  2. Wählen Sie die Instanz mit den vom Nutzer erstellten Instanzpartitionen aus.

  3. Wählen Sie die Datenbank aus, in der Sie Daten partitionieren möchten.

  4. Klicken Sie im Navigationsmenü auf Spanner Studio.

  5. Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder verwenden Sie den leeren Editor-Tab.

  6. Geben Sie die DDL-Anweisung CREATE PLACEMENT (GoogleSQL, PostgreSQL) ein.

    Sie können beispielsweise Folgendes ausführen, um eine Platzierungstabelle nam8placement in der Instanzpartition nam8-partition mit dem Standard-Leader-Standort us-west1 zu 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.

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

  1. Klicken Sie im Navigationsmenü auf Spanner Studio.
  2. Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder verwenden Sie den leeren Editor-Tab.
  3. Geben Sie die DDL-Anweisung für DROP PLACEMENT(GoogleSQL, PostgreSQL) ein.

    Sie können beispielsweise Folgendes ausführen, um die Platzierungstabelle europeplacement zu 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:

  1. Ändern Sie Ihre Anwendung so, dass keine Zeilen mehr mit der Platzierung eingefügt oder aktualisiert werden, die Sie löschen möchten.
  2. 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

  1. Klicken Sie im Navigationsmenü auf Spanner Studio.
  2. Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder verwenden Sie den leeren Editor-Tab.
  3. Geben Sie die DDL-Anweisung CREATE TABLE (GoogleSQL, PostgreSQL) ein.

    Sie können beispielsweise eine Tabelle Singers erstellen, 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:

  1. Löschen Sie alle Zeilen in der Placement-Tabelle.
  2. Warten Sie, bis die version_retention_period für die Datenbank abgeschlossen ist. Weitere Informationen finden Sie unter Wiederherstellung zu einem bestimmten Zeitpunkt. Führen Sie dann die folgenden Schritte aus:

Console

  1. Klicken Sie im Navigationsmenü auf Spanner Studio.
  2. Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder verwenden Sie den leeren Editor-Tab.
  3. 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

  1. Klicken Sie im Navigationsmenü auf Spanner Studio.
  2. Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder verwenden Sie den leeren Editor-Tab.
  3. Geben Sie die DDL-Anweisung INSERT INTO (GoogleSQL, PostgreSQL) ein.

    Fügen Sie beispielsweise den Sänger Marc Richards zur Tabelle Singers hinzu und partitionieren Sie ihn in europeplacement:

    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

  1. Klicken Sie im Navigationsmenü auf Spanner Studio.
  2. Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder verwenden Sie den leeren Editor-Tab.
  3. Verwenden Sie DML oder Mutationen, um Daten in einer Platzierungstabelle zu aktualisieren.

    Aktualisieren Sie beispielsweise den Namen von singerid=1 in der Tabelle Singers auf Catalina 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

  1. Erstellen Sie eine neue Instanzpartition und -platzierung, falls Sie das noch nicht getan haben.
  2. Klicken Sie im Navigationsmenü auf Spanner Studio.
  3. Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder verwenden Sie den leeren Editor-Tab.
  4. Verwenden Sie DML oder Mutationen, um Daten in die neue Instanzpartition zu verschieben.

    Verschieben Sie beispielsweise singerid=1 in der Tabelle Singers nach asiaplacement:

    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

  1. Klicken Sie im Navigationsmenü auf Spanner Studio.
  2. Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder verwenden Sie den leeren Editor-Tab.
  3. Verwenden Sie DML oder Mutationen, um Daten zu löschen.

    Löschen Sie beispielsweise singerid=1 in der Tabelle Singers:

    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

  1. Klicken Sie im Navigationsmenü auf Spanner Studio.
  2. Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder verwenden Sie den leeren Editor-Tab.
  3. Führen Sie die Abfrage aus.

    Fragen Sie beispielsweise die Tabelle Singers ab:

    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'

Nächste Schritte