Google Cloud Storage BigTable Connector

Google Cloud BigTable Connecotr: Ermöglicht den Anschluss an Google Cloud BigTable, einen hochverfügbaren NoSQL-Datenspeicher, der die Arbeit der Datenbankverwaltung entlastet.

Eigenschaften (Properties)

Operation

Vom Adapter ausgeführte Operation

Mögliche Werte:

CreateTable: Erstellt eine Tabelle mit Tabellenname und Spaltenfamilienname
Erforderliche Parameter: tableName, columnFamilyName
ListTable: Listet alle Tabellen für das Projekt und die Instanz auf
Erforderliche Parameter: tableName, columnFamilyName
PutRow: Fügt Zeilen mit den Werten aus dem XML-Eingabedokument ein. Verwendet columnName und value für das rowKey-Attribut.
Erforderliche Parameter: tableName, columnFamilyName
GetRow: Durchsucht die Tabelle, indem rowKey über Parameter übergeben wird und gibt das Ergebnis in einer Ausgabe-XML zurück.
Erforderliche Parameter: tableName, columnFamilyName
Scan: Scannt die Tabelle und gibt eine Ausgabe-XML entsprechend der Parameter zurück. Der Scanvorgang filtert die Suche.
Erforderliche Parameter: tableName, columnFamilyName, columnName, startRow, stopRow, scanCached, scanResultSize, scanTimestamp, scanMaxVersions, scanCacheBlocks
EnableTable: Aktiviert die Tabelle (Tabelle muss deaktiviert sein).
Erforderliche Parameter: tableName, columnFamilyName
DisableTable: Deaktiviert die Tabelle (Tabelle muss aktiviert sein).
Erforderliche Parameter: tableName, columnFamilyName
Delete: Löscht die Tabelle. Wenn die Parameter rowKey und columnName angegeben sind, wird nur die entsprechende Spalte in der gewählten Zeile gelöscht.
Erforderliche Parameter: tableName, columnFamilyName, columnName, rowKey

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. Weitere Informationen, wie eine Instanz in Google BigTable erstellt werden kann, finden sich hier.
`tableName`	Name der Tabelle. Notwendiger Parameter für alle Operationen
`columnFamilyName`	Spaltenfamilienname. Gruppiert Spalten mit eindeutigen Namen.
`rowKey`	Zeilenschlüssel der Zeile. Identifikator, um Zeilen einzufügen oder zu durchsuchen.
`columnName`	Spaltenname. Wird verwendet, um mit der `Delete`-Operation eine bestimmte Spalte in einer Zeile zu löschen.
`startRow`	Spezifiziert eine bestimmte Zeile, bei der der Scanvorgang beginnt. Mögliche Werte: Zeilenschlüssel `rowKey`
`stopRow`	Spezifiziert eine bestimmte Zeile, bei der der Scanvorgang endet. Die Zeile selbst wird nicht mehr in den Scan-Ergebnissen angezeigt. Mögliche Werte: Zeilenschlüssel `rowKey`
`scanCached`	Ändert das Scanner-Caching für diesen Scan. Wenn der Parameter nicht gesetzt ist, wird der Caching-Wert der Hosting-Tabelle verwendet. Mögliche Werte: Ganzzahl
`scanResultSize`	Legt die maximale Anzahl der Scan-Ergebnisse fest. Mögliche Werte: Ganzzahl Wenn die beiden Parameter `scanCached` und `scanResultSize` gesetzt sind, werden einzelne Server Requests entweder durch die Anzahl der Zeilen oder die maximale Ergebnisgröße begrenzt, je nachdem, welches Limit zuerst eintritt.
`scanTimestamp`	Filtert nach Spalten mit einem bestimmten Zeitstempel. Mögliche Werte: Ganzzahl
`scanMaxVersions`	Begrenzt die Anzahl Versionen jeder Spalte, die zurückgegeben werden sollen. Mögliche Werte: Ganzzahl
`scanCacheBlocks`	Serverseitiges Caching für diesen Scan explizit deaktivieren. Mögliche Werte: `true` / `false`

Statuswerte

`1`	Die Adapter-Operation wurde erfolgreich ausgeführt.
`0`	Die Adapter-Operation wurde nicht vollständig ausgeführt, es ist aber kein Fehler aufgetreten.
`-1`	Bei der Ausführung des Adapters ist ein Fehler aufgetreten.

Input

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

XML

<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>

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

Output

Der Adapter liefert abhängig von der ausgeführten Operation unterschiedliche Arten von Dokumenten zurück.

GetRow-Operation ausführen:

XML

<Result>
	<Row rowKey="DEV employee">
		<RowColumn ColumnName="Address" value="Ettlingen" />
<RowColumn ColumnName="Frameworks" value="Java-Hibernate" />
		<RowColumn ColumnName="ID" value="00003" />
		<RowColumn ColumnName="Name" value="Lorena" />
	</Row>
</Result>

Scan-Operation ausführen:

XML

<Column FamilyName="FamilyNamePrimary">
	<Row rowKey="CLean employee">
		<Attribute ColumnName="Address" value="Ettlingen" timeStamp="1544603282081" />
		<Attribute ColumnName="ID" value="00005" timeStamp="1544603282081" />
	</Row>
	<Row rowKey="DEV employee">
		<Attribute ColumnName="Address" value="Ettlingen" timeStamp="1544603280340" />
		<Attribute ColumnName="Frameworks" value="Java-Hibernate" timeStamp="1544603280340" />
		<Attribute ColumnName="ID" value="00003" timeStamp="1544603280340" />
		<Attribute ColumnName="Name" value="Lorena" timeStamp="1544603280340" />
	</Row>
	<Row rowKey="HR employee">
		<Attribute ColumnName="ID" value="00002" timeStamp="1544603278048" />
		<Attribute ColumnName="Name" value="Francis Ernesto" timeStamp="1544603278048" />
		<Attribute ColumnName="Surname" value="Underwood" timeStamp="1544603278048" />
	</Row>
	<Row rowKey="IT employee">
		<Attribute ColumnName="Address" value="Karlsruhe" timeStamp="1544603276625" />
		<Attribute ColumnName="Bonus" value="Yes" timeStamp="1544603276625" />
		<Attribute ColumnName="ID" value="00001" timeStamp="1544603276625" />
		<Attribute ColumnName="Name" value="Paolo" timeStamp="1544603276625" />
		<Attribute ColumnName="Phone" value="552-968-369" timeStamp="1544603276625" />
	<Attribute ColumnName="Profession" value="System Administrator" timeStamp="1544603276625" />
		<Attribute ColumnName="Surname" value="Green" timeStamp="1544603276625" />
	</Row>
	<Row rowKey="Marketing employee">
		<Attribute ColumnName="ID" value="00004" timeStamp="1544603281175" />
	<Attribute ColumnName="Name" value="Petra" timeStamp="1544603281175" />
	</Row>
	<Row rowKey="Security employee">
		<Attribute ColumnName="Address" value="Ettlingen/Build1" timeStamp="1544603283155" />
		<Attribute ColumnName="ID" value="00006" timeStamp="1544603283155" />
		<Attribute ColumnName="Name" value="Robert" timeStamp="1544603283155" />
		<Attribute ColumnName="Permisions" value="Day-Night" timeStamp="1544603283155" />
	</Row>
</Column>

ListTable-Operation ausführen:

XML

<?xml version="1.0" encoding="UTF-8" ?>
<Result>
	<ListTables>
	<Table name="TestTable" />
	</ListTables>
</Result>