建立及管理資料刊登位置

本頁面說明如何在 Spanner 建立及管理資料位置。

如要進一步瞭解地理區域分區的運作方式,請參閱「地理區域分區總覽」。

管理轉送中繼資料

當應用程式需要讀取或寫入資料時,Spanner 會使用轉送中繼資料,找出哪些伺服器含有所需的特定資料列。

選擇轉送中繼資料的存放位置時,取決於大多數用戶端要求是針對同一區域內或區域外的資料,以及是否使用多區域設定。轉送中繼資料設定會影響延遲時間,且建立刊登位置後即無法變更。

per_placement_routing_metadata 選項會根據下列設定,決定轉送中繼資料的存放位置:

  • TRUE:如果設為 TRUE,轉送中繼資料會與資料位於同一個執行個體分區。路由中繼資料會依區域進行 shard。這可減少區域內資料要求的延遲時間 (即用戶端和要求的資料位於相同區域),因此 Spanner 不必對區域外發出呼叫來轉送中繼資料。不過,這項設定可能會增加區域外要求的延遲時間、不存在刊登位置資料列的負面查詢,以及需要全域索引的查詢。

    如果預期大多數要求都是針對與用戶端位於同一區域的使用者資料,且預設分區沒有與所有執行個體分區位於同一位置的讀寫或唯讀區域,建議您採用這項設定。

  • FALSE:路由中繼資料會集中在預設分區。

    如果您預期用戶端會經常隨手查區域外資料,建議採用這項設定。例如,歐盟區域的用戶端隨手查美國使用者的資料。

    如果預設執行個體分區採用多區域設定,且該設定提供的讀寫或唯讀區域與所有執行個體分區位於相同位置,也建議您使用這項設定。採用這項設定時,系統會將完整轉送中繼資料的副本,與預設執行個體分區的每個副本一併儲存。因此,所有具有執行個體分區的區域,都會有轉送中繼資料的副本。這樣一來,區域內和區域外的要求都能在本機查詢轉送中繼資料。

設定 per_placement_routing_metadata 選項

per_placement_routing_metadata 選項接受布林值。如果這個選項為 TRUE,則轉送中繼資料會與資料位於相同的執行個體分區。如果 FALSE,則轉送中繼資料會位於預設執行個體分區。

如要設定 per_placement_routing_metadata 選項,請更新資料庫結構定義。如要瞭解更新結構定義的其他方式,例如用戶端程式庫或 REST 和 RPC API,請參閱「更新結構定義」。

選取下列選項之一:

控制台

  1. 前往 Google Cloud 控制台的「Instances」(執行個體) 頁面。

    前往「Instances」(執行個體) 頁面

  2. 選取含有使用者建立執行個體分區的執行個體。

  3. 選取要設定轉送中繼資料的資料庫。

  4. 在導覽選單中,點選「Spanner Studio」。

  5. 在「Spanner Studio」頁面中,按一下 「New tab」(新增分頁),或使用空白的編輯器分頁。

  6. 輸入 ALTER DATABASE (GoogleSQL, PostgreSQL) DDL 語句:

    GoogleSQL

    ALTER DATABASE `DATABASE_NAME`
      SET OPTIONS (per_placement_routing_metadata = METADATA_BOOLEAN);
    

    更改下列內容:

    • DATABASE_NAME:資料庫名稱。
    • METADATA_BOOLEAN:per_placement_routing_metadata 的值。如果 TRUE,則轉送中繼資料會與資料位於相同的執行個體分區。如果為 FALSE,轉送中繼資料會位於預設執行個體分區。

    PostgreSQL

    ALTER DATABASE "DATABASE_NAME"
      SET spanner.per_placement_routing_metadata = METADATA_BOOLEAN;
    

    更改下列內容:

    • DATABASE_NAME:資料庫名稱。
    • METADATA_BOOLEAN:per_placement_routing_metadata 的值。如果 TRUE,則轉送中繼資料會與資料位於相同的執行個體分區。如果為 FALSE,轉送中繼資料會位於預設執行個體分區。
  7. 按一下「執行」。

