Amazon QLDB のINSERT コマンド - Amazon Quantum Ledger Database (Amazon QLDB)
構文パラメータ戻り値例ドライバーを使用したプログラムでの実行

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

Amazon QLDB のINSERT コマンド

Amazon QLDB では、テーブルに 1 つまたは複数の Amazon Ion ドキュメントを追加するには、INSERT コマンドを使用します。

注記

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

構文

単一のドキュメントを挿入します。

INSERT INTO table_name VALUE document

複数のドキュメントを挿入します。

INSERT INTO table_name << document, document, ... >>

パラメータ

table_name

データを挿入するユーザーテーブルの名前。このテーブルは既存であることが必要です。DML ステートメントは、デフォルトのユーザービューでのみサポートされています。

document

有効な QLDB ドキュメント。1 つ以上のドキュメントを指定する必要があります。複数のドキュメントはカンマで区切る必要があります。

ドキュメントは中括弧 ({...}) で表す必要があります。

ドキュメント内の各フィールド名は、大文字小文字を区別する Ion シンボルで、PartiQL では一重引用符 ('...') で表すことができます。

文字列値も、PartiQL では一重引用符 ('...') で表されます。

Ion リテラルはバックティック (`...`) で示すことができます。

注記

二重山かっこ (<<...>>) は、順序付けられていないコレクション (PartiQL ではバッグと呼ばれます) を示し、複数のドキュメントを挿入する場合にのみ必要です。

戻り値

documentId - 挿入した各ドキュメントの ID。

例

単一のドキュメントを挿入します。

INSERT INTO VehicleRegistration VALUE
{
    'VIN' : 'KM8SRDHF6EU074761', --string
    'RegNum' : 1722, --integer
    'State' : 'WA',
    'City' : 'Kent',
    'PendingPenaltyTicketAmount' : 130.75, --decimal
    'Owners' : { --nested struct
        'PrimaryOwner' : { 'PersonId': '294jJ3YUoH1IEEm8GSabOs' },
        'SecondaryOwners' : [ --list of structs
            { 'PersonId' : '1nmeDdLo3AhGswBtyM1eYh' },
            { 'PersonId': 'IN7MvYtUjkp1GMZu0F6CG9' }
        ]
    },
    'ValidFromDate' : `2017-09-14T`, --Ion timestamp literal with day precision
    'ValidToDate' : `2020-06-25T`
}

このステートメントは、挿入したドキュメントの一意の ID を次のように返します。

{
    documentId: "2kKuOPNB07D2iTPBrUTWGl"
}

複数のドキュメントを挿入します。

INSERT INTO Person << 
{
    'FirstName' : 'Raul',
    'LastName' : 'Lewis',
    'DOB' : `1963-08-19T`,
    'GovId' : 'LEWISR261LL',
    'GovIdType' : 'Driver License',
    'Address' : '1719 University Street, Seattle, WA, 98109'
},
{
    'FirstName' : 'Brent',
    'LastName' : 'Logan',
    'DOB' : `1967-07-03T`,
    'GovId' : 'LOGANB486CG',
    'GovIdType' : 'Driver License',
    'Address' : '43 Stockert Hollow Road, Everett, WA, 98203'
},
{
    'FirstName' : 'Alexis',
    'LastName' : 'Pena',
    'DOB' : `1974-02-10T`,
    'GovId' : '744 849 301',
    'GovIdType' : 'SSN',
    'Address' : '4058 Melrose Street, Spokane Valley, WA, 99206'
}
>>

このステートメントは、挿入した各ドキュメントの一意の ID を次のように返します。

{
    documentId: "6WXzLscsJ3bDWW97Dy8nyp"
},
{
    documentId: "35e0ToZyTGJ7LGvcwrkX65"
},
{
    documentId: "BVHPcH612o7JROQ4yP8jiH"
}

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

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