Amazon Athena Google BigQuery 连接器 - Amazon Athena
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

Amazon Athena Google BigQuery 连接器

适用于 Google BigQuery 的 Amazon Athena 连接器使 Amazon Athena 能够对您的 Google BigQuery 数据运行 SQL 查询。

先决条件

限制

  • Lambda 函数的最大超时值为 15 分钟。每次拆分都会在 BigQuery 上执行一次查询,并且必须有足够的时间来存储结果,以便 Athena 读取。如果 Lambda 函数超时,查询将失败。

  • Google BigQuery 区分大小写。连接器尝试更正数据集名称和表名的大小写,但不对项目 ID 进行任何大小写更正。这很有必要,因为 Athena 所有元数据均采用小写形式。这些更正对 Google BigQuery 进行了许多额外的调用。

  • 不支持 Binary 数据类型。

  • 不支持复杂数据类型,例如 mapliststruct

  • 由于 Google BigQuery 的并发和配额限制,连接器可能会遇到 Google 配额限制问题。为了避免这些问题,请尽可能多地向 Google BigQuery 施加限制。有关 BigQuery 配额的信息,请参阅 Google BigQuery 文档中的 配额和限制

参数

使用本节中的 Lambda 环境变量来配置 Google BigQuery 连接器。

  • spill_bucket - 为超出 Lambda 函数限制的数据指定 Amazon S3 存储桶。

  • spill_prefix -(可选)默认为指定 spill_bucket(称为 athena-federation-spill)中的子文件夹。我们建议您在此位置配置 Amazon S3 存储生命周期,以删除早于预定天数或小时数的溢出内容。

  • spill_put_request_headers -(可选)用于溢出的 Amazon S3 putObject 请求的请求标头和值的 JSON 编码映射(例如,{"x-amz-server-side-encryption" : "AES256"})。有关其他可能的标头,请参阅《Amazon Simple Storage Service API 参考》中的 PutObject

  • kms_key_id -(可选)默认情况下,将使用经过 AES-GCM 身份验证的加密模式和随机生成的密钥对溢出到 Amazon S3 的任何数据进行加密。要让您的 Lambda 函数使用 KMS 生成的更强的加密密钥(如 a7e63k4b-8loc-40db-a2a1-4d0en2cd8331),您可以指定 KMS 密钥 ID。

  • disable_spill_encryption -(可选)当设置为 True 时,将禁用溢出加密。默认值为 False,此时将使用 AES-GCM 对溢出到 S3 的数据使用进行加密 - 使用随机生成的密钥,或者使用 KMS 生成密钥。禁用溢出加密可以提高性能,尤其是当您的溢出位置使用服务器端加密时。

  • gcp_project_id - 项目 ID(不是项目名称),包含连接器应从中读取的数据集(例如 semiotic-primer-1234567)。

  • secret_manager_gcp_creds_name - Amazon Secrets Manager 中的密钥名称,包含 JSON 格式的 BigQuery 凭证(例如 GoogleCloudPlatformCredentials)。

分区和拆分

BigQuery 连接器使用在 Google 项目中定义的 concurrencyLimit 环境变量,以确定拆分的页数。连接器不会根据表上的分区生成拆分。

性能

为了减少必须返回的结果数量,连接器会尝试向 Google BigQuery 推送尽可能多的限制。

许可证信息

Amazon Athena Google BigQuery 连接器项目已获得 Apache-2.0 许可证授权。

使用此连接器,即表示您确认包含第三方组件(这些组件的列表可在此连接器的 pom.xml 文件中找到),并同意 GitHub.com 上的 LICENSE.txt 文件中提供的相应第三方许可证中的条款。

另请参阅

有关此连接器的更多信息,请访问 GitHub.com 上的相应站点