Daten-Placements erstellen und verwalten

Vorschau — Geo-partitioning

Diese Funktion unterliegt den „Nutzungsbedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Nutzungsbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Funktionen sind „wie besehen“ verfügbar und werden möglicherweise nur eingeschränkt unterstützt. Weitere Informationen finden Sie in den Beschreibungen der Startphase.

Hinweis zur PostgreSQL-Schnittstelle: Die Vorabversion der Geopartitionierung unterstützt nicht den PostgreSQL-Schnittstelle für Spanner.

Auf dieser Seite wird beschrieben, wie Sie Datenplatzierungen in Spanner erstellen und verwalten.

Weitere Informationen zur Funktionsweise der Geopartitionierung finden Sie in der Geo-Partitionierung – Übersicht

Daten-Placement erstellen

Nachdem Sie Ihre Spanner-Partitionen erstellt haben und Datenbanken, erstellen Sie Ihr Placement.

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

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

4. Klicken Sie im Navigationsmenü auf Spanner Studio.

5. Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder leeres Feld Editor-Tab.

6. Geben Sie die DDL-Anweisung CREATE PLACEMENT ein.

   Sie können beispielsweise den folgenden Befehl ausführen, um eine Placement-Tabelle zu erstellen. europeplacement in der Partition europe-partition:

     CREATE PLACEMENT `europeplacement` OPTIONS(instance_partitions="europe-partition");
   

   Optional: Im Bereich Objekt-Explorer können Sie Daten und mit Ihren Placement-Objekten interagieren. Weitere Informationen finden Sie unter Daten auswerten

7. Klicken Sie auf Ausführen.

gcloud

Um ein Placement mit dem gcloud CLI-Befehl zu erstellen, verwenden Sie gcloud spanner databases ddl update.

Erstellen Sie beispielsweise eine Platzierung in der Partition europe-partition:

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="CREATE PLACEMENT europeplacement OPTIONS (instance_partition='europe-partition')"

Daten-Placement löschen

Sie können ein Placement nicht löschen. Sie müssen die Datenbank löschen, um den das Placement und die zugehörigen Daten. Weitere Informationen finden Sie unter Datenbank löschen

Tabelle mit einem Placement-Schlüssel erstellen

Console

1. Klicken Sie im Navigationsmenü auf Spanner Studio.
2. Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder leeres Feld Editor-Tab.

3. Geben Sie die DDL-Anweisung CREATE TABLE ein.

   Sie können beispielsweise eine Singers-Tabelle erstellen, die Placement-Schlüssel zum Partitionieren von Sängerdaten:

   CREATE TABLE Singers (
     SingerId INT64 NOT NULL,
     Name STRING(MAX) NOT NULL,
     ...
     Location STRING(MAX) NOT NULL PLACEMENT KEY
   ) PRIMARY KEY (SingerId);
   

gcloud

Verwenden Sie zum Erstellen einer Tabelle gcloud spanner databases ddl update.

Sie können beispielsweise eine Singers-Tabelle erstellen, die Placement-Schlüssel zum Partitionieren von Sängerdaten:

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)"

Tabelle mit einem Placement-Schlüssel bearbeiten

Ein Placement-Schlüssel kann nicht aus einer Tabelle gelöscht werden. Sie können auch keinen Placement-Schlüssel hinzufügen. in eine Tabelle einfügen. Sie können jedoch das ALTER TABLE DDL-Anweisung, um andere Felder im zum Beispiel durch Hinzufügen und Löschen von Nicht-Placement-Schlüsselspalten.

Tabelle mit einem Placement-Schlüssel löschen

Bevor Sie eine Tabelle mit einem Placement-Schlüssel löschen, müssen Sie Folgendes tun:

1. Löschen Sie alle Zeilen in der Placement-Tabelle.
2. Warten Sie, bis der version_retention_period für den zu übergeben. Weitere Informationen finden Sie unter Wiederherstellung zu einem bestimmten Zeitpunkt. Führen Sie anschließend folgende Schritte aus:

Console

1. Klicken Sie im Navigationsmenü auf Spanner Studio.
2. Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder leeres Feld Editor-Tab.

3. Geben Sie die DDL-Anweisung DROP TABLE ein.

   Löschen Sie beispielsweise die Tabelle Singers:

   DROP TABLE Singers;
   

gcloud

Verwenden Sie zum Löschen einer Tabelle gcloud spanner databases ddl update.

Löschen Sie beispielsweise die Tabelle Singers:

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="DROP TABLE Singers"

Zeile in eine Placement-Tabelle einfügen

Console

1. Klicken Sie im Navigationsmenü auf Spanner Studio.
2. Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder leeres Feld Editor-Tab.

3. Geben Sie die DDL-Anweisung INSERT INTO ein.

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

     INSERT INTO Singers(SingerId, Name, Location)
     VALUES (1, 'Marc Richards', 'europeplacement')
   

gcloud

Um Daten in eine Tabelle zu schreiben, verwenden Sie gcloud spanner rows insert.

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

gcloud spanner rows insert --table=Singers --database=example-db \
  --instance=test-instance --data=SingerId=1,SingerName='Marc Richards',Location='europeplacement'

Zeilen in einer Placement-Tabelle aktualisieren

Console

1. Klicken Sie im Navigationsmenü auf Spanner Studio.
2. Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder leeres Feld Editor-Tab.

3. Verwenden Sie DML oder Mutationen, um Daten in einem Placement-Tabelle.

   Ändern Sie beispielsweise den Namen von singerid=1 in der Tabelle Singers zu Catalina Smith:

   UPDATE Singers s
   SET s.name='Catalina Smith'
   WHERE s.id=1;
   

gcloud

Um Daten in einer Placement-Tabelle zu aktualisieren, Verwenden Sie gcloud spanner rows update.

Ändern Sie beispielsweise den Namen von singerid=1 in der Tabelle Singers zu Catalina Smith:

gcloud spanner rows update --table=Singers --database=example-db \
  --instance=test-instance --data=SingerId=1,SingerName='Catalina Smith'

Zeilen in einer Placement-Tabelle verschieben

Console

1. Erstellen Sie eine neue Partition und ein neues Placement, falls Sie dies noch nicht getan haben.
2. Klicken Sie im Navigationsmenü auf Spanner Studio.
3. Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder leeres Feld Editor-Tab.

4. Verschieben Sie Daten mithilfe von DML oder Mutationen in den neuen Partition an.

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

   UPDATE Singers s
   SET s.location='asiaplacement'
   WHERE s.id=1;
   

gcloud

Nachdem Sie die Partition und das Placement erstellt haben, in das Sie Ihre Daten verschieben möchten, Verwenden Sie gcloud spanner rows update.

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

gcloud spanner rows update --table=Singers --database=example-db \
  --instance=test-instance --data=SingerId=1,Location='asiaplacement'

Zeilen in einer Placement-Tabelle löschen

Console

1. Klicken Sie im Navigationsmenü auf Spanner Studio.
2. Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder leeres Feld 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

Wenn Sie Daten löschen möchten, verwenden Sie 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 Placement-Tabelle abfragen

Console

1. Klicken Sie im Navigationsmenü auf Spanner Studio.
2. Klicken Sie auf der Seite Spanner Studio auf Neuer Tab oder leeres Feld 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 \
  --sql='SELECT * FROM Singers s WHERE s.SingerId=1'

Nächste Schritte

• Weitere Informationen zur Geopartitionierung

• Partitionen erstellen und verwalten