注意：以下翻译的准确性尚未经过验证。这是使用 AIP ↗ 从原始英文文本进行的机器翻译。

Slack [Beta]

Slack连接器处于测试阶段，可能无法在您的Foundry注册中使用。如果您在数据连接的新来源页面找不到Slack，请联系Palantir支持以启用访问。

使用CData JDBC驱动将Foundry连接到Slack，以将数据导入Foundry数据集。

支持的功能

功能	状态
批量导入	🟡 测试版
探索	🟡 测试版
增量	🟡 测试版

数据模型

CData驱动将Slack数据建模为关系数据库中的表列表，可以使用标准SQL语句查询。有关可用表及其内容的信息，请查看CData文档中的Slack表 ↗。

设置

打开数据连接应用程序，并在屏幕右上角选择**+ 新来源**。
从可用连接器类型中选择Slack。
选择通过互联网使用直接连接或通过中介代理连接通过代理。
按照下面各部分中的信息继续设置连接器的其他配置提示。

了解有关在Foundry中设置连接器的更多信息。

身份验证

对Slack的身份验证是通过Bearer词元进行的。这可以通过与您Slack工作区中安装的Slack应用程序关联的机器人用户词元提供。

使用机器人词元可以创建持久且稳健的来源，而无需直接链接到个人用户。要创建Slack应用程序并获取其机器人词元，请按照Slack文档中的步骤操作：

在目标工作区中创建Slack应用程序。↗
为应用程序配置所需范围。↗
- 有关所需范围的详细信息，请参见权限。
将应用程序安装到目标工作区。↗
- 应用程序安装可能需要您Slack工作区管理员的批准。对应用程序范围的任何添加也将需要重新安装。
- 安装后，请按照Slack文档中的步骤将安装的应用程序的机器人词元定位并复制到数据连接中的Slack来源的凭据设置中（见配置选项）。

权限

要摄取数据表，必须为在来源配置的凭据设置中配置的Bearer词元的Slack应用程序授予特定的Slack权限范围。

有关支持所有CData驱动功能所需的权限范围的完整列表，请参阅CData文档 ↗。当仅使用Slack连接器进行数据摄取功能时，不需要写入权限范围。有关权限范围的更多详细信息，请查看Slack文档 ↗。

用于数据摄取的Slack应用程序的权限范围要求可以减少，如果仅需要这些表中的特定数据表或类型的Slack频道数据进行摄取。

示例：用于摄取与Slack消息和频道类型相关的数据表的权限范围要求包括以下内容：

表名	范围	总是需要吗？	描述
`Users`	`users:read`	是	加载用户。
`Channels`	`channels:read`, `groups:read`, `im:read`, `mpim:read`	否	仅在分别加载公共、私人、im（直接消息）或mpim（群组直接消息）频道时需要。加载所有频道类型时（如果没有指定频道筛选，这就是默认设置）需要所有权限。
`Messages` 或 `MessageReplies`	`channels:history`, `groups:history`, `im:history`, `mpim:history` + `Channels`的要求	否	仅在分别从公共、私人、im或mpim频道加载消息/回复时需要。加载所有频道类型时（如果没有指定频道筛选，这就是默认设置）需要所有权限。另见下面关于频道成员资格要求的附加说明。

要使用Slack连接器的Slack应用程序的机器人词元从给定的Slack频道摄取消息和消息回复，必须首先将Slack应用程序添加到Slack频道中，并且如上所述具有频道类型的读取权限范围。 Slack应用程序可以由用户手动添加到Slack中的频道，也可以使用应用程序的机器人用户词元通过Slack Web API ↗以编程方式加入公共频道。

网络

Slack连接器需要对slack.com的网络访问，端口为443。如果您正在通过互联网使用直接连接，请确保存在出口策略。对于代理运行时，运行代理的服务器必须能够访问该域。

配置选项

Slack连接器可用的配置选项如下：

选项	必需吗？	描述
`凭据设置`	是	使用上面显示的身份验证指南进行配置。
`代理设置`	否	启用并输入用户名和密码以允许通过代理连接到Slack。
`日志`	否	启用以控制连接器如何记录信息。有关更多详细信息，请查看日志设置部分。

从Slack同步数据

要设置Slack同步，请在来源概览屏幕的右上角选择探索和创建同步。接下来，选择要同步到Foundry的表。当您准备好同步时，选择为x个数据集创建同步。

了解有关在Foundry中进行来源探索的更多信息。

配置Slack同步

Slack连接器允许进行高级同步配置，以确定将哪些数据量引入Foundry。

在探索可用的同步并将其添加到连接器后，导航到编辑同步。从左侧的同步面板中，找到您要配置的同步并选择右侧的**>**。

选项	必需吗？	描述
`表`	是	选择要从Slack复制到Foundry的表。请参阅数据模型了解支持哪些表。
`列选择`	否	选择要同步到Foundry的列子集。有关更多信息，请查看列选择部分。
`行筛选`	否	启用并添加筛选以删除不符合其列值标准的行。有关更多信息，请查看行筛选部分。
`限制`	否	向底层查询添加SQL `limit`子句。此设置可用于限制在一次运行中同步到Foundry的行数。
`增量`	否	启用以小批量将数据同步到Foundry。有关更多信息，请查看增量部分。

增量

通常，同步将从目标表导入所有匹配的行，无论同步之间数据是否更改。相比之下，增量同步会维护最近一次同步的状态，仅摄取目标中的新匹配行。

在从Slack摄取大表时，可以使用增量同步。要使用增量同步，表必须包含一个严格单调递增的列。此外，读取的表必须包含一个具有以下数据类型之一的列：

DATE
TIMESTAMP

数值列类型：

int
TINYINT
SMALLINT
INTEGER
long
BIGINT
NUMERIC
NUMBER
DECIMAL
DEC

字符串列类型：

string
VARCHAR
CHAR
NVARCHAR
NCHAR
LONGNVARCHAR
LONGVARCHAR

增量同步需要以下配置：

选项	必需吗？	描述
列	是	选择将被用于增量摄取的列。如果表不包含任何支持的列类型，下拉菜单将为空。
`初始值`	是	起始同步数据的值。

示例同步配置：