翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon Keyspaces のマルチリージョンレプリケーション (Apache Cassandra 用）
Amazon Keyspaces マルチリージョンレプリケーションを使用して、選択した 全体で自動、フルマネージド、*アクティブ/アクティブ*レプリケーションを使用してデータをレプリケート AWS リージョン できます。アクティブ-アクティブレプリケーションでは、各リージョンが個別に読み取りと書き込みを行うことができます。リージョンレベルでパフォーマンスが低下した場合に可用性と回復力の両方を復旧でき、グローバルアプリケーションの場合はローカルでの低レイテンシーの読み取りと書き込みというメリットもあります。
マルチリージョンレプリケーションでは、Amazon Keyspaces はリージョン間でデータを非同期的にレプリケートし、通常、データは 1 秒以内にリージョン間で伝播されます。また、マルチリージョンレプリケーションでは、競合を解決し、データ分散の問題を修正するという難しい作業がなくなり、アプリケーションに集中できるようになります。
デフォルトでは、Amazon Keyspaces は耐久性と高可用性 AWS リージョン のために、同じ 内の 3 つの[アベイラビリティーゾーン](https://aws.amazon.com/about-aws/global-infrastructure/regions_az/)にデータをレプリケートします。マルチリージョンレプリケーションを使用すると、 AWS リージョン 選択したさまざまな地理的にテーブルをレプリケートするマルチリージョンキースペースを作成できます。
**Topics**
+ [マルチリージョンレプリケーションを使用する利点](#mrr-benefits)
+ [キャパシティモードと料金](#mrr-pricing)
+ [Amazon Keyspaces でのマルチリージョンレプリケーションの仕組み](multiRegion-replication_how-it-works.md)
+ [Amazon Keyspaces マルチリージョンレプリケーションの使用に関する注意事項](multiRegion-replication_usage-notes.md)
+ [Amazon Keyspaces のマルチリージョンレプリケーションを設定する (Apache Cassandra 用)](multiRegion-replication-configure.md)
## マルチリージョンレプリケーションを使用する利点
マルチリージョンレプリケーションには以下の利点があります。
+ **1 桁ミリ秒のレイテンシーでグローバルな読み取りと書き込みを実行** – Amazon Keyspaces では、レプリケーションはアクティブ-アクティブで行われます。どのような規模でも、1 桁ミリ秒のレイテンシーで、顧客に最も近いリージョンからの読み取りと書き込みの両方をローカルで処理できます。世界中のどこでも、Amazon Keyspaces のマルチリージョンテーブルは、高速な応答時間を必要とするグローバルアプリケーションに使用できます。
+ **ビジネス継続性の向上と単一リージョンの劣化からの保護** – マルチリージョンレプリケーションでは、アプリケーションをマルチリージョンキースペース内の別のリージョンにリダイレクト AWS リージョン することで、単一リージョンの劣化から回復できます。Amazon Keyspaces はアクティブ-アクティブレプリケーションを提供するため、読み取りと書き込みに影響はありません。
Amazon Keyspaces は、マルチリージョンキースペースに対して実行されても、すべてのレプリカリージョンにまだ反映されていない書き込みを追跡します。リージョンがオンラインに復帰した際に、欠落した変更があれば自動的に同期されるため、アプリケーションに影響を及ぼすことなく復旧できます。
+ **リージョン間の高速レ**プリケーション – マルチリージョンレプリケーションは、リージョン間のデータのストレージベースの高速物理レプリケーションを使用し、レプリケーションの遅延は通常 1 秒未満です。
Amazon Keyspaces でのレプリケーションは、コンピューティングリソースをアプリケーションと共有しないため、データベースクエリにほとんどまたはまったく影響がありません。そのため、アプリケーションに影響を及ぼすことなく、書き込みスループットが高いユースケースや、スループットが急増する (バースト性が高い) ユースケースに対応できます。
+ **整合性と競合の解決** – いずれかのリージョンのデータに加えられた変更は、マルチリージョンキースペース内の他のリージョンにレプリケートされます。アプリケーションが異なるリージョンにある同一データをほぼ同時に更新すると、競合が発生する可能性があります。
最終的な一貫性を保つために、Amazon Keyspaces はセルレベルのタイムスタンプを使用し、同時更新間の調整は*最後のライターが優先します*。競合の解決は全面的に管理され、アプリケーションに影響を与えることなくバックグラウンドで処理されます。
サポート対象の設定の詳細については、「[Amazon Keyspaces マルチリージョンレプリケーションの使用に関する注意事項](multiRegion-replication_usage-notes.md)」を参照してください。
## キャパシティモードと料金
マルチリージョンキースペースでは、*オンデマンドキャパシティモード*または*プロビジョンドキャパシティモード*を使用できます。詳細については、「[Amazon Keyspaces で読み取り/書き込みのキャパシティモードを設定する](ReadWriteCapacityMode.md)」を参照してください。
オンデマンドモードでは、単一リージョンテーブルの場合と同様に、行ごとに最大 1 KB のデータを書き込むように 1 つの書き込みリクエストユニット (WRU) に課金されます。ただし、マルチリージョンキースペースの各リージョンでの書き込みに対して課金されます。たとえば、2 つのリージョンを持つマルチリージョンキースペースに 3 KB のデータ行を書き込むには、3 \$1 2 = 6 WRUs 6 WRUsが必要です。さらに、静的データと非静的データの両方がある書き込みには、追加の書き込みオペレーションが必要です。
プロビジョニングモードでは、単一リージョンテーブルの場合と同様に、行ごとに最大 1 KB のデータを書き込むように 1 つの書き込みキャパシティーユニット (WCU) に課金されます。ただし、マルチリージョンキースペースの各リージョンでの書き込みに対して課金されます。たとえば、2 つのリージョンを持つマルチリージョンキースペースで 1 秒あたり 3 KB のデータ行を書き込むには、3 x 2 = 6 WCUs 6 WCUsが必要です。さらに、静的データと非静的データの両方がある書き込みには、追加の書き込みオペレーションが必要です。
料金の詳細については、「[Amazon Keyspaces (for Apache Cassandra) pricing (Amazon Keyspaces (Apache Cassandra 向け) の料金)](https://aws.amazon.com/keyspaces/pricing)」を参照してください。
# Amazon Keyspaces でのマルチリージョンレプリケーションの仕組み
このセクションでは、Amazon Keyspaces マルチリージョンレプリケーションの仕組みの概要を説明します。料金の詳細については、「[Amazon Keyspaces (for Apache Cassandra) pricing (Amazon Keyspaces (Apache Cassandra 向け) の料金)](https://aws.amazon.com/keyspaces/pricing)」を参照してください。
**Topics**
+ [Amazon Keyspaces でのマルチリージョンレプリケーションの仕組み](#multiRegion-replication_how-it-works-overview)
+ [マルチリージョンレプリケーションの競合の解決](#multiRegion-replication_how-it-works-conflict-resolution)
+ [マルチリージョンレプリケーションディザスタリカバリ](#howitworks_disaster_recovery)
+ [のマルチリージョンレプリケーションはデフォルトで AWS リージョン 無効になっています](#howitworks_mrr_opt_in)
+ [マルチリージョンレプリケーションとpoint-in-timeリカバリ (PITR) との統合](#howitworks_mrr_pitr)
+ [マルチリージョンレプリケーションと AWS サービスとの統合](#howitworks_integration)
## Amazon Keyspaces でのマルチリージョンレプリケーションの仕組み
Amazon Keyspaces マルチリージョンレプリケーションは、独立した地理的分散型にデータを分散するデータ耐障害性アーキテクチャを実装します AWS リージョン。*アクティブ-アクティブレプリケーション*を使用しているため、ローカルで低レイテンシーを実現し、各リージョンが個別に読み取りと書き込みを実行できます。
Amazon Keyspaces マルチリージョンキースペースを作成するときに、データがレプリケートされる追加のリージョンを選択できます。マルチリージョンのキー空間に作成するテーブルは、Amazon Keyspaces に 1 つの単位と認識される複数のレプリカテーブル (リージョンごとに 1 つ) で構成されます。
すべてのレプリカは、同じテーブル名と同じプライマリキーのスキーマを持っています。アプリケーションによって 1 つのリージョンのローカルテーブルにデータが書き込まれると、データはその `LOCAL_QUORUM` 整合性レベルを使用して永続的に書き込まれます。Amazon Keyspaces は、データを他のレプリケーションリージョンに自動的に非同期で複製します。リージョン間のレプリケーション遅延は通常 1 秒未満なので、アプリケーションのパフォーマンスやスループットには影響はありません。
データが書き込まれると、`LOCAL_ONE/LOCAL_QUORUM` 整合性レベルが設定された別のレプリケーションリージョンのマルチリージョンテーブルからデータを読み取ることができます。サポートされる設定の詳細については、「[Amazon Keyspaces マルチリージョンレプリケーションの使用に関する注意事項](multiRegion-replication_usage-notes.md)」をご参照ください。
![\[ユーザーは Amazon Keyspaces テーブルに保存されているデータをそれぞれのローカルで読み書きしています AWS リージョン が、Amazon Keyspaces は使用可能なすべてのリージョンのテーブル間で書き込みを非同期的にレプリケートします。\]](http://docs.aws.amazon.com/ja_jp/keyspaces/latest/devguide/images/keyspaces_multi_Region_replication.png)
## マルチリージョンレプリケーションの競合の解決
Amazon Keyspaces マルチリージョンレプリケーションはフルマネージド型であるため、データ同期の問題をクリーンアップするために定期的に修復オペレーションを実行するなど、レプリケーションタスクを実行する必要はありません。Amazon Keyspaces は、競合を検出して修復 AWS リージョン することで、異なる のテーブル間のデータ整合性を監視し、レプリカを自動的に同期します。
Amazon Keyspaces では、*最終ライターが勝者となる*方法を使用してデータ調整を行います。この競合解決メカニズムでは、マルチリージョンキー空間内のすべてのリージョンが最新の更新を受け入れ、すべてのリージョンで同一のデータが保存される状態に収束します。調整プロセスはアプリケーションのパフォーマンスには影響しません。競合解決をサポートするため、マルチリージョンテーブルではクライアント側のタイムスタンプが自動的にオンになります。オフにすることはできません。詳細については、「[Amazon Keyspaces でのクライアント側のタイムスタンプ](client-side-timestamps.md)」を参照してください。
## マルチリージョンレプリケーションディザスタリカバリ
Amazon Keyspaces マルチリージョンレプリケーションでは、書き込みは各リージョン間で非同期的にレプリケートされます。まれに単一リージョンの劣化や障害が発生した場合、マルチリージョンレプリケーションは、アプリケーションにほとんどまたはまったく影響することなく、災害から回復するのに役立ちます。ディザスターからの回復は、通常、目標復旧時間 (RTO) と目標復旧時点 (RPO) の値を使用して測定されます。
**目標復旧時間** - ディザスター後にシステムが稼働状態に戻るまでにかかる時間。RTO は、ワークロードが許容できるダウンタイムを時間単位で測定します。マルチリージョンレプリケーションを使用して影響を受けていないリージョンにフェイルオーバーするディザスタリカバリプランの場合、RTO はほぼゼロになる可能性があります。RTO は、アプリケーションが障害状態をどれだけ早く検出してトラフィックを別のリージョンにリダイレクトできるかによって制限されます。
**目標復旧時点** - 損失するおそれのあるデータの量 (時間単位)。マルチリージョンレプリケーションを使用して影響を受けていないリージョンにフェイルオーバーするディザスタリカバリプランの場合、RPO は通常 1 桁の秒です。RPO は、フェールオーバーターゲットレプリカへのレプリケーション遅延によって制限されます。
Amazon Keyspaces のレプリケーションはアクティブ-アクティブなので、リージョンの障害または機能低下が発生しても、セカンダリリージョンの昇格や、データベースのフェイルオーバー手順の実行は必要ありません。代わりに、Amazon Route 53 で、最も近くにある正常なリージョンにアプリケーションをルーティングできます。Route 53 の詳細については、「[Amazon Route 53 とは?](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/Welcome.html)」を参照してください。 。
単一の AWS リージョン が分離または低下した場合、アプリケーションは Route 53 を使用してトラフィックを別のリージョンにリダイレクトし、別のレプリカテーブルに対して読み取りと書き込みを実行できます。また、カスタムビジネスロジックを適用すれば、リクエストを他のリージョンにリダイレクトするタイミングを決定できます。一例として、使用可能な複数のエンドポイントをアプリケーションに認識させるケースが考えられます。
リージョンがオンラインに戻ると、Amazon Keyspaces はそのリージョンから他のリージョンのレプリカテーブルへの保留中の書き込みの伝播を再開します。また、他のレプリカテーブルから現在オンラインに戻っているリージョンへの書き込みの伝播も再開します。
## のマルチリージョンレプリケーションはデフォルトで AWS リージョン 無効になっています
Amazon Keyspaces マルチリージョンレプリケーションは、デフォルトで無効 AWS リージョン になっている以下の でサポートされています。
+ アフリカ (ケープタウン) リージョン
+ 中東 (アラブ首長国連邦) リージョン
+ アジアパシフィック (香港) リージョン
+ 中東 (バーレーン) リージョン
Amazon Keyspaces マルチリージョンレプリケーションでデフォルトで無効になっているリージョンを使用するには、まずリージョンを有効にする必要があります。詳細については、[https://docs.aws.amazon.com/organizations/latest/userguide/](https://docs.aws.amazon.com/organizations/latest/userguide/)」の[「アカウント AWS リージョン で を有効または無効に](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html#rande-manage-enable)する」を参照してください。
リージョンを有効にしたら、そのリージョンに新しい Amazon Keyspaces リソースを作成し、そのリージョンをマルチリージョンキースペースに追加できます。
Amazon Keyspaces マルチリージョンレプリケーションで使用されるリージョンを無効にすると、Amazon Keyspaces は 24 時間の猶予期間を開始します。この時間枠では、次の動作が期待できます。
+ Amazon Keyspaces は、有効なリージョンで引き続きデータ操作言語 (DML) オペレーションを実行します。
+ Amazon Keyspaces は、有効なリージョンから無効なリージョンへのデータ更新のレプリケーションを一時停止します。
+ Amazon Keyspaces は、無効なリージョン内のすべてのデータ定義言語 (DDL) リクエストをブロックします。
リージョンを誤って無効にした場合は、24 時間以内にリージョンを再度有効にできます。24 時間の猶予期間中にリージョンを再度有効にすると、Amazon Keyspaces は次のアクションを実行します。
+ 再有効化されたリージョンへのすべてのレプリケーションを自動的に再開します。
+ データの整合性を確保するために、リージョンが無効になっている間に有効なリージョンで発生したデータ更新をレプリケートします。
+ 追加のすべてのマルチリージョンレプリケーションオペレーションを自動的に続行します。
24 時間のウィンドウが閉じた後もリージョンが無効のままの場合、Amazon Keyspaces は次のアクションを実行して、マルチリージョンレプリケーションからリージョンを完全に削除します。
+ すべてのマルチリージョンレプリケーションキースペースから無効なリージョンを削除します。
+ 無効なリージョンのマルチリージョンレプリケーションテーブルレプリカを単一リージョンのキースペースとテーブルに変換します。
+ Amazon Keyspaces は、無効なリージョンからリソースを削除しません。
Amazon Keyspaces が無効化されたリージョンをマルチリージョンキースペースから完全に削除した後は、無効化されたリージョンを再度追加することはできません。
## マルチリージョンレプリケーションとpoint-in-timeリカバリ (PITR) との統合
Point-in-timeリカバリは、マルチリージョンテーブルでサポートされています。PITR を使用してマルチリージョンテーブルを正常に復元するには、次の条件を満たす必要があります。
+ ソーステーブルとターゲットテーブルは、マルチリージョンのテーブルとして設定します。
+ ソーステーブルのキー空間とターゲットテーブルのキー空間のレプリケーションリージョンは同じリージョンであることとします。
+ PITR は、ソーステーブルのすべてのレプリカで有効にする必要があります。
restore ステートメントは、ソーステーブルが使用可能であれば、どのリージョンからでも実行できます。Amazon Keyspaces は、各リージョンのターゲットテーブルを自動的に復元します。PITR の詳細については「[Amazon Keyspaces のポイントインタイムリカバリの仕組み](PointInTimeRecovery_HowItWorks.md)」を参照してください。
マルチリージョンテーブルを作成すると、作成プロセス中に定義した PITR 設定がすべてのリージョンのすべてのテーブルに自動的に適用されます。を使用して PITR 設定を変更すると`ALTER TABLE`、Amazon Keyspaces は更新をローカルテーブルにのみ適用し、他のリージョンのレプリカには適用されません。既存のマルチリージョンテーブルに対して PITR を有効にするには、すべてのレプリカに対して `ALTER TABLE`ステートメントを繰り返す必要があります。
## マルチリージョンレプリケーションと AWS サービスとの統合
Amazon CloudWatch メトリクスを使用して AWS リージョン 、異なる のテーブル間のレプリケーションパフォーマンスをモニタリングできます。次のメトリクスでは、マルチリージョンキー空間を継続的にモニタリングできます。
+ `ReplicationLatency` — このメトリクスは、マルチリージョンキー空間内のあるレプリカテーブルから別のレプリカテーブルへ `updates`、`inserts`、または `deletes` を複製するときの所用時間を測定します。
CloudWatch のメトリクスのモニタリング方法については、「[Amazon CloudWatch による Amazon Keyspaces のモニタリング](monitoring-cloudwatch.md)」を参照してください。
# Amazon Keyspaces マルチリージョンレプリケーションの使用に関する注意事項
Amazon Keyspaces でマルチリージョンレプリケーションを使用する場合は、次の点を考慮してください。
+ [使用可能な任意のパブリック](programmatic.endpoints.md#global_endpoints) AWS リージョンを選択できます。 AWS リージョン [デフォルトでは無効になっている の詳細については、](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html#rande-manage-enable)「」を参照してください[のマルチリージョンレプリケーションはデフォルトで AWS リージョン 無効になっています](multiRegion-replication_how-it-works.md#howitworks_mrr_opt_in)。
+ AWS GovCloud (US) Regions および中国リージョンはサポートされていません。
+ 各機能が利用できるようになるまでは、次の対策を検討してください。
マルチリージョンテーブルの作成時に Time to Live (TTL) を設定します。後から TTL の有効/無効を切り替えることや、TTL 値を調整することはできません。詳細については、「[Amazon Keyspaces (Apache Cassandra 向け) で有効期限 (TTL) を使用してデータを期限切れにする](TTL.md)」を参照してください。
+ 保管時の暗号化には、 AWS 所有キーを使用します。カスタマーマネージドキーは、現時点では、マルチリージョンテーブルではサポートされていません。詳細については「」を参照してください。
[保管データ暗号化: Amazon Keyspaces での動作](encryption.howitworks.md).
+ `ALTER KEYSPACE` を使用して、リージョンを単一リージョンまたはマルチリージョンのキースペースに追加できます。詳細については、「[Amazon Keyspaces のキースペース AWS リージョン に を追加する](keyspaces-multi-region-add-replica.md)」を参照してください。
+ リージョンを単一リージョンのキースペースに追加する前に、キースペースの下にカスタマーマネージドキーでテーブルが設定されていないことを確認してください。
+ キースペースまたはテーブル用に設定された既存のタグは、新しいリージョンにレプリケートされません。
+ プロビジョニングされるキャパシティを Amazon Keyspaces の自動スケーリングで管理する場合は、Amazon Keyspaces の API オペレーションを使用してマルチリージョンテーブルを作成および設定してください。Amazon Keyspaces で自動的に呼び出される基盤の Application Auto Scaling API オペレーションには、マルチリージョンの機能がありません。
詳細については、「[Amazon Keyspaces でマルチリージョンテーブルのプロビジョンドキャパシティと自動スケーリングの設定を更新する](tables-mrr-autoscaling.md)」を参照してください。プロビジョンドモードのマルチリージョンテーブルの書き込みキャパシティスループットを推定する方法については、「[Amazon Keyspaces でマルチリージョンテーブルのキャパシティを推定およびプロビジョニングする](tables-multi-region-capacity.md)」を参照してください。
+ データはマルチリージョンテーブルの選択したリージョン間で自動的に複製されますが、クライアントが 1 つのリージョンのエンドポイントに接続して `system.peers` テーブルをクエリすると、クエリはローカル情報のみを返します。クエリ結果は、クライアントには単一のデータセンターのクラスターのように見えます。
+ Amazon Keyspaces マルチリージョンレプリケーションは非同期であり、書き込みの`LOCAL_QUORUM`一貫性をサポートします。 の`LOCAL_QUORUM`一貫性を保つには、クライアントに成功を返す前に、行の更新をローカルリージョンの 2 つのレプリカに永続的に保持する必要があります。レプリケート先のリージョンへの書き込みの伝播は、その後非同期で実行されます。
Amazon Keyspaces マルチリージョンレプリケーションは、同期レプリケーションまたは`QUORUM`整合性をサポートしていません。
+ マルチリージョンのキースペースまたはテーブルを作成すると、作成プロセス中に定義したタグは、すべてのリージョンのすべてのキースペースとテーブルに自動的に適用されます。`ALTER KEYSPACE` または `ALTER TABLE` を使用して既存のタグを変更した場合、変更を行ったリージョン内の該当するキースペースまたはテーブルのみが更新されます。
+ Amazon CloudWatch は、複製した各リージョンに `ReplicationLatency` メトリクスを提供します。このメトリクスは、到着する行を追跡し、到着時間と最初の書き込み時間を比較して、平均値を計算することで算出されます。タイミングはソースリージョンの CloudWatch 内に保存されます。詳細については、「[Amazon CloudWatch による Amazon Keyspaces のモニタリング](monitoring-cloudwatch.md)」を参照してください。
タイミングの平均値と最大値を表示すると、レプリケーション遅延の平均値や最悪のケースを把握するのに役立ちます。このレイテンシーには SLA はありません。
+ マルチリージョンテーブルをオンデマンドモードで使用する場合は、テーブルレプリカが新たなトラフィックピークを迎えると、書き込みの非同期レプリケーションのレイテンシーが増加する可能性があります。Amazon Keyspaces は受信したアプリケーショントラフィックに応じて単一リージョンのオンデマンドテーブルのキャパシティを自動調整しますが、それと同様に、マルチリージョンのオンデマンドテーブルレプリカのキャパシティも、受信したトラフィックに応じて自動的に調整します。Amazon Keyspaces はトラフィック量が増えれば、その分割り当てるキャパシティを自動的に増量させるため、レプリケーションレイテンシーの増加は一時的な現象です。すべてのレプリカがトラフィック量に合わせて調整されれば、レプリケーションレイテンシーは正常に戻ります。詳細については、「[ピークトラフィックとスケーリングプロパティ](ReadWriteCapacityMode.OnDemand.md#ReadWriteCapacityMode.PeakTraffic)」を参照してください。
+ マルチリージョンテーブルをプロビジョンドモードで使用する場合は、アプリケーションの消費量がプロビジョニング済みのスループットキャパシティを上回ると、キャパシティ不足のエラーが発生し、レプリケーションレイテンシーが増加する可能性があります。すべての AWS リージョン マルチリージョンテーブルのすべてのテーブルレプリカに十分な読み取りおよび書き込み容量を常に確保するには、Amazon Keyspaces 自動スケーリングを設定することをお勧めします。Amazon Keyspaces の自動スケーリングは、実際のアプリケーショントラフィックに応じてスループットキャパシティを自動的に調整するので、変動的なワークロードに対してスループットキャパシティを効率的にプロビジョニングできます。詳細については、「[マルチリージョンテーブルに対する自動スケーリングの仕組み](autoscaling.md#autoscaling.multi-region)」を参照してください。
# Amazon Keyspaces のマルチリージョンレプリケーションを設定する (Apache Cassandra 用)
コンソール、Cassandra クエリ言語 (CQL)、または を使用して AWS Command Line Interface 、Amazon Keyspaces でマルチリージョンのキースペースとテーブルを作成および管理できます。
このセクションでは、マルチリージョンのキースペースとテーブルを作成し、管理する方法の例を紹介します。マルチリージョンキースペース内に作成したテーブルはすべて、そのキースペースのマルチリージョン設定を自動的に継承します。
サポートされる設定の詳細については、「[Amazon Keyspaces マルチリージョンレプリケーションの使用に関する注意事項](multiRegion-replication_usage-notes.md)」をご参照ください。
**Topics**
+ [マルチリージョンのキースペースとテーブルの作成に必要な IAM アクセス許可を設定する](howitworks_replication_permissions.md)
+ [キースペースに を追加するために必要な AWS リージョン IAM アクセス許可を設定する](howitworks_replication_permissions_addReplica.md)
+ [Amazon Keyspaces でマルチリージョンキースペースを作成する](keyspaces-mrr-create.md)
+ [Amazon Keyspaces のキースペース AWS リージョン に を追加する](keyspaces-multi-region-add-replica.md)
+ [キースペースに新しいリージョンを追加するときにレプリケーションの進行状況を確認する](keyspaces-multi-region-replica-status.md)
+ [Amazon Keyspaces でデフォルト設定のマルチリージョンテーブルを作成する](tables-mrr-create-default.md)
+ [Amazon Keyspaces で自動スケーリングが有効なプロビジョンドモードのマルチリージョンテーブルを作成する](tables-mrr-create-provisioned.md)
+ [Amazon Keyspaces でマルチリージョンテーブルのプロビジョンドキャパシティと自動スケーリングの設定を更新する](tables-mrr-autoscaling.md)
+ [Amazon Keyspaces でマルチリージョンテーブルのプロビジョンドキャパシティと自動スケーリングの設定を表示する](tables-mrr-view.md)
+ [Amazon Keyspaces でテーブルの自動スケーリングを無効にする](tables-mrr-autoscaling-off.md)
+ [Amazon Keyspaces でマルチリージョンテーブルにプロビジョニングされるキャパシティを手動で設定する](tables-mrr-capacity-manually.md)
# マルチリージョンのキースペースとテーブルの作成に必要な IAM アクセス許可を設定する
マルチリージョンのキースペースとテーブルを正常に作成するには、IAM プリンシパルがサービスにリンクされたロールを作成できることが条件になります。このサービスにリンクされたロールは、Amazon Keyspaces によって事前に定義された特殊なタイプの IAM ロールです。このロールには、Amazon Keyspaces がお客様に代わってアクションを実行するために必要なすべての権限が含まれます。サービスにリンクされたロールの詳細については、「[Amazon Keyspaces のマルチリージョンレプリケーションでのロールの使用](using-service-linked-roles-multi-region-replication.md)」を参照してください。
マルチリージョンレプリケーションに必要なサービスにリンクされたロールを作成するには、IAM プリンシパルのポリシーに次の要素が必要です。
+ `iam:CreateServiceLinkedRole` – プリンシパルが実行できる**アクション**。
+ `arn:aws:iam::*:role/aws-service-role/replication.cassandra.amazonaws.com/AWSServiceRoleForKeyspacesReplication` – このアクションを実行できる**リソース**。
+ `iam:AWSServiceName": "replication.cassandra.amazonaws.com` – このロールをアタッチできる唯一の AWS サービスは Amazon Keyspaces です。
マルチリージョンキースペースとテーブルを作成するために必要な最小限の権限をユーザーに与えるポリシーの例を以下に示します。
```
{
"Effect": "Allow",
"Action": "iam:CreateServiceLinkedRole",
"Resource": "arn:aws:iam::*:role/aws-service-role/replication.cassandra.amazonaws.com/AWSServiceRoleForKeyspacesReplication",
"Condition": {"StringLike": {"iam:AWSServiceName": "replication.cassandra.amazonaws.com"}}
}
```
マルチリージョンのキースペースとテーブル用のその他の IAM アクセス許可については、「サービス認可リファレンス**」の「[Actions, resources, and condition keys for Amazon Keyspaces (for Apache Cassandra)](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonkeyspacesforapachecassandra.html)」を参照してください。
# キースペースに を追加するために必要な AWS リージョン IAM アクセス許可を設定する
リージョンをキースペースに追加するには、IAM プリンシパルに次のアクセス許可が必要です。
+ `cassandra:Alter`
+ `cassandra:AlterMultiRegionResource`
+ `cassandra:Create`
+ `cassandra:CreateMultiRegionResource`
+ `cassandra:Select`
+ `cassandra:SelectMultiRegionResource`
+ `cassandra:Modify`
+ `cassandra:ModifyMultiRegionResource`
テーブルがプロビジョニングモードで自動スケーリングを有効にして設定されている場合は、次の追加のアクセス許可が必要です。
+ `application-autoscaling:RegisterScalableTarget`
+ `application-autoscaling:DeregisterScalableTarget`
+ `application-autoscaling:DescribeScalableTargets`
+ `application-autoscaling:PutScalingPolicy`
+ `application-autoscaling:DescribeScalingPolicies`
リージョンを単一リージョンのキースペースに正常に追加するには、IAM プリンシパルもサービスにリンクされたロールを作成できる必要があります。このサービスにリンクされたロールは、Amazon Keyspaces によって事前に定義された特殊なタイプの IAM ロールです。このロールには、Amazon Keyspaces がお客様に代わってアクションを実行するために必要なすべての権限が含まれます。サービスにリンクされたロールの詳細については、「[Amazon Keyspaces のマルチリージョンレプリケーションでのロールの使用](using-service-linked-roles-multi-region-replication.md)」を参照してください。
マルチリージョンレプリケーションに必要なサービスにリンクされたロールを作成するには、IAM プリンシパルのポリシーに次の要素が必要です。
+ `iam:CreateServiceLinkedRole` – プリンシパルが実行できる**アクション**。
+ `arn:aws:iam::*:role/aws-service-role/replication.cassandra.amazonaws.com/AWSServiceRoleForKeyspacesReplication` – このアクションを実行できる**リソース**。
+ `iam:AWSServiceName": "replication.cassandra.amazonaws.com` – このロールをアタッチできる唯一の AWS サービスは Amazon Keyspaces です。
以下は、キースペースにリージョンを追加するために必要な最小限のアクセス許可をプリンシパルに付与するポリシーの例です。
```
{
"Effect": "Allow",
"Action": "iam:CreateServiceLinkedRole",
"Resource": "arn:aws:iam::*:role/aws-service-role/replication.cassandra.amazonaws.com/AWSServiceRoleForKeyspacesReplication",
"Condition": {"StringLike": {"iam:AWSServiceName": "replication.cassandra.amazonaws.com"}}
}
```
# Amazon Keyspaces でマルチリージョンキースペースを作成する
このセクションでは、マルチリージョンキースペースの作成方法の例を紹介します。この作業は、Amazon Keyspaces コンソール、CQL、または AWS CLIを使用して行うことができます。マルチリージョンキースペース内に作成したテーブルはすべて、そのキースペースのマルチリージョン設定を自動的に継承します。
**注記**
マルチリージョンキースペースを作成すると、Amazon Keyspaces はアカウント内の名前 `AWSServiceRoleForAmazonKeyspacesReplication` でサービスにリンクされたロールを作成します。このロールにより、Amazon Keyspaces はユーザーに代わってマルチリージョンテーブルのすべてのレプリカへの書き込みを複製できます。詳細については[Amazon Keyspaces のマルチリージョンレプリケーションでのロールの使用](using-service-linked-roles-multi-region-replication.md)を参照してください。
------
#### [ Console ]
**マルチリージョンキースペースを作成する (コンソール)**
1. にサインインし AWS マネジメントコンソール、[https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) で Amazon Keyspaces コンソールを開きます。
1. ナビゲーションペインで [**Keyspaces (キースペース)**] を選択し、次に [**Create keyspace (キースペースの作成)**] を選択します。
1. [**Keyspace name (キースペース名)**] でキースペースの名前を入力します。
1. **マルチリージョンレプリケーション**セクションでは、リストで使用できるリージョンを追加できます。
1. 終了するには、[**ロールを作成**] を選択します。
------
#### [ Cassandra Query Language (CQL) ]
**CQL を使用してマルチリージョンキースペースを作成する**
1. マルチリージョンキースペースを作成するには、 `NetworkTopologyStrategy`を使用して、キースペースをレプリケート AWS リージョン する を指定します。現在のリージョン以外に、追加リージョンを 1 つ以上、含める必要があります。
キースペース内のすべてのテーブルは、そのキースペースのレプリケーション戦略を継承します。テーブルレベルでレプリケーション戦略を変更することはできません。
`NetworkTopologyStrategy` – Amazon Keyspaces はデフォルトで同じ 内の 3 つの[アベイラビリティーゾーン](https://aws.amazon.com/about-aws/global-infrastructure/regions_az/)にデータをレプリケートするため AWS リージョン、各リージョンのレプリケーション係数は 3 です。
例を、次の CQL ステートメントで示します。
```
CREATE KEYSPACE mykeyspace
WITH REPLICATION = {'class':'NetworkTopologyStrategy', 'us-east-1':'3', 'ap-southeast-1':'3','eu-west-1':'3' };
```
1. CQL ステートメントで `system_multiregion_info` キースペース内の `tables` テーブルをクエリすると、指定したマルチリージョンテーブルのリージョンとステータスをプログラムによって一覧表示できます。次のコードは、この例です。
```
SELECT * from system_multiregion_info.tables WHERE keyspace_name = 'mykeyspace' AND table_name = 'mytable';
```
このステートメントの出力は、次のようになります。
```
keyspace_name | table_name | region | status
----------------+----------------+----------------+--------
mykeyspace | mytable | us-east-1 | ACTIVE
mykeyspace | mytable | ap-southeast-1 | ACTIVE
mykeyspace | mytable | eu-west-1 | ACTIVE
```
------
#### [ CLI ]
**を使用して新しいマルチリージョンキースペースを作成する AWS CLI**
+ マルチリージョンキースペースは、次の CLI ステートメントで作成できます。現在のリージョンと `regionList` に 1 つ以上の追加リージョンを指定します。
```
aws keyspaces create-keyspace --keyspace-name mykeyspace \
--replication-specification replicationStrategy=MULTI_REGION,regionList=us-east-1,eu-west-1
```
------
マルチリージョンテーブルを作成するには、「[Amazon Keyspaces でデフォルト設定のマルチリージョンテーブルを作成する](tables-mrr-create-default.md)」および「[Amazon Keyspaces で自動スケーリングが有効なプロビジョンドモードのマルチリージョンテーブルを作成する](tables-mrr-create-provisioned.md)」を参照してください。
# Amazon Keyspaces のキースペース AWS リージョン に を追加する
単一のキースペースまたはマルチリージョンのキースペースのいずれかであるキースペース AWS リージョン に新しい を追加できます。新しいレプリカリージョンは、キースペース内のすべてのテーブルに適用されます。
シングルリージョンをマルチリージョンキースペースに変更するには、キースペース内のすべてのテーブルに対してクライアント側のタイムスタンプを有効にする必要があります。詳細については、「[Amazon Keyspaces でのクライアント側のタイムスタンプ](client-side-timestamps.md)」を参照してください。
マルチリージョンキースペースにリージョンを追加する場合、Amazon Keyspaces は、既存のテーブルごとに 1 回限りのクロスリージョン復元を使用して、既存のテーブル (複数可) を新しいリージョンにレプリケートする必要があります。各テーブルの復元料金は GB ごとに請求されます。詳細については、Amazon Keyspaces (Apache Cassandra 向け) の料金ページの[「バックアップと復元](https://aws.amazon.com/keyspaces/pricing/#:~:text=per%20GB-month-,Restoring%20a%20table,-Restoring%20a%20table)」を参照してください。この復元オペレーションでは、リージョン間のデータ転送に料金はかかりません。データに加えて、タグを除くすべてのテーブルプロパティが新しいリージョンにレプリケートされます。
CQL の `ALTER KEYSPACE`ステートメント、 の `update-keyspace` コマンド AWS CLI、または コンソールを使用して、Amazon Keyspaces の単一のキースペースまたはマルチリージョンキースペースに新しいリージョンを追加できます。ステートメントを正常に実行するには、使用しているアカウントが、キースペースが既に利用可能なリージョンのいずれかにある必要があります。レプリカの追加中は、更新およびレプリケートされるリソースに対して他のデータ定義言語 (DDL) オペレーションを実行することはできません。
リージョンの追加に必要なアクセス許可の詳細については、「」を参照してください[キースペースに を追加するために必要な AWS リージョン IAM アクセス許可を設定する](howitworks_replication_permissions_addReplica.md)。
**注記**
単一リージョンのキースペースにリージョンを追加すると、Amazon Keyspaces は`AWSServiceRoleForAmazonKeyspacesReplication`アカウントに という名前のサービスにリンクされたロールを作成します。このロールにより、Amazon Keyspaces はテーブルを新しいリージョンにレプリケートし、ユーザーに代わって 1 つのテーブルからマルチリージョンテーブルのすべてのレプリカに書き込みをレプリケートできます。詳細については[Amazon Keyspaces のマルチリージョンレプリケーションでのロールの使用](using-service-linked-roles-multi-region-replication.md)を参照してください。
------
#### [ Console ]
Amazon Keyspaces コンソールを使用してキースペースにリージョンを追加するには、次の手順に従います。
**キースペースにリージョンを追加する (コンソール)**
1. にサインインし AWS マネジメントコンソール、[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"}'
```
------
# キースペースに新しいリージョンを追加するときにレプリケーションの進行状況を確認する
Amazon Keyspaces キースペースへの新しいリージョンの追加は、長時間実行されるオペレーションです。進行状況を追跡するには、このセクションに示すクエリを使用できます。
------
#### [ Cassandra Query Language (CQL) ]
**CQL を使用してリージョンの追加の進行状況を確認する**
+ 特定のキースペースで新しいテーブルレプリカの作成の進行状況を確認するには、`system_multiregion_info.keyspaces`テーブルをクエリできます。例を、次の CQL ステートメントで示します。
```
SELECT keyspace_name, region, status, tables_replication_progress
FROM system_multiregion_info.keyspaces
WHERE keyspace_name = 'my_keyspace';
```
レプリケーションオペレーションの進行中、ステータスは新しいリージョンでのテーブル作成の進行状況を示します。これは、10 個のテーブルのうち 5 個が新しいリージョンにレプリケートされた例です。
```
keyspace_name | region | status | tables_replication_progress
---------------+-----------+-----------+-------------------------
my_keyspace | us-east-1 | Updating |
my_keyspace | us-west-2 | Updating |
my_keyspace | eu-west-1 | Creating | 50%
```
レプリケーションプロセスが正常に完了すると、出力は次の例のようになります。
```
keyspace_name | region | status
---------------+-----------+-----------
my_keyspace | us-east-1 | Active
my_keyspace | us-west-2 | Active
my_keyspace | eu-west-1 | Active
```
------
#### [ CLI ]
**を使用してリージョンの追加の進行状況 AWS CLI を確認する**
+ 特定のキースペースのテーブルレプリカ作成のステータスを確認するには、次の例を使用します。
```
aws keyspaces get-keyspace \
--keyspace-name my_keyspace
```
この例のような出力が得られます。
```
{
"keyspaceName": "my_keyspace",
"resourceArn": "arn:aws:cassandra:us-east-1:111122223333:/keyspace/my_keyspace/",
"replicationStrategy": "MULTI_REGION",
"replicationRegions": [
"us-east-1",
"eu-west-1"
]
"replicationGroupStatus": [
{
"RegionName": "us-east-1",
"KeyspaceStatus": "Active"
},
{
"RegionName": "eu-west-1",
"KeyspaceStatus": "Creating",
"TablesReplicationProgress": "50.0%"
}
]
}
```
------
# Amazon Keyspaces でデフォルト設定のマルチリージョンテーブルを作成する
このセクションでは、オンデマンドモードのマルチリージョンテーブルをすべてデフォルトの設定で作成する方法の例を紹介します。この作業は、Amazon Keyspaces コンソール、CQL、または AWS CLIを使用して行うことができます。マルチリージョンキースペース内に作成したテーブルはすべて、そのキースペースのマルチリージョン設定を自動的に継承します。
マルチリージョンキースペースを作成するには、「[Amazon Keyspaces でマルチリージョンキースペースを作成する](keyspaces-mrr-create.md)」を参照してください。
------
#### [ Console ]
**マルチリージョンテーブルをデフォルト設定で作成する (コンソール)**
1. にサインインし AWS マネジメントコンソール、[https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) で Amazon Keyspaces コンソールを開きます。
1. マルチリージョンキー空間を選択します。
1. [**テーブル**] タブで [**テーブルを作成**] を選択します。
1. [**テーブル名**] にテーブルの名前を入力します。このテーブルが複製される AWS リージョン が情報ボックスに表示されます。
1. テーブルスキーマを続行します。
1. [**テーブル設定**] で、[**デフォルト設定**] オプションに進みます。マルチリージョンテーブルの次のデフォルト設定に注意してください。
+ **キャパシティモード** – デフォルトのキャパシティモードは **[オンデマンド]** です。**プロビジョンドモード**の設定の詳細については、「[Amazon Keyspaces で自動スケーリングが有効なプロビジョンドモードのマルチリージョンテーブルを作成する](tables-mrr-create-provisioned.md)」を参照してください。
+ **暗号化キー管理** — **AWS 所有のキー** オプションのみがサポートされます。
+ **クライアント側のタイムスタンプ** — この機能はマルチリージョンテーブルに必要です。
+ テーブルとそのすべてのレプリカの Time to Live (TTL) を有効にする必要がある場合は、[**設定をカスタマイズ**] を選択します。
**注記**
既存のマルチリージョンテーブルの TTL 設定は変更できません。
1. 終了するには、[**テーブルを作成**] を選択します。
------
#### [ Cassandra Query Language (CQL) ]
**オンデマンドモードのマルチリージョンテーブルをデフォルト設定で作成する**
+ マルチリージョンテーブルをデフォルト設定で作成するには、次の CQL ステートメントを使用します。
```
CREATE TABLE mykeyspace.mytable(pk int, ck int, PRIMARY KEY (pk, ck))
WITH CUSTOM_PROPERTIES = {
'capacity_mode':{
'throughput_mode':'PAY_PER_REQUEST'
},
'point_in_time_recovery':{
'status':'enabled'
},
'encryption_specification':{
'encryption_type':'AWS_OWNED_KMS_KEY'
},
'client_side_timestamps':{
'status':'enabled'
}
};
```
------
#### [ CLI ]
**の使用 AWS CLI**
1. マルチリージョンテーブルをデフォルト設定で作成するには、スキーマのみを指定する必要があります。次の例を使用できます。
```
aws keyspaces create-table --keyspace-name mykeyspace --table-name mytable \
--schema-definition 'allColumns=[{name=pk,type=int}],partitionKeys={name= pk}'
```
このコマンドの出力は、次のようになります。
```
{
"resourceArn": "arn:aws:cassandra:us-east-1:111122223333:/keyspace/mykeyspace/table/mytable"
}
```
1. テーブルの設定を確認するには、次のステートメントを使用します。
```
aws keyspaces get-table --keyspace-name mykeyspace --table-name mytable
```
出力には、マルチリージョンテーブルのデフォルト設定がすべて表示されます。
```
{
"keyspaceName": "mykeyspace",
"tableName": "mytable",
"resourceArn": "arn:aws:cassandra:us-east-1:111122223333:/keyspace/mykeyspace/table/mytable",
"creationTimestamp": "2023-12-19T16:50:37.639000+00:00",
"status": "ACTIVE",
"schemaDefinition": {
"allColumns": [
{
"name": "pk",
"type": "int"
}
],
"partitionKeys": [
{
"name": "pk"
}
],
"clusteringKeys": [],
"staticColumns": []
},
"capacitySpecification": {
"throughputMode": "PAY_PER_REQUEST",
"lastUpdateToPayPerRequestTimestamp": "2023-12-19T16:50:37.639000+00:00"
},
"encryptionSpecification": {
"type": "AWS_OWNED_KMS_KEY"
},
"pointInTimeRecovery": {
"status": "DISABLED"
},
"defaultTimeToLive": 0,
"comment": {
"message": ""
},
"clientSideTimestamps": {
"status": "ENABLED"
},
"replicaSpecifications": [
{
"region": "us-east-1",
"status": "ACTIVE",
"capacitySpecification": {
"throughputMode": "PAY_PER_REQUEST",
"lastUpdateToPayPerRequestTimestamp": 1702895811.469
}
},
{
"region": "eu-north-1",
"status": "ACTIVE",
"capacitySpecification": {
"throughputMode": "PAY_PER_REQUEST",
"lastUpdateToPayPerRequestTimestamp": 1702895811.121
}
}
]
}
```
------
# Amazon Keyspaces で自動スケーリングが有効なプロビジョンドモードのマルチリージョンテーブルを作成する
このセクションでは、自動スケーリングが有効なプロビジョンドモードのマルチリージョンテーブルを作成する方法の例を紹介します。この作業は、Amazon Keyspaces コンソール、CQL、または AWS CLIを使用して行うことができます。
サポートされている設定とマルチリージョンレプリケーション機能の詳細については、「」を参照してください[Amazon Keyspaces マルチリージョンレプリケーションの使用に関する注意事項](multiRegion-replication_usage-notes.md)。
マルチリージョンキースペースを作成するには、「[Amazon Keyspaces でマルチリージョンキースペースを作成する](keyspaces-mrr-create.md)」を参照してください。
自動スケーリング設定を使用してプロビジョンドモードの新しいマルチリージョンテーブルを作成する場合、そのテーブルのレプリケート先のすべての AWS リージョン に適用される汎用設定を指定できます。その上で、読み取りキャパシティ設定と読み取りの自動スケーリング設定をレプリカごとに上書きできます。一方、書き込みキャパシティについては、すべてのリージョン間で書き込みをレプリケートするためのキャパシティを十分に確保するため、すべてのレプリカ間で同期されます。
**注記**
Amazon Keyspaces の自動スケーリングでは、ユーザーに代わって自動スケーリングアクションを実行するサービスリンクロール (`AWSServiceRoleForApplicationAutoScaling_CassandraTable`) の存在が必要になります。このロールは自動的に作成されます。詳細については、「[Amazon Keyspaces のサービスリンクロールの使用](using-service-linked-roles.md)」を参照してください。
------
#### [ Console ]
**自動スケーリングが有効な新しいマルチリージョンテーブルを作成する**
1. にサインインし AWS マネジメントコンソール、[https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) で Amazon Keyspaces コンソールを開きます。
1. マルチリージョンキー空間を選択します。
1. [**テーブル**] タブで [**テーブルを作成**] を選択します。
1. [**Table details (テーブルの詳細)**] セクションの [**Create table (テーブルの作成)**] ページで、キースペースを選択し、新しいテーブルに名前を付けます。
1. **[列]** セクションで、テーブルのスキーマを作成します。
1. **[プライマリキー]** セクションで、テーブルのプライマリキーを定義し、オプションでクラスタリング列を選択します。
1. **[テーブルの設定]** セクションで、**[設定のカスタマイズ]** を選択します。
1. [**Read/write capacity settings (読み取り/書き込みキャパシティの設定)**] に進みます。
1. [**Capacity mode (キャパシティモード)**] で、[**Provisioned (プロビジョン)**] を選択します。
1. [**Read capacity]** (読み取りキャパシティ) セクションで、[**Scale automatically (自動スケーリング)**] が選択されているか確認します。
テーブルのレプリケート先のすべての AWS リージョン で同じ読み取りキャパシティユニットを設定するチェックボックスを選択できます。または、そのチェックボックスの選択を解除して、リージョンごとに別々の読み取りキャパシティを設定できます。
リージョンごとに別々に設定する選択肢を選んだ場合は、各テーブルレプリカの最小と最大の読み取りキャパシティユニットとターゲット使用率を併せて選択します。
+ **最小キャパシティユニット** — テーブルをいつでもすぐにサポートできる状態にするために、最小レベルのスループット値を入力します。この値は、1 から、アカウントの秒単位の最大スループットクォータ (デフォルトは 40,000) までの範囲でなければなりません。
+ **最大キャパシティユニット** — テーブルに対してプロビジョニングするスループットの最大量を入力します。この値は、1 から、アカウントの秒単位の最大スループットクォータ (デフォルトは 40,000) までの範囲でなければなりません。
+ **ターゲット使用率**— ターゲット使用率を 20%～90% の範囲で入力します。定義したターゲット使用率をトラフィックが上回ると、キャパシティが自動的に増加されます。定義したターゲットをトラフィックが下回ると、再び容量が自動的に減少されます。
+ テーブルの読み取りキャパシティを手動でプロビジョニングする場合は、**[自動スケーリング]** チェックボックスの選択を解除します。この設定は、テーブルのすべてのレプリカに適用されます。
**注記**
すべてのレプリカに十分な読み取りキャパシティを確保するために、プロビジョンドモードのマルチリージョンテーブルでは Amazon Keyspaces の自動スケーリングを使用することをお勧めします。
**注記**
アカウントのデフォルトクォータの詳細およびクォータを引き上げる方法については、「[Amazon Keyspaces (Apache Cassandra 向け) のクォータ](quotas.md)」を参照してください。
1. **[読み込みキャパシティ]** セクションで、**[自動スケーリング]** が選択されていることを確認します。その上で、テーブルのキャパシティユニットを設定します。書き込みキャパシティユニットは、すべてのリージョン間で書き込みイベントをレプリケートするためのキャパシティを十分に確保するため、すべての AWS リージョン 間で同期されます。
+ テーブルの書き込みキャパシティを手動でプロビジョニングする場合は、**[自動スケーリング]** の選択を解除します。この設定は、テーブルのすべてのレプリカに適用されます。
**注記**
すべてのレプリカに十分な書き込みキャパシティを確保するために、プロビジョンドモードのマルチリージョンテーブルでは Amazon Keyspaces の自動スケーリングを使用することをお勧めします。
1. [**Create table (テーブルの作成)**] を選択します。指定した自動スケーリングパラメータを使用してテーブルが作成されます。
------
#### [ Cassandra Query Language (CQL) ]
**自動スケーリングが有効なプロビジョンドキャパシティモードのマルチリージョンテーブルを CQL を使用して作成する**
+ 自動スケーリングが有効なプロビジョンドモードのマルチリージョンテーブルを作成するには、まず、テーブルの `CUSTOM_PROPERTIES` を定義し、キャパシティモードを指定する必要があります。プロビジョンド (provisioned) キャパシティモードを指定した後で、`AUTOSCALING_SETTINGS` を使用して、テーブルの自動スケーリングを設定できます。
自動スケーリング設定、ターゲット追跡ポリシー、ターゲット値、オプション設定の詳細については、「[自動スケーリングを有効にして新規テーブルを作成する](autoscaling.createTable.md)」を参照してください。
特定のリージョン内のテーブルレプリカの読み取りキャパシティを定義するには、テーブルの `replica_updates` の一部として次のパラメータを設定できます。
+ リージョン
+ プロビジョニングされた読み取りキャパシティユニット (オプション)
+ 読み取りキャパシティの自動スケーリング設定 (オプション)
次の例は、プロビジョンドモードのマルチリージョンテーブルの `CREATE TABLE` ステートメントです。書き込みキャパシティと読み取りキャパシティの自動スケーリングの汎用設定は同じです。ただし、読み取りの自動スケーリング設定では、テーブルの読み取りキャパシティをスケールアップまたはスケールダウンする前のクールダウン期間として 60 秒が追加で指定されています。さらに、米国東部 (バージニア北部) リージョンの読み取りキャパシティの自動スケーリング設定は、他のレプリカと比べて高めの設定になっています。また、ターゲット値の設定も 50% ではなく 70% です。
```
CREATE TABLE mykeyspace.mytable(pk int, ck int, PRIMARY KEY (pk, ck))
WITH CUSTOM_PROPERTIES = {
'capacity_mode': {
'throughput_mode': 'PROVISIONED',
'read_capacity_units': 5,
'write_capacity_units': 5
}
} AND AUTOSCALING_SETTINGS = {
'provisioned_write_capacity_autoscaling_update': {
'maximum_units': 10,
'minimum_units': 5,
'scaling_policy': {
'target_tracking_scaling_policy_configuration': {
'target_value': 50
}
}
},
'provisioned_read_capacity_autoscaling_update': {
'maximum_units': 10,
'minimum_units': 5,
'scaling_policy': {
'target_tracking_scaling_policy_configuration': {
'target_value': 50,
'scale_in_cooldown': 60,
'scale_out_cooldown': 60
}
}
},
'replica_updates': {
'us-east-1': {
'provisioned_read_capacity_autoscaling_update': {
'maximum_units': 20,
'minimum_units': 5,
'scaling_policy': {
'target_tracking_scaling_policy_configuration': {
'target_value': 70
}
}
}
}
}
};
```
------
#### [ CLI ]
**を使用して、自動スケーリングを使用してプロビジョンドモードで新しいマルチリージョンテーブルを作成する AWS CLI**
+ 自動スケーリング設定を使用してプロビジョンドモードのマルチリージョンテーブルを作成するには、 AWS CLIを使用します。マルチリージョンの自動スケーリングの設定には、Amazon Keyspaces CLI の `create-table` コマンドを使用する必要があります。その理由は、Application Auto Scaling (Amazon Keyspaces が自動スケーリングを実行するために使用するサービス) がマルチリージョンに対応していないからです。
自動スケーリング設定、ターゲット追跡ポリシー、ターゲット値、オプション設定の詳細については、「[自動スケーリングを有効にして新規テーブルを作成する](autoscaling.createTable.md)」を参照してください。
特定のリージョン内のテーブルレプリカの読み取りキャパシティを定義するには、テーブルの `replicaSpecifications` の一部として次のパラメータを設定できます。
+ リージョン
+ プロビジョニングされた読み取りキャパシティユニット (オプション)
+ 読み取りキャパシティの自動スケーリング設定 (オプション)
自動スケーリング設定が複雑で、テーブルレプリカごとに設定が異なるマルチリージョンテーブルを作成する場合は、テーブルの自動スケーリング設定とレプリカ設定を JSON ファイルからロードすると便利です。
次のコード例を使用するには、サンプル JSON ファイルを収録した [auto-scaling.zip](samples/auto-scaling.zip) をダウンロードし、`auto-scaling.json` と `replication.json` を抽出します。ファイルのパスを書き留めておいてください。
この例では、JSON ファイルは現在のディレクトリにあります。さまざまなファイルパスオプションについては、「[ファイルからパラメーターを読み込む方法](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-file.html#cli-usage-parameters-file-how)」を参照してください。
```
aws keyspaces create-table --keyspace-name mykeyspace --table-name mytable \
--schema-definition 'allColumns=[{name=pk,type=int},{name=ck,type=int}],partitionKeys=[{name=pk},{name=ck}]' \
--capacity-specification throughputMode=PROVISIONED,readCapacityUnits=1,writeCapacityUnits=1 \
--auto-scaling-specification file://auto-scaling.json \
--replica-specifications file://replication.json
```
------
# Amazon Keyspaces でマルチリージョンテーブルのプロビジョンドキャパシティと自動スケーリングの設定を更新する
このセクションでは、コンソール、CQL、および を使用して、プロビジョニングされたマルチリージョンテーブルの Amazon Keyspaces 自動スケーリング設定 AWS CLI を管理する方法の例を示します。一般的な自動スケーリング設定のオプションの詳細と仕組みについては、「[Amazon Keyspaces 自動スケーリングでスループットキャパシティを自動的に管理する](autoscaling.md)」を参照してください。
マルチリージョンテーブルでプロビジョンドキャパシティモードを使用している場合は、常に Amazon Keyspaces API コールを使用して自動スケーリングを設定する必要があります。その理由は、基盤となる Application Auto Scaling API オペレーションがリージョンに対応していないからです。
プロビジョンドモードのマルチリージョンテーブルの書き込みキャパシティスループットを推定する方法については、「[Amazon Keyspaces でマルチリージョンテーブルのキャパシティを推定およびプロビジョニングする](tables-multi-region-capacity.md)」を参照してください。
Amazon Keyspaces API の詳細については、「[Amazon Keyspaces API リファレンス](https://docs.aws.amazon.com/keyspaces/latest/APIReference/Welcome.html)**」を参照してください。
マルチリージョンテーブルのププロビジョンドモードまたは自動スケーリングの設定を更新する場合、テーブルの各レプリカの読み取りキャパシティ設定と読み取りの自動スケーリング設定を更新できます。
一方、書き込みキャパシティについては、すべてのリージョン間で書き込みをレプリケートするためのキャパシティを十分に確保するため、すべてのレプリカ間で同期されます。
------
#### [ Cassandra Query Language (CQL) ]
**CQL を使用してマルチリージョンテーブルのプロビジョンドキャパシティと自動スケーリングの設定を更新する**
+ `ALTER TABLE` を使用して、既存のテーブルのキャパシティモードと自動スケーリングの設定を更新できます。現時点でオンデマンドキャパシティモードのテーブルを更新する場合は、`capacity_mode` が必須です。テーブルが既にプロビジョンドキャパシティモードになっている場合、このフィールドは省略できます。
自動スケーリング設定、ターゲット追跡ポリシー、ターゲット値、オプション設定の詳細については、「[自動スケーリングを有効にして新規テーブルを作成する](autoscaling.createTable.md)」を参照してください。
同じステートメントでテーブルの `replica_updates` プロパティを更新して、特定のリージョンのテーブルレプリカの読み取りキャパシティと自動スケーリングの設定を更新することもできます。以下のステートメントは、この例です。
```
ALTER TABLE mykeyspace.mytable
WITH CUSTOM_PROPERTIES = {
'capacity_mode': {
'throughput_mode': 'PROVISIONED',
'read_capacity_units': 1,
'write_capacity_units': 1
}
} AND AUTOSCALING_SETTINGS = {
'provisioned_write_capacity_autoscaling_update': {
'maximum_units': 10,
'minimum_units': 5,
'scaling_policy': {
'target_tracking_scaling_policy_configuration': {
'target_value': 50
}
}
},
'provisioned_read_capacity_autoscaling_update': {
'maximum_units': 10,
'minimum_units': 5,
'scaling_policy': {
'target_tracking_scaling_policy_configuration': {
'target_value': 50,
'scale_in_cooldown': 60,
'scale_out_cooldown': 60
}
}
},
'replica_updates': {
'us-east-1': {
'provisioned_read_capacity_autoscaling_update': {
'maximum_units': 20,
'minimum_units': 5,
'scaling_policy': {
'target_tracking_scaling_policy_configuration': {
'target_value': 70
}
}
}
}
}
};
```
------
#### [ CLI ]
**を使用してマルチリージョンテーブルのプロビジョニングされた容量と自動スケーリング設定を更新する AWS CLI**
+ 既存のテーブルのプロビジョニングモードと自動スケーリング設定を更新するには、 コマンドを使用できます AWS CLI `update-table`。
マルチリージョンの自動スケーリング設定を作成または変更するには、Amazon Keyspaces の CLI コマンドを使用する必要があります。その理由は、Application Auto Scaling (Amazon Keyspaces がテーブルの自動スケーリングを実行するために使用するサービス) が複数の AWS リージョンに対応していないからです。
特定のリージョンのテーブルレプリカの読み取りキャパシティを更新するには、テーブルの `replicaSpecifications` の次のオプションパラメータのいずれかを変更します。
+ プロビジョニングされた読み取りキャパシティユニット (オプション)
+ 読み取りキャパシティの自動スケーリング設定 (オプション)
自動スケーリング設定が複雑で、テーブルレプリカごとに設定が異なるマルチリージョンテーブルを更新する場合は、テーブルの自動スケーリング設定とレプリカ設定を JSON ファイルからロードすると便利です。
次のコード例を使用するには、サンプル JSON ファイルを収録した [auto-scaling.zip](samples/auto-scaling.zip) をダウンロードし、`auto-scaling.json` と `replication.json` を抽出します。ファイルのパスを書き留めておいてください。
この例では、JSON ファイルは現在のディレクトリにあります。さまざまなファイルパスオプションについては、「[ファイルからパラメーターを読み込む方法](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-file.html#cli-usage-parameters-file-how)」を参照してください。
```
aws keyspaces update-table --keyspace-name mykeyspace --table-name mytable \
--capacity-specification throughputMode=PROVISIONED,readCapacityUnits=1,writeCapacityUnits=1 \
--auto-scaling-specification file://auto-scaling.json \
--replica-specifications file://replication.json
```
------
# Amazon Keyspaces でマルチリージョンテーブルのプロビジョンドキャパシティと自動スケーリングの設定を表示する
マルチリージョンテーブルのプロビジョンドキャパシティと自動スケーリングの設定は、Amazon Keyspaces コンソール、CQL、または AWS CLIで表示できます。このセクションでは、CQL と を使用してこれを行う方法の例を示します AWS CLI。
------
#### [ Cassandra Query Language (CQL) ]
**CQL を使用してマルチリージョンテーブルのプロビジョンドキャパシティと自動スケーリングの設定を表示する**
+ マルチリージョンテーブルの自動スケーリング設定を表示するには、次のコマンドを使用します。
```
SELECT * FROM system_multiregion_info.autoscaling WHERE keyspace_name = 'mykeyspace' AND table_name = 'mytable';
```
このコマンドの出力は、次のようになります。
```
keyspace_name | table_name | region | provisioned_read_capacity_autoscaling_update | provisioned_write_capacity_autoscaling_update
----------------+------------+----------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
mykeyspace | mytable | ap-southeast-1 | {'minimum_units': 5, 'maximum_units': 10, 'scaling_policy': {'target_tracking_scaling_policy_configuration': {'scale_out_cooldown': 60, 'disable_scale_in': false, 'target_value': 50, 'scale_in_cooldown': 60}}} | {'minimum_units': 5, 'maximum_units': 10, 'scaling_policy': {'target_tracking_scaling_policy_configuration': {'scale_out_cooldown': 0, 'disable_scale_in': false, 'target_value': 50, 'scale_in_cooldown': 0}}}
mykeyspace | mytable | us-east-1 | {'minimum_units': 5, 'maximum_units': 20, 'scaling_policy': {'target_tracking_scaling_policy_configuration': {'scale_out_cooldown': 60, 'disable_scale_in': false, 'target_value': 70, 'scale_in_cooldown': 60}}} | {'minimum_units': 5, 'maximum_units': 10, 'scaling_policy': {'target_tracking_scaling_policy_configuration': {'scale_out_cooldown': 0, 'disable_scale_in': false, 'target_value': 50, 'scale_in_cooldown': 0}}}
mykeyspace | mytable | eu-west-1 | {'minimum_units': 5, 'maximum_units': 10, 'scaling_policy': {'target_tracking_scaling_policy_configuration': {'scale_out_cooldown': 60, 'disable_scale_in': false, 'target_value': 50, 'scale_in_cooldown': 60}}} | {'minimum_units': 5, 'maximum_units': 10, 'scaling_policy': {'target_tracking_scaling_policy_configuration': {'scale_out_cooldown': 0, 'disable_scale_in': false, 'target_value': 50, 'scale_in_cooldown': 0}}}
```
------
#### [ CLI ]
**を使用してマルチリージョンテーブルのプロビジョンドキャパシティと自動スケーリング設定を表示する AWS CLI**
+ マルチリージョンテーブルの自動スケーリング設定を表示するには、`get-table-auto-scaling-settings` オペレーションを使用します。次の CLI コマンドは一例です。
```
aws keyspaces get-table-auto-scaling-settings --keyspace-name mykeyspace --table-name mytable
```
次のような出力が表示されます。
```
{
"keyspaceName": "mykeyspace",
"tableName": "mytable",
"resourceArn": "arn:aws:cassandra:us-east-1:777788889999:/keyspace/mykeyspace/table/mytable",
"autoScalingSpecification": {
"writeCapacityAutoScaling": {
"autoScalingDisabled": false,
"minimumUnits": 5,
"maximumUnits": 10,
"scalingPolicy": {
"targetTrackingScalingPolicyConfiguration": {
"disableScaleIn": false,
"scaleInCooldown": 0,
"scaleOutCooldown": 0,
"targetValue": 50.0
}
}
},
"readCapacityAutoScaling": {
"autoScalingDisabled": false,
"minimumUnits": 5,
"maximumUnits": 20,
"scalingPolicy": {
"targetTrackingScalingPolicyConfiguration": {
"disableScaleIn": false,
"scaleInCooldown": 60,
"scaleOutCooldown": 60,
"targetValue": 70.0
}
}
}
},
"replicaSpecifications": [
{
"region": "us-east-1",
"autoScalingSpecification": {
"writeCapacityAutoScaling": {
"autoScalingDisabled": false,
"minimumUnits": 5,
"maximumUnits": 10,
"scalingPolicy": {
"targetTrackingScalingPolicyConfiguration": {
"disableScaleIn": false,
"scaleInCooldown": 0,
"scaleOutCooldown": 0,
"targetValue": 50.0
}
}
},
"readCapacityAutoScaling": {
"autoScalingDisabled": false,
"minimumUnits": 5,
"maximumUnits": 20,
"scalingPolicy": {
"targetTrackingScalingPolicyConfiguration": {
"disableScaleIn": false,
"scaleInCooldown": 60,
"scaleOutCooldown": 60,
"targetValue": 70.0
}
}
}
}
},
{
"region": "eu-north-1",
"autoScalingSpecification": {
"writeCapacityAutoScaling": {
"autoScalingDisabled": false,
"minimumUnits": 5,
"maximumUnits": 10,
"scalingPolicy": {
"targetTrackingScalingPolicyConfiguration": {
"disableScaleIn": false,
"scaleInCooldown": 0,
"scaleOutCooldown": 0,
"targetValue": 50.0
}
}
},
"readCapacityAutoScaling": {
"autoScalingDisabled": false,
"minimumUnits": 5,
"maximumUnits": 10,
"scalingPolicy": {
"targetTrackingScalingPolicyConfiguration": {
"disableScaleIn": false,
"scaleInCooldown": 60,
"scaleOutCooldown": 60,
"targetValue": 50.0
}
}
}
}
}
]
}
```
------
# Amazon Keyspaces でテーブルの自動スケーリングを無効にする
このセクションでは、プロビジョンドキャパシティモードのマルチリージョンテーブルの自動スケーリングを無効にする方法の例を紹介します。この作業は、Amazon Keyspaces コンソール、CQL、または AWS CLIを使用して行うことができます。
**重要**
プロビジョンドキャパシティモードを使用するマルチリージョンテーブルでは、自動スケーリングを使用することをお勧めします。詳細については、「[Amazon Keyspaces でマルチリージョンテーブルのキャパシティを推定およびプロビジョニングする](tables-multi-region-capacity.md)」を参照してください。
**注記**
Application Auto Scaling で使用されているサービスリンクロールを削除するには、すべての AWS リージョンにおいてアカウント内のすべてのテーブルで自動スケーリングを無効にする必要があります。
------
#### [ Console ]
**コンソールで既存のマルチリージョンテーブルの Amazon Keyspaces 自動スケーリングを無効にする**
1. にサインインし AWS マネジメントコンソール、[https://console.aws.amazon.com/keyspaces/home](https://console.aws.amazon.com/keyspaces/home) で Amazon Keyspaces コンソールを開きます。
1. 操作対象のテーブルを選択してから、**[キャパシティ]** を選択します。
1. **[キャパシティ設定]** セクションで、**[編集]** を選択します。
1. Amazon Keyspaces の自動スケーリングを無効にするには、**[自動スケーリング]** チェックボックスの選択を解除します。自動スケーリングを無効にすると、Application Auto Scaling のスケーラブルターゲットとしてのテーブルの登録が解除されます。Amazon Keyspaces テーブルにアクセスするために Application Auto Scaling が使用するサービスリンクロールを削除するには、「[Amazon Keyspaces のサービスリンクロールの削除](using-service-linked-roles-app-auto-scaling.md#delete-service-linked-role-app-auto-scaling)」の手順を実行してください。
1. 自動スケーリング設定が定義されたら、[**Save (保存)**] を選択します。
------
#### [ Cassandra Query Language (CQL) ]
**CQL を使用してマルチリージョンテーブルの自動スケーリングを無効にする**
+ `ALTER TABLE` を使用して、既存のテーブルの自動スケーリングを無効にすることができます。テーブルレプリカの自動スケーリングを個別に無効化することはできません。
次の例では、テーブルの読み取りキャパシティに対する自動スケーリングを無効にしています。
```
ALTER TABLE mykeyspace.mytable
WITH AUTOSCALING_SETTINGS = {
'provisioned_read_capacity_autoscaling_update': {
'autoscaling_disabled': true
}
};
```
------
#### [ CLI ]
**を使用してマルチリージョンテーブルの自動スケーリングをオフにする AWS CLI**
+ コマンドを使用して AWS CLI `update-table`、既存のテーブルの自動スケーリングをオフにできます。テーブルレプリカの自動スケーリングを個別に無効化することはできません。
次の例では、テーブルの読み取りキャパシティに対する自動スケーリングを無効にしています。
```
aws keyspaces update-table --keyspace-name mykeyspace --table-name mytable
\ --auto-scaling-specification readCapacityAutoScaling={autoScalingDisabled=true}
```
------
# Amazon Keyspaces でマルチリージョンテーブルにプロビジョニングされるキャパシティを手動で設定する
マルチリージョンテーブルの自動スケーリングを無効にする必要がある場合は、CQL または AWS CLIを使用して、レプリカテーブル用の読み取りキャパシティを手動でプロビジョニングすることができます。
**注記**
プロビジョンドキャパシティモードを使用するマルチリージョンテーブルでは、自動スケーリングを使用することをお勧めします。詳細については、「[Amazon Keyspaces でマルチリージョンテーブルのキャパシティを推定およびプロビジョニングする](tables-multi-region-capacity.md)」を参照してください。
------
#### [ Cassandra Query Language (CQL) ]
**CQL を使用してマルチリージョンテーブルにプロビジョニングされるキャパシティを手動で設定する**
+ `ALTER TABLE` を使用して、レプリカテーブルの読み取りキャパシティを手動でプロビジョニングすることができます。
```
ALTER TABLE mykeyspace.mytable
WITH CUSTOM_PROPERTIES = {
'capacity_mode': {
'throughput_mode': 'PROVISIONED',
'read_capacity_units': 1,
'write_capacity_units': 1
},
'replica_updates': {
'us-east-1': {
'read_capacity_units': 2
}
}
};
```
------
#### [ CLI ]
**を使用してマルチリージョンテーブルのプロビジョニングされた容量を手動で設定する AWS CLI**
+ マルチリージョンテーブルの自動スケーリングを無効にする必要がある場合は、`update-table` を使用して、レプリカテーブルの読み取りキャパシティを手動でプロビジョニングすることができます。
```
aws keyspaces update-table --keyspace-name mykeyspace --table-name mytable \
--capacity-specification throughputMode=PROVISIONED,readCapacityUnits=1,writeCapacityUnits=1 \
--replica-specifications region="us-east-1",readCapacityUnits=5
```
------