X4 Produktdokumentation

Operation: PutRow

Mit der Operation PutRow fügen Sie Zeilen mit den Werten aus dem XML-Eingabedokument in eine Tabelle ein.

Weitere Informationen zu anderen Operationen des Google Cloud Storage BigTable Connectors finden Sie unter Google Cloud Storage BigTable Connector.

Parameter

Adapter

🚫

Hauptklasse des Adapters (nicht verändern!)

Mögliche Werte:

de.softproject.integration.adapter.google.cloud.bigtable.storage.GoogleCloudBigtableAdapter: Hauptklasse (Standard)

serviceAccountFile

Pfad zur JSON-Datei, die den Service Account Key enthält, um sich gegenüber dem Google Cloud Storage zu authentifizieren.

Mögliche Werte:

  • Systempfad: z. B.:
    C:\X4\V_5.4\Server\X4DB\1\ExampleProcess\GoogleCloud\Config\serviceAccountFile.json

  • X4DB-URL: z. B.:
    x4db://1/ExampleProcess/GoogleCloud/Config/serviceAccountFile.json

  • Xstore-URL: z. B.:
    xstore://ExampleProcess/GoogleCloud/Config/serviceAccountFile.json

projectID

ID des Projekts

Mögliche Werte:

ID eines Google Cloud Projekts. Kann in der Google Cloud Konsole eingesehen werden.

instanceID

ID der Instanz

Mögliche Werte:

ID einer Google Cloud Instanz. Kann in der Google Cloud Konsole eingesehen werden.

Hinweis:

Weitere Informationen, wie eine Instanz in Google BigTable erstellt werden kann, finden Sie in der Google Cloud Dokumentation:

Bigtable>Instanzen erstellen und verwalten>Instanz erstellen (https://cloud.google.com/bigtable/docs/creating-instance?hl=de).

tableName

✳️

Dieser Parameter ist erforderlich für diese Operation.

Name der Tabelle

columnFamilyName

✳️

Dieser Parameter ist erforderlich für diese Operation.

Spaltenfamilienname. Gruppiert Spalten mit eindeutigen Namen.

rowKey

Zeilenschlüssel der Zeile. Identifikator, um Zeilen einzufügen oder zu durchsuchen.

Hinweis:

Die Operation verwendet die Attribute columnName und value für den rowKey-Parameter.

Statuswerte

1

Die Operation wurde erfolgreich ausgeführt

0

Die Operation wurde nicht vollständig ausgeführt, es ist aber kein Fehler aufgetreten.

-1

Die Operation ist aufgrund eines technischen Fehlers fehlgeschlagen.

Input

Der Adapter erwartet für die PutRow-Operation XML in folgender Struktur:

<ListRows>
    <row rowKey="IT employee">
        <rowAttribute1 columnName="ID" value="00001" />
        <rowAttribute2 columnName="Address" value="Karlsruhe" />
        <rowAttribute3 columnName="Name" value="Paolo" />
        <rowAttribute4 columnName="Surname" value="Green" />
        <rowAttribute5 columnName="Phone" value="552-968-369" />
        <rowAttribute6 columnName="Bonus" value="Yes" />
        <rowAttribute7 columnName="Profession" value="System Administrator" />
    </row>
</ListRows>

Hinweis:

Elementnamen können frei gewählt werden, allerdings sind die Attribute rowKey, columnName und value erforderlich.

Output

Der Adapter fügt Zeilen mit den Werten aus dem XML-Eingabedokument in die festgelegte Tabelle ein.