Google BigQuery-Erweiterung

Sie sehen sich die Dokumentation zu Apigee Edge an.
Sehen Sie sich die Apigee X-Dokumentation an. info

Version 2.0.0

Zeilen in eine BigQuery-Tabelle einfügen Zeilen aus der Tabelle auflisten

Vorbereitung

Dieser Artikel enthält eine Referenz zum Konfigurieren und Verwenden dieser Erweiterung. Bevor Sie die Erweiterung über einen API-Proxy mit der ExtensionCallout-Richtlinie verwenden können, müssen Sie Folgendes tun:

  1. Die BigQuery API muss für Ihr Konto aktiviert sein.

  2. Sie müssen ein dataset und eine Tabelle (mit Schema) erstellt haben, bevor Sie Zeilen einfügen können.

  3. Erstellen Sie mit der GCP Console einen Schlüssel für das Dienstkonto.

  4. Verwenden Sie den Inhalt der resultierenden JSON-Schlüsseldatei, wenn Sie die Erweiterung mithilfe der Konfigurationsreferenz hinzufügen und konfigurieren.

Über Google BigQuery

Google BigQuery ist ein serverloses, skalierbares Data Warehouse, das dank der Verarbeitungsleistung der Google-Infrastruktur extrem schnelle SQL-Abfragen ermöglicht. Da keine Infrastruktur verwaltet werden muss, können Sie sich voll und ganz auf die Datenanalyse konzentrieren und über eine vertraute SQL-Benutzeroberfläche aussagekräftige Informationen abrufen. Dafür wird kein Datenbankadministrator benötigt.

Eine praktische Einführung finden Sie in den Google BigQuery-Kurzanleitungen.

Aktionen

insert

Sie können eine Reihe von Einträgen als Dataset direkt in BigQuery einfügen. Geben Sie dazu die einzufügenden Zeilen und die Dataset-/Tabellen-ID an.

Syntax

<Action>insert</Action>
<Input><![CDATA[{
  "dataset" : dataset-to-insert,
  "table" : table-to-receive-data,
  "rows" : array-of-rows-to-insert
}]]></Input>

Beispiel

<Action>insert</Action>
<Input><![CDATA[{
  "dataset" : "TestData",
  "table" : "TestTable",
  "rows" : [
    {"technology":"CRISPR","inventorFirstName":"Jennifer","inventorLastName":"Doudna"},
    {"technology":"World Wide Web","inventorFirstName":"Tim","inventorLastName":"Berners-Lee"}
    {"technology":"Alternating current","inventorFirstName":"Nikola","inventorLastName":"Tesla"}
  ]
}]]></Input>

Anfrageparameter

Parameter Beschreibung Typ Standard Erforderlich
Dataset ID des Datasets, das in BigQuery eingefügt werden soll. String Keine. Ja.
Zeilen Zeilen, die in die Tabelle eingefügt werden sollen. Array Keine. Ja.
Tisch Name der Tabelle, in der die Daten empfangen werden sollen. String Keine. Ja.

Antwort

Keine.

listRows

Listet die Zeilen in der Tabelle auf, die durch die Tabellen-ID und die Dataset-ID angegeben ist.

Syntax

<Action>listRows</Action>
<Input><![CDATA[{
  "dataset" : ID-of-dataset-to-examine,
  "limit" : maximum-rows-to-list,
  "startIndex" : row-index-at-which-to-start-list
  "table" : ID-of-table-to-examine
}]]></Input>

Beispiel

<Action>listRows</Action>
<Input><![CDATA[{
  "dataset" : "TestData",
  "limit" : 2,
  "startIndex" : 1,
  "table" : "TestTable"
}]]></Input>

Anfrageparameter

Parameter Beschreibung Typ Standard Erforderlich
Dataset ID des Datensatzes, aus dem Zeilen aufgelistet werden sollen. String Keine. Ja.
Limit Maximale Anzahl der Zeilen, die aufgelistet werden sollen. Ganzzahl Keine. Nein.
startIndex Der Zeilenindex, bei dem die Liste beginnen soll. Ganzzahl Keine. Nein.
Tisch ID der Tabelle, aus der Zeilen aufgelistet werden sollen. String Keine. Ja.

Antwort

Ein rows-Array.

{
  "rows": [
    {"technology":"World Wide Web","inventorFirstName":"Tim","inventorLastName":"Berners-Lee"}
    {"technology":"Alternating current","inventorFirstName":"Nikola","inventorLastName":"Tesla"}
  ]
}
Parameter Beschreibung Typ Standard Erforderlich
Zeilen Array der Zeilen, die von der Anfrage zurückgegeben wurden. Array Keine. Ja.

Konfigurationsreferenz

Beachten Sie Folgendes, wenn Sie diese Erweiterung für die Verwendung in API-Proxys konfigurieren und bereitstellen. Eine Anleitung zum Konfigurieren einer Erweiterung mit der Apigee Console finden Sie unter Erweiterung hinzufügen und konfigurieren.

Gängige Erweiterungseigenschaften

Für jede Erweiterung sind die folgenden Eigenschaften vorhanden.

Attribut Beschreibung Standard Erforderlich
name Der Name, den Sie dieser Konfiguration der Erweiterung zuweisen. – Ja
packageName Name des Erweiterungspakets, wie von Apigee Edge angegeben. – Ja
version Versionsnummer für das Erweiterungspaket, von dem Sie eine Erweiterung konfigurieren. – Ja
configuration Konfigurationswert speziell für die Erweiterung, die Sie hinzufügen. Weitere Informationen finden Sie unter Eigenschaften für dieses Erweiterungspaket. – Ja

Properties für dieses Erweiterungspaket

Geben Sie Werte für die folgenden Konfigurationseigenschaften an, die für diese Erweiterung spezifisch sind.

Attribut Beschreibung Standard Erforderlich
projectId ID des GCP-Projekts, in dem sich die Daten befinden. Keine. Ja.
Anmeldedaten Wenn Sie diesen Wert in die Apigee Edge-Konsole eingeben, entspricht er dem Inhalt Ihrer Dienstkonto-Schlüsseldatei. Wenn er über die Verwaltungs-API gesendet wird, ist er ein Base64-codierter Wert, der aus der Dienstkonto-Schlüsseldatei generiert wird. Keine. Ja.