Cuando envíe un trabajo puede incluir datos en línea o hacer referencia a sus datos en su solicitud. A continuación, estos datos se asignan a un archivo denominado con el identificador de datos y utilizado por el modelo. La extensión del identificador de datos define el formato del archivo utilizado. Puede definir qué datos de entrada desea utilizar y cómo recopilarlos (como datos en línea o referenciados).
Datos en línea
Puede incrustar datos en línea en su solicitud.
- Datos tabulares en línea
- Este ejemplo genera el archivo
diet_food.csv
correspondiente que se utiliza como archivo de entrada del modelo. Sólo se admiten archivoscsv
."input_data": [{ "id":"diet_food.csv", "fields" : ["name","unit_cost","qmin","qmax"], "values" : [ ["Roasted Chicken", 0.84, 0, 10] ] }]
- Datos brutos en línea
- Este tipo de datos en línea es útil para archivos como un archivo OPL
.dat
o un archivo.lp
."input_data": [{ "id":"model.lp", "content":"<model encoded as base64 string>" }]
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 cargar datos sin necesidad de cambiar su formato. 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 identificadores de datos, los datos se cargan como un archivo binario de datos sin procesar sin ninguna transformación.
- 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. Para utilizar los activos de datos de un proyecto, primero debe promoverlos a su espacio.
Este ejemplo define referencias de datos de entrada a un activo de datos en un espacio.
"input_data_references": [{ "type": "data_asset", "id": "diet_food.csv", "connection": {}, "location": { "href": "/v2/assets/<ASSET_ID>?space_id=<SPACE_ID>" } }]
Este ejemplo muestra cómo cargar un archivo de Microsoft Excel activo <ASSET_ID> desde el espacio <SPACE_ID>.
"input_data_references": [{ "type": "data_asset", "id": "kpis.csv", "connection": {}, "location": { "href": "/v2/assets/<ASSET_ID>?space_id=<SPACE_ID>" } }]
- 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:"input_data_references": [{ "type": "connection_asset", "id": "diet_food.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
"."input_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 cargar un archivo de Microsoft Excel desde un cubo 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 ejemplo muestra cómo conectarse a un activo Db2. La referencia de la conexión se indica en el 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 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 fuente 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 de referencia URL
- Puede utilizar datos referenciados a una URL para cargar datos de una URL concreta.Este ejemplo utiliza el comando
GET
para recuperar el archivodiet_food.csv
de una URL como datos de entrada para el trabajo de despliegue 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": {} }
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.