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 快速入门。

Action

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 代理中使用时，请使用以下代码。如需了解使用 Apigee 控制台配置扩展程序的步骤，请参阅添加和配置扩展程序。

通用扩展属性

每个扩展程序都有以下属性。

属性 说明 默认 必需
name 您为扩展程序配置此名称。 无 是
packageName Apigee Edge 提供的扩展包的名称。 无 是
version 配置扩展程序所用的扩展程序软件包的版本号。 无 是
configuration 特定于您要添加的附加信息的配置值。请参阅此扩展程序软件包的属性 无 是

此扩展程序软件包的属性

为此扩展程序的以下配置属性指定值。

媒体资源 说明 默认 必需
projectId 数据所在的 GCP 项目的 ID。 无。 有。
凭据 在 Apigee Edge 控制台中输入时，这是服务帐号密钥文件的内容。通过 Management API 发送时，它是从服务帐号密钥文件生成的 base64 编码值。 无。 有。