Spotfire® 用户指南

PostgreSQL 连接器 - 功能和设置

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

页面内容

连接器功能

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

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

数据源属性

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

选项 说明
服务器

您的数据所在的服务器名称。若要包含端口号,请将其直接添加在名称的后面,前面带有冒号。

端口号的示例:MyDatabaseServer:1234

身份验证方法

当登录到数据库时要使用的身份验证方法。从 Windows 身份验证和数据库身份验证中选择。

Windows 身份验证

当使用 Windows 身份验证(例如 Kerberos)时,系统将使用已登录用户的访问令牌。已提供适当访问权限的用户能够连接和读取数据。

域凭据未存储在分析文件中。

用户名和密码

使用用户名和密码,身份验证通过数据库用户来执行。通过使用“数据源设置”对话框中的设置,可将数据库凭据作为分析文件的一部分加以存储和解密。如果在分析文件中找到凭据,则会使用这些凭据对数据库进行自动身份验证。

如果在分析文件中未找到凭据或凭据配置文件,则打开该文件的所有用户都将被提示输入数据库凭据。

请注意,如果嵌入到分析文件中的凭据失败,则不会提示输入凭据。

Use SSL 确定是否为数据库连接启用安全套接层 (SSL)。
SSL 模式

[仅当选择“使用 SSL”时可用。]

确定要在与数据库的连接中使用的 SSL 模式。包括以下选项:

allow

仅在服务器要求时使用 SSL 加密。

prefer

如果服务器支持,则应使用 SSL。

require

必须始终使用 SSL。

verify-ca

[使用此选项需要证书文件。]

必须使用 SSL,且必须验证服务器的 CA 证书。

verify-full

[使用此选项需要证书文件。]

必须使用 SSL,必须验证服务器的 CA 证书,且服务器主机名必须与证书的主机名匹配。

有关如何使用 SSL 模式的详细信息,请参见官方 PostgreSQL 文档。

嵌入证书文件

[仅当选择“使用 SSL”时可用。]

选择 SSL 模式 verify-ca 或 verify-full 时用于验证数据库服务器的 SSL 证书文件。

要嵌入证书,请单击“浏览”并选择计算机上的证书文件。证书文件将嵌入并存储在 Spotfire 数据源中。

提示: 由于嵌入了证书文件,因此其他用户不必将证书文件保存在其计算机上。

我应该使用什么证书文件?

注: 如果您使用的是公共 Spotfire Server(非内部部署),则只能使用包含公钥的证书文件。

证书文件必须与数据库服务器上的 CA 证书匹配。

建议仅使用包含公钥的证书文件。

使用包含私钥的证书文件会带来安全风险,因为证书文件嵌入在 Spotfire 数据源中,可能还会嵌入在分析文件中。

要嵌入包含私钥的证书文件,您必须是已为 PostgreSQL 连接器启用偏好设置 AllowEmbeddingCertificatesWithPrivateKeys 的用户组的成员。作为管理员,您可以在管理器中编辑用户和组的偏好设置。

提示: 为保持高效重用和可维护性,建议在库中使用共享的连接数据源。
注: 如果未嵌入证书文件,PostgreSQL ODBC 驱动程序将尝试使用默认目录中的证书文件。如果使用此方法,则必须将此证书文件放在运行自动化服务或 Web Player 服务的所有计算机上的此目录中。有关驱动程序默认情况下如何处理证书文件的更多信息,请参见 PostgreSQL 的官方文档。
视图 在 Windows 中打开“证书”对话框,您可以在其中查看有关嵌入的证书文件的信息。
删除 删除嵌入的证书文件。
数据库 从下拉列表中选择感兴趣的数据库。此外也可键入所需数据库的名称。
禁止遗传优化器 确定在连接到数据库时 PostgreSQL ODBC 驱动程序中是否使用“禁止遗传优化器”设置。
解析语句

确定在连接到数据库时 PostgreSQL ODBC 驱动程序中是否使用“解析语句”设置。

服务器端准备

确定在连接到数据库时 PostgreSQL ODBC 驱动程序中是否使用“服务器端准备”设置。

连接缓存大小

元组缓存中的行数。

默认值为 100 行。

系统表前缀

数据库中应视为系统表的表名的前缀。使用分号分隔各个值。

默认值为 dd_

连接超时(秒)

与数据库建立连接时允许等待的最长时间(以秒为单位)。

默认值为 120 秒。

命令超时 (秒)

执行一条命令所允许的最长时间(以秒为单位)。

默认值为 1800 秒。

受支持的数据类型

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

数据库数据类型 Spotfire 数据类型
BYTEA Binary
GEOMETRY Binary
注: 在自定义查询中不受支持。
BOOL Boolean
MONEY Currency
DATE Date
TIMESTAMP DateTime
TIMESTAMPTZ DateTime
BIT Integer
注: 在自定义查询中不受支持。
INT2 Integer
INT4 Integer
SMALLSERIAL Integer
SERIAL Integer
INT8 LongInteger
BIGSERIAL LongInteger
FLOAT8 Real
FLOAT4 SingleReal
BPCHAR String
VARCHAR String
TEXT String
INTERVAL String
注: 在自定义查询中不受支持。

可能无法从某些版本的 Brytlyt 访问 INTERVAL 数据。

CIDR String
INET String
MACADDR String
XML String
TIME Time
TIMETZ Time
注: 在自定义查询中不受支持。
NUMERIC(p,s)

当 p <= 9 并且 s = 0 时:Integer/Int

当 9 < p <= 18 并且 s = 0 时:LongInteger/Long

当 p <= 15 时:Real/Double

其他:Currency/Decimal

支持的函数

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

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

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

函数类型 支持的函数
日期和时间 Millennium, Year, Quarter, Month, Week, Day, DayOfMonth, DayOfYear, DayOfWeek, Hour, Minute, Second, Millisecond
转换 SN
数学 Degrees, Abs, Mod, Pi, Radians, Random, Scale, ACos, ACosd, ASin, ASind, Cos, Cosd, Cot, Cotd, Sin, Sind, Tan, Tand, Cbrt, Ceiling, Div, Exp, Floor, Ln, Log, Power, Round, Sign, Sqrt, ATan, ATand, ATan2, ATan2d
运算符 +, -, *, /, %, &
统计 Sum, Avg, Min, Max, First, Last, Count, UniqueCount, Corr, Covar_pop, Regr_avgx, Regr_avgy, Regr_count, Regr_intercept, Regr_r2, Regr_slope, Regr_sxx, Regr_sxy, Regr_syy, Stddev, Stddev_pop, Stddev_samp, Variance, Var_pop, Var_samp
文本 Concat, Initcap, LeftStr, Length, Lower, LTrim, Md5, RightStr, RTrim, Repeat, Replace, Reverse, Strpos, Trim, Upper, Bit_length, Char_length, Octet_length, Btrim, Chr, To_ascii, To_hex, Substr, Translate, Convert, Convert_From, Convert_To

PostgreSQL 还支持合并