Show Menu
トピック×

データセットの作成

カタログAPIを使用してデータセットを作成するには、そのデータセットの基となるExperience Data Model(XDM)スキーマの $id 値を把握しておく必要があります。 スキーマIDを取得したら、カタログAPIのエンドポイントにPOSTリクエストを行って、データセットを作成でき /datasets ます。
このドキュメントでは、Catalogでデータセットオブジェクトを作成する方法についてのみ説明します。 データセットの作成、設定、監視の手順について詳しくは、次の チュートリアルを参照してください
API形式
POST /dataSets

リクエスト
次のリクエストは、以前に定義したスキーマーを参照するデータセットを作成します。
curl -X POST \
  'https://platform.adobe.io/data/foundation/catalog/dataSets?requestDataSource=true' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '{
    "name":"LoyaltyMembersDataset",
    "schemaRef": {
        "id": "https://ns.adobe.com/{TENANT_ID}/schemas/719c4e19184402c27595e65b931a142b",
        "contentType": "application/vnd.adobe.xed+json;version=1"
    },
    "fileDescription": {
        "persisted": true,
        "containerFormat": "parquet",
        "format": "parquet"
    }
}'

プロパティ
説明
name
作成するデータセットの名前。
schemaRef.id
データセットの基となるXDMスキーマのURI $id 値。
次の例では、 パーケット ・ファイル形式を containerFormat プロパティに使用します。 JSONファイル形式の使用例については、『 batch ingestion developer guide 』を参照してください。
応答
正常に完了すると、HTTPステータス201(作成済み)と、新たに作成されたデータセットのIDを形式で含む配列で構成される応答オブジェクトが返され "@/datasets/{DATASET_ID}" ます。 データセットIDは、API呼び出しでデータセットを参照するために使用される、読み取り専用の、システム生成の文字列です。
[
    "@/dataSets/5c8c3c555033b814b69f947f"
]