Spotfire® 用户指南

Google BigQuery 连接器 - 功能和设置

可以连接到 Google BigQuery 并访问其中的数据。在此页面上,可以了解相关功能、可用设置以及处理与 Google BigQuery 的数据连接时的注意事项。

页面内容

提示: 有关如何创建与 Google BigQuery 的第一个连接的说明,以及有关在 Spotfire 中处理 BigQuery 数据的信息,请参见访问来自 Google BigQuery 的数据

连接器功能

当您使用 Google BigQuery 连接器访问数据时,可以使用以下功能。

功能 支持?
加载方法
  • 导入(内存中)
  • 外部(数据库内)
  • 按需
自定义查询
预存程序
自定义连接属性
使用身份提供程序进行单点登录 不适用
在 Web 客户端中编写
包含在 Linux 上的 Spotfire 发行版中

数据源属性

以下是在使用 Google BigQuery 连接器创建数据连接时可以配置的受支持的数据源属性。

选项 说明
计帐项目 选择将为数据连接向 BigQuery 发送的查询费用的 Google Cloud Platform 项目。
注: 偏好设置 ListAllProjects 确定您是只能看到来自所选计帐项目的数据,还是可以看到您在 Google BigQuery 中有权访问的所有数据(在您所属的项目中)。作为管理员,您可以在管理器下的“连接器”>“Google BigQuery”>“ListAllProjects”中更改偏好。

如果 ListAllProjects 设置为 False,并且您想要访问来自所选计帐项目以外的项目的数据,请选择“包括来自其他项目的数据”并输入项目 ID。

包括来自其他项目的数据 可以将此设置用于两个目的:
  • 如果您想从尚未加入的 Google Cloud Platform 项目访问数据,请输入项目 ID 以访问该数据。
  • 如果偏好设置 ListAllProjects 设置为 False,并且您想要访问来自所选计帐项目以外的项目的数据,请输入项目 ID。
选中此复选框,然后在文本字段中输入要包含其中数据集的项目的项目 ID。要输入多个项目,请用逗号分隔 ID。例如:
example-project-id-1, example-project-id-2
启用重复列 决定您是否可以在与数据源的连接中查看和选择重复列。

在 Spotfire 中使用重复列要求您对数据具有深入了解。有关来自 BigQuery 的重复列在 Spotfire 中如何工作的更多信息,请参阅来自 Google BigQuery 的重复列

默认情况下取消选中此复选框。“连接中的视图”对话框中不列出重复列以供选择。

注: 如果要使用 BigQuery 连接器访问 Google Analytics 数据,您必须在连接中启用重复列。
显示公共数据 决定您是否可以在与数据源的连接中查看和选择来自 BigQuery 公共数据集的数据。

默认情况下取消选中此复选框。“连接中的视图”对话框中不列出来自 BigQuery 公共数据集的数据以供选择。

启用公共数据时,在“连接中的视图”对话框中加载数据数据表可能需要耗费很长时间。

提示: 作为 Spotfire 管理员,您可以控制“显示公共数据”对用户是否可用。如果您希望用户无法选择公共数据,请在 Spotfire 管理器中将 Google BigQuery 偏好 ShowPublicDataCheckBox 设置为 False
使用专用终结点 选择是否要使用专用终结点连接到 Google BigQuery。为此,请单击“专用终结点”选项卡。有五个专用终结点,可以从偏好设置中进行选取,也可以自定义。请参见 Google BigQuery 的专用终结点

受支持的数据类型

设置到外部数据源的连接时,Spotfire 需要将数据源中的数据类型映射到 Spotfire 中的数据类型。以下是 Google BigQuery 连接器支持的数据类型。

数据库数据类型 Spotfire 数据类型
BYTES Binary
GEOGRAPHY Binary
BOOL Boolean/Bool
NUMERIC Currency/Decimal
DATE Date
DATETIME DateTime
INT64 LongInteger/Long
FLOAT64 Real/Double
STRING String
TIME Time

