Wenn Sie einen Auftrag übermitteln, können Sie Inline-Daten hinzufügen oder auf Ihre Daten in Ihrer Anfrage verweisen. Diese Daten werden dann in eine Datei mit einem Datenidentifikator eingeordnet und vom Modell verwendet. Die Erweiterung des Datenbezeichners definiert das Format der verwendeten Datei. Sie können festlegen, welche Eingabedaten Sie verwenden möchten und wie Sie diese erfassen (entweder als Inline- oder als referenzierte Daten).
Inlinedaten
Sie können Inline-Daten in Ihre Anfrage einbetten.
- Tabellarische Inline-Daten
- Dieses Beispiel erzeugt die entsprechende
diet_food.csv
-Datei, die als Modelleingabedatei verwendet wird. Es werden nurcsv
-Dateien unterstützt."input_data": [{ "id":"diet_food.csv", "fields" : ["name","unit_cost","qmin","qmax"], "values" : [ ["Roasted Chicken", 0.84, 0, 10] ] }]
- Inline-Rohdaten
- Diese Art von Inline-Daten ist nützlich für Dateien wie eine OPL
.dat
-Datei oder eine.lp
-Datei."input_data": [{ "id":"model.lp", "content":"<model encoded as base64 string>" }]
Referenzierte Daten
Bei der Verwendung von Daten- oder Verbindungs-Assets für tabellarische Daten ist unabhängig vom Asset-Typ " .csv
als Datenbezeichner-Erweiterung im Feld " id
zu verwenden. Der Data-Connector führt die notwendigen Transformationen durch, so dass Sie Daten laden können, ohne das Format der Daten ändern zu müssen. Sie können also dasselbe Decision Optimization mit vielen verschiedenen Datenquellentypen und -formaten verwenden, indem Sie einen Datenkonnektor verwenden, um Ihre Daten zu referenzieren. Wenn Sie andere Datenbezeichner-Erweiterungen verwenden, werden die Daten als Rohdaten-Binärdatei ohne jegliche Transformation geladen.
- Datenassets
- Sie können Datenbestandsreferenzen verwenden, um alle in Ihrem Bereich vorhandenen Datenbestände zu lokalisieren und von den Integrationsmöglichkeiten der Datenverbindungen zu profitieren. Um Datenbestände aus einem Projekt zu verwenden, müssen Sie sie zunächst in Ihren Bereich bringen.
In diesem Beispiel werden Eingangsdatenreferenzen auf ein Daten-Asset in einem Raum definiert.
"input_data_references": [{ "type": "data_asset", "id": "diet_food.csv", "connection": {}, "location": { "href": "/v2/assets/<ASSET_ID>?space_id=<SPACE_ID>" } }]
In diesem Beispiel wird gezeigt, wie Sie ein Microsoft Excel-Datei-Asset <ASSET_ID> aus dem Raum <SPACE_ID> laden.
"input_data_references": [{ "type": "data_asset", "id": "kpis.csv", "connection": {}, "location": { "href": "/v2/assets/<ASSET_ID>?space_id=<SPACE_ID>" } }]
- Anschlussvermögen
- Sie können Verbindungs-Assets verwenden, um auf beliebige Daten zu verweisen und sich dann auf die Verbindung zu beziehen, ohne jedes Mal die Anmeldedaten angeben zu müssen. Der Verweis auf eine sichere Verbindung, ohne integrierte Berechtigungsnachweise in den Nutzdaten verwenden zu müssen, bietet auch mehr Sicherheit. Sie können die
id
verwenden, um Verbindungen zu identifizieren. Beispiel:"input_data_references": [{ "type": "connection_asset", "id": "diet_food.csv", "connection": { "id" : "<CONNECTION_ID>", } "location": { <Data-connector interaction properties depending on connection type> } }]
Der
<CONNECTION_ID>
ist der weltweit eindeutige Bezeichner für eine Verbindung. Sie finden diese Kennung, wenn Sie eine Verbindung erstellt haben und diese dann in Ihrem Projekt bearbeiten. Die Kennung ist in der URL des Fensters Verbindung bearbeiten sichtbar.Informationen zu Auftragsdefinitionen finden Sie unter Auftragsdefinitionen für die Bereitstellung.
Im Feld "
location
können Sie die Interaktionseigenschaften angeben, die für die Verbindung erforderlich sind.In diesem Beispiel wird eine Verbindung zu einem COS/S3 hergestellt. Die Interaktionseigenschaften werden im Feld "location
angegeben."location": { "file_name" : "<FILENAME>", "bucket" : "<BUCKET_NAME>" }
Dieses Beispiel stellt eine Verbindung zu einer Db2-Anlage her. Die Interaktionseigenschaften werden im Feld "location
angegeben."location" : { "table_name" : "<TABLE_NAME>", "schema_name" : "<SCHEMA_NAME>" }
In diesem Beispiel wird eine Verbindung zu einem COS/S3 hergestellt. Die Verbindungsreferenz wird im Feld "
id
angegeben."input_data_references": [{ "type": "connection_asset", "id": "diet_food.csv", "connection": { "id" : "<CONNECTION_ID>" }, "location": { "file_name" : "<FILENAME>", "bucket" : "<BUCKET_NAME>" } }]
Dieses Beispiel zeigt Ihnen, wie Sie eine Microsoft Excel-Datei aus einem COS/S3 laden können."input_data_references": [{ "type": "kpis.csv", "id": "diet_food.csv", "connection": { "id" : "<CONNECTION_ID>" }, "location": { "file_name" : "<kpis.xlsx>", "bucket" : "<BUCKET_NAME>" } }]
Dieses Beispiel zeigt Ihnen, wie Sie eine Verbindung zu einer Db2-Anlage herstellen. Die Verbindungsreferenz wird im Feld "id
angegeben."input_data_references": [{ "type" : "connection_asset", "id" : "diet_food.csv", "connection" : { "id" : "<CONNECTION_ID>" }, "location" : { "table_name" : "<TABLE_NAME>", "schema_name" : "<SCHEMA_NAME>" } }]
Weitere Informationen zu den Interaktionseigenschaften, die Sie im Feld "
location
verwenden können, finden Sie unter Plattformverbindungen im Hauptmenü. Wählen Sie auf der Seite Verbindungen die Option Verbindungsressourcen > Verbindungseigenschaften. Wählen Sie dann die Registerkarte Interaktionseigenschaften > Als Quelle für den entsprechenden Connector. Möglicherweise müssen Sie einen Platform assets catalog erstellen.Weitere Informationen über die verschiedenen für die Decision Optimization verfügbaren Verbindungen finden Sie unter Unterstützte Datenquellen in der Decision Optimization.
- URL referenzierte Daten
- Sie können URL-referenzierte Daten verwenden, um Daten von einer bestimmten URL zu laden.In diesem Beispiel wird der Befehl
GET
verwendet, um die Dateidiet_food.csv
von einer URL als Eingabedaten für den Einsatzauftrag Decision Optimization abzurufen."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": {} }
Sie können verschiedene Arten von Daten in einer Anfrage kombinieren. Weitere Informationen zu Datendefinitionen finden Sie unter Hinzufügen von Daten zu einem Analyseprojekt.