Données en ligne

Vous pouvez intégrer des données en ligne dans votre demande.

Données tabulaires en ligne

Cet exemple génère le fichier diet_food.csv correspondant qui est utilisé comme fichier d'entrée du modèle. Seuls les fichiers csv sont pris en charge.

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

Données brutes en ligne

Ce type de données en ligne est utile pour les fichiers tels qu'un fichier OPL .dat ou un fichier .lp.

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

Données référencées

Lors de l'utilisation de ressources de données ou de connexions pour les données tabulaires, utilisez " .csv comme extension de l'identifiant de données dans le champ " id, quel que soit le type de ressource. Le connecteur de données effectue les transformations nécessaires, de sorte que vous pouvez charger des données sans avoir à en modifier le format. Vous pouvez donc utiliser le même modèle d'Decision Optimization avec de nombreux types et formats de sources de données différents en utilisant un connecteur de données pour référencer vos données. Si vous utilisez d'autres extensions d'identifiant de données, les données sont chargées sous la forme d'un fichier binaire de données brutes sans aucune transformation.

Actifs de données

Vous pouvez utiliser les références des biens de données pour localiser tout bien de données présent dans votre espace et bénéficier des capacités d'intégration des connecteurs de données. Pour utiliser les données d'un projet, vous devez d'abord les promouvoir dans votre espace.

Cet exemple définit les références des données d'entrée à un bien de données dans un espace.

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

Cet exemple vous montre comment charger un fichier Microsoft Excel de l'actif <ASSET_ID> depuis l'espace <SPACE_ID>.

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

Actifs de connexion

Vous pouvez utiliser des actifs de connexion pour référencer n'importe quelles données et vous référer ensuite à la connexion sans avoir à spécifier les informations d'identification à chaque fois. Le référencement d'une connexion sécurisée sans avoir à utiliser des informations d'identification en ligne dans le contenu renforce également la sécurité. Vous pouvez utiliser le id pour identifier les connexions. Exemple :

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

Le <CONNECTION_ID> est l'identifiant unique d'une connexion. Vous pouvez trouver cet identifiant lorsque vous avez créé une connexion et que vous la modifiez ensuite dans votre projet. L'identifiant est visible dans l'URL de la fenêtre Editer la connexion.

Pour plus d'informations sur les définitions de tâches, voir Définitions des tâches de déploiement.

Vous pouvez spécifier les propriétés d'interaction requises pour la connexion dans le champ 'location

Cet exemple se connecte à un seau COS/S3. Les propriétés d'interaction sont indiquées dans le champ " location

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

Cet exemple se connecte à une ressource Db2. Les propriétés d'interaction sont indiquées dans le champ " location

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

Cet exemple se connecte à un seau COS/S3. La référence de la connexion est indiquée dans le champ " id.

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

Cet exemple vous montre comment charger un fichier Microsoft Excel à partir d'un seau COS/S3.

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

Cet exemple vous montre comment vous connecter à un poste Db2. La référence de la connexion est indiquée dans le champ " id.

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

Pour plus d'informations sur les propriétés d'interaction que vous pouvez utiliser dans le champ " location, voir Connexions de plate-forme dans le menu principal. Sur la page Connexions, sélectionnez Ressources de connexion > Propriétés de connexion. Sélectionnez ensuite l'onglet Propriétés de l'interaction > En tant que source pour le connecteur concerné. Il se peut que vous deviez créer un Platform assets catalog

Pour plus d'informations sur les différentes connexions disponibles pour l' Decision Optimization, voir Sources de données prises en charge dans l'Decision Optimization

Données référencées par l'URL

Vous pouvez utiliser des données référencées par URL pour charger des données à partir d'une URL particulière.

Cet exemple utilise la commande GET pour récupérer le fichier diet_food.csv à partir d'une URL comme données d'entrée pour le travail de déploiement 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": {}
}