인라인 데이터

요청에 인라인 데이터를 포함할 수 있습니다.

표 형식 인라인 데이터

이 예에서는 모델 입력 파일로 사용되는 해당 diet_food.csv 파일을 생성합니다. csv 파일만 지원됩니다.

"input_data": [{
      "id":"diet_food.csv",
      "fields" : ["name","unit_cost","qmin","qmax"],
      "values" : [
                 ["Roasted Chicken", 0.84, 0, 10]
      ]
}]

원시 인라인 데이터

이 유형의 인라인 데이터는 OPL .dat 파일이나 .lp 파일과 같은 파일에 유용합니다.

"input_data": [{
      "id":"model.lp",
      "content":"<model encoded as base64 string>"
}]

참조된 데이터

표 형식 데이터에 데이터 또는 연결 자산을 사용하는 경우 자산 유형에 관계없이 ' id ' 필드에 데이터 식별자 확장자로 ' .csv '를 사용합니다. 데이터 커넥터는 필요한 변환을 수행하므로 데이터 형식을 변경할 필요 없이 데이터를 로드할 수 있습니다. 따라서 데이터 커넥터를 사용하여 데이터를 참조함으로써 다양한 데이터 소스 유형 및 형식에 대해 동일한 Decision Optimization 모델을 사용할 수 있습니다. 다른 데이터 식별자 확장을 사용하는 경우, 데이터는 변환 없이 원시 데이터 바이너리 파일로 로드됩니다.

데이터 자원

데이터 자산 참조를 사용하여 공간에 있는 모든 데이터 자산을 찾고 데이터 커넥터 통합 기능의 이점을 누릴 수 있습니다. 프로젝트의 데이터 에셋을 사용하려면 먼저 해당 에셋을 스페이스로 승격해야 합니다.

이 예에서는 스페이스의 데이터 자산에 대한 입력 데이터 참조를 정의합니다.

"input_data_references": [{
      "type": "data_asset",
      "id": "diet_food.csv",
      "connection": {},
      "location": {
            "href": "/v2/assets/<ASSET_ID>?space_id=<SPACE_ID>"
      }
}]

이 예는 스페이스 <SPACE_ID>에서 Microsoft Excel 파일 자산 <ASSET_ID>를 로드하는 방법을 보여 줍니다.

"input_data_references": [{
      "type": "data_asset",
      "id": "kpis.csv",
      "connection": {},
      "location": {
            "href": "/v2/assets/<ASSET_ID>?space_id=<SPACE_ID>"
      }
}]

연결 자산

연결 자산을 사용하여 모든 데이터를 참조한 다음 매번 자격 증명을 지정할 필요 없이 연결을 참조할 수 있습니다. 페이로드에서 인라인 인증 정보를 사용하지 않고도 보안 연결을 참조하면 보안이 향상됩니다. id을 사용하여 연결을 식별할 수 있습니다. 예를 들면 다음과 같습니다.

"input_data_references": [{
      "type": "connection_asset",
      "id": "diet_food.csv",
      "connection": {
              "id" : "<CONNECTION_ID>",
      }
      "location": {  
              <Data-connector interaction properties depending on connection type>
      }
}]

<CONNECTION_ID>은 연결의 글로벌 고유 식별자입니다. 이 식별자는 연결을 생성한 후 프로젝트에서 연결을 편집할 때 찾을 수 있습니다. 식별자는 연결 편집 창의 URL에서 확인할 수 있습니다.

작업 정의에 대한 자세한 내용은 배포 작업 정의를 참조하세요.

' location ' 필드에 연결에 필요한 상호 작용 속성을 지정할 수 있습니다.

이 예는 COS/S3 버킷에 연결합니다. 인터랙션 속성은 ' location ' 필드에 제공됩니다.

      "location": { 
            "file_name" : "<FILENAME>",
            "bucket" : "<BUCKET_NAME>"
      }

이 예는 Db2 에셋에 연결합니다. 인터랙션 속성은 ' location ' 필드에 제공됩니다.

      "location" : { 
            "table_name" : "<TABLE_NAME>", 
            "schema_name" : "<SCHEMA_NAME>" 
      }

이 예는 COS/S3 버킷에 연결합니다. 연결 참조는 ' id ' 필드에 제공됩니다.

"input_data_references": [{
      "type": "connection_asset",
      "id": "diet_food.csv",
      "connection": {
            "id" : "<CONNECTION_ID>"
      },
      "location": {
            "file_name" : "<FILENAME>",
            "bucket" : "<BUCKET_NAME>"
      }
}]

이 예는 COS/S3 버킷에서 Microsoft Excel 파일을 로드하는 방법을 보여 줍니다.

"input_data_references": [{
      "type": "kpis.csv",
      "id": "diet_food.csv",
      "connection": {
            "id" : "<CONNECTION_ID>"
      },
      "location": {
            "file_name" : "<kpis.xlsx>",
            "bucket" : "<BUCKET_NAME>"
      }
}]

이 예는 Db2 에셋에 연결하는 방법을 보여줍니다. 연결 참조는 ' id ' 필드에 제공됩니다.

"input_data_references": [{
      "type" : "connection_asset",
      "id" : "diet_food.csv",
      "connection" : {
            "id" : "<CONNECTION_ID>"
      },
      "location" : {
            "table_name" : "<TABLE_NAME>",
            "schema_name" : "<SCHEMA_NAME>"
      }
}]

' location ' 필드에서 사용할 수 있는 상호 작용 속성에 대한 자세한 내용은 주 메뉴의 플랫폼 연결을 참조하세요. 연결 페이지에서 연결 리소스 > 연결 속성을 선택합니다. 그런 다음 해당 커넥터의 상호 작용 속성 > 소스 탭을 선택합니다. Platform assets catalog 만들어야 할 수도 있습니다.

Decision Optimization 사용할 수 있는 다양한 연결에 대한 자세한 내용은 Decision Optimization에서 지원되는 데이터 원본을 참조하세요.

URL 참조 데이터

URL 참조 데이터를 사용하여 특정 URL에서 데이터를 로드할 수 있습니다.

이 예에서는 GET 명령을 사용하여 URL에서 diet_food.csv 파일을 Decision Optimization 배포 작업의 입력 데이터로 검색합니다.

"input_data_references": {
      "type": "url",
      "id": "diet_food.csv",
      "connection": {
            "verb": "GET",
            "url": "https://myserver.com/diet_food.csv",
            "headers": {
                "Content-Type": "application/x-www-form-urlencoded"
            }
      },
   "location": {}
}