gcloud

如要使用 Google Cloud CLI 設定 per_placement_routing_metadata 選項,請使用 gcloud spanner databases ddl update:

GoogleSQL

gcloud spanner databases ddl update DATABASE_NAME \
    --instance=INSTANCE_ID \
    --ddl='ALTER DATABASE `DATABASE_NAME`
      SET OPTIONS (per_placement_routing_metadata = METADATA_BOOLEAN)'

更改下列內容:

  • DATABASE_NAME:資料庫名稱。
  • INSTANCE_ID:Spanner 執行個體的 ID。
  • METADATA_BOOLEAN:per_placement_routing_metadata 的值。如果 TRUE,則轉送中繼資料會與資料位於相同的執行個體分區。如果為 FALSE,轉送中繼資料會位於預設執行個體分區。

PostgreSQL

gcloud spanner databases ddl update DATABASE_NAME \
    --instance=INSTANCE_ID \
    --ddl='ALTER DATABASE "DATABASE_NAME"
      SET spanner.per_placement_routing_metadata = METADATA_BOOLEAN'

更改下列內容:

  • DATABASE_NAME:資料庫名稱。
  • INSTANCE_ID:Spanner 執行個體的 ID。
  • METADATA_BOOLEAN:per_placement_routing_metadata 的值。如果 TRUE,則轉送中繼資料會與資料位於相同的執行個體分區。如果為 FALSE,轉送中繼資料會位於預設執行個體分區。

建立資料放置

建立 Spanner 執行個體分區和資料庫,並設定 per_placement_routing_metadata 選項後,即可建立位置。

控制台

  1. 前往 Google Cloud 控制台的「Instances」(執行個體) 頁面。

    執行個體

  2. 選取含有使用者建立執行個體分區的執行個體。

  3. 選取要分區資料的資料庫。

  4. 在導覽選單中,點選「Spanner Studio」。

  5. 在「Spanner Studio」頁面中,按一下 「New tab」(新增分頁),或使用空白的編輯器分頁。

  6. 輸入 CREATE PLACEMENT (GoogleSQL、PostgreSQL) DDL 陳述式。

    例如,您可以執行下列指令,在執行個體分區 europe-partition 中建立配置表 europeplacement:

    GoogleSQL

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

    PostgreSQL

    CREATE PLACEMENT europeplacement WITH (instance_partition='europe-partition');
    

    選用:您也可以使用「Object Explorer」窗格,查看、搜尋及操作刊登位置物件。詳情請參閱「探索資料」。

  7. 按一下「執行」。

gcloud

如要使用 gcloud CLI 指令建立配置,請使用 gcloud spanner databases ddl update。

舉例來說,在執行個體分區 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')"

設定刊登位置的預設主要廣告

如果刊登位置位於多區域,您可以設定預設主要區域。新的領導者區域必須是多區域位置中的兩個讀寫區域之一。詳情請參閱多區域可用設定表格。

如未設定主要區域,刊登位置會使用其位置指定的預設主要區域。如需各多區域位置的主要區域清單,請參閱「多區域可用設定」表格。預設主要區域會以 L 表示。舉例來說,nam8 的預設領導者區域位於洛杉磯 (us-west2)。以下操作說明將介紹如何將其設為奧勒岡州 (us-west1)。

控制台

  1. 前往 Google Cloud 控制台的「Instances」(執行個體) 頁面。

    執行個體

  2. 選取含有使用者建立執行個體分區的執行個體。

  3. 選取要分區資料的資料庫。

  4. 在導覽選單中,點選「Spanner Studio」。

  5. 在「Spanner Studio」頁面中,按一下 「New tab」(新增分頁),或使用空白的編輯器分頁。

  6. 輸入 CREATE PLACEMENT (GoogleSQL、PostgreSQL) DDL 陳述式。

    舉例來說,您可以執行下列指令,在執行個體分區 nam8-partition 中建立配置資料表 nam8placement,並將預設領導者位置設為 us-west1:

    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');
    

    選用:您也可以使用「Object Explorer」窗格,查看、搜尋及操作刊登位置物件。詳情請參閱「探索資料」。

  7. 按一下「執行」。

