Google BigQuery-Erweiterung

Sie lesen gerade die Dokumentation zu Apigee Edge.
Apigee X-Dokumentation aufrufen info

Version 2.0.2

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

Vorbereitung

Dieser Inhalt 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 BigQuery-Dataset und eine Tabelle (mit Schema) erstellt haben, bevor Sie versuchen, Zeilen einzufügen.

  3. Mit der Google Cloud Console einen Schlüssel für das Dienstkonto generieren

  4. Verwenden Sie den Inhalt der resultierenden JSON-Schlüsseldatei, wenn Sie die Erweiterung mit 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

Fügen Sie eine Reihe von Datensätzen als Dataset direkt in BigQuery ein. Dazu sind die einzufügenden Zeilen sowie die Dataset- und Tabellen-ID erforderlich.

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.
Tabelle Name der Tabelle, in die die Daten eingefügt 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 wird.

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 aufzulistenden Zeilen. Ganzzahl Keine. Nein.
startIndex Zeilenindex, mit dem die Liste beginnen soll. Ganzzahl Keine. Nein.
Tabelle 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 mit Zeilen, die von der Anfrage zurückgegeben werden. Array Keine. Ja.

Konfigurationsreferenz

Verwenden Sie die folgenden Informationen, wenn Sie diese Erweiterung für die 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.

Allgemeine 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 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 Google Cloud-Projekts, in dem sich die Daten befinden. Keine. Ja.
Anmeldedaten Wenn Sie diesen Wert in der Apigee Edge-Konsole eingeben, ist das der Inhalt Ihrer Dienstkonto-Schlüsseldatei. Wenn er über die Management API gesendet wird, ist er ein base64-codierter Wert, der aus der Dienstkonto-Schlüsseldatei generiert wird. Keine. Ja.