Google BigQuery 扩展程序

您正在查看 Apigee Edge 文档。
前往 Apigee X 文档。 信息

版本 2.0.0

将行插入到 BigQuery 表中。列出表中的行。

前提条件

本文档提供了有关配置和使用此扩展程序的参考信息。在使用 ExtensionCallout 政策从 API 代理使用扩展程序之前，您必须满足以下条件：

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

  2. 请确保您已创建 BigQuery dataset和表（包含架构），然后再尝试插入行。

  3. 使用 GCP 控制台为服务账号生成密钥。

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

Google BigQuery 简介

Google BigQuery 是一个无服务器的可扩缩企业级数据仓库，它可利用 Google 基础架构的强大处理能力实现极其快速的 SQL 查询。由于无需管理基础架构，因此您可以专心分析数据，使用熟悉的 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 代理中使用时，请使用以下内容。如需了解使用 Apigee 控制台配置扩展程序的步骤，请参阅添加和配置扩展程序。

常见的扩展属性

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

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

此扩展程序软件包的属性

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

属性 说明 默认 必需
projectId 数据所在的 GCP 项目的 ID。 无。 是。
凭据 在 Apigee Edge 控制台中输入此值时，系统会将其视为服务账号密钥文件的内容。通过 Management API 发送时，此参数是从服务账号密钥文件生成的 base64 编码值。 无。 是。