gcloud

如要使用 gcloud CLI 指令建立配置,請使用 gcloud spanner databases ddl update。

舉例來說,在執行個體分區 nam8-partition 中建立刊登位置資料表 nam8placement,並將預設主要備用資源位置設為 us-west1:

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

捨棄資料配置

您必須先移除刊登位置中的所有資料列,才能捨棄刊登位置。完成後,您可以使用 Google Cloud 控制台或 gcloud CLI 捨棄配置。

控制台

  1. 在導覽選單中,點選「Spanner Studio」。
  2. 在「Spanner Studio」頁面中,按一下 「New tab」(新增分頁),或使用空白的編輯器分頁。
  3. 輸入 DROP PLACEMENT(GoogleSQL、PostgreSQL) DDL 陳述式。

    例如,您可以執行下列指令,捨棄刊登位置資料表 europeplacement:

    GoogleSQL

    DROP PLACEMENT europeplacement;
    

    PostgreSQL

    DROP PLACEMENT europeplacement;
    

gcloud

如要使用 gcloud CLI 指令捨棄配置,請使用 gcloud spanner databases ddl update。

例如,刪除刊登位置 europeplacement:

gcloud spanner databases ddl update example-db \
  --instance=test-instance \
  --ddl="DROP PLACEMENT europeplacement"

放置錯誤

如果刊登位置正在使用中,DROP PLACEMENT 作業會失敗,並顯示類似以下的 錯誤訊息:「Statement failed: Placement PLACEMENT_NAME can't be dropped because it is in use by placement table PLACEMENT_TABLE_NAME.」(陳述式失敗:刊登位置 正在由刊登位置資料表 使用,因此無法捨棄)。如果遇到 這項錯誤,請完成下列步驟:

  1. 修改應用程式,停止插入或更新含有要捨棄位置的資料列。
  2. 以下任一項:

    • 使用分區 DML 陳述式,將使用要刪除位置的現有位置資料列,移至其他位置,如下所示:

      UPDATE PLACEMENT_TABLE_NAME SET LOCATION = NEW_PLACEMENT_NAME
      WHERE LOCATION = ORIGINAL_PLACEMENT_NAME;
      
    • 使用分區 DML 陳述式刪除刊登位置資料列,如下所示:

      DELETE FROM PLACEMENT_TABLE_NAME
      WHERE LOCATION = ORIGINAL_PLACEMENT_NAME;
      

      上述特定分區 DML 陳述式僅適用於分區 DML。這類陳述式會像一般 DML 陳述式一樣失敗。詳情請參閱「限制」一節。您也可以使用 Mutation API 移動或捨棄刊登位置資料列。

取消 DROP PLACEMENT 作業

在長時間執行的作業從資料庫結構定義中完全刪除刊登位置之前,您隨時可以取消 DROP PLACEMENT 作業。如要瞭解如何取得長時間執行的作業 ID,以便查看狀態或取消作業,請參閱「管理及觀測長時間執行的作業」。

建立含有刊登位置索引鍵的資料表

控制台

  1. 在導覽選單中,點選「Spanner Studio」。
  2. 在「Spanner Studio」頁面中,按一下 「New tab」(新增分頁),或使用空白的編輯器分頁。
  3. 輸入 CREATE TABLE (GoogleSQL、PostgreSQL) DDL 陳述式。

    舉例來說,您可以建立使用放置鍵來分區歌手資料的 Singers 資料表:

    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

如要建立表格,請使用 gcloud spanner databases ddl update。

舉例來說,您可以建立使用放置鍵來分區歌手資料的 Singers 資料表:

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

使用刊登位置鍵編輯表格

您無法從資料表捨棄刊登位置索引鍵。資料表建立後,也無法新增配置索引鍵。不過,您可以使用 ALTER TABLE (GoogleSQL、PostgreSQL) DDL 陳述式變更資料表中的其他欄位,例如新增及捨棄非放置金鑰欄。

