Spotfire® 用户指南

Amazon Redshift 连接器 - 功能和设置

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

页面内容

连接器功能

当您使用 Amazon Redshift 连接器访问数据时，可以使用以下功能。

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

数据源属性

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

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

端口号的示例：MyDatabaseServer:5439
身份验证方法 要用于登录到 Amazon Redshift 的身份验证方法。从以下选项中选择：
  • 用户名和密码

    使用用户名和密码登录 Amazon Redshift。有时在 Amazon Redshift 中称为标准身份验证。

  • AWS 配置文件
  • 使用已作为配置文件存储在 AWS 凭据文件中的 IAM 凭据登录 Amazon Redshift。
    注： 选择“AWS 配置文件”时，“用户名”字段控制连接设置 Dbuser。
    注： 必须在要使用该连接的、所有正在运行 Spotfire 客户端的计算机上提供并配置 AWS 凭据文件。如果在您的 Spotfire 环境中使用 Kerberos 身份验证，可能必须在运行 Web Player 服务的计算机上为每个用户配置 AWS 凭据文件。
  • AWS IAM 凭据
    使用 AWS IAM 凭据登录 Amazon Redshift。在“身份验证方法设置”表中输入 AWS IAM 凭据以及 AccessKeyID 和 SecretAccessKey 设置。
    注： 如果选择“AWS IAM 凭据”但您没有输入 AccessKeyID 和 SecretAccessKey，Amazon Redshift ODBC 驱动程序会尝试使用 AWS 凭据文件中的默认 AWS 配置文件（如果您的计算机上有该文件）。
  • AD FS
    使用 Active Directory 联合身份验证服务登录 Amazon Redshift。在“身份验证方法设置”表中输入以下信息：
    • IdP_Host: AD FS 服务的地址。
  • Azure AD
    使用 Azure AD 登录 Amazon Redshift。在“身份验证方法设置”表中输入以下信息：
    • IdP_Tenant: Azure AD 应用程序的租户 ID。
    • Client_ID: Azure 中 Redshift 群集的客户端 ID。
    • Client_Secret: Azure 中 Redshift 群集的客户端密钥。
  • Okta
    使用 Okta 的 AWS IAM 凭据登录 Amazon Redshift。在“身份验证方法设置”表中输入以下信息：
    • IdP_Host: Okta 服务的地址。
    • App_ID: Okta 中 Redshift 群集的应用程序 ID。
    • DbUser: 要使用的 Amazon Redshift 中的数据库用户。
  • PingFederate
    使用 PingFederate 的 AWS IAM 凭据登录 Amazon Redshift。在“身份验证方法设置”表中输入以下信息：
    • IdP_Host: PingFederate 服务的地址。
    • IdP_Port: PingFederate 服务的端口号。
    • DbUser: 要使用的 Amazon Redshift 中的数据库用户。
身份验证方法设置 所选身份验证方法的设置。根据您选择的身份验证方法，会向该表添加不同设置。还可以添加其他相关连接设置。要配置设置，请填充“值”列。然后使用“保存”复选框选择是希望将输入的值存储在连接中，还是希望用户在打开连接时填充自己的值。

保存设置值还是要求用户填充自己的值？

在表中，您可以选择是否要保存为设置输入的值。默认情况下，未选择“保存”。
  • 如果不选择“保存”，输入的设置值就不会存储在连接中。该设置被视为用户名或密码，因此当用户打开连接时，Spotfire 会要求他们输入设置值。
    重要： 在数据源设置对话框中，如果您选择“是，将凭据保存在连接数据源中”，所有设置都将保存在数据源中。
  • 如果选择“保存”，输入的设置值会存储在连接中。用户打开连接时，使用同一个值连接到 Amazon Redshift 群集。
    警告： 当您选择“保存”时，输入的值会以未加密的形式存储在分析文件中。对密钥信息（例如，用户名和密码）不选择“保存”。
添加设置

要添加新设置，则在表最后一行的“设置”列中输入设置的名称。然后在“值”列中输入值。输入设置的名称和值后，将添加一个新行，您可以在其中添加更多设置。

删除设置

要删除已添加的连接属性，请单击行中最左侧的单元格以选择整个行。然后按 Delete 键。

