您可以将 Looker 应用安装到 Slack 工作区,以直接向公共和专用 Slack 频道发送或安排数据传送。如需启用 Looker 应用的安装,您的 Slack 工作区所有者可能需要调整 Slack 工作区的应用安装设置。
Slack 附件(API 令牌)集成也仍可使用。
在 Looker 操作中心启用集成
如果您的 Looker 实例满足必要条件,您的 Looker 管理员就必须在 Looker Action Hub 中为每个 Looker 实例启用 Slack 集成,然后用户才能使用 Slack 集成提供数据。
- 在平台下的管理面板中,转到操作页面。
- 点击启用按钮以在 Looker 操作中心启用 Slack 集成。
在 Slack 操作页面上,点击连接以连接到您的 Slack 工作区。
Looker 将请求访问 Slack 工作区,该工作区在页面右上角的下拉菜单中指示。要将多个 Slack 工作区连接到单个 Looker 实例,请点击 + 连接到 Slack 工作区链接。
点击 Allow(允许),并返回 Slack 操作页面。
点击启用开关,然后点击保存。
管理 Slack 工作区与 Looker 的连接
您可以通过 Slack 操作页面管理实例的 Slack 工作区连接。在管理面板的操作页面上,点击 Slack 集成旁边的设置按钮。
管理员可以对每个 Slack 工作区连接执行以下操作:连接、断开连接和重置。
如需将其他 Slack 工作区连接到 Looker 实例,请点击 + Connect to Slack workspace 链接。
如需断开现有的 Slack 工作区连接,请点击断开连接按钮,然后点击弹出式警告消息中的确定。您无需点击 Slack 操作页面上的保存即可保存这些设置。即使未连接 Slack 工作区,该操作仍将显示为已启用。
如需刷新 Slack 工作区连接而无需断开连接并重新连接,请点击重置按钮。
向 Slack 工作区进行身份验证
用户必须在 Looker 管理员连接到 Looker 的同一个 Slack 工作区中进行身份验证。用户还必须是工作区的现有成员,才能从 Looker 向工作区进行身份验证。
您可以通过以下方式在 Slack 工作区中首次进行身份验证:
从 Looker 成功验证身份到 Slack 后,您会收到确认 Slack 消息。
从“帐号”页面向 Slack 工作区进行身份验证
- 在 Looker 中,点击屏幕右上角的用户个人资料图标,然后选择帐号。
- 为实例启用的任何集成都显示在集成下。如果您的 Looker 管理员启用了至少一个 Slack 工作区,系统会显示一个使用 Slack 登录按钮。如果您的 Looker 管理员已将多个 Slack 工作区与您的 Looker 实例连接,系统会显示一个工作区列表,其中包含用于分别登录各个工作区的选项。
- Looker 将请求访问 Slack 工作区。如果您的 Looker 管理员已将多个 Slack 工作区连接到 Looker 实例,则 OAuth 页面的右上角会显示一个下拉菜单。从下拉菜单中选择适当的 Slack 工作区。点击允许。
- 返回您的 Account 页面后,Integrations(集成)部分中现在会显示一个选项,可让您撤消所关联工作区的 Slack 凭据。 注意:切勿撤消您的 Slack 令牌 - 一旦撤消,您创建的任何时间表都将失败。
现在您已经通过了身份验证,可以发送或安排显示信息中心、Looks 和探索了。如需了解详情,请参阅本页面上的向 Slack 传送数据部分。
通过“发送”或“调度”窗口向 Slack 工作区进行身份验证
- 在 Looker 中,导航至要传送的内容,点击齿轮图标,然后点击发送或计划发布。在信息中心部分,选择安排递送。
- 在“探索”或“查看”的发送或时间表窗口中,选择这些数据应传输到何处?下的 Slack 操作作为递送目的地。对于信息中心,选择安排和发送时间范围中的安排发送时间。
- 点击 Slack 旁边的登录。
- Looker 将请求访问 Slack 工作区。如果您的 Looker 管理员已将多个 Slack 工作区连接到 Looker 实例,则 OAuth 页面的右上角会显示一个下拉菜单。从下拉菜单中选择适当的 Slack 工作区。点击允许。
- 发送或安排递送窗口(或信息中心的安排递送窗口)现在会显示您的 Slack 递送选项,包括 Slack 工作区的公共和专用通道。
向 Slack 传送数据
您可以将内容传送到多个 Slack 工作区。Looker 管理员设置好工作区连接后,您可以从用户帐号页面登录每个工作区。然后,您可以从发送或安排发送时间弹出式窗口的工作区下拉列表中选择一个目标工作区,或为信息中心选择安排递送时间范围。
以下示例展示了用于提供信息中心的格式设置选项,其中包括:
- 可视化图表 (PNG)
- CSV ZIP 文件
发送或安排查看或探索的功能有不同的格式设置选项,包括:
- CSV
- XLSX
- JSON - 简单:在此格式中,Looker 使用维度或衡量操作的字段名称(而非字段的标签)作为其呈现值。
- JSON - 标签:在此格式中,Looker 将字段 labels 用作其 JSON 输出中的渲染值。
- JSON - 简单、内嵌:在此格式中,Looker 使用维度或衡量操作的字段名称(而非字段的标签)作为其呈现值。
- JSON - 详细、内嵌:在此格式中,Looker 使用维度或衡量操作的字段名称(而非字段的标签)作为其呈现值。
- 文本
- HTML
如需提供用户定义的信息中心、LookML 信息中心、 Look 或探索,请导航至您的内容并执行以下步骤:
- 点击齿轮图标,然后点击发送或计划发布。(您无法选择安排探索。)对于信息中心,请从信息中心的三点状菜单中选择安排送货时间。
- 在 Send 或 Schedule 窗口中,在 此数据应存储在何处? 下选择 Slack 集成作为交付目的地。对于信息中心,选择 Slack 集成作为目标位置下的交付目的地。如果这是您第一次使用 Slack 集成,则需要先在 Slack 工作区中进行身份验证。
- Looker 会显示特定于此 Looker 实例的 Slack 工作区或工作区的传送选项。
- 在分享方式字段中,输入要将数据发布到的 Slack 频道的名称。您可以向公开或不公开渠道发送私信,或者发送私信。请在开头添加 # 字符,例如 #Sales。
- 在评论字段中,输入您要在传送内容中添加的任何文本。您还可以使用 Slack 的高级格式和特殊解析来提及特定群组、用户或频道,或进行其他特殊提及。
- 在 Filename(文件名)字段中,输入附件文件的名称。
- 如果您正在安排数据传输,请点击保存全部。您的查询或信息中心将按计划传送到 Slack。如要发送数据,请点击发送。您的数据将传送到您的 Slack 频道。
从 Slack 访问 Looker
您可以通过以下方式在 Slack 中访问 Looker 数据:
在 Slack 中分享指向 Looker 内容的链接
您可以分享指向 Slack 中的 SQL Runner 可视化图表、用户定义的信息中心、LookML 信息中心、Looks(但不是公开嵌入的 Looks)或 Discovers 的链接。
该链接会在 Slack 中展开,以显示内容的标题和部分元数据,只有有权访问基础内容的用户才能看到。链接展开后,您或其他用户可以:
- 将链接返回到 Looker 中的内容和频道中内容的概况 - 点击发布到此频道。内容发布到频道后,频道中的任何人都可以查看内容概况和标题,即使无权访问 Looker 中的基础内容也是如此。
- 将内容添加到 Looker 收藏夹文件夹中 - 点击添加到收藏夹。将内容添加到收藏夹文件夹后,Slack 中的 Looker 应用会在 Slack 中显示一条消息,其中包含一个用于访问 Looker 中的收藏夹文件夹的链接。
如果您有多个 Looker 实例连接到工作区,则必须设置默认实例,以匹配您要共享链接的 Looker 实例。
在 Slack 中使用斜杠命令检索 Looker 信息
如果您还启用了 Lookerbot,则可能需要重命名一些斜杠命令。自定义 Slack 命令不适用于 Slack 集成,但您可以在 Lookerbot 中配置自定义命令。按照 Lookerbot GitHub 代码库中的更新(如使用 Lookerbot for Slack 最佳做法部分中的说明),确保您使用的是 Lookerbot 0.0.16 版或更高版本。
使用以下斜杠命令从 Looker 检索信息并将其发布到 Slack:
/looker
和/looker whoami
- Slack 中的 Looker 应用会按名称问候您;会告知您关联的 Looker 实例;并提供指向 Looker 收藏夹文件夹、您的个人文件夹和帮助的链接。/looker help
- Slack 中的 Looker 应用列出了支持的斜杠命令。/looker favorites
- Slack 中的 Looker 应用列出了 Looker Favorites 文件夹中的内容。点击每项内容旁边的省略号 (...
) 即可访问可从发布到此频道或从收藏夹中移除的菜单。/looker folder
- Slack 中的 Looker 应用列出了 Looker 个人文件夹中的内容。点击每项内容旁边的省略号 (...
) 即可访问能够发布到此频道或从收藏夹中移除的菜单(如果相应内容也位于收藏夹文件夹中)。/looker select
- Slack 中的 Looker 应用列出了连接到该 Slack 工作区的一个或多个实例。如需为 Slack 工作区设置默认实例,请从此列表中点击该实例。所有针对特定实例的斜杠命令都将应用于默认的 Looker 实例。
在 Slack 中查看 Looker 应用的“首页”标签页
如需查看 Slack 中您喜爱的 Looker 内容和文件夹的列表,请点击 Looker 应用中的首页标签页。
如果您为 Slack 工作区设置默认 Looker 实例,则只会看到您的 Looker 应用首页标签页中来自该实例的内容。
为 Slack 工作区设置默认 Looker 实例
如果您的 Looker 管理员只将一个 Looker 实例连接到了 Slack 工作区,则该实例是您的默认实例。
如果您的 Looker 管理员已将多个 Looker 实例连接到您的 Slack 工作区,那么您可以将其中一个实例设置为默认 Looker 实例。任何针对特定实例的斜杠命令(/looker help
之外的大多数命令)和链接展开都适用于默认实例。
在 Slack 中,运行斜杠命令
/looker select
以查看与您的 Slack 工作区关联的 Looker 实例列表。Looker 应用会询问您希望将哪个实例设为默认实例?点击与 Looker 实例名称对应的按钮,将此实例设为默认实例。
Looker 应用会确认您的选择。
如需切换默认 Looker 实例,请再次运行 /looker select
并选择其他 Looker 实例。如果您要从不是默认实例的 Looker 实例展开链接,则必须切换默认实例。如果您不切换实例并尝试从非默认 Looker 实例取消链接,系统会提示您登录该 Looker 实例。