Dados de saída para Decision Optimization trabalhos de implantação

Ao enviar um trabalho, você pode definir quais dados de saída deseja usar e como coletá-los (como dados em linha ou referenciados).

Dados sequenciais

Você pode definir como coletar seus dados de saída como dados em linha.

Este exemplo coleta a saída solution.csv como dados em linha.

"output_data": [{
      "id":"solution.csv"
}]

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 salvar os dados no formato de destino 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 salvos como um arquivo binário de dados brutos sem nenhuma transformação.

Para usar dados referenciados em sua solicitação, você pode adaptar e usar os exemplos de código a seguir.

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.

Você pode especificar o local da saída usando um ' href, se o ativo já existir no espaço, e o ativo for atualizado. Por exemplo,

      "location": {
           "href": "/v2/assets/<ASSET_ID>?space_id=<SPACE_ID>"
      }

Você também pode criar um ativo especificando o nome do ativo e uma descrição. Este exemplo cria o ativo " solution.csv.

      "location": {
            "name": "solution.csv",
            "description": "solution description"
      }

Este exemplo define referências de dados de saída para atualizar um ativo de dados em um espaço.

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

Você também pode salvar seus dados de saída como um ativo com um nome diferente usando o campo " name. Este exemplo cria um ativo de saída chamado " my_solution.csv no espaço atual.

"output_data_references": [{
      "type" : "data_asset",
      "id" : "solution.csv",
      "connection": {},
      "location": {
            "name": "my_solution.csv"
      }
}]

Este exemplo mostra como salvar um ativo de arquivo do Microsoft Excel em um espaço.

"output_data_references": [{
      "type": "data_asset",
      "id": "kpis.csv",
      "connection": {},
      "location": {
            "id": "<SPACE_ID>"
            "name": "kpis.xlsx"
      }
}]

Você também pode usar uma expressão regular como identificador. Para obter mais informações, consulte Regexp.

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,

"output_data_references": [{
      "type": "connection_asset",
      "id": "solution.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.

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

Este exemplo mostra como salvar um arquivo do Microsoft Excel em um bucket COS/S3.

"output_data_references": [{
      "type": "kpis.csv",
      "id": "kpis.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.

"output_data_references": [{
      "type" : "connection_asset",
      "id" : "solution.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 alvo 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 armazenar dados em um URL específico.

Este exemplo usa o comando PUT para colocar o arquivo de saída solution.csv no servidor.

"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": {}
}

Regexp

Você pode usar um Regexp como um identificador para todos os tipos de saídas. Por exemplo, para coletar todos os arquivos de saída .csv:

"id":".*\\.csv"

Ou todos os arquivos de saída de qualquer tipo:

"id":".*"

Você pode usar um ' Regexp como identificador e combiná-lo com os espaços reservados ' ${oaas_job_id} e ' ${oaas_attachment_name} no ' name, para criar um ativo de saída sempre que o trabalho for executado.

"output_data_references": [{
      "type" : "data_asset",
      "id" : ".*",
      "connection": {
            "href" : "/v2/connections/<CONNECTION_ID>?space_id=><SPACE_ID>"
      },
      "location": {
            "name" : "${oaas_job_id}_${oaas_attachment_name}"
      }
}]

Esse exemplo cria um arquivo em uma pasta COS/S3 específica do trabalho para cada saída retornada pelo modelo. Se, por exemplo, um arquivo solution.csv for gerado como saída, esse arquivo será salvo em uma pasta com o mesmo nome do número do trabalho.

"output_data_references": [{
      "type" : "connection_asset",
      "id" : ".*",
      "connection": {
            "id" : "<CONNECTION_ID>"
      },
      "location": {
            "bucket" : "<BUCKET_NAME>",
            "file_name": "${oaas_job_id}/${oaas_attachment_name}"
      }
}]

Você pode combinar diferentes tipos de dados na mesma solicitação. Para obter mais informações sobre definições de dados, consulte Adicionar dados a um projeto de análise.