您可以将 Looker 应用安装到 Slack 工作区,以便直接将数据发送或安排数据传送到公开和私人 Slack 频道。如需启用 Looker 应用的安装,您的 Slack 工作区所有者可能需要为您的 Slack 工作区调整应用安装设置。
Slack 附件(API 令牌)集成也仍然可用。
在 Looker Action Hub 中启用集成
如果您的 Looker 实例满足必要条件,则您的 Looker 管理员必须先在 Looker Action Hub 中为每个 Looker 实例启用 Slack 集成,然后用户才能通过 Slack 集成提交数据。
- 在管理面板的平台下,前往操作页面。
- 点击 Looker Action Hub 中的 Enable 按钮,以启用 Slack 集成。
在 Slack 操作页面上,点击连接以连接到您的 Slack 工作区。
Looker 会请求访问页面右上角下拉菜单中显示的 Slack 工作区。如需将多个 Slack 工作区连接到单个 Looker 实例,请点击 + 连接到 Slack 工作区链接。
点击允许,然后返回 Slack 操作页面。
点击启用开关,然后点击保存。
管理 Slack 工作区与 Looker 的连接
您可以在 Slack 操作页面上管理实例的 Slack 工作区关联。在管理面板的操作页面上,点击 Slack 集成旁边的设置按钮。
管理员可以对每个 Slack 工作区连接执行以下操作:关联、断开连接和重置。
如需将其他 Slack 工作区连接到 Looker 实例,请点击 + 连接到 Slack 工作区链接。
如需断开现有 Slack 工作区连接,请点击断开连接按钮,然后点击弹出式警告消息中的确定。您无需在 Slack 操作页面上点击保存即可保存这些设置,即使未关联任何 Slack 工作区,该操作仍会显示为已启用。
如需刷新 Slack 工作区连接,而无需断开连接并重新连接,请点击重置按钮。
向您的 Slack 工作区进行身份验证
用户必须对 Looker 管理员已与 Looker 关联的 Slack 工作区进行身份验证。用户还必须是工作区的现有成员,才能通过 Looker 对其进行身份验证。
您可以通过以下方式首次对 Slack 工作区进行身份验证:
- 账号页面。(如果有多个 Slack 工作区与您的 Looker 实例相关联,则此选项是您的唯一选择。)
- 发送或安排定期发送窗口。
从 Looker 成功对 Slack 进行身份验证后,您会收到一条 Slack 确认消息。
从“账号”页面登录 Slack 工作区
- 在 Looker 中,点击屏幕右上角的用户个人资料图标,然后选择账号。
- 为您的实例启用的所有集成都显示在集成下。如果您的 Looker 管理员已启用至少一个 Slack 工作区,则会显示使用 Slack 登录按钮。如果您的 Looker 管理员已将多个 Slack 工作区关联到您的 Looker 实例,系统会显示一个工作区列表,其中包含用于分别登录每个工作区的选项。
- Looker 会请求访问 Slack 工作区。如果您的 Looker 管理员已将多个 Slack 工作区与您的 Looker 实例相关联,OAuth 页面右上角会显示一个下拉菜单。从下拉菜单中选择适当的 Slack 工作区。点击允许。
- 当您返回账号页面时,集成部分中会显示一个选项,可让您撤消与您关联的所有工作区的 Slack 凭据。 注意:请勿撤消您的 Slack 令牌,否则您创建的所有时间表都将失败。
现在,您已完成身份验证,可以发送或安排信息中心、Look 和探索。如需了解详情,请参阅本页的将数据提交到 Slack 部分。
从“发送”或“安排发送”窗口登录 Slack 工作区
- 在 Looker 中,前往要提交的内容,点击齿轮菜单,然后点击发送或安排。对于信息中心,请选择安排提交时间。
- 在探索或数据洞见的发送或安排窗口中,选择 Slack 操作作为这些数据应发送到哪里?下的传送目标。对于信息中心,请在安排和发送时间中选择安排提交时间。
- 点击 Slack 旁边的登录。
- Looker 会请求访问 Slack 工作区。如果您的 Looker 管理员已将多个 Slack 工作区与您的 Looker 实例相关联,OAuth 页面右上角会显示一个下拉菜单。从下拉菜单中选择适当的 Slack 工作区。点击允许。
- 发送或安排窗口(或信息中心的安排提交时间窗口)现在会显示您的 Slack 提交选项,包括 Slack 工作区的公开和私密频道。
将数据提交到 Slack
您可以将内容提交到多个 Slack 工作区中的任一工作区。Looker 管理员设置好 Workspace 关联后,您就可以在用户账号页面中登录每个 Workspace。然后,您可以从发送或安排弹出式窗口的工作区下拉菜单中选择目标工作区,也可以为信息中心选择安排提交时间范围。
提交信息中心的格式选项如下:
- 可视化图表 (PNG)
- CSV ZIP 文件
发送或安排发送外观或探索时,您可以使用不同的格式选项,包括:
- CSV
- XLSX
- JSON - 简单:在此格式中,Looker 会使用维度或测量的字段名称作为其呈现的值,而不是字段的标签。
- JSON - 标签:在此格式中,Looker 会在 JSON 输出中使用 labels 字段作为其呈现的值。
- JSON - 简单、内嵌:在此格式中,Looker 会使用维度或测量的字段名称作为其呈现的值,而不是字段的标签。
- JSON - 详细、内嵌:在此格式中,Looker 会使用维度或测量的字段名称作为其呈现的值,而不是字段的标签。
- 文本
- HTML
如需提交用户定义的信息中心、LookML 信息中心、Look 或探索,请前往您的内容,然后执行以下步骤:
- 点击齿轮菜单,然后点击发送或安排发布时间。(您将无法选择安排探索。)对于信息中心,请从信息中心的三点状菜单中选择安排提交时间。
- 在发送或安排窗口中,在这些数据应发送到哪里?下方选择 Slack 集成作为传送目的地对于信息中心,请在目标位置下选择 Slack 集成作为传送目标位置。如果这是您首次使用 Slack 集成,则需要先对 Slack 工作区进行身份验证。
- Looker 会显示与此 Looker 实例关联的 Slack 工作区或工作区专用的提交选项。
- 在 Share In(分享到)字段中,输入要将数据发布到的 Slack 渠道的名称。您可以向公开或私密频道发送私信或消息。请添加前置的 # 字符,例如 #Sales。
- 在备注字段中,输入您要随传送内容一起发送的任何文本。您还可以使用 Slack 的高级格式设置和特殊解析功能,提及特定群组、用户或渠道,或进行任何其他特殊提及。
- 在文件名字段中,输入附件文件的名称。
- 如果您要安排数据传送,请点击全部保存。您的查询或信息中心将按计划发送到 Slack。如果您要发送数据,请点击发送。您的数据将发送到您的 Slack 频道。
通过 Slack 访问 Looker
您可以通过以下方式在 Slack 中访问 Looker 数据:
在 Slack 中分享指向 Looker 内容的链接
您可以在 Slack 中分享指向 SQL Runner 可视化图表、用户定义的信息中心、LookML 信息中心、Look(但不包括公开嵌入的 Look)或探索的链接。
该链接会在 Slack 中展开,以显示内容的标题及其部分元数据,只有有权访问底层内容的用户才能看到这些元数据。展开链接后,您或其他用户可以:
- 发布指向 Looker 中相应内容的链接以及相应频道中相应内容的快照,然后点击发布到此频道。内容发布到渠道后,渠道中的任何人都可以查看内容快照和标题,即使他们没有权限访问 Looker 中的底层内容。
- 将内容添加到 Looker 的收藏夹 - 点击添加到收藏夹。将内容添加到收藏文件夹后,Slack 中的 Looker 应用会在 Slack 中显示一条消息,其中包含用于访问 Looker 中的收藏文件夹的链接。
如果您有多个与工作区关联的 Looker 实例,则必须设置默认实例,使其与您要分享链接的 Looker 实例保持一致。
使用 Slash 命令在 Slack 中检索 Looker 信息
如果您还启用了 Lookerbot,则可能需要重命名某些斜线命令。Slack 集成不支持自定义 Slack 命令,但您可以在 Lookerbot 中配置自定义命令。按照使用 Lookerbot for Slack 最佳实践页面中使用 Lookerbot 入门部分中的说明,从 Lookerbot GitHub 代码库更新,确保您使用的是 Lookerbot 0.0.16 或更高版本。
您可以使用以下正斜线命令从 Looker 检索信息并将其发布到 Slack:
/looker
和/looker whoami
- Slack 中的 Looker 应用会以您的名字向您致意;告知您所连接的 Looker 实例;并提供指向 Looker 收藏文件夹、您的个人文件夹和帮助的链接。/looker help
- Slack 中的 Looker 应用会列出支持的 Slash 命令。/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 实例。