Google BigQuery 拡張機能

ここに表示されているのは Apigee Edge のドキュメントです。
Go to the Apigee X のドキュメントに移動します。 info

バージョン 2.0.2

BigQuery テーブルに行を挿入します。テーブルから行を一覧表示します。

前提条件

このコンテンツでは、この拡張機能の設定と使用に関するリファレンスを提供します。ExtensionCallout ポリシーで API プロキシ経由で拡張機能を使用する前に、次のことを行う必要があります。

  1. お使いのアカウントで BigQuery API が有効になっていることを確認します。

  2. 行を挿入する前に、BigQuery データセットと テーブル（スキーマ付き）を作成していることを確認します。

  3. Google Cloud コンソールを使用して、サービス アカウントのキーを生成します。

  4. 構成リファレンスを使用して拡張機能を追加して構成するときに、生成されたキー JSON ファイルの内容を使用します。

Google BigQuery について

Google BigQuery は、Google のインフラストラクチャの処理能力を使用して超高速の SQL クエリを実行できる、サーバーレスでスケーラブルなエンタープライズ データ ウェアハウスです。インフラストラクチャを管理する必要がないため、データベース管理者を必要とせずに、使い慣れた SQL を使用してデータを分析し、有意義な分析情報を得ることができます。

実際の操作を通じた機能紹介については、Google BigQuery クイックスタートをお試しください。

操作

挿入

挿入する行、データセット ID、テーブル ID を指定して、一連のレコードをデータセットとして BigQuery に直接挿入します。

構文

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

例

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

リクエスト パラメータ

パラメータ 説明 型 デフォルト 必須
データセット BigQuery に挿入するデータセットの ID。 文字列 なし。 はい。
行 テーブルに挿入する行。 配列 なし。 はい。
テーブル データを受信するテーブルの名前。 文字列 なし。 はい。

レスポンス

なし。

listRows

テーブル ID とデータセット ID で指定されたテーブルの行を一覧表示します。

構文

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

例

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

リクエスト パラメータ

パラメータ 説明 型 デフォルト 必須
データセット 行を一覧表示するデータセットの ID。 文字列 なし。 はい。
limit 一覧表示する行の最大数。 整数 なし。 いいえ。
startIndex リストを開始する行インデックス。 整数 なし。 いいえ。
テーブル 行を一覧表示するテーブルの ID。 文字列 なし。 はい。

レスポンス

rows 配列。

{
  "rows": [
    {"technology":"World Wide Web","inventorFirstName":"Tim","inventorLastName":"Berners-Lee"}
    {"technology":"Alternating current","inventorFirstName":"Nikola","inventorLastName":"Tesla"}
  ]
}
パラメータ 説明 型 デフォルト 必須
行 リクエストから返された行の配列。 配列 なし。 はい。

構成リファレンス

API プロキシで使用するためにこの拡張機能を構成してデプロイする場合は、以下を使用します。Apigee コンソールを使用して拡張機能を構成する手順については、拡張機能の追加と構成をご覧ください。

拡張機能の共通プロパティ

すべての拡張機能には次のプロパティがあります。

プロパティ 説明 デフォルト 必須
name この拡張機能に付ける名前。 なし ○
packageName Apigee Edge から提供された拡張機能パッケージの名前。 なし ○
version 拡張機能を構成する拡張機能パッケージのバージョン番号。 なし ○
configuration 追加する拡張機能に固有の構成値。この拡張機能パッケージのプロパティをご覧ください。 なし ○

この拡張機能パッケージのプロパティ

この拡張機能に固有の次の構成プロパティの値を指定します。

プロパティ 説明 デフォルト 必須
projectId データが保存されている Google Cloud プロジェクトの ID。 なし。 はい。
credentials Apigee Edge コンソール内で入力する場合は、サービス アカウント キーのファイルの内容です。Management API を使用して送信する場合は、サービス アカウント キーファイルから生成された base64 エンコード値です。 なし。 はい。