支持的函数

支持的函数是指您在处理数据库中的数据表时可以使用的函数,例如在计算的列和自定义表达式中使用。

注: 您的数据库可能无法使用某些受支持的函数。这取决于数据库中可用的函数,不同数据库版本和类型之间通常会有差异。

以下是 Google BigQuery 连接器支持的函数。

函数类型 支持的函数
聚合函数 AVGCOUNTCOUNTIFLOGICAL_ANDLOGICAL_ORMAXMINSTRING_AGGSUM
近似聚合函数 APPROX_COUNT_DISTINCT
位函数 BIT_COUNT
转换 STRING
日期函数 EXTRACTDATEDATE_ADDDATE_SUBDATE_DIFFDATE_TRUNCDATE_FROM_UNIX_DATEFORMAT_DATEPARSE_DATEUNIX_DATE
日期时间函数 DATETIMEDATETIME_ADDDATETIME_SUBDATETIME_DIFFDATETIME_TRUNCFORMAT_DATETIMEPARSE_DATETIME
地理函数 ST_GEOGPOINTST_MAKELINEST_MAKEPOLYGONST_GEOGFROMGEOJSONST_GEOGFROMTEXTST_GEOGFROMWKBST_ASGEOJSONST_ASTEXTST_ASBINARYST_BOUNDARYST_CENTROIDST_CLOSESTPOINTST_DIFFERENCEST_INTERSECTIONST_SNAPTOGRIDST_UNIONST_XST_YST_CONTAINSST_COVEREDBYST_COVERSST_DISJOINTST_DWITHINST_EQUALSST_INTERSECTSST_INTERSECTSBOXST_TOUCHESST_WITHINST_ISEMPTYST_ISCOLLECTIONST_DIMENSIONST_NUMPOINTSST_AREAST_DISTANCEST_LENGTHST_MAXDISTANCEST_PERIMETERST_UNION_AGG
哈希函数 FARM_FINGERPRINTMD5SHA1SHA256SHA512
JSON 函数 JSON_EXTRACTJSON_EXTRACT_SCALARTO_JSON_STRING
数学函数 ABSSIGNIS_INFIS_NANIEEE_DIVIDERANDSQRTPOWPOWEREXPLNLOG、LOG10、GREATESTLEASTDIVSAFE_DIVIDEMODROUNDTRUNCCEILCEILINGFLOORCOSCOSHACOSACOSHSINSINHASINASINHTANTANHATANATANHATAN2
运算符 +-*/
统计聚合函数 CORRCOVAR_POPCOVAR_SAMPSTDDEV_POPSTDDEV_SAMPSTDDEVVAR_POPVAR_SAMPVARIANCE
字符串函数 BYTE_LENGTHCHAR_LENGTHCHARACTER_LENGTHCONCATENDS_WITHFROM_BASE64FROM_BASE32FROM_HEXLENGTHLPADLOWERLTRIMNORMALIZENORMALIZE_AND_CASEFOLDREGEXP_CONTAINSREGEXP_EXTRACTREGEXP_REPLACEREPLACEREPEATREVERSERPADRTRIMSAFE_CONVERT_BYTES_TO_STRINGSTARTS_WITHSUBSTRTO_BASE32TO_BASE64TO_HEXTRIM
时间函数 TIMETIME_ADDTIME_SUBTIME_DIFFTIME_TRUNCFORMAT_TIMEPARSE_TIME
时间戳函数 EXTRACTSTRINGTIMESTAMPTIMESTAMP_ADDTIMESTAMP_SUBTIMESTAMP_DIFFTIMESTAMP_TRUNCFORMAT_TIMESTAMPTIMESTAMP_SECONDSTIMESTAMP_MILLISTIMESTAMP_MICROSUNIX_SECONDSUNIX_MILLISUNIX_MICROS
UUID 函数 GENERATE_UUID