Datos de salida de los trabajos de implantación de Decision Optimization

Volver a la versión inglesa de la documentación

Datos de salida para Decision Optimization trabajos de despliegue

Última actualización: 05 dic 2024

Datos de salida de los trabajos de implantación de Decision Optimization

Al enviar un trabajo, puede definir qué datos de salida desea utilizar y cómo recopilarlos (como datos en línea o referenciados).

Datos en línea

Puede definir cómo recoger sus datos de salida como datos en línea.

Este ejemplo recoge la salida solution.csv como datos en línea.

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

Datos de referencia

Cuando se utilicen activos de datos o de conexión para datos tabulares, utilice " .csv " como extensión del identificador de datos en el campo " id ", independientemente del tipo de activo. El conector de datos realiza las transformaciones necesarias para que puedas guardar los datos en el formato de destino sin necesidad de cambiar el formato de los datos. Por lo tanto, puede utilizar el mismo modelo de Decision Optimization con diferentes tipos y formatos de fuentes de datos utilizando un conector de datos para referenciar sus datos. Si utiliza otras extensiones de identificador de datos, los datos se guardan como un archivo binario de datos sin procesar sin ninguna transformación.

Para utilizar datos referenciados en su solicitud, puede adaptar y utilizar los siguientes ejemplos de código.

Activos de datos

Puede utilizar referencias de activos de datos para localizar cualquier activo de datos presente en su espacio y beneficiarse de las capacidades de integración de conectores de datos.

Si el activo ya existe en el espacio href se actualiza. Por ejemplo:

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

También puede crear un activo especificando el nombre del activo y una descripción. Este ejemplo crea el activo ' solution.csv.

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

Este ejemplo define referencias de datos de salida para actualizar un activo de datos en un espacio.

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

También puede guardar los datos de salida como un activo con un nombre diferente utilizando el campo " name ". Este ejemplo crea un activo de salida llamado " my_solution.csv " en el espacio actual.

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

Este ejemplo muestra cómo guardar un activo de archivo de Microsoft Excel en un espacio.

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

También puede utilizar una expresión regular como identificador. Para obtener más información, consulte Regexp.

Activos de conexión

Puede utilizar activos de conexión para hacer referencia a cualquier dato y, a continuación, hacer referencia a la conexión sin tener que especificar las credenciales cada vez. Poder hacer referencia a una conexión segura sin tener que utilizar credenciales en línea en la carga útil también le ofrece una mejor seguridad. Puede utilizar el id para identificar las conexiones. Por ejemplo:

"output_data_references": [{
      "type": "connection_asset",
      "id": "solution.csv",
      "connection": {
              "id" : "<CONNECTION_ID>",
      }
      "location": {  
              <data-connector interaction properties depending on connection type>
      }
}]

El <CONNECTION_ID> es el identificador único global de una conexión. Encontrará este identificador cuando haya creado una conexión y, a continuación, edite la conexión en su proyecto. El identificador es visible en la URL de la ventana Editar conexión.

Para obtener información sobre las definiciones de tareas, consulte Definiciones de tareas de despliegue.

Puede especificar las propiedades de interacción necesarias para la conexión en el campo " location ".

Este ejemplo se conecta a un cubo COS/S3. Las propiedades de interacción se indican en el campo " location ".

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

Este ejemplo se conecta a un activo Db2. Las propiedades de interacción se indican en el campo " location ".

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

Este ejemplo se conecta a un cubo COS/S3. La referencia de la conexión se indica en el campo " id ".

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

Este ejemplo muestra cómo guardar un archivo de Microsoft Excel en un cubo COS/S3.

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

Este ejemplo muestra cómo conectarse a un activo Db2. La referencia de la conexión se indica en el 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 obtener más información sobre las propiedades de interacción que puede utilizar en el campo location, consulte Conexiones de plataforma en el menú principal. En la página Conexiones, seleccione Recursos de conexión > Propiedades de conexión. A continuación, selecciona la pestaña Propiedades de interacción > Como objetivo del conector correspondiente. Puede que necesite crear un Platform assets catalog.

Para más información sobre las distintas conexiones disponibles para " Decision Optimization, consulte " Fuentes de datos compatibles en " Decision Optimization.

Datos referenciados a URL

Puede utilizar datos referenciados a una URL para almacenar datos en una URL concreta.

Este ejemplo utiliza el comando PUT para colocar el archivo de salida solution.csv en el 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": {}
}

Expresión regular

Puede utilizar un Regexp como identificador para todos los tipos de salidas. Por ejemplo, para recopilar todos los archivos de salida .csv:

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

O todos los archivos de salida de cualquier tipo:

"id":".*"

Puede utilizar un ' Regexp como identificador, y combinarlo con los marcadores de posición ' ${oaas_job_id} y ' ${oaas_attachment_name} en el ' name, para crear un activo de salida cada vez que se ejecute el trabajo.

"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}"
      }
}]

Este ejemplo crea un archivo en una carpeta COS/S3 específica del trabajo para cada salida devuelta por el modelo. Si, por ejemplo, se genera un archivo solution.csv como salida, este archivo se guarda en una carpeta que tiene el mismo nombre que el número de trabajo.

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

Puede combinar diferentes tipos de datos en la misma solicitud. Para obtener más información sobre las definiciones de datos, consulte Añadir datos a un proyecto de análisis.