您可以将 Looker 应用安装到 Slack 工作区中,以便直接向公开和专用 Slack 频道发送或安排数据传送。如需允许安装 Looker 应用,您的 Slack 工作区所有者可能需要调整 Slack 工作区的应用安装设置。
客户托管的实例不支持 Slack 集成。
Slack 集成适用于满足以下条件的由 Looker 托管的部署:
- Looker 实例使用的是 6.24 或更高版本。
- IP 许可名单功能在 Looker 实例上未启用。
Slack Attachment(API 令牌)集成仍然可用。
在 Looker 操作中心中启用集成
如果您的 Looker 实例满足必要条件,则您的 Looker 管理员必须在 Looker 操作中心为每个 Looker 实例启用 Slack 集成功能,然后用户才能使用 Slack 集成服务提供数据。
- 在平台下的管理面板中,转到操作页面。
- 点击 Enable 按钮以在 Looker 操作中心启用 Slack 集成。
在 Slack 操作页面上,点击连接以连接到您的 Slack 工作区。
Looker 将请求访问 Slack 工作区(显示在页面右上角的下拉菜单中)。要将多个 Slack 工作区连接到单个 Looker 实例,请点击 + 连接到 Slack 工作区链接。
点击 Allow(允许),然后返回 Slack 操作页面。
点击启用开关,然后点击保存。
管理与 Looker 的 Slack 工作区连接
您可以通过 Slack 操作页面管理实例的 Slack 工作区连接。在管理面板的操作页面上,点击 Slack 集成旁边的设置按钮。
管理员可以对每个 Slack 工作区连接执行以下操作:连接、断开连接和重置。
如需将其他 Slack 工作区连接到 Looker 实例,请点击 + 连接到 Slack 工作区链接。
如需断开与现有 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 工作区。点击允许。
- 现在,当您返回到帐号页面时,系统会显示一个选项,提示您撤消与您关联的所有工作区的 Slack 凭据。
请注意不要撤消 Slack 令牌 - 如果您撤消了,那么您创建的所有时间表都将失败。
现在您已通过身份验证,可以发送或安排信息中心、外观和探索了。如需了解详情,请参阅本页面上的向 Slack 传送数据部分。
通过“发送”或“安排时间”窗口向 Slack 工作区进行身份验证
- 在 Looker 中,转到要传送的内容,点击齿轮菜单,然后点击发送或计划发布。
- 在 Send 或 Schedule 窗口中,选择 Slack 操作作为递送目的地(位于 This data should go to?
- 点击 Slack 旁边的登录。
- Looker 将请求访问 Slack 工作区。如果您的 Looker 管理员已将多个 Slack 工作区连接到 Looker 实例,则 OAuth 页面右上角会显示一个下拉菜单。从下拉列表中选择适当的 Slack 工作区。点击允许。
- 发送或计划发布窗口现在会显示您的 Slack 递送选项,包括 Slack 工作区的公开和不公开频道。
向 Slack 传送数据
如需向 Slack 集成传送数据,Looker 管理员必须先向用户授予
send_to_integration
权限,并在 Looker Action Hub 中启用 Slack 集成。用户还必须在管理员连接到 Looker 的相同 Slack 工作区或工作区中进行身份验证。
您可以将内容传送到多个 Slack 工作区之一。Looker 管理员设置工作区连接后,您可以从用户帐号页面登录各个工作区。然后,您可以从发送或计划弹出式窗口的工作区下拉列表中列出的目标工作区。
以下示例展示了用于传送信息中心的格式选项,其中包括:
- 可视化图表 (PNG)
- CSV ZIP 文件
发送或安排 Look 或 Discover 时具有不同的格式设置选项,包括:
- CSV
- XLSX
- JSON - 简单:在此格式中,Looker 使用维度或测量值的字段名称(而非字段的标签)作为其渲染值。
- JSON - 标签:在此格式中,Looker 使用字段标签作为其 JSON 输出中的渲染值。
- JSON - 简单、内嵌:在此格式中,Looker 使用维度或测量值的字段名称(而非字段的标签)作为其渲染值。
- JSON - 详细、内嵌:在此格式中,Looker 使用维度或测量值的字段名称(而非字段的标签)作为其渲染值。
- 文字
- HTML
如需以 PDF 或 PNG 格式发送“探索”,请将“保存到信息中心”设置为所需格式。如需安排“探索”,您必须先将其保存为“外观”。
如需以 PDF 或 PNG 格式发送或安排查看,请将“查看”保存到信息中心,然后以所需的格式安排定期查看信息中心。
如需提供用户定义的信息中心、LookML 信息中心、Look 或 Discover,请转到您的内容并执行以下步骤:
- 点击齿轮菜单,然后点击发送或计划发布。(您将无法安排探索。)
- 在发送或时间安排窗口中,在此数据应位于何处?下,选择 Slack 集成作为递送目的地。如果这是您首次使用 Slack 集成,您需要先在 Slack 工作区中进行身份验证。
- Looker 会显示专用于此 Looker 实例的 Slack 工作区或工作区的分发选项。
- 在共享方式字段中,输入要将数据发布到的 Slack 频道的名称。您可以向公开或不公开渠道发送私信或发送消息。请添加前导的 # 字符,例如 #Sales。
- 在注释字段中,输入要包含在传送中的任何文本。
- 要提及用户,请添加
<@user_ID>
,您可以通过点击其 Slack 用户个人资料中的 ... 按钮进行复制。 - 若要提及某个群组,请在访问群组个人资料时添加
<@group_ID>
(可从浏览器网址复制)。 - 若要提及特定的频道,请添加
<#channel_ID>
,当您进入该频道时,即可从浏览器网址复制此频道。 - 对于其他特殊提及,请使用
<!here>
、<!channel>
或<!everyone>
。
- 要提及用户,请添加
- 在文件名字段中,输入附件文件的名称。
- 如果您要安排数据传输,请点击全部保存。您的查询或信息中心将按计划递送到 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 中配置自定义命令。按照使用 Slack 的 Lookerbot 帮助中心文章的更新 Lookerbot 应用中的说明,从 Lookerbot GitHub 代码库进行更新,以确保您使用的是 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 实例。