注： 如果您的键盘没有 Delete 键，则改为使用相应的键盘快捷方式。例如在 Mac 计算机上，相应的键盘快捷方式为 Fn + Backspace。

可以使用什么设置？

不能保证添加的任何特定连接设置都能在 Spotfire 中正常工作。出于安全原因，不允许实施某些设置。此外，您不能添加已经有专用控件或输入字段的设置。
SSL 模式 指定是否应在连接至 Amazon Redshift 数据库时使用 SSL。不使用 SSL，且连接不加密。
  • allow

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

  • prefer

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

  • require

    必须始终使用 SSL。

  • verify-ca

    必须使用 SSL，且必须验证证书。

  • verify-full

    必须使用 SSL，且必须验证服务器证书和主机名。

有关如何使用 SSL 模式的详细信息，请参见官方 Amazon Redshift 文档。
数据库 您的数据所在的数据库名称。
使用 unicode 如果选中此复选框，Amazon Redshift ODBC 驱动程序将为 CHAR 返回 SQL_WCHAR，为 VARCHAR 返回 SQL_WVARCHAR，并为 TEXT 返回 SQL_WLONGVARCHAR。

如果未选中此复选框，Amazon Redshift ODBC 驱动程序将为 CHAR 返回 SQL_CHAR，为 VARCHAR 返回 SQL_VARCHAR，并为 TEXT 返回 SQL_LONGVARCHAR。
连接超时(秒) 指定与数据库尝试建立连接允许的最大秒数。
注： 如果将连接超时设为零，则被视为永不超时。即，尝试连接时不设上限。通常不建议采取这种做法。
命令超时 (秒) 指定执行命令允许的最大秒数。
注： 如果将命令超时设为零，则被视为永不超时。即，尝试执行命令时不设上限。通常不建议采取这种做法。
设置配置文件 在 Web 客户端或自动化服务中打开连接时要使用的设置配置文件的名称。

设置配置文件是一种存储“身份验证方法设置”表中设置的方法，而无需将值保存在分析文件中。设置配置文件存储在自动化服务和 Web Player 服务的配置中。
其他设置
警告： 在“其他设置”表中添加的所有设置和值都以未加密形式存储在分析文件中。不要添加诸如用户名和密码之类的密钥信息。在 General 选项卡的 Settings for authentication method 表中，无需将值存储在分析文件中即可添加设置。

添加和使用其他连接设置。

在 Amazon Redshift ODBC 驱动程序中，有许多连接设置，它们在 Spotfire 中没有控件。该表可让您使用更多这些设置。要了解有哪些可用的连接设置，请参见 Amazon Redshift ODBC 驱动程序的文档。

添加设置

在“其他设置”表中，每一行表示一个连接设置。要添加新设置，请在“设置”列中输入该设置的名称，并在“值”列中输入值。输入设置的名称和值后，将添加一个新行，您可以在其中添加更多设置。

删除设置

要删除已添加的连接属性，请单击行中最左侧的单元格以选择整个行。然后按 Delete 键。
提示： 如果您的键盘没有 Delete 键，则改为使用相应的键盘快捷方式。例如在 Mac 计算机上，相应的键盘快捷方式为 Fn + Backspace。

可以使用什么设置？

不能保证添加的任何特定连接设置都能在 Spotfire 中正常工作。出于安全原因，不允许实施某些设置。此外，您不能添加已经有专用控件或输入字段的设置。

受支持的数据类型

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

数据库数据类型 Spotfire 数据类型
GEOMETRY Binary
BOOLEAN Boolean/Bool
DATE Date
TIMESTAMP DateTime
TIMESTAMPTZ DateTime
INTEGER Integer/Int
SMALLINT Integer/Int
BIGINT LongInteger/Long
FLOAT Real
DOUBLE PRECISION Real/Double
REAL SingleReal/Float
CHAR String
VARCHAR String
DECIMAL(p,s) 当 p <= 9 并且 s = 0 时：Integer/Int

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

当 p <= 15 时：Real/Double

其他：Currency/Decimal

支持的函数

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

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

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

函数类型 支持的函数
聚合 ApproximateCount、Bit_And、Bit_Or、Bool_And、Bool_Or、CountIf、ListAgg
合并

