CREATE TABLE Amazon の コマンド QLDB - Amazon Quantum 台帳データベース (Amazon QLDB）
構文パラメータ戻り値作成時のテーブルのタグ付け例ドライバーを使用したプログラムでの実行

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

CREATE TABLE Amazon の コマンド QLDB

重要

サポート終了通知: 既存のお客様は、07/31/2025 のサポート終了QLDBまで Amazon を使用できます。詳細については、「Amazon Ledger QLDB を Amazon Aurora Postgre に移行するSQL」を参照してください。

Amazon ではQLDB、 CREATE TABLE コマンドを使用して新しいテーブルを作成します。

テーブルには名前空間のない単純な名前を付けます。QLDB はオープンコンテンツをサポートし、スキーマを適用しないため、テーブルの作成時に属性やデータ型を定義しません。

注記

台帳でこの PartiQL コマンドを実行するためのアクセスを制御する方法については、「Amazon での標準アクセス許可モードの開始方法 QLDB」を参照してください。

構文

CREATE TABLE table_name [ WITH (aws_tags = `{'key': 'value'}`) ]

パラメータ

table_name

作成するテーブルの一意の名前。同じ名前のアクティブなテーブルがまだ存在していない必要があります。以下は命名に関する制約です。

  • 1～128 個の英数字またはアンダースコア文字のみを使用する必要があります。

  • 1 字目は文字またはアンダースコアでなければなりません。

  • 残りの文字は英数字とアンダースコアの任意の組み合わせにできます。

  • 大文字と小文字を区別します。

  • QLDB PartiQL の予約語は使用できません。

'key': 'value'

(オプション) 作成時にテーブルリソースにアタッチするタグ。各タグは、キーと値のペアとして定義されます。この場合、キーと値はそれぞれ一重引用符で示されます。キーと値のペアはそれぞれ、バックティックで示される Amazon Ion 構造内で定義されます。

作成時のテーブルのタグ付けは、現在 STANDARD 許可モードの台帳のみでサポートされています。

戻り値

tableId - 作成したテーブルの一意の ID。

作成時のテーブルのタグ付け

注記

作成時のテーブルのタグ付けは、現在 STANDARD 許可モードの台帳のみでサポートされています。

必要に応じて、CREATE TABLE ステートメントでタグを指定して、テーブルリソースをタグ付けできます。タグの詳細については、Amazon QLDBリソースのタグ付けを参照してください。次の例では、Vehicle という名前のテーブルをタグ environment=production を付けて作成します。

CREATE TABLE Vehicle WITH (aws_tags = `{'environment': 'production'}`)

作成時にテーブルにタグを付けるには、qldb:PartiQLCreateTable および qldb:TagResource アクションの両方にアクセスする必要があります。QLDB リソースのアクセス許可の詳細については、「」を参照してくださいAmazon での のQLDB仕組み IAM。

作成時にリソースにタグ付けすることで、リソース作成後にカスタムタグ付けスクリプトを実行する必要がなくなります。テーブルにタグを付けると、それらのタグに基づいてテーブルへのアクセスを制御できます。例えば、特定のタグを持つテーブルにのみフルアクセスを付与できます。JSON ポリシーの例については、「」を参照してくださいテーブルタグに基づくすべてのアクションへのフルアクセス。

例

CREATE TABLE VehicleRegistration
CREATE TABLE Vehicle WITH (aws_tags = `{'environment': 'development'}`)
CREATE TABLE Vehicle WITH (aws_tags = `{'key1': 'value1', 'key2': 'value2'}`)

ドライバーを使用したプログラムでの実行

QLDB ドライバーを使用してこのステートメントをプログラムで実行する方法については、「ドライバーの開始方法」の以下のチュートリアルを参照してください。