Google BigQuery 拡張機能

現在、Apigee Edge のドキュメントを表示しています。
Apigee X のドキュメントをご確認ください。 情報

バージョン 1.2.1

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

前提条件

ここでは、この拡張機能の構成と使用について説明します。ExtensionCallout ポリシーで API プロキシから拡張機能を使用する前に、次のことを行う必要があります。

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

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

  3. GCP Console を使用してサービス アカウント キーを生成します。

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

Google BigQuery について

Google BigQuery は、サーバーレスでスケーラブルなエンタープライズ データ ウェアハウスです。Google のインフラストラクチャの処理能力を活用して SQL クエリを超高速で実行します。インフラストラクチャの管理が不要なため、有意義な情報を見つけるためのデータ分析に集中できます。また、データベースの操作には使い慣れた SQL を使用できるほか、データベース管理者も必要ありません。

実践的な概要として、Google BigQuery クイックスタートのいずれかをお試しください。

アクション

挿入

挿入する行とデータセット/テーブル 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。 文字列 なし。 はい、できます。
上限 リストする行の最大数。 Integer なし。 違います
startIndex リストを開始する行インデックス。 Integer なし。 違います
テーブル 行を一覧表示するテーブルの 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 データがある GCP プロジェクトの ID。 なし。 はい、できます。
証明書 これは、Apigee Edge コンソールで入力する場合、サービス アカウント キー ファイルの内容です。Management API 経由で送信される場合は、サービス アカウント キー ファイルから生成された、Base64 エンコードの値です。 なし。 はい、できます。