支持合并。

对于合并操作，可以使用“自动合并列”功能。

还可以使用以下 Spotfire 合并函数：BinByDateTime，BinByEvenIntervals，BinBySubstring

自定义函数 Width_Bucket 也可用：

Width_Bucket([Column],Min,Max,Buckets)
日期和时间 Add_Months、AtTimeZone、Convert_Timezone、Date、DateAdd、DateDiff、Date_Cmp、Date_Cmp_Timestamp、Date_From_Unix_Date、Date_Part、Date_Part_Year、Date_Trunc、Day、DayOfMonth、DayOfWeek、DayOfYear、Extract、Hour、Interval_Cmp、Last_Day、Millennium、Millisecond、Minute、Month、Months_Between、Next_Day、Quarter、Second、Timestamp_Cmp、Timestamp_Cmp_Date、Timestamp_Micros、Timestamp_Millis、Timestamp_Seconds、Timestamp_Trunc、Timezone、To_Timestamp、Trunc、Unix_Date、Unix_Micros、Unix_Millis、Unix_Seconds、Week、Year
转换 SN、To_Char、To_Date、To_Number
数学 Abs、ACos、ACosH、ASin、ASinH、ATan、ATan2、ATanH、Bit_Count、Cbrt、Ceil、Ceiling、Checksum、Cos、CosH、Cot、Degrees、DExp、Div、DLog1、DLog10、Exp、Floor、Fnv_Hash、From_Hex、Greatest、IEEE_Divide、Is_Inf、Is_NaN、Least、Ln、Log、Mod、Pi、Power、Radians、Random、Round、Safe_Divide、SHA、SHA1、SHA2、Sign、Sin、SinH、Sqrt、Tan、TanH、To_Hex
运算符 +、-、*、/、%、&
空间 GeometryType、ST_AddPoint、ST_Area、ST_AsBinary、ST_AsEWKB、ST_AsEWKT、ST_AsGeoJSON、ST_AsText、ST_Azimuth、ST_Contains、ST_CoveredBy、ST_Covers、ST_Dimension、ST_Disjoint、ST_Distance、ST_DistanceSphere、ST_DWithin、ST_EndPoint、ST_Envelope、ST_Equals、ST_GeometryN、ST_GeometryType、ST_GeomFromEWKB、ST_GeomFromText、ST_GeomFromWKB、ST_Intersects、ST_IsClosed、ST_IsCollection、ST_IsEmpty、ST_Length、ST_Length2D、ST_LineFromMultiPoint、ST_MakeLine、ST_MakePoint、ST_MakePolygon、ST_MemSIze、ST_NPoints、ST_NRings、ST_NumGeometries、ST_NumInteriorRings、ST_NumPoints、ST_Perimeter、ST_Perimeter2D、ST_Point、ST_PointN、ST_Polygon、ST_RemovePoint、ST_SetSRID、ST_SRID、ST_StartPoint、ST_Touches、ST_Within、ST_X、ST_XMax、ST_XMin、ST_Y、ST_YMax、ST_YMin
统计 Approximate_Percentile_Disc、Avg、Corr、Count、Covar_pop、Covar_samp、First、Last、Max、Median、Min、Percentile_Cont、Stddev_Pop、Stddev_Samp、Sum、UniqueCount、Var_Pop、Var_Samp
文本 BpCharCmp、BTrim、Bttext_Pattern_Cmp、CharIndex、Char_Length、Chr,Concat、CRC32, Ends_With、Initcap、Is_Valid_JSON、Is_Valid_JSON_Array、JSON_Array_Length、JSON_Extract_Array_Element_Text、JSON_Extract_Path_Text、LeftStr、Length、Lower、Lpad、LTrim、Md5、Octet_Length、Position、Quote_Ident、Quote_Literal、Regexp_Contains、Regexp_Count、Regexp_Instr、Regexp_Replace、Regexp_Substr、Repeat、Replace、Replicate、Reverse、RightStr、Rpad、RTrim、Split_Part、Starts_With、Strpos、Strtol、Substring、Translate、Trim、Upper
Copyright © Cloud Software Group, Inc. All rights reserved.