Docs
...
Input data for deployment jobs

Sorgenti di dati in ingresso per Decision Optimization lavori di distribuzione

Ultimo aggiornamento: 05 dic 2024
Dati di input per i lavori di distribuzione Decision Optimization

Quando si invia un lavoro, è possibile includere dati in linea o fare riferimento ai propri dati nella richiesta. Questi dati vengono quindi mappati in un file denominato con l'identificativo dei dati e utilizzato dal modello. L'estensione dell'identificatore dei dati definisce il formato del file utilizzato. È possibile definire quali dati di input utilizzare e come raccoglierli (come dati in linea o di riferimento).

Dati inline

È possibile incorporare dati in linea nella richiesta.

Dati tabellari in linea
Questo esempio genera il file diet_food.csv corrispondente, utilizzato come file di input del modello. Sono supportati solo i file csv.
"input_data": [{
      "id":"diet_food.csv",
      "fields" : ["name","unit_cost","qmin","qmax"],
      "values" : [
                 ["Roasted Chicken", 0.84, 0, 10]
      ]
}]
Dati in linea grezzi
Questo tipo di dati in linea è utile per file come un file OPL .dat o un file .lp.
"input_data": [{
      "id":"model.lp",
      "content":"<model encoded as base64 string>"
}]

Dati di riferimento

quando si utilizzano asset di dati o connessioni per dati tabellari, utilizzare .csv come estensione dell'identificatore di dati nel campo " id, indipendentemente dal tipo di asset. Il connettore dati effettua le trasformazioni necessarie, in modo da poter caricare i dati senza doverne modificare il formato. È quindi possibile utilizzare lo stesso modello di Decision Optimization con molti tipi e formati di fonti di dati diversi, utilizzando un connettore di dati per fare riferimento ai dati. Se si utilizzano altre estensioni di identificatori di dati, i dati vengono caricati come file binari di dati grezzi senza alcuna trasformazione.

Asset di dati
È possibile utilizzare i riferimenti agli asset di dati per individuare qualsiasi asset di dati presente nello spazio e beneficiare delle funzionalità di integrazione dei connettori di dati. Per utilizzare le risorse di dati di un progetto, dovete prima promuoverle nel vostro spazio.

Questo esempio definisce i riferimenti dei dati di input a un asset di dati in uno spazio.

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

Questo esempio mostra come caricare una risorsa di file Microsoft Excel <ASSET_ID> dallo spazio <SPACE_ID>.

"input_data_references": [{
      "type": "data_asset",
      "id": "kpis.csv",
      "connection": {},
      "location": {
            "href": "/v2/assets/<ASSET_ID>?space_id=<SPACE_ID>"
      }
}]
Attività di connessione
È possibile utilizzare le risorse di connessione per fare riferimento a qualsiasi dato e poi fare riferimento alla connessione senza dover specificare ogni volta le credenziali. Anche il riferimento a una connessione sicura, senza dover utilizzare le credenziali inline nel payload, offre una maggiore sicurezza. Per identificare le connessioni, si può usare l'opzione id. Ad esempio:
"input_data_references": [{
      "type": "connection_asset",
      "id": "diet_food.csv",
      "connection": {
              "id" : "<CONNECTION_ID>",
      }
      "location": {  
              <Data-connector interaction properties depending on connection type>
      }
}]

Il <CONNECTION_ID> è l'identificatore unico globale di una connessione. Questo identificatore si trova quando si crea una connessione e poi si modifica la connessione nel progetto. L'identificatore è visibile nell'URL della finestra Modifica connessione.

Per informazioni sulle definizioni dei lavori, vedere Definizioni dei lavori di distribuzione.

Nel campo " location " è possibile specificare le proprietà di interazione necessarie per la connessione.

Questo esempio si collega a un bucket COS/S3. Le proprietà dell'interazione sono fornite nel campo " location.
      "location": { 
            "file_name" : "<FILENAME>",
            "bucket" : "<BUCKET_NAME>"
      }
Questo esempio si collega a una risorsa Db2. Le proprietà dell'interazione sono fornite nel campo " location.
      "location" : { 
            "table_name" : "<TABLE_NAME>", 
            "schema_name" : "<SCHEMA_NAME>" 
      }

Questo esempio si collega a un bucket COS/S3. Il riferimento alla connessione viene fornito nel campo " id.

"input_data_references": [{
      "type": "connection_asset",
      "id": "diet_food.csv",
      "connection": {
            "id" : "<CONNECTION_ID>"
      },
      "location": {
            "file_name" : "<FILENAME>",
            "bucket" : "<BUCKET_NAME>"
      }
}]
Questo esempio mostra come caricare un file Microsoft Excel da un 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>"
      }
}]
Questo esempio mostra come connettersi a una risorsa Db2. Il riferimento alla connessione viene fornito nel 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>"
      }
}]

Per ulteriori informazioni sulle proprietà di interazione che si possono utilizzare nel campo 'location, vedere Connessioni della piattaforma nel menu principale. Nella pagina Connessioni, selezionare Risorse di connessione > Proprietà della connessione. Selezionare quindi la scheda Proprietà dell'interazione > Come origine per il connettore in questione. Potrebbe essere necessario creare un Platform assets catalog.

Per ulteriori informazioni sulle diverse connessioni disponibili per Decision Optimization, vedere Fonti di dati supportate in Decision Optimization.

Dati riferiti all'URL
È possibile utilizzare i dati con riferimento all'URL per caricare i dati da un determinato URL.
Questo esempio utilizza il comando GET per recuperare il file diet_food.csv da un URL come dati di input per il lavoro di distribuzione 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": {}
}

È possibile combinare diversi tipi di dati nella stessa richiesta. Per ulteriori informazioni sulle definizioni dei dati, vedere Aggiungi dati a un progetto di analisi.