本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 將 AWS 區域 新增至 Amazon Keyspaces 中的金鑰空間
<a name="keyspaces-multi-region-add-replica"></a>

您可以將新的 AWS 區域 新增至單一或多區域金鑰空間的金鑰空間。新的複本區域會套用至金鑰空間中的所有資料表。

若要將單一區域變更為多區域金鑰空間，您必須為金鑰空間中的所有資料表啟用用戶端時間戳記。如需詳細資訊，請參閱[Amazon Keyspaces 中的用戶端時間戳記](client-side-timestamps.md)。

如果您要將其他區域新增至多區域金鑰空間，Amazon Keyspaces 必須使用每個現有資料表的一次性跨區域還原，將現有資料表複寫至新區域。每個資料表的還原費用按 GB 計費，如需詳細資訊，請參閱 Amazon Keyspaces （適用於 Apache Cassandra) 定價頁面上的[備份和還原](https://aws.amazon.com/keyspaces/pricing/#:~:text=per%20GB-month-,Restoring%20a%20table,-Restoring%20a%20table)。針對此還原操作，跨區域傳輸資料無需付費。除了資料之外，除了標籤之外的所有資料表屬性都會複寫到新的區域。

您可以在 CQL、 `update-keyspace`命令與 AWS CLI或 主控台中使用 `ALTER KEYSPACE`陳述式，將新區域新增至 Amazon Keyspaces 中的單一或多區域金鑰空間。若要成功執行 陳述式，您使用的帳戶必須位於已提供 金鑰空間的其中一個區域中。正在新增複本時，您無法對正在更新和複寫的資源執行任何其他資料定義語言 (DDL) 操作。

如需新增區域所需許可的詳細資訊，請參閱 [設定將 新增至金鑰空間所需的 IAM AWS 區域 許可](howitworks_replication_permissions_addReplica.md)。

**注意**  
將其他區域新增至單一區域金鑰空間時，Amazon Keyspaces 會使用`AWSServiceRoleForAmazonKeyspacesReplication`您帳戶中的名稱建立服務連結角色。此角色允許 Amazon Keyspaces 將資料表複寫至新區域，並代表您將寫入從一個資料表複寫至多區域資料表的所有複本。如需詳細資訊，請參閱 [使用 Amazon Keyspaces 多區域複寫的角色](using-service-linked-roles-multi-region-replication.md)。

------
#### [ Console ]

請依照下列步驟，使用 Amazon Keyspaces 主控台將區域新增至金鑰空間。

**將區域新增至金鑰空間 （主控台）**

1. 登入 AWS 管理主控台，並在 https：//[https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) 開啟 Amazon Keyspaces 主控台。

1. 在導覽窗格中，選擇**金鑰空間**，然後從清單中選擇金鑰空間。

1. 選擇 ** (AWS 區域)** 索引標籤。

1. 在**AWS 區域**索引標籤上，選擇**新增區域**。

1. 在**新增區域**對話方塊中，選擇您要新增至金鑰空間的其他區域。

1. 若要完成，請選擇**新增**。

------
#### [ Cassandra Query Language (CQL) ]

**使用 CQL 將區域新增至金鑰空間**
+ 若要將新區域新增至金鑰空間，您可以使用下列陳述式。在此範例中，美國東部 （維吉尼亞北部） 區域和美國西部 （奧勒岡） 區域已提供 金鑰空間，而 CQL 陳述式正在新增美國西部 （加利佛尼亞北部） 區域。

  ```
  ALTER KEYSPACE my_keyspace
  WITH REPLICATION = {
      'class': 'NetworkTopologyStrategy',
      'us-east-1': '3',
      'us-west-2': '3',
      'us-west-1': '3'
  } AND CLIENT_SIDE_TIMESTAMPS = {'status': 'ENABLED'};
  ```

------
#### [ CLI ]

**使用 將區域新增至金鑰空間 AWS CLI**
+ 若要使用 CLI 將新區域新增至金鑰空間，您可以使用下列範例。請注意，`client-side-timestamps` 預設值為 `DISABLED`。使用 `update-keyspace`命令，您必須將值變更為 `ENABLED`。

  ```
  aws keyspaces update-keyspace \
  --keyspace-name my_keyspace \
  --replication-specification '{"replicationStrategy": "MULTI_REGION", "regionList": ["us-east-1", "eu-west-1", "eu-west-3"] }' \
  --client-side-timestamps '{"status": "ENABLED"}'
  ```

------