Fontes de dados de entrada para Decision Optimization trabalhos de implantação

Dados sequenciais

Você pode incorporar dados inline em sua solicitação.

Dados tabulares em linha

Esse exemplo gera o arquivo diet_food.csv correspondente que é usado como o arquivo de entrada do modelo. Somente arquivos csv são suportados.

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

Dados brutos em linha

Esse tipo de dados em linha é útil para arquivos como um arquivo OPL .dat ou um arquivo .lp.

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

Dados de referência

Ao usar dados ou ativos de conexão para dados tabulares, use ' .csv como a extensão do identificador de dados no campo ' id, independentemente do tipo de ativo. O conector de dados faz as transformações necessárias, para que você possa carregar dados sem precisar alterar o formato dos dados. Assim, você pode usar o mesmo modelo de Decision Optimization com muitos tipos e formatos diferentes de fontes de dados, usando um conector de dados para fazer referência aos seus dados. Se você usar outras extensões de identificador de dados, os dados serão carregados como um arquivo binário de dados brutos sem nenhuma transformação.

Ativos de dados

Você pode usar referências de ativos de dados para localizar qualquer ativo de dados presente em seu espaço e se beneficiar dos recursos de integração de conectores de dados. Para usar os ativos de dados de um projeto, você deve primeiro promovê-los ao seu espaço.

Este exemplo define referências de dados de entrada a um ativo de dados em um espaço.

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

Este exemplo mostra como carregar um ativo de arquivo do Microsoft Excel <ASSET_ID> do espaço <SPACE_ID>.

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

Ativos de conexão

Você pode usar ativos de conexão para fazer referência a qualquer dado e, em seguida, consultar a conexão sem precisar especificar as credenciais todas as vezes. A referência a uma conexão segura sem ter que usar credenciais embutidas na carga útil também oferece melhor segurança. Você pode usar o id para identificar conexões. Por exemplo,

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

O <CONNECTION_ID> é o identificador globalmente exclusivo de uma conexão. Você pode encontrar esse identificador quando tiver criado uma conexão e depois editar a conexão em seu projeto. O identificador é visível no URL da janela Editar conexão.

Para obter informações sobre definições de trabalhos, consulte Definições de trabalhos de implantação.

Você pode especificar as propriedades de interação que são necessárias para a conexão no campo " location.

Este exemplo se conecta a um bucket COS/S3. As propriedades de interação são fornecidas no campo " location.

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

Este exemplo se conecta a um ativo Db2. As propriedades de interação são fornecidas no campo " location.

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

Este exemplo se conecta a um bucket COS/S3. A referência da conexão é fornecida no campo " id.

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

Este exemplo mostra como carregar um arquivo do Microsoft Excel de um bucket COS/S3.

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

Este exemplo mostra como se conectar a um ativo Db2. A referência da conexão é fornecida no campo " id.

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

Para obter mais informações sobre as propriedades de interação que você pode usar no campo location, consulte Conexões de plataforma no menu principal. Na página Conexões, selecione Recursos de conexão > Propriedades da conexão. Em seguida, selecione a guia Propriedades de interação > Como fonte para o conector relevante. Talvez você precise criar um Platform assets catalog.

Para obter mais informações sobre as diferentes conexões disponíveis para o Decision Optimization, consulte Fontes de dados suportadas no Decision Optimization.

Dados referenciados por URL

Você pode usar dados referenciados por URL para carregar dados de um URL específico.

Este exemplo usa o comando GET para recuperar o arquivo diet_food.csv de um URL como dados de entrada para o trabalho de implantação 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": {}
}