使用位置索引鍵刪除資料表

刪除含有刊登位置鍵的表格前,請先完成下列事項:

  1. 刪除刊登位置表格中的所有資料列。
  2. 等待資料庫的 version_retention_period 通過。詳情請參閱「時間點復原」。 然後按照下列步驟操作:

控制台

  1. 在導覽選單中,點選「Spanner Studio」。
  2. 在「Spanner Studio」頁面中,按一下 「New tab」(新增分頁),或使用空白的編輯器分頁。
  3. 輸入 DROP TABLE (GoogleSQL、PostgreSQL) DDL 陳述式。

    例如,捨棄 Singers 資料表:

    DROP TABLE Singers;
    

gcloud

如要捨棄資料表,請使用 gcloud spanner databases ddl update。

例如,捨棄 Singers 資料表:

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

在刊登位置表格中插入一列

控制台

  1. 在導覽選單中,點選「Spanner Studio」。
  2. 在「Spanner Studio」頁面中,按一下 「New tab」(新增分頁),或使用空白的編輯器分頁。
  3. 輸入 INSERT INTO (GoogleSQL、PostgreSQL) DDL 陳述式。

    例如,將歌手 Marc Richards 新增至 Singers 資料表,並在 europeplacement 中進行分區:

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

gcloud

如要將資料寫入資料表,請使用 gcloud spanner rows insert。

例如,將歌手 Marc Richards 新增至 Singers 資料表,並在 europeplacement 中進行分區:

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

更新刊登位置表格中的資料列

控制台

  1. 在導覽選單中,點選「Spanner Studio」。
  2. 在「Spanner Studio」頁面中,按一下 「New tab」(新增分頁),或使用空白的編輯器分頁。
  3. 使用 DML 或異動更新刊登位置資料表中的資料。

    例如,將 Singers 資料表中的 singerid=1 名稱更新為 Catalina Smith:

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

gcloud

如要更新刊登位置表格中的資料,請使用 gcloud spanner rows update。

例如,將 Singers 資料表中的 singerid=1 名稱更新為 Catalina Smith:

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

移動刊登位置表格中的資料列

控制台

  1. 如果尚未建立新的執行個體分區和配置,請先建立。
  2. 在導覽選單中,點選「Spanner Studio」。
  3. 在「Spanner Studio」頁面中,按一下 「New tab」(新增分頁),或使用空白的編輯器分頁。
  4. 使用 DML 或異動,將資料移至新的執行個體分區。

    例如,將 Singers 資料表中的 singerid=1 移至 asiaplacement:

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

gcloud

建立執行個體分區和要移動資料的位置後,請使用 gcloud spanner rows update。

例如,將 Singers 資料表中的 singerid=1 移至 asiaplacement:

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

刪除刊登位置表格中的資料列

控制台

  1. 在導覽選單中,點選「Spanner Studio」。
  2. 在「Spanner Studio」頁面中,按一下 「New tab」(新增分頁),或使用空白的編輯器分頁。
  3. 使用 DML 或異動刪除資料。

    例如,刪除 Singers 資料表中的 singerid=1:

    DELETE FROM Singers s
    WHERE s.id=1;
    

gcloud

如要刪除資料,請使用 gcloud spanner rows delete。

例如,刪除 Singers 資料表中的 singerid=1:

gcloud spanner rows delete --table=Singers --database=example-db \
  --instance=test-instance --keys=1

查詢刊登位置資料表中的資料

控制台

  1. 在導覽選單中,點選「Spanner Studio」。
  2. 在「Spanner Studio」頁面中,按一下 「New tab」(新增分頁),或使用空白的編輯器分頁。
  3. 執行查詢。

    例如,查詢 Singers 資料表:

    SELECT * FROM Singers s WHERE s.SingerId=1;
    

gcloud

如要查詢資料,請使用 gcloud spanner databases execute-sql。

例如,查詢 Singers 資料表:

gcloud spanner databases execute-sql example-db \
  --instance=test-instance \
  --sql='SELECT * FROM Singers s WHERE s.SingerId=1'

後續步驟