行の挿入
テーブルの一意のIDまたは名前を参照して、Catalyst Data Storeのテーブルに新しい行を挿入できます。次のセクションで説明するように、テーブルに複数の行を挿入することもできます。
以下のコードで使用されているtable_service参照は、以前に作成されたテーブルインスタンスまたはテーブルメタのいずれかです。
注意:
単一行の挿入
以下に示すように、行の詳細を{カラム名 : カラム値}形式で含む辞書を作成し、それをinsert_row()メソッドの引数として渡す必要があります。これにより、一意のテーブル名またはテーブルIDで参照するテーブルに行が挿入されます。
行が挿入されると、一意のID値が自動的に生成されます。以下で使用されているコンポーネントインスタンスdatastore_serviceとテーブルインスタンスtable_serviceの詳細については、それぞれのヘルプセクションを参照してください。
使用するパラメータ
| パラメータ名 | データ型 | 定義 |
|---|---|---|
| row_data | Array | 必須パラメータです。挿入する行の詳細をキーと値のペアで保持します。 |
copy
#テーブルに単一行を挿入する
datastore_service = app.datastore()
table_service = datastore_service.table("Employee")
row_data = {'name': 'George Hamilton', 'id': '6868', 'age': '22'}
row_response = table_service.insert_row(row_data)
サンプルレスポンスを以下に示します:
copy
{
CREATORID: "2136000000006003",
MODIFIEDTIME: "2021-08-16 16:30:12:799",
Name: "George Hamilton",
Age: 22,
ID: 6868,
CREATEDTIME: "2021-08-16 16:30:12:799",
ROWID: "2136000000011015"
}
複数行の挿入
以下に示すように、行を含む配列を構築し、それをinsert_rows()メソッドの引数として渡すことで、テーブルに複数の行を挿入できます。以下で使用されているコンポーネントインスタンスdatastore_serviceとテーブルインスタンスtable_serviceの詳細については、それぞれのヘルプセクションを参照してください。
行オブジェクトの配列を含むレスポンスが返されます。
使用するパラメータ
| パラメータ名 | データ型 | 定義 |
|---|---|---|
| row_data | Array | 必須パラメータです。挿入する行の詳細をキーと値のペアで保持します。 |
copy
datastore_service = app.datastore()
table_service = datastore_service.table("Employee")
row_data = [{'name': 'Mark Wellington', 'id': '7218', 'age': '29'},
{'name': 'Zendaya Jones', 'id': '3211', 'age': '32'}]
row_response = table_service.insert_rows(row_data)
サンプルレスポンスを以下に示します:
copy
[
{
CREATORID: "2136000000006003",
MODIFIEDTIME: "2021-08-25 13:55:04:904",
Name: "Mark Wellington",
Age: 29,
ID: 7218,
CREATEDTIME: "2021-08-25 13:55:04:904",
ROWID: 2136000000011015
},
{
CREATORID: "2136000000006003",
MODIFIEDTIME: "2021-08-25 13:55:04:906",
Name: "Zendaya Jones",
Age: 32,
ID: 3211,
CREATEDTIME: "2021-08-25 13:55:04:906",
ROWID: 2136000000011016
}
]
情報: 上記の操作を実行するために必要な権限レベルを確認するには、SDKスコープの表を参照してください。
最終更新日 2026-03-30 13:40:30 +0530 IST
Yes
No
Send your feedback to us
Skip
Submit