Google BigQuery-Erweiterung

Sie lesen gerade die Apigee Edge -Dokumentation.
Zur Apigee X -Dokumentation. info

Version 1.0.0

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, müssen Sie Folgendes tun:

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

  2. Achten Sie darauf, dass Sie ein BigQuery-Dataset und eine Tabelle (mit Schema) erstellt haben, bevor Sie versuchen, Zeilen einzufügen.

  3. Generieren Sie in der GCP Console einen Schlüssel für das Dienstkonto.

  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

Eine Reihe von Datensätzen als Dataset direkt in BigQuery einfügen, mit einzufügenden Zeilen und 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.
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, bei 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 von Zeilen, die von der Anfrage zurückgegeben wurden. 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 speziell für diese Erweiterung gelten.

Attribut Beschreibung Standard Erforderlich
projectId ID des GCP-Projekts, in dem sich die Daten befinden. Keine. Ja.
Anmeldedaten Wenn in der Apigee Edge-Konsole eingegeben, ist dies der Inhalt Ihrer Dienstkonto-Schlüsseldatei. Wenn über die Management API gesendet, ist es ein base64-codierter Wert, der aus der Dienstkonto-Schlüsseldatei generiert wurde. Keine. Ja.