Google BigQuery 擴充功能

查看 Apigee Edge 說明文件。
前往 Apigee X說明文件。 資訊

1.0.0 版本

在 BigQuery 資料表中插入資料列。列出資料表中的資料列。

必要條件

這項內容提供設定與使用這項擴充功能的參考資源。透過 Extension 摘要政策使用 API Proxy 擴充功能之前，您必須：

  1. 確認您已經為帳戶啟用 BigQuery API。

  2. 嘗試插入資料列之前，請務必先建立 BigQuery 資料集和資料表 (含結構定義)。

  3. 使用 GCP 主控台為服務帳戶產生金鑰。

  4. 使用設定參考資料新增及設定擴充功能時，請使用產生的金鑰 JSON 檔案內容。

關於 Google BigQuery

Google BigQuery 是可擴充的無伺服器企業資料倉儲，會運用 Google 基礎架構的處理能力，飛快處理 SQL 查詢。由於 BigQuery 沒有基礎架構需要管理，更不需要資料庫管理員，因此您可以專心分析資料，使用熟悉的 SQL，找出有意義的深入分析結果。

如需實作簡介，請參閱 Google BigQuery 快速入門導覽課程。

動作

insert

將一組記錄做為資料集直接插入 BigQuery，並在資料集內插入資料列和資料集/資料表 ID，

語法

<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。 字串 無。 是。
限制 要列出的列數上限。 整數 無。 編號
startIndex 清單啟動位置的列索引。 整數 無。 編號
資料表 要列出其資料列的資料表 ID。 字串 無。 是。

回應

rows 陣列。

{
  "rows": [
    {"technology":"World Wide Web","inventorFirstName":"Tim","inventorLastName":"Berners-Lee"}
    {"technology":"Alternating current","inventorFirstName":"Nikola","inventorLastName":"Tesla"}
  ]
}
參數 說明 類型 預設 必填
資料列 要求傳回的資料列陣列。 陣列 無。 是。

設定參考資料

設定及部署這項擴充功能以用於 API Proxy 時，請使用下列指令。如需使用 Apigee 控制台設定擴充功能的步驟，請參閱新增及設定擴充功能。

常見擴充功能屬性

每個擴充功能都有下列屬性。

屬性 說明 預設 必要
name 您要為這項擴充功能設定的名稱。 無 相容
packageName Apigee Edge 指定的擴充功能套件名稱。 無 相容
version 擴充功能的擴充功能套件版本號碼。 無 相容
configuration 您要新增的擴充功能專屬的設定值。請參閱「這個擴充功能套件的屬性」一文 無 相容

這個擴充功能套件的屬性

指定這個擴充功能專用的下列設定屬性值。

屬性 說明 預設 必填
專案 ID 資料所在 GCP 專案的 ID。 無。 是。
憑證 您在 Apigee Edge 控制台中輸入的內容，是指您的服務帳戶金鑰檔案的內容。透過 Management API 傳送時，這是從服務帳戶金鑰檔案產生的 Base64 編碼值。 無。 是。