DDL Amazon Keyspaces のステートメント (データ定義言語）

データ定義言語 (DDL) は、キースペースやテーブルなどの Amazon Keyspaces (Apache Cassandra 向けCQL) のデータ構造を管理するために使用される Cassandra クエリ言語 () ステートメントのセットです。DDL を使用して、これらのデータ構造を作成し、作成後に変更し、使用されなくなったら削除します。Amazon Keyspaces は非同期的にDDLオペレーションを実行します。非同期操作が完了したことを確認する方法の詳細については、「キースペースとテーブルの非同期的な作成および削除」を参照してください。

以下のDDLステートメントがサポートされています。

CREATE KEYSPACE
ALTER KEYSPACE
DROP KEYSPACE
CREATE TABLE
ALTER TABLE
RESTORE TABLE
DROP TABLE

Keyspaces

キー空間は、1 つ以上のアプリケーションに関係している関連テーブルをグループ化するものです。リレーショナルデータベース管理システム (RDBMS) では、キースペースはデータベース、テーブルスペース、または同様のコンストラクトとほぼ似ています。

注記

Apache Cassandra では、キー空間により、複数のストレージノードにおけるデータのレプリケーション方法が決まります。ただし、Amazon Keyspaces はフルマネージドサービスであり、ストレージレイヤーの詳細情報がユーザーに代わって管理されます。このため、Amazon Keyspaces の Keyspaces は論理構造のみであり、基礎となる物理ストレージとは関係ありません。

Amazon Keyspaces キー空間のクォータ制限と制約については、「Amazon Keyspaces (Apache Cassandra 向け) のクォータ」を参照してください。

キースペースのステートメント

CREATE KEYSPACE
ALTER KEYSPACE
DROP KEYSPACE

CREATE KEYSPACE

CREATE KEYSPACE ステートメントを使用して、新しいキー空間を作成します。

[Syntax (構文)]


create_keyspace_statement ::= 
    CREATE KEYSPACE [ IF NOT EXISTS ] keyspace_name
    WITH options

Where:

keyspace_name は作成するキー空間の名前です。
options は以下のうちの 1 つ以上です。
- REPLICATION — キー空間のレプリケーション戦略を示すマップ。
  - SingleRegionStrategy — 単一リージョンのキー空間用。(必須)
  - NetworkTopologyStrategy – 少なくとも 2 つから最大 6 つを指定します。 AWS リージョン。各リージョンのレプリケーション係数は 3 です。(オプション)
- DURABLE_WRITES — Amazon Keyspaces への書き込みは常に耐久性があるため、このオプションは必要ありません。ただし、指定する場合は、値は true でなければなりません。
- TAGS – 作成時にリソースにアタッチされるキー値のペアタグのリスト。(オプション)

例

次のようなキー空間を作成します。


CREATE KEYSPACE my_keyspace
    WITH REPLICATION = {'class': 'SingleRegionStrategy'} and TAGS ={'key1':'val1', 'key2':'val2'} ;

マルチリージョンキースペースを作成するには、を指定NetworkTopologyStrategyし、少なくとも 2 つから最大 6 つを含めます。 AWS リージョン。各リージョンのレプリケーション係数は 3 です。


CREATE KEYSPACE my_keyspace
    WITH REPLICATION = {'class':'NetworkTopologyStrategy', 'us-east-1':'3', 'ap-southeast-1':'3','eu-west-1':'3'};

ALTER KEYSPACE

を使用してALTER KEYSPACE、キースペースにタグを追加または削除できます。

タグを追加または削除するには、次の構文を使用できます。

[Syntax] (構文)


alter_keyspace_statement ::= 
    ALTER KEYSPACE keyspace_name
    [[ADD | DROP] TAGS

Where:

keyspace_name は変更するキー空間の名前です。
TAGS — キー空間で追加または削除されるキーバリューペアタグのリスト。

例

キー空間を次のように変更します。


ALTER KEYSPACE my_keyspace ADD TAGS {'key1':'val1', 'key2':'val2'};

DROP KEYSPACE

DROP KEYSPACE ステートメントを使用してキー空間(テーブルなどあらゆるコンテンツを含む)を削除します。

[Syntax (構文)]


drop_keyspace_statement ::= 
    DROP KEYSPACE [ IF EXISTS ] keyspace_name

Where:

keyspace_name は、削除 (ドロップ) されるキー空間の名前です。

例


DROP KEYSPACE "myGSGKeyspace";

テーブル

テーブルは Amazon Keyspaces の主要なデータ構造です。テーブル内のデータは行と列で編成されます。これらの列のサブセットは、パーティションキーの指定によるパーティショニング (および最終的にはデータ配置) を決定するために使用されます。

別の列セットをクラスタリング列に定義できます。つまり、クエリ実行に述語として盛り込めるということです。

デフォルトでは、新規のテーブルはオンデマンドのスループットキャパシティがある状態で作成されます。新規のテーブルと既存のテーブルのキャパシティモードは変更できます。読み込み/書き込みのキャパシティスループットモードの詳細については、「Amazon Keyspaces で読み取り/書き込みキャパシティモードを設定する」を参照してください。

プロビジョンドモードのテーブルでは、オプションのを設定できますAUTOSCALING_SETTINGS。Amazon Keyspaces の自動スケーリングと使用可能なオプションの詳細については、「」を参照してください既存のテーブルで自動スケーリングを設定する。

Amazon Keyspaces テーブルのクォータ制限と制約については、「Amazon Keyspaces (Apache Cassandra 向け) のクォータ」を参照してください。

テーブルのステートメント

CREATE TABLE
ALTER TABLE
RESTORE TABLE
DROP TABLE

CREATE TABLE

CREATE TABLE ステートメントを使用して新しいテーブルを作成します。

[Syntax (構文)]


create_table_statement ::=  CREATE TABLE [ IF NOT EXISTS ] table_name
    '('
        column_definition 
        ( ',' column_definition )*
        [ ',' PRIMARY KEY '(' primary_key ')' ]
    ')' [ WITH table_options ]

column_definition      ::=  column_name cql_type [ FROZEN ][ STATIC ][ PRIMARY KEY]

primary_key            ::=  partition_key [ ',' clustering_columns ]

partition_key          ::=  column_name
                              | '(' column_name ( ',' column_name )* ')'

clustering_columns     ::=  column_name ( ',' column_name )*

table_options          ::=  [table_options]
                              | CLUSTERING ORDER BY '(' clustering_order ')' [ AND table_options ]
                              | options
                              | CUSTOM_PROPERTIES
                              | AUTOSCALING_SETTINGS
                              | default_time_to_live
                              | TAGS

clustering_order       ::=  column_name (ASC | DESC) ( ',' column_name (ASC | DESC) )*

Where:

table_name は作成するテーブルの名前です。
column_definition は以下で構成されます。
- column_name – 列の名前。
- cql_type — Amazon Keyspaces のデータ型 (「データ型」を参照)。
- FROZEN— この種の列 collection (LIST、SET、またはMAP など) をフリーズとして指定します。フリーズコレクションは 1 つの不変の値にシリアル化され、BLOBと同様に扱われます。詳細については、「コレクション型」を参照してください。
- STATIC — この列を静的として指定します。静的列には、同じパーティション内のすべての行で共有される値が保存されます。
- PRIMARY KEY — この列をテーブルのプライマリキーとして指定します。
primary_key は以下で構成されます。
- partition_key
- clustering_columns
partition_key:
- パーティションキーは、1 つの列である場合もあれば、2 つ以上の列で構成される複合値である場合もあります。プライマリキーのパーティションキー部分は必須で、これによって Amazon Keyspaces におけるデータの保存方法が決まります。
clustering_columns:
- プライマリキーのオプションのクラスタリング列部分は、各パーティションにおけるデータのクラスター処理方法とソート方法を決定するものです。
table_options は以下で構成されます。
- CLUSTERING ORDER BY – テーブルCLUSTERINGORDERのデフォルトは、 ASC (昇順) ソート方向のクラスタリングキーで構成されます。デフォルトのソート動作をオーバーライドするには、この値を指定します。
- CUSTOM_PROPERTIES — Amazon Keyspaces に固有の設定のマップ。
  - capacity_mode: テーブルの読み取り/書き込みスループットキャパシティモードを指定します。オプションは throughput_mode:PAY_PER_REQUEST と throughput_mode:PROVISIONED です。プロビジョンドキャパシティモードには入力として read_capacity_units と write_capacity_units が必要です。デフォルト: throughput_mode:PAY_PER_REQUEST。
  - client_side_timestamps: テーブルに対してクライアント側のタイムスタンプを有効にするか無効にするかを指定します。オプションは {'status': 'enabled'} と {'status': 'disabled'} です。指定しない場合、デフォルトの status:disabled になります。クライアント側のタイムスタンプをテーブルで有効にした後は、この設定を無効にすることはできません。
  - encryption_specification: 保管データ暗号化の暗号化オプションを指定します。指定しない場合、デフォルトの encryption_type:AWS_OWNED_KMS_KEY になります。暗号化オプションのカスタマーマネージドキーには、 AWS KMS 入力としての Amazon リソースネーム (ARN) 形式のキー: kms_key_identifier:ARN: kms_key_identifier:ARN。
  - point_in_time_recovery: テーブルに対して point-in-time 復元を有効または無効にするかどうかを指定します。オプションは status:enabled と status:disabled です。指定しない場合、デフォルトの status:disabled になります。
  - replica_updates: に固有のマルチリージョンテーブルの設定を指定します。 AWS リージョン。マルチリージョンテーブルの場合、テーブルの読み込み容量はごとに異なるように設定できます。 AWS リージョン。これを行うには、次のパラメータを設定します。詳細な説明と例については、「Amazon Keyspaces で自動スケーリングを使用してプロビジョニングモードでマルチリージョンテーブルを作成する」を参照してください。
    
    region – AWS リージョン次の設定のテーブルレプリカの。
    
    read_capacity_units
  - TTL: テーブルの有効期限 (TTL) カスタム設定を有効にします。有効にする場合は、status:enabled を使用します。デフォルト: status:disabled。TTL を有効にした後、そのテーブルに対してそれを無効にすることはできません。
- AUTOSCALING_SETTINGS には、プロビジョニングモードのテーブルに対する以下のオプション設定が含まれています。詳細な説明と例については、「自動スケーリングを使用して新しいテーブルを作成する」を参照してください。
  - provisioned_write_capacity_autoscaling_update:
    
    autoscaling_disabled – 書き込み容量の自動スケーリングを有効にするには、値をに設定しますfalse。デフォルト: true。(オプション)
    minimum_units – テーブルが常にサポートする準備が整っている必要がある書き込みスループットの最小レベル。値は 1 からアカウントの 1 秒あたりの最大スループットクォータ (デフォルトでは 40,000) の間でなければなりません。
    maximum_units – テーブルが常にサポートする準備が整っている必要がある書き込みスループットの最大レベル。値は 1 からアカウントの 1 秒あたりの最大スループットクォータ (デフォルトでは 40,000) の間でなければなりません。
    scaling_policy – Amazon Keyspaces はターゲット追跡ポリシーをサポートしています。自動スケーリングターゲットは、テーブルのプロビジョニングされた書き込み容量です。
    
    target_tracking_scaling_policy_configuration – ターゲット追跡ポリシーを定義するには、ターゲット値を定義する必要があります。ターゲットの追跡期間とクールダウン期間の詳細については、Application Auto Scaling ユーザーガイドの「ターゲット追跡スケーリングポリシー」を参照してください。 Auto Scaling
    
    target_value – テーブルのターゲット使用率。Amazon Keyspaces の自動スケーリングにより、プロビジョンドキャパシティに対する消費キャパシティの比率がこの値以下になります。target_value をパーセンテージとして定義します。20～90 の倍数。(必須)
    scale_in_cooldown – 別のスケールインアクティビティが開始される前にテーブルが安定する、スケーリングアクティビティ間の秒単位のクールダウン期間。値が指定されていない場合、デフォルトは 0 です。(オプション)
    scale_out_cooldown – 別のスケールアウトアクティビティが開始される前にテーブルが安定する、スケーリングアクティビティ間の秒単位のクールダウン期間。値が指定されていない場合、デフォルトは 0 です。(オプション)
    disable_scale_in: テーブルに対して scale-inが無効か有効かbooleanを指定する。このパラメータはデフォルトで無効になっています。をオンにするにはscale-in、boolean値をに設定しますFALSE。つまり、ユーザーに代わってテーブルの容量が自動的にスケールダウンされます。(オプション)
  - provisioned_read_capacity_autoscaling_update:
    
    autoscaling_disabled - 読み取り容量の自動スケーリングを有効にするには、値をに設定しますfalse。デフォルト: true。(オプション)
    minimum_units – テーブルが常にサポートする準備が整っている必要があるスループットの最小レベル。値は 1 からアカウントの 1 秒あたりの最大スループットクォータ (デフォルトでは 40,000) の間でなければなりません。
    maximum_units – テーブルが常にサポートする準備が整っている必要があるスループットの最大レベル。値は 1 からアカウントの 1 秒あたりの最大スループットクォータ (デフォルトでは 40,000) の間でなければなりません。
    scaling_policy – Amazon Keyspaces はターゲット追跡ポリシーをサポートしています。自動スケーリングターゲットは、テーブルのプロビジョニングされた読み込み容量です。
    
    target_tracking_scaling_policy_configuration – ターゲット追跡ポリシーを定義するには、ターゲット値を定義する必要があります。ターゲットの追跡期間とクールダウン期間の詳細については、Application Auto Scaling ユーザーガイドの「ターゲット追跡スケーリングポリシー」を参照してください。 Auto Scaling
    
    target_value – テーブルのターゲット使用率。Amazon Keyspaces の自動スケーリングにより、プロビジョンドキャパシティに対する消費キャパシティの比率がこの値以下になります。target_value をパーセンテージとして定義します。20～90 の倍数。(必須)
    
    scale_in_cooldown – 別のスケールインアクティビティが開始される前にテーブルが安定する、スケーリングアクティビティ間の秒単位のクールダウン期間。値が指定されていない場合、デフォルトは 0 です。(オプション)
    
    scale_out_cooldown – 別のスケールアウトアクティビティが開始される前にテーブルが安定する、スケーリングアクティビティ間の秒単位のクールダウン期間。値が指定されていない場合、デフォルトは 0 です。(オプション)
    
    disable_scale_in: テーブルに対して scale-inが無効か有効かbooleanを指定する。このパラメータはデフォルトで無効になっています。をオンにするにはscale-in、boolean値をに設定しますFALSE。つまり、ユーザーに代わってテーブルの容量が自動的にスケールダウンされます。(オプション)
  - replica_updates: を指定します。 AWS リージョンマルチリージョンテーブルの特定の自動スケーリング設定。マルチリージョンテーブルの場合、テーブルの読み込み容量はごとに異なるように設定できます。 AWS リージョン。これを行うには、次のパラメータを設定します。詳細な説明と例については、「Amazon Keyspaces のマルチリージョンテーブルのプロビジョニングされた容量と自動スケーリング設定を更新する」を参照してください。
    
    region – AWS リージョン次の設定のテーブルレプリカの。
    
    provisioned_read_capacity_autoscaling_update
    
    autoscaling_disabled – テーブルの読み込み容量の自動スケーリングを有効にするには、値をに設定しますfalse。デフォルト: true。(オプション)
    
    注記
    マルチリージョンテーブルの自動スケーリングは、テーブルのすべてのレプリカで有効または無効にする必要があります。
    
    minimum_units – テーブルが常にサポートする準備が整っている必要がある読み取りスループットの最小レベル。値は 1 からアカウントの 1 秒あたりの最大スループットクォータ (デフォルトでは 40,000) の間でなければなりません。
    maximum_units – テーブルが常にサポートする準備が整っている必要がある読み取りスループットの最大レベル。値は、1 からアカウントの 1 秒あたりの最大スループットクォータ (デフォルトでは 40,000) の間でなければなりません。
    scaling_policy — Amazon Keyspaces はターゲット追跡ポリシーをサポートしています。自動スケーリングターゲットは、テーブルのプロビジョニングされた読み込み容量です。
    
    target_tracking_scaling_policy_configuration – ターゲット追跡ポリシーを定義するには、ターゲット値を定義する必要があります。ターゲットの追跡期間とクールダウン期間の詳細については、Application Auto Scaling ユーザーガイドの「ターゲット追跡スケーリングポリシー」を参照してください。 Auto Scaling
    
    target_value – テーブルのターゲット使用率。Amazon Keyspaces の自動スケーリングにより、消費された読み込み容量とプロビジョニングされた読み込み容量の比率がこの値またはその近くにとどまるようになります。target_value をパーセンテージとして定義します。20～90 の倍数。(必須)
    scale_in_cooldown – 別のスケールインアクティビティが開始される前にテーブルが安定する、スケーリングアクティビティ間の秒単位のクールダウン期間。値が指定されていない場合、デフォルトは 0 です。(オプション)
    scale_out_cooldown – 別のスケールアウトアクティビティが開始される前にテーブルを安定させる、スケーリングアクティビティ間の秒単位のクールダウン期間。値が指定されていない場合、デフォルトは 0 です。(オプション)
    disable_scale_in: テーブルに対して scale-inが無効か有効かbooleanを指定する。このパラメータはデフォルトで無効になっています。をオンにするにはscale-in、boolean値をに設定しますFALSE。つまり、ユーザーに代わってテーブルの読み取り容量が自動的にスケールダウンされます。(オプション)
- default_time_to_live — テーブルのデフォルトの有効期限 (TTL) 設定 (秒)。
- TAGS – 作成時にリソースにアタッチされるキーバリューペアタグのリスト。
clustering_order は以下で構成されます。
- column_name – 列の名前。
- ASC | DESC — 昇順修飾子 (ASC) または降順修飾子 (DESC) を設定します。指定しない場合、デフォルトの順序はですASC。

例


CREATE TABLE IF NOT EXISTS "my_keyspace".my_table (
                                            id text,
                                            name text,
                                            region text,
                                            division text,
                                            project text,
                                            role text,
                                            pay_scale int,
                                            vacation_hrs float,
                                            manager_id text,
                                            PRIMARY KEY (id,division))
                                            WITH CUSTOM_PROPERTIES={
                                                'capacity_mode':{
                                                        'throughput_mode': 'PROVISIONED', 'read_capacity_units': 10, 'write_capacity_units': 20
                                                    },
                                                'point_in_time_recovery':{'status': 'enabled'},
                                                'encryption_specification':{
                                                        'encryption_type': 'CUSTOMER_MANAGED_KMS_KEY', 
                                                        'kms_key_identifier':'arn:aws:kms:eu-west-1:5555555555555:key/11111111-1111-111-1111-111111111111'
                                                    }
                                            }
                                            AND CLUSTERING ORDER BY (division ASC) 
                                            AND TAGS={'key1':'val1', 'key2':'val2'}
                                            AND default_time_to_live = 3024000;

クラスタリング列を使用しているテーブルでは、テーブル定義で非クラスタリング列を静的として宣言できます。静的列の詳細については、「Amazon Keyspaces の静的列の容量消費量を見積もる」を参照してください。

例


CREATE TABLE "my_keyspace".my_table (
                                            id int,
                                            name text,
                                            region text,
                                            division text,
                                            project text STATIC,
                                            PRIMARY KEY (id,division));

ALTER TABLE

ALTER TABLE ステートメントを使用して、新しい列の追加、タグの追加、テーブルのカスタムプロパティの変更を行います。

[Syntax] (構文)


alter_table_statement ::=  ALTER TABLE table_name    
 
        [ ADD ( column_definition | column_definition_list)  ] 
        [[ADD | DROP] TAGS {'key1':'val1', 'key2':'val2'}]            
        [ WITH table_options [ , ... ] ] ;
        
column_definition      ::=  column_name cql_type

Where:

table_name は変更するテーブルの名前です。
column_definition は追加する列の名前とデータ型です。
column_definition_list は括弧内に配置された列のリストでカンマで区切られています。
table_options は以下で構成されます。
- CUSTOM_PROPERTIES — Amazon Keyspaces に固有の設定のマップ。
  - capacity_mode: テーブルの読み取り/書き込みスループットキャパシティモードを指定します。オプションは throughput_mode:PAY_PER_REQUEST と throughput_mode:PROVISIONED です。プロビジョンドキャパシティモードには入力として read_capacity_units と write_capacity_units が必要です。デフォルト: throughput_mode:PAY_PER_REQUEST。
  - client_side_timestamps: テーブルに対してクライアント側のタイムスタンプを有効にするか無効にするかを指定します。オプションは {'status': 'enabled'} と {'status': 'disabled'} です。指定しない場合、デフォルトの status:disabled になります。クライアント側のタイムスタンプをテーブルで有効にした後は、この設定を無効にすることはできません。
  - encryption_specification: 保管データ暗号化の暗号化オプションを指定します。オプションは encryption_type:AWS_OWNED_KMS_KEY と encryption_type:CUSTOMER_MANAGED_KMS_KEY です。暗号化オプションのカスタマーマネージドキーには、 AWS KMS 入力としての Amazon リソースネーム (ARN) 形式のキー: kms_key_identifier:ARN。
  - point_in_time_recovery: テーブルに対して point-in-time 復元を有効または無効にするかどうかを指定します。オプションは status:enabled と status:disabled です。デフォルト: status:disabled。
  - replica_updates: を指定します。 AWS リージョンマルチリージョンテーブルの特定の設定。マルチリージョンテーブルの場合、テーブルの読み込み容量はごとに異なるように設定できます。 AWS リージョン。これを行うには、次のパラメータを設定します。詳細な説明と例については、「Amazon Keyspaces のマルチリージョンテーブルのプロビジョニングされた容量と自動スケーリング設定を更新する」を参照してください。
    
    region – AWS リージョン次の設定のテーブルレプリカの。
    
    read_capacity_units
  - ttl: テーブルの有効期限 (TTL) カスタム設定を有効にします。有効にする場合は、status:enabled を使用します。デフォルト: status:disabled。ttl を有効にした後、そのテーブルに対してそれを無効にすることはできません。
- AUTOSCALING_SETTINGS には、プロビジョニングされたテーブルのオプションの自動スケーリング設定が含まれています。構文と詳細な説明については、「」を参照してくださいCREATE TABLE。例については、「既存のテーブルで自動スケーリングを設定する」を参照してください。
default_time_to_live: テーブルのデフォルトの有効期限 (TTL) 設定 (秒)。
TAGS はリソースにアタッチされるキーバリューペアタグのリストです。

注記

ではALTERTABLE、単一のカスタムプロパティのみ変更できます。同じステートメントに複数のALTERTABLEコマンドを組み合わせることはできません。

例

次のステートメントは、既存のテーブルに列を追加する方法を示しています。


ALTER TABLE mykeyspace.mytable ADD (ID int);

このステートメントは、既存のテーブルに 2 つのコレクション列を追加する方法を示します。

ネストされたフリーズコレクションを含むフリーズコレクション列 col_frozen_list
ネストされたフリーズコレクションを含む非フリーズコレクション列 col_map


ALTER TABLE my_Table ADD(col_frozen_list FROZEN<LIST<FROZEN<SET<TEXT>>>>, col_map MAP<INT, FROZEN<SET<INT>>>);

テーブルのキャパシティモードを変更し、読み取りおよび書き込みのキャパシティユニットを指定するには、次のステートメントを使用します。


ALTER TABLE mykeyspace.mytable WITH CUSTOM_PROPERTIES={'capacity_mode':{'throughput_mode': 'PROVISIONED', 'read_capacity_units': 10, 'write_capacity_units': 20}};

次のステートメントは、テーブルのカスタマーマネージドKMSキーを指定します。


ALTER TABLE mykeyspace.mytable WITH CUSTOM_PROPERTIES={     
              'encryption_specification':{ 
                      'encryption_type': 'CUSTOMER_MANAGED_KMS_KEY', 
                      'kms_key_identifier':'arn:aws:kms:eu-west-1:5555555555555:key/11111111-1111-111-1111-111111111111'     
                  } 
         };

テーブルの point-in-time 復元を有効にするには、次のステートメントを使用できます。


ALTER TABLE mykeyspace.mytable WITH CUSTOM_PROPERTIES={'point_in_time_recovery': {'status': 'enabled'}};

テーブルのデフォルトの有効期限 (TTL) 値を秒単位で設定するには、次のステートメントを使用します。


ALTER TABLE my_table WITH default_time_to_live = 2592000;

このステートメントは、テーブルのカスタムの有効期限 (TTL) 設定を有効にします。


ALTER TABLE mytable WITH CUSTOM_PROPERTIES={'ttl':{'status': 'enabled'}};

RESTORE TABLE

RESTORE TABLE ステートメントを使用して、特定時点 (ポイントインタイム) にテーブルを復元 (リストア) します。このステートメントでは、テーブルで point-in-time リカバリを有効にする必要があります。詳細については、「Amazon Keyspaces の point-in-time リカバリによるデータのバックアップと復元」を参照してください。

[Syntax] (構文)


restore_table_statement ::=  
    RESTORE TABLE restored_table_name FROM TABLE source_table_name 
                    [ WITH table_options [ , ... ] ];

Where:

restored_table_name は復元されたテーブルの名前です。
source_table_name はソーステーブルの名前です。
table_options は以下で構成されます。
- restore_timestamp は、8601 ISO 形式の復元ポイント時間です。これが指定されない場合は、現在のタイムスタンプが使用されます。
- CUSTOM_PROPERTIES — Amazon Keyspaces に固有の設定のマップ。
  - capacity_mode: テーブルの読み取り/書き込みスループットキャパシティモードを指定します。オプションは throughput_mode:PAY_PER_REQUEST と throughput_mode:PROVISIONED です。プロビジョンドキャパシティモードには入力として read_capacity_units と write_capacity_units が必要です。デフォルトは、ソーステーブルの現在の設定です。
  - encryption_specification: 保管データ暗号化の暗号化オプションを指定します。オプションは encryption_type:AWS_OWNED_KMS_KEY と encryption_type:CUSTOMER_MANAGED_KMS_KEY です。暗号化オプションのカスタマーマネージドキーには、 AWS KMS 入力としての Amazon リソースネーム (ARN) 形式のキー: kms_key_identifier:ARN。カスタマーマネージドキーで暗号化されたテーブルを、で暗号化されたテーブルに復元するには AWS 所有のキー、Amazon Keyspaces はにアクセスする必要があります AWS KMS ソーステーブルのキー。
  - point_in_time_recovery: テーブルに対して point-in-time 復元を有効または無効にするかどうかを指定します。オプションは status:enabled と status:disabled です。新しいテーブルを作成する場合とは異なり、復元されたテーブルのデフォルトのステータスは status:enabled になります。これは設定がソーステーブルから継承されるためです。復元されたテーブルPITRのを無効にするには、をstatus:disabled明示的に設定する必要があります。
  - replica_updates: を指定します。 AWS リージョンマルチリージョンテーブルの特定の設定。マルチリージョンテーブルの場合、テーブルの読み込み容量はごとに異なるように設定できます。 AWS リージョン。これを行うには、次のパラメータを設定します。
    
    region – AWS リージョン次の設定のテーブルレプリカの。
    
    read_capacity_units
- AUTOSCALING_SETTINGS には、プロビジョニングされたテーブルのオプションの自動スケーリング設定が含まれています。構文と説明の詳細については、「」を参照してくださいCREATE TABLE。
- TAGS はリソースにアタッチされるキーバリューペアタグのリストです。

注記

削除されたテーブルは、削除時にのみ復元できます。

例


RESTORE TABLE mykeyspace.mytable_restored from table mykeyspace.my_table 
WITH restore_timestamp = '2020-06-30T04:05:00+0000'
AND custom_properties = {'point_in_time_recovery':{'status':'disabled'}, 'capacity_mode':{'throughput_mode': 'PROVISIONED', 'read_capacity_units': 10, 'write_capacity_units': 20}}
AND TAGS={'key1':'val1', 'key2':'val2'};

DROP TABLE

キー空間からテーブルを削除するには DROP TABLE ステートメントを使用します。

[Syntax] (構文)


drop_table_statement ::=  
    DROP TABLE [ IF EXISTS ] table_name

Where:

IF EXISTS により、テーブルが存在しない場合の DROP TABLE の失敗が阻止されます。(オプション)
table_name は削除 (ドロップ) されるテーブルの名前です。

例


DROP TABLE "myGSGKeyspace".employees_tbl;

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

言語要素

DML ステートメント

DDL Amazon Keyspaces の ステートメント (データ定義言語）

トピック

Keyspaces

注記

キースペースのステートメント

CREATE KEYSPACE

ALTER KEYSPACE

DROP KEYSPACE

テーブル

テーブルのステートメント

CREATE TABLE

注記

ALTER TABLE

注記

RESTORE TABLE

注記

DROP TABLE

DDL Amazon Keyspaces のステートメント (データ定義言語）