dataset.create

データセットを新規に作成します。

パラメータ

• dataset_name: string -- データセット名。
• columns: column_def array -- データセットのカラム情報。 column_def の配列として表現します。
• key_columns: string array -- レコードを一意に識別するカラム名の配列です。 レコードの登録時に、本項目に指定されたカラムの値が完全に一致するレコードが存在する場合は、新規登録ではなく既存レコードの更新となります。 本項目は省略可能です。 省略された場合はレコードを一意に識別するカラムは設定されません。

戻り値

作成されたデータセットのデータセット情報が戻されます。 詳細は dataset_info を参照してください。

実行例

リクエストデータ

{
    "id": 1,
    "jsonrpc": "2.0",
    "method": "dataset.create",
    "params": {
      "dataset_name": "my_dataset",
      "columns": [
        {
          "column_name": "id",
          "data_type": "int"
        },
        {
          "column_name": "name",
          "data_type": "varchar"
        },
        {
          "column_name": "email",
          "data_type": "varchar",
          "nullable": true
        }
      ],
      "key_columns": [
        "id"
      ]
    }
}

リクエスト実行

curl -H "Content-type: application/json" \
     -H "APIKey: 9c6f4574-89d1-4e3c-8af7-2549dc217fcf" \
     -H "Secret: aef8caingiej1ieNieJ3Phool4maeGohcies" \
     -X POST -d "@request.json" \
     https://localhost/api/v2/dataset/jsonrpc

レスポンス

{
  "result": {
    "id": 3,
    "session_id": null,
    "usename": "evwh_admin",
    "ddc_type": "table",
    "short_form": "my_dataset",
    "long_form": "my_dataset_1752026764.296948",
    "realname": "provenance.prov_b9888baddfafaf0c5aff1fa033f72118",
    "created_at": {
      "_type": "datetime",
      "val": "2025-07-09T11:06:04.296948+09:00"
    },
    "committed_at": null,
    "prepared_activity_id": null
  },
  "id": 1,
  "jsonrpc": "2.0"
}