お知らせ:

当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

行の挿入

テーブルの一意のIDまたは名前を参照して、Catalyst Data Storeのテーブルに新しい行を挿入できます。次のセクションで説明するように、テーブルに複数の行を挿入することもできます。

以下のコードで使用されているtable_service参照は、以前に作成されたテーブルインスタンスまたはテーブルメタのいずれかです。

注意:
  • テーブルとその中のカラムは事前に作成されている必要があります。コンソールからテーブルを作成し、カラムを作成できます。

  • 開発環境では、各プロジェクトの各テーブルに最大5000件のレコードを挿入できます。開発環境では、各プロジェクト全体で最大25,000件のレコードを作成できます。本番環境ではレコード作成の上限はありません。

単一行の挿入

以下に示すように、行の詳細を{カラム名 : カラム値}形式で含む辞書を作成し、それを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