Decision Optimization配備ジョブの出力データ

"output_data": [{
      "id":"solution.csv"
}]
Copy to clipboardクリップボードにコピーされました

データ資産

データ資産参照を使用して、スペースに存在するあらゆるデータ資産を検索し、データ・コネクタ統合機能の恩恵を受けることができます。

アセットがすでにそのスペースに存在し、アセットが更新されている場合は、「href」を使用して出力場所を指定できます。 例:

      "location": {
           "href": "/v2/assets/<ASSET_ID>?space_id=<SPACE_ID>"
      }
Copy to clipboardクリップボードにコピーされました

アセット名と説明を指定してアセットを作成することもできます。 この例では、アセット 'solution.csv を作成します。

      "location": {
            "name": "solution.csv",
            "description": "solution description"
      }
Copy to clipboardクリップボードにコピーされました

この例では、スペース内のデータ資産を更新するための出力データ参照を定義しています。

output_data_references": [{
      "type": "data_asset",
      "id" : "solution.csv",
      "connection": {},
      "location": {
            "href": "/v2/assets/<ASSET_ID>?space_id=<SPACE_ID>"
      }
}]
Copy to clipboardクリップボードにコピーされました

また、「nameフィールドを使用して、出力データを別の名前でアセットとして保存することもできます。 この例では、現在のスペースに「my_solution.csv名前の出力アセットを作成します。

"output_data_references": [{
      "type" : "data_asset",
      "id" : "solution.csv",
      "connection": {},
      "location": {
            "name": "my_solution.csv"
      }
}]
Copy to clipboardクリップボードにコピーされました

この例では、Microsoft Excelファイルのアセットをスペースに保存する方法を示します。

"output_data_references": [{
      "type": "data_asset",
      "id": "kpis.csv",
      "connection": {},
      "location": {
            "id": "<SPACE_ID>"
            "name": "kpis.xlsx"
      }
}]
Copy to clipboardクリップボードにコピーされました

識別子として正規表現を使うこともできる。 詳しくは正規表現を参照。

接続資産

接続アセットを使用して任意のデータを参照し、その都度認証情報を指定することなく接続を参照することができます。 セキュア接続を参照すると、ペイロードでインライン資格情報を使用する必要がなくなり、セキュリティーの向上にもつながります。 idを使って接続を識別することができます。 例:

"output_data_references": [{
      "type": "connection_asset",
      "id": "solution.csv",
      "connection": {
              "id" : "<CONNECTION_ID>",
      }
      "location": {  
              <data-connector interaction properties depending on connection type>
      }
}]
Copy to clipboardクリップボードにコピーされました

<CONNECTION_ID>は、接続のグローバル一意識別子です。 この識別子は、接続を作成し、プロジェクトで接続を編集するときに見つけることができます。 この識別子は、接続の編集ウィンドウのURLに表示されます。

ジョブの定義については、配置ジョブの定義を参照してください。

locationフィールドには、接続に必要なインタラクション・プロパティを指定することができる。

この例では、COS/S3バケットに接続している。 相互作用のプロパティは「locationフィールドに記載されている。

      "location": {
            "file_name" : "<FILENAME>",
            "bucket" : "<BUCKET_NAME>"
      }
Copy to clipboardクリップボードにコピーされました

この例では、Db2 アセットに接続しています。 相互作用のプロパティは「locationフィールドに記載されている。

      "location": {
            "table_name" : "<TABLE_NAME>",
            "schema_name" : "<SCHEMA_NAME>"
      }
Copy to clipboardクリップボードにコピーされました

この例では、COS/S3バケットに接続している。 接続リファレンスは「idフィールドに記載される。

"output_data_references": [{
      "type": "connection_asset",
      "id": "diet_food.csv",
      "connection": {
            "id" : "<CONNECTION_ID>"
      },
      "location": {
            "file_name" : "<FILENAME>",
            "bucket" : "<BUCKET_NAME>"
      }
}]
Copy to clipboardクリップボードにコピーされました

この例では、Microsoft ExcelファイルをCOS/S3バケットに保存する方法を示します。

"output_data_references": [{
      "type": "kpis.csv",
      "id": "kpis.csv",
      "connection": {
            "id" : "<CONNECTION_ID>"
      },
      "location": {
            "file_name" : "<kpis.xlsx>",
            "bucket" : "<BUCKET_NAME>"
      }
}]
Copy to clipboardクリップボードにコピーされました

この例では、Db2 アセットに接続する方法を示します。 接続リファレンスは'idフィールドに記載される。

"output_data_references": [{
      "type" : "connection_asset",
      "id" : "solution.csv",
      "connection" : {
            "id" : "<CONNECTION_ID>"
      },
      "location" : {
            "table_name" : "<TABLE_NAME>",
            "schema_name" : "<SCHEMA_NAME>"
      }
}]
Copy to clipboardクリップボードにコピーされました

Decision Optimizationで利用可能なさまざまな接続の詳細については、 Decision Optimizationでサポートされているデータ・ソースを参照してください。

URL参照データ

URL参照データを使えば、特定のURLのデータを保存することができる。

この例では、PUTコマンドを使って、solution.csv出力ファイルをサーバーに置いています。

"output_data_references": {
      "type": "url",
      "id": "solution.csv",
      "connection": {
            "verb": "PUT",
            "url": "https://myserver.com/diet_food.csv",
            "headers": {
                  "Content-Type": "application/x-www-form-urlencoded"
            }
      },
      "location": {}
}
Copy to clipboardクリップボードにコピーされました

"id":".*\\.csv"
Copy to clipboardクリップボードにコピーされました

"id":".*"
Copy to clipboardクリップボードにコピーされました

"output_data_references": [{
      "type" : "connection_asset",
      "id" : ".*",
      "connection": {
            "id" : "<CONNECTION_ID>"
      },
      "location": {
            "bucket" : "<BUCKET_NAME>",
            "file_name": "${oaas_job_id}/${oaas_attachment_name}"
      }
}]
Copy to clipboardクリップボードにコピーされました