Google BigQuery 扩展程序

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

版本 1.2.1

将行插入到 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 控制台配置扩展程序的步骤，请参阅添加和配置扩展程序。

常见的扩展属性

The following properties are present for every extension.

Property Description Default Required
name Name you're giving this configuration of the extension. None Yes
packageName Name of the extension package as given by Apigee Edge. None Yes
version Version number for the extension package from which you're configuring an extension. None Yes
configuration Configuration value specific to the extension you're adding. See Properties for this extension package None Yes

此扩展程序软件包的属性

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

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