Erstellen von Datenmodellen mithilfe der API - Cloud

Nutzungshandbuch für Talend Cloud Data Stewardship

Version
Cloud
Language
Deutsch
Product
Talend Cloud
Module
Talend Data Stewardship
Content
Administration und Überwachung > Verwaltung von Benutzern
Data Governance > Datenmodellverwaltung
Data Governance > Kampagnenverwaltung
Data Governance > Taskzuweisung
Datenqualität und Datenaufbereitung > Handhabung von Tasks
Last publication date
2024-02-05

Ein Datenmodell besteht aus einer Liste von Attributen. Das Datenmodell muss vor der Erstellung der Kampagne erstellt werden.

In diesem Beispiel wird Talend API Tester zum Senden von Requests verwendet.

Weitere Informationen zu Talend API Tester finden Sie im Nutzungshandbuch für Talend Cloud API Tester.

Prozedur

  1. Sofern Sie noch nicht über ein persönliches Zugriffstoken verfügen, erzeugen Sie eines. Weitere Informationen finden Sie unter „Generieren persönlicher Zugriffstoken“.
  2. Öffnen Sie Talend API Tester in Ihrem Browser.
  3. Wählen Sie auf der Registerkarte Repository die Methode Post in der Dropdown-Liste Method (Methode) aus.
  4. Geben Sie folgende URL ein: https://tds.{region}.cloud.talend.com/schemaservice/api/v1/schemas/org.talend.schema

    Eine Liste der für die verschiedenen Rechenzentren zu verwendenden URLs finden Sie unter Talend Cloud-Regionen und -URLs.

  5. Klicken Sie auf die Schaltfläche Add header (Header hinzufügen) und geben Sie Authorization (Autorisierung) in das Feld name (Name) und Bearer, gefolgt von einem Leerzeichen und Ihrem Token in das Feld value (Wert) ein.
  6. Klicken Sie auf die Schaltfläche Add header (Header hinzufügen), geben Sie Cookie in das Feld name (Name) ein und lassen Sie das Feld value (Wert) leer.
  7. Nehmen Sie in das Feld Body die Datenmodelldetails in JSON auf.

    Example

    Um dasselbe Datenmodell demo_product (Demoprodukt) wie in der Führung zu erstellen, verwenden Sie einen anderen Namen, beispielsweise my_products_created_via_API (Meine per API erstellten Produkte). Geben Sie dazu Folgendes ein:
    {
        "name": "my_products_created_via_API",
        "displayName": "Product (created via API)",
        "description": "Product catalog available.",
        "fields": [{
            "name": "Id",
            "displayName": "Id",
            "description": "",
            "type": "integer",
            "required": true
        }, {
            "name": "Name",
            "displayName": "Name",
            "description": "",
            "type": "text",
            "required": true
        }, {
            "name": "Material",
            "displayName": "Material",
            "description": "",
            "type": "text",
            "required": true
        }, {
            "name": "Size",
            "displayName": "Size",
            "description": "",
            "type": "text",
            "required": true
        }, {
            "name": "Price",
            "displayName": "Price",
            "description": "",
            "type": "decimal",
            "required": true,
            "constraints": [{
                "name": "scaleDecimal",
                "value": 2
            }]
        }, {
            "name": "Quantity",
            "displayName": "Quantity",
            "description": "",
            "type": "integer",
            "required": true
        }, {
            "name": "Family",
            "displayName": "Family",
            "description": "",
            "type": "text",
            "required": true
        }, {
            "name": "Packaging",
            "displayName": "Packaging",
            "description": "",
            "type": "text",
            "required": true
        }, {
            "name": "ProductURL",
            "displayName": "Product URL",
            "description": "",
            "type": "URL",
            "required": true
        }, {
            "name": "productType",
            "displayName": "Type",
            "description": "",
            "type": "text",
            "required": false
        }]
    }
  8. Klicken Sie auf Send (Senden).

Ergebnisse

Die API gibt den HTTP-Code 200 zurück, um Sie darüber zu informieren, dass der Request erfolgreich war. Die Antwort enthält eine JSON-Beschreibung des erstellten Datenmodells. Beispiel:
{
    "namespace": "org.talend.schema",
    "displayName": "Product (created via API)",
    "name": "my_products_created_via_API",
    "description": "Product catalog available.",
    "version": 1,
    "references":[],
    "creationDate": 1601467434441,
    "lastUpdateDate": 1601467434441,
    "createdBy": {
        "id": "3e2eed7d-c632-40da-822e-9780f2c74842",
        "username": "user@account",
        "firstName": "user",
        "lastName": "name",
        "enabled": true
    },
    "lastUpdatedBy": {
        "id": "3e2eed7d-c632-40da-822e-9780f2c74842",
        "username": "user@account",
        "firstName": "user",
        "lastName": "name",
        "enabled": true
    },
    "fields": null,
    "referenced": false
}

Das von Ihnen erstellte Datenmodell wird in Talend Cloud Data Stewardship angezeigt.

Anmerkung: Wenn Sie versuchen, ein Datenmodell mit einem bereits vorhandenen Namen zu erstellen, gibt die API den Fehler 400 Bad request (400 Ungültiger Request) zurück. Die Antwort enthält in etwa folgende Nachricht:
{"code":"SCHEMA_ALL_SCHEMA_NAME_ALREADY_EXISTS","message":"SCHEMA_NAME_ALREADY_EXISTS","context":{"name":"demo_product"}}