Ausgabedaten für Decision Optimization Einsatzaufträge

Zurück zur englischen Version der Dokumentation

Letzte Aktualisierung: 05. Dez. 2024

Ausgabedaten für Decision Optimization Einsatzaufträge

Wenn Sie einen Auftrag übermitteln, können Sie festlegen, welche Ausgabedaten Sie verwenden möchten und wie Sie diese erfassen (entweder als Inline- oder als referenzierte Daten).

Inlinedaten

Sie können festlegen, wie Ihre Ausgabedaten als Inline-Daten erfasst werden sollen.

In diesem Beispiel wird die solution.csv-Ausgabe als Inline-Daten erfasst.

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

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 im Zielformat speichern 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 Umwandlung gespeichert.

Um referenzierte Daten in Ihrer Anfrage zu verwenden, können Sie die folgenden Codebeispiele anpassen und verwenden.

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.

Sie können den Speicherort für die Ausgabe angeben, indem Sie einen " href verwenden, wenn das Asset bereits in dem Bereich vorhanden ist, und das Asset wird aktualisiert. Beispiel:

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

Sie können auch ein Asset erstellen, indem Sie den Assetnamen und eine Beschreibung angeben. In diesem Beispiel wird das Asset " solution.csv erstellt.

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

In diesem Beispiel werden Ausgabedatenreferenzen zur Aktualisierung eines Datenbestands in einem Raum definiert.

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

Sie können Ihre Ausgabedaten auch als Asset mit einem anderen Namen speichern, indem Sie das Feld " name verwenden. In diesem Beispiel wird ein Ausgabe-Asset mit dem Namen " my_solution.csv im aktuellen Bereich erstellt.

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

Dieses Beispiel zeigt Ihnen, wie Sie ein Microsoft Excel-Asset in einem Leerzeichen speichern können.

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

Sie können auch einen regulären Ausdruck als Bezeichner verwenden. Weitere Informationen finden Sie unter Regexp.

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:

"output_data_references": [{
      "type": "connection_asset",
      "id": "solution.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.

"output_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 in einem COS/S3 speichern können.

"output_data_references": [{
      "type": "kpis.csv",
      "id": "kpis.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.

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

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 unter einer bestimmten URL zu speichern.

In diesem Beispiel wird der Befehl PUT verwendet, um die Ausgabedatei solution.csv auf dem Server abzulegen.

"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": {}
}

Regulärer Ausdruck

Sie können ein Regexp als Bezeichner für alle Arten von Ausgaben verwenden. Zum Beispiel, um alle .csv Ausgabedateien zu sammeln:

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

Oder alle Ausgabedateien jeglicher Art:

"id":".*"

Sie können einen " Regexp als Bezeichner verwenden und ihn mit den Platzhaltern " ${oaas_job_id} und " ${oaas_attachment_name} im " name kombinieren, um bei jeder Ausführung des Auftrags eine Ausgabe zu erstellen.

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

In diesem Beispiel wird für jede vom Modell zurückgegebene Ausgabe eine Datei in einem auftragsspezifischen COS/S3 erstellt. Wenn zum Beispiel eine solution.csv-Datei als Ausgabe erzeugt wird, wird diese Datei in einem Ordner gespeichert, der den gleichen Namen wie die Auftragsnummer trägt.

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

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.