Google BigQuery 扩展程序

<ph type="x-smartling-placeholder"></ph> 您正在查看 Apigee Edge 文档。
转到 Apigee X 文档。 信息

<ph type="x-smartling-placeholder">

版本 1.0.0

在 BigQuery 表中插入行。列出表中的行。

前提条件

本文提供了配置和使用此扩展程序的参考信息。在通过 API 代理使用 ExtensionCallout 政策使用扩展程序之前，您必须：

  1. 确保您已为自己的账号启用 BigQuery API。

  2. 在尝试插入行之前，请确保您已创建 BigQuery 数据集和表（具有架构）。

  3. 使用 GCP Console 为服务账号生成密钥。

  4. 在通过配置参考添加和配置扩展程序时，使用所生成的密钥 JSON 文件的内容。

Google BigQuery 简介

Google BigQuery 是一个可扩缩的无服务器企业数据仓库，利用 Google 基础架构的强大处理能力实现超快的 SQL 查询。由于没有需要管理的基础架构，因此您可以专心分析数据，使用熟悉的 SQL 发掘有意义的数据洞见，而无需指派数据库管理员。

如需查看实操介绍，请参阅其中一个 Google BigQuery 快速入门。

操作

<ph type="x-smartling-placeholder">

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 编码值。 无。 是。