Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Tambahkan Wilayah AWS ke ruang kunci di Amazon Keyspaces
<a name="keyspaces-multi-region-add-replica"></a>

Anda dapat menambahkan yang baru Wilayah AWS ke ruang kunci yang merupakan ruang kunci tunggal atau Multi-wilayah. Region replika baru diterapkan ke semua tabel di keyspace. 

Untuk mengubah wilayah Tunggal menjadi ruang kunci Multi-wilayah, Anda harus mengaktifkan stempel waktu sisi klien untuk semua tabel di ruang kunci. Untuk informasi selengkapnya, lihat [Stempel waktu sisi klien di Amazon Keyspaces](client-side-timestamps.md).

Jika Anda menambahkan Wilayah tambahan ke ruang kunci Multi-wilayah, Amazon Keyspaces harus mereplikasi tabel yang ada ke Wilayah baru menggunakan pemulihan Lintas wilayah satu kali untuk setiap tabel yang ada. Biaya pemulihan untuk setiap tabel ditagih per GB, untuk informasi selengkapnya lihat [Backup dan restore](https://aws.amazon.com/keyspaces/pricing/#:~:text=per%20GB-month-,Restoring%20a%20table,-Restoring%20a%20table) di halaman harga Amazon Keyspaces (untuk Apache Cassandra). Tidak ada biaya untuk transfer data di seluruh Wilayah untuk operasi pemulihan ini. Selain data, semua properti tabel dengan pengecualian tag akan direplikasi ke Wilayah baru.

Anda dapat menggunakan `ALTER KEYSPACE` pernyataan di CQL, `update-keyspace` perintah dengan AWS CLI, atau konsol untuk menambahkan Wilayah baru ke satu atau ke ruang kunci Multi-wilayah di Amazon Keyspaces. Untuk menjalankan pernyataan dengan sukses, akun yang Anda gunakan harus berada di salah satu Wilayah di mana ruang kunci sudah tersedia. Saat replika ditambahkan, Anda tidak dapat melakukan operasi bahasa definisi data (DDL) lainnya pada sumber daya yang sedang diperbarui dan direplikasi.

Untuk informasi selengkapnya tentang izin yang diperlukan untuk menambahkan Wilayah, lihat[Konfigurasikan izin IAM yang diperlukan untuk menambahkan ke ruang Wilayah AWS kunci](howitworks_replication_permissions_addReplica.md).

**catatan**  
Saat menambahkan Wilayah tambahan ke ruang kunci Wilayah Tunggal, Amazon Keyspaces membuat peran terkait layanan dengan nama di akun Anda. `AWSServiceRoleForAmazonKeyspacesReplication` Peran ini memungkinkan Amazon Keyspaces untuk mereplikasi tabel ke Wilayah baru dan mereplikasi penulisan dari satu tabel ke semua replika tabel Multi-wilayah atas nama Anda. Untuk mempelajari selengkapnya, lihat [Menggunakan peran untuk Replikasi Multi-Region Amazon Keyspaces](using-service-linked-roles-multi-region-replication.md).

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

Ikuti langkah-langkah berikut untuk menambahkan Wilayah ke ruang kunci menggunakan konsol Amazon Keyspaces.

**Menambahkan Region ke keyspace (konsol)**

1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon Keyspaces di https://console.aws.amazon.com/keyspaces/ rumah.](https://console.aws.amazon.com/keyspaces/home)

1. Di panel navigasi, pilih **Keyspaces**, lalu pilih keyspace dari daftar.

1. Pilih **Wilayah AWS**tab.

1. Pada **Wilayah AWS**tab, pilih **Tambah Wilayah**.

1. Dalam dialog **Add Region**, pilih Region tambahan yang ingin Anda tambahkan ke keyspace.

1. Untuk menyelesaikannya, pilih **Tambah**.

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

**Menambahkan Region ke keyspace menggunakan CQL**
+ Untuk menambahkan Region baru ke keyspace, Anda dapat menggunakan pernyataan berikut. Dalam contoh ini, ruang kunci sudah tersedia di Wilayah AS Timur (Virginia N.) dan Wilayah Wilayah Barat (Oregon) AS, dan pernyataan CQL menambahkan Wilayah AS Barat (California N.). 

  ```
  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 ]

**Menambahkan Region ke keyspace menggunakan AWS CLI**
+ Untuk menambahkan Region baru ke keyspace menggunakan CLI, Anda dapat menggunakan contoh berikut. Perhatikan bahwa nilai default untuk `client-side-timestamps` adalah `DISABLED`. Dengan `update-keyspace` perintah, Anda harus mengubah nilainya menjadi`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"}'
  ```

------