Google BigQuery-Erweiterung

Sie sehen die Dokumentation zu Apigee Edge.
Zur Apigee X-Dokumentation weitere Informationen

Version 1.2.1

Fügen Sie Zeilen in eine BigQuery-Tabelle ein. Listen Sie Zeilen aus der Tabelle auf.

Voraussetzungen

In diesem Artikel erfahren Sie, wie Sie diese Erweiterung konfigurieren und verwenden. Bevor Sie die Erweiterung mithilfe der ExtensionCallout-Richtlinie von einem API-Proxy verwenden, müssen Sie Folgendes tun:

  1. Achten Sie darauf, dass die BigQuery API für Ihr Konto aktiviert ist.

  2. Bevor Sie Zeilen einfügen, sollten Sie ein BigQuery-Dataset und eine BigQuery-Tabelle (mit Schema) erstellt haben.

  3. Verwenden Sie die GCP Console, um einen Schlüssel für das Dienstkonto zu generieren.

  4. Verwenden Sie den Inhalt der resultierenden JSON-Schlüssel-JSON-Datei beim Hinzufügen und Konfigurieren der Erweiterung mithilfe der Konfigurationsreferenz.

Über Google BigQuery

Google BigQuery ist ein serverloses, skalierbares Data Warehouse für Unternehmen, das superschnelle SQL-Abfragen ermöglicht und dabei die Rechenleistung der Google-Infrastruktur nutzt. Da keine Infrastruktur verwaltet werden muss, können Sie sich auf die Analyse von Daten konzentrieren, um mit dem vertrauten SQL aussagekräftige Informationen zu gewinnen, ohne dass ein Datenbankadministrator erforderlich ist.

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

Aktionen

insert

Fügen Sie einen Satz von Datensätzen als Dataset direkt in BigQuery ein, mit den einzufügenden Zeilen und der Dataset-/Tabellen-ID.

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.
table Name der Tabelle, die die Daten empfangen soll. String Keine. Ja.

Antwort

Keine.

listRows

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

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 Datasets, aus dem Zeilen aufgelistet werden sollen. String Keine. Ja.
Limit Maximale Anzahl der Zeilen, die aufgelistet werden sollen. Ganzzahl Keine. Nein.
startIndex Zeilenindex, bei dem die Liste beginnen soll. Ganzzahl Keine. Nein.
table 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 von der Anfrage zurückgegebenen Zeilen. Array Keine. Ja.

Konfigurationsreferenz

Verwenden Sie Folgendes, wenn Sie diese Erweiterung zur Verwendung in API-Proxys konfigurieren und bereitstellen. Eine Anleitung zum Konfigurieren einer Erweiterung mit der Apigee-Konsole finden Sie unter Erweiterung hinzufügen und konfigurieren.

Häufige 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

Eigenschaften dieses Erweiterungspakets

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

Property Beschreibung Standard Erforderlich
projectId ID des GCP-Projekts, in dem sich die Daten befinden. Keine. Ja.
Anmeldedaten Bei Eingabe in die Apigee Edge-Konsole ist dies der Inhalt Ihrer Dienstkonto-Schlüsseldatei. Wenn er über die Verwaltungs-API gesendet wird, ist er ein base64-codierter Wert, der aus der Schlüsseldatei des Dienstkontos generiert wird. Keine. Ja.