安排和发送信息中心

本页面介绍如何安排和发送信息中心。如需了解如何安排 Look 或探索,请访问使用 Looker Scheduler 传送内容文档页面。

借助 Looker,您可以使用安排传送信息中心菜单选项,安排立即或定期传送信息中心。

根据 Looker 管理员为您设置的数据传送权限,您或许能够将内容传送到一个或多个 Looker 内置传送目标位置:

您还可以安排将数据传送到与 Looker 集成的第三方服务,例如 Slack。

如果缓存中有有效结果,Looker 将提供缓存的结果。如果没有结果或缓存的结果已过期,Looker 将重新运行查询并缓存这些结果。

从信息中心开始交付

确保信息中心未处于修改模式。选择信息中心右上角的信息中心操作三点状菜单,然后选择安排传送。如果您没有看到安排传送选项,请咨询您的 Looker 管理员,了解您拥有的权限。

选择安排传送后,系统会显示现有时间表窗口或安排传送或发送窗口,具体取决于您是否已在信息中心内创建现有时间表。

从文件夹开始传送

您还可以从信息中心所在的文件夹开始信息中心传送。

从该信息中心所在行右侧的三点状菜单(在列表视图中)或缩略图右上角的三点状菜单(在网格视图中)中选择安排发送。

“现有时间表”窗口

如果您已为此信息中心创建了时间表,则系统会显示一个现有时间表窗口。此窗口会显示您设置的时间表以及每个时间表的相关信息,例如目标位置和格式。使用立即发送重复周期的递送和由其他人创建的时间表不会显示在此窗口中。

现有预约时限,其中显示了名为“订单分析”的预定信息中心传送。

您可以在现有时间表窗口中执行以下功能:

  • 选择立即发送,即可立即发送现有的预定内容,而不会中断预定的发送节奏。

  • 选择三点状菜单,即可修改、复制或删除时间表。

  • 选择完成以退出窗口。

  • 选择新建以打开安排传送或发送窗口,然后创建新的传送时间安排或立即发送新的传送内容。

“安排发送时间”窗口

如果您从现有时间表窗口中选择新建,或者如果您没有任何预先存在的仪表板时间表,则会打开时间表传送或发送窗口。在此窗口中,您可以自定义重复周期、目标位置、格式、过滤条件等:

“安排传送”窗口会显示用于自定义信息中心传送的名称、周期、目标位置和格式的选项。

通过安排投放或发送窗口中的设置标签页,您可以自定义投放的重复周期、目标位置、格式等。

命名递送

安排传送或发送窗口的顶部会显示自动为传送指定的名称。名称默认为信息中心的名称。如需修改投放名称,请选择该名称(由虚线下划线指示),然后进行修改。

根据您交付的目的地,标题也可能会出现在其他位置:

  • 对于通过电子邮件发送的内容,如果您选择使用电子邮件附件的格式,则标题会用作电子邮件的主题行,并作为文件名的一部分。
  • 对于网络钩子,标题会包含在网络钩子载荷的标题字段中。
  • 对于传送到 Amazon S3 存储桶的内容,标题会用在传送的文件名和发送的所有错误电子邮件中。交付文件的文件名采用 TITLE_TIMESTAMP_HASH 格式,其中 HASH 是一个随机的六字符标识符,TIMESTAMP 采用 YYYY-MM-DDTHHMM 格式(例如,2019 年 5 月 31 日上午 9:33 的时间戳部分将显示为 2019-05-31T0933)。时间戳的时区将与交付时区一致。
  • 对于 SFTP 传送,标题会包含在传送的文件名中。交付文件的文件名采用 TITLE_TIMESTAMP_HASH 格式,其中 HASH 是一个随机的六字符标识符,TIMESTAMP 采用 YYYY-MM-DDTHHMM 格式(例如,2019 年 5 月 31 日上午 9:33 的时间戳部分将显示为 2019-05-31T0933)。时间戳的时区将与交付时区一致。
  • 对于向生成文件附件的集成服务进行的传送,标题会包含在传送的文件名中。

重复周期

在重复部分中自定义发送时间。

立即发送

如果您从重复下拉菜单中选择立即发送,则在您填写必填字段并选择窗口底部的立即发送按钮后,系统会发送一次信息中心。

基于时间和日期的日程安排

从重复下拉菜单中选择以下选项之一:

  • 按月
  • 每周一次
  • 每天
  • 按小时
  • 分钟
  • 特定月份
  • 特定日期

时间选项会因您选择的选项而异。例如,每小时设置包括开始时间和结束时间。Looker 将从开始时间到结束时间每小时发送一次。

时间、开始和结束字段使用 24 小时制。如果下拉菜单中没有您想要的时间,请选择该字段并手动输入时间,例如 9:15 或 15:37。

每小时和分钟时间表会在您设置的开始和结束时段内每天重复。每小时和分钟间隔的结束时间不包含在内。最后一次发送是在指定结束时间之前的最后一个所选时间间隔。例如,如果信息中心计划在凌晨 12:00 到晚上 11:00 之间每小时发送一次,则会在凌晨 12:00 到晚上 10:00 之间每小时整点发送一次。如果重复周期是凌晨 12:00 到晚上 11:00 之间每 30 分钟发送一次,则最后一次发送时间是晚上 10:30。

由数据组更新触发的时间表

如果您的 LookML 开发者已配置数据组,您可以安排在数据组触发、管理缓存并重新构建相关 PDT 后交付信息中心。

从重复下拉菜单中选择数据组更新。此时会显示一个数据组字段,其中包含一个下拉菜单。选择其更新应触发传送的数据组。

如需使用数据组更新触发器来安排信息中心,信息中心必须至少包含一个基于模型文件的图块,该模型文件包含 datagroup 参数。数据组下拉菜单会列出在信息中心包含的模型中定义的所有数据组,即使这些数据组不用于处理查询或 PDT 的缓存也是如此。即使数据组仅在一个图块的模型中使用,在所选数据组更新完成后,系统也会发送整个信息中心。

基于数据组的计划仅在所有使用该数据组参数持久化的 PDT 完成重新生成流程后才会发送,以确保您交付的内容包含最新数据。

目的地

目标位置设置可能会显示多个信息中心传送目标位置选项。选择数据目标位置后,系统会显示一个新的设置字段,供您添加有关该目标位置的具体详细信息,例如电子邮件地址或网络钩子网址。如需了解每个目标位置的设置,请参阅以下部分。

电子邮件

在目标字段中选择电子邮件后,系统会显示一个新的电子邮件地址字段。此字段是必填字段。

在电子邮件地址字段中输入收件人的电子邮件地址。如果您要输入多个邮箱,请在输入每个邮箱后按 Enter 键或添加英文逗号。您可以添加的收件人数量没有限制。

根据 Looker 实例的设置和分配给您的权限,您或许可以向未与 Looker 实例上的任何用户账号关联的邮箱发送邮件。这些电子邮件会被归类为外部邮件。该字段右侧的全部和外部指示器会显示所有电子邮件收件人的数量以及仅外部电子邮件收件人的数量。选择每个指示器,即可在显示所有电子邮件收件人和仅显示外部电子邮件收件人之间切换。为了让您能够向外部用户交付内容,您的 Looker 管理员必须已向您授予向外部用户交付内容的权限,或已将这些收件人的电子邮件网域添加到计划内容的电子邮件网域许可清单中。

如果收件人是其他 Looker 用户,则该用户会在电子邮件中看到返回信息中心的选项,除非您的 Looker 管理员已将 Looker 实例的电子邮件数据政策设置为仅发送数据,或者取消选中包含链接选项。

通过电子邮件发送的交付内容不得超过 20 MB(对于在邮件正文中交付的格式)和 15 MB(对于作为附件交付的格式)。

如需详细了解电子邮件递送,请参阅本页面上的高级选项部分。

网络钩子

Webhook 是一种触发基于互联网的服务之间交换的方式。借助 Zapier 等网络服务,网络钩子可让 Looker 数据传送到各种应用;例如,您可以安排定期将信息中心传送到网络钩子。

如需设置 webhook,请前往您的 Web 服务并执行以下操作:

  • 获取 Looker 应向其发送 HTTPS 请求的网址。
  • 为 Looker 数据传送指定目标应用。目标应用可能需要进行额外配置才能接收来自 Looker 的数据。

具体流程取决于您使用哪种网络服务和目标应用来传送数据。如需了解如何设置其他应用以接收来自 Looker 的网络钩子数据,请参阅使用网络钩子安排 Look 和信息中心社区帖子。

在目标字段中选择网络钩子后,系统会显示一个新的网络钩子网址字段。此字段是必填字段。

在网络钩子网址字段中,输入 Looker 应向其发送 HTTPS 请求以进行此次传送的网址。您可以从用于处理 webhook 的 Web 服务中获取此网址。

Amazon S3

Amazon S3 存储桶是存储大量数据的常用方式。您或贵公司需要先通过 Amazon 创建 S3 存储桶,然后 Looker 才能使用该存储桶。

在目标位置字段中选择 Amazon S3 后,系统会显示几个新字段,并提示您输入有关 Amazon S3 存储桶的信息:

  • 存储桶:Amazon S3 存储桶的名称。此字段是必填字段。
  • 可选路径:您要将数据保存到的文件夹(如有)。
  • 访问密钥:您的 S3 存储桶的访问密钥 ID,由 Amazon 提供。此字段是必填字段。
  • 密钥:Amazon 提供的 S3 存储桶的私有访问密钥。此字段是必填字段。
  • 区域:托管 S3 存储桶的 Amazon 服务区域。

如需详细了解如何使用 Amazon S3 存储桶传送数据,请参阅将(无限制)结果安排到 S3 社区帖子。

SFTP

在此数据应发送到何处?部分中选择 SFTP,将内容传送到 SFTP 服务器。如果数据或可视化图表太大,无法使用电子邮件发送,则将结果发送到 SFTP 服务器是一种很好的方法。如果您选择此传送选项,Looker 会提示您输入 SFTP 服务器地址、用户名和密码,如下所述。

关于 SFTP 传送,请注意以下事项:

  • 如需接收来自 Looker 的 SFTP 传送内容,请确保您的网络管理员已将 Looker 的 IP 地址添加到 SFTP 服务器的 IP 许可清单或入站流量规则中。
  • 向 SFTP 服务器传送数据时,传送的文件名中仅支持字母数字、下划线 (_) 和连字符 (-) 字符。Looker 会从您在为时间表命名字段中输入的内容中移除 A-Z、a-z、0-9、_ 或 - 以外的所有字符。

当您选择 SFTP 时,Looker 会提示您输入服务器的网址和登录信息:

  • 地址:您要将数据发送到的 SFTP 服务器的网址或 IP 地址。例如:

    • sftp://files.looker.com/Marketing/In/
    • sftp://192.168.0.10/Marketing/In/

    此示例网址以 / 字符结尾。这表示文件将保存在名为 In 的文件夹中。如果您省略末尾的 /,文件将保存在 Marketing 文件夹中,并且“In”将附加到文件名的开头。您必须对要在其中创建文件的文件夹拥有写入权限。

  • 用户名和密码:SFTP 服务器的登录凭证

  • 首选密钥交换算法:此字段为可选字段。如需进行配置,请选择用于建立连接的首选 SSH 密钥交换算法。受支持的选项有:

    • ecdh-sha2-nistp521
    • ecdh-sha2-nistp384
    • ecdh-sha2-nistp256
    • diffie-hellman-group-exchange-sha256
    • diffie-hellman-group14-sha256
    • diffie-hellman-group14-sha1

    如果连接未在 5 分钟内建立,请选择其他算法。某些算法需要很长时间才能生成 SSH 密钥。此选项可让您使用可能耗时更少的算法。选择其中一种算法后,该算法将成为建立 SSH 连接的首选算法。如果服务器不支持该算法,则在后续尝试中使用所有其他算法。如果此字段设置为默认,则会使用连接库中算法的原始顺序。

SFTP 支持仅限于用户名和密码凭据。不支持 SSH 私钥凭据。

Looker SFTP 传送支持的主机密钥算法如下:

  • ssh-ed25519-cert-v01@openssh.com
  • ssh-ed25519
  • ecdsa-sha2-nistp521-cert-v01@openssh.com
  • ecdsa-sha2-nistp384-cert-v01@openssh.com
  • ecdsa-sha2-nistp256-cert-v01@openssh.com
  • ecdsa-sha2-nistp521
  • ecdsa-sha2-nistp384
  • ecdsa-sha2-nistp256
  • ssh-rsa-cert-v01@openssh.com
  • ssh-rsa-cert-v00@openssh.com
  • ssh-rsa
  • rsa-sha2-256
  • rsa-sha2-512

Looker SFTP 传送支持的加密算法(加密方式)如下:

  • aes256-ctr
  • aes192-ctr
  • aes128-ctr
  • aes256-gcm@openssh.com
  • aes128-gcm@openssh.com

Looker SFTP 递送支持的消息认证码算法如下:

  • hmac-sha2-512-etm@openssh.com
  • hmac-sha2-256-etm@openssh.com
  • hmac-sha2-512
  • hmac-sha2-256
  • hmac-sha1

Looker 会将文件上传到 SFTP 服务器上的指定目录,并使用以下命名惯例:

<name>_<timestamp>_<token>.<file extension>
  • <name> 是您在为时间表命名字段中提供的名称,Looker 会移除 A-Z、a-z、0-9、_ 或 - 以外的所有字符
  • <timestamp> 是发送时间表的时间戳,格式为 %Y-%m-%dT%H%M
  • <token> 是一个由 6 个字符组成的随机字符串
  • <file extension> 是文件扩展名

例如:Test_Schedule_2019-04-11T1130_HWkvys.csv

集成服务目标位置

您可以安排或发送信息中心内容到与 Looker 集成的服务,例如 Slack、Dropbox、Google 云端硬盘等。集成必须由 Looker 管理员启用。Looker 管理员必须明确授予用户和嵌入用户权限,才能向第三方集成发送数据和安排数据发送。

在计划工具的目标位置字段中选择集成服务后,系统可能会显示几个新字段,并提示您提供更多信息。

下表列出了您可以向其传送信息中心内容的 Looker Action Hub 服务。

以下是该列表的使用方法:

  • 自述文件链接列中显示的网址提供了有关如何启用和配置集成服务以使其与 Looker 搭配使用的说明。
  • 如何使用此集成列中显示的网址提供了有关如何将数据从 Looker 发送到集成服务的说明。其中一些文章还包含启用说明。
  • 必需的 LookML 标记列出了必须与内容底层模型中的 tags 参数一起使用的所有必需标记。
  • 操作类型表示集成服务发送的数据级别:字段、查询或信息中心。字段级操作会发送数据表中单个指定单元格的值。查询级操作会发送整个查询的结果,例如“探索”或 Look 中的所有行。信息中心级操作会发送信息中心的图片。
  • 使用 Google OAuth 身份验证表示集成服务是否使用 Google OAuth 凭据进行身份验证。
  • 使用数据流表示集成服务是否支持流式查询结果。信息中心无法流式传输数据。
集成服务 说明 README 文件链接 如何使用此集成 必需的 LookML 标记 是否使用 Google OAuth 身份验证(是/否) 使用数据流(是/否)
Azure Storage 在 Azure Storage 上发送和存储数据文件。 在 GitHub 上查看自述文件 查看社区文章 无 否 否
DigitalOcean Spaces 将数据文件发送到 DigitalOcean Storage 并存储在其中。 在 GitHub 上查看 README 查看社区文章 无 否 否
Dropbox 在 Dropbox 上发送和存储数据文件。 没有可用的自述文件 查看文档 无 是 否
Google Cloud Storage 将数据文件写入 Google Cloud Storage 存储桶。 在 GitHub 上查看 README 查看社区文章 无 否 否
Google 云端硬盘 将数据发送到 Google 云端硬盘。 没有可用的自述文件 查看文档 无 是 否
SendGrid 使用 SendGrid 的 API 发送数据并安排将结果发送到电子邮件地址。 在 GitHub 上查看自述文件 查看社区文章 无 否 否
Slack 使用 OAuth 在 Slack 中通过私信、公共频道和私密频道发送 Looker 内容。它适用于 Looker 托管的 6.24 及更高版本部署,且 IP 许可清单功能处于停用状态。 没有可用的自述文件 查看文档 无 是 否
Slack 附件(API 令牌) 将数据以及用户凭证直接发送到 Slack 频道。您可能还需要参考 Lookerbot 文档,了解其他 Slack 功能。 在 GitHub 上查看 README 查看文档 无 否 否
Teams - 传入 Webhook 使用传入网络钩子将数据发送到 Microsoft Teams。 在 GitHub 上查看 README 查看自述文件 无 否 否

格式

格式字段包含一个下拉菜单,其中列出了可用的格式:

  • CSV ZIP 文件:信息中心内未经格式化的数据,以逗号分隔值 (CSV) 文件的形式提供,并打包在 ZIP 压缩目录中。对于电子邮件传送,ZIP 文件会作为电子邮件附件传送。
  • PDF:信息中心的图片,以单个 PDF 文件形式提供。默认布局会按照信息中心内的排列方式显示图块,但高级选项下提供了其他布局和大小选项。对于通过电子邮件传送,文件会以电子邮件附件的形式传送。

  • PNG 可视化图表:信息中心的图片,采用单个 PNG 文件格式。默认布局会按照图块在信息中心内的排列方式显示图块,但您可以在高级选项下找到其他布局选项。对于通过电子邮件发送的内容,图片会以内嵌方式显示在电子邮件正文中。

下载标签页

如果信息中心有标签页,您可以在将信息中心下载为 PDF 文件时,从下载标签页菜单中选择一个选项。您可以选择发送整个信息中心、打开的标签页或自定义选择的标签页。如果您选择自定义,则可以在选择标签页字段中指定要下载的标签页。如果选择了多个标签页(例如,如果选择了整个信息中心,或者为自定义选项指定了一个或多个标签页),所有标签页都会显示在同一页面上。每个标签页的内容都将整理在带有标签页名称的内容标题下。

高级选项

高级选项标签页提供了更多投放自定义选项。可用选项取决于所选的目标位置和传送格式。

自定义消息

此选项仅适用于电子邮件目标位置。

输入您希望包含在发送给收件人的邮件正文中的消息。Looker 将自定义消息中的字符数限制为 1,500。

以收件人身份运行时间表

此选项仅适用于电子邮件目标位置。

借助以收件人身份运行时间表选项,用户可以指定一个收件人列表,其中每位收件人都会收到内容传送,就像每位收件人都根据各自的权限运行了查询一样。这意味着,每位用户的访问权限过滤条件和用户属性都将应用于每封电子邮件中包含的数据。

如果用户是 Looker 管理员,则可以使用以收件人身份运行时间表选项指定一个用户列表,其中每个用户都会收到内容交付,就像每个人都根据自己的权限运行了查询一样。非管理员用户也可以输入自己的邮箱,以便根据自己的权限接收内容,就像他们查询了内容一样。这意味着,每位用户的访问权限过滤条件和用户属性都将应用于每封电子邮件中包含的数据。

在以下示例中,Looker 管理员需要安排数据传送,以列出每个州的用户数。

用户 A 的访问权限过滤条件设置为 users.state = 'California'。如果选择以收件人身份运行时间表,则预定查询将应用访问权限过滤条件 users.state = 'California',并将过滤后的结果发送给用户 A。过滤后的结果将仅包含与加利福尼亚州相关的数据。

在高级选项标签页中,选中以收件人身份运行时间表复选框,然后在设置标签页下的电子邮件地址文本字段中添加收件人的电子邮件地址。此选项会考虑创建时间表的用户权限,以及添加到电子邮件地址字段中的电子邮件地址类型。在某些情况下,以收件人身份运行时间表选项不可用:

  • 当用户添加已停用用户的邮箱时
  • 当用户添加不属于 Looker 用户的邮箱时,邮箱列表旁边的外部计数会显示相应数量。

    一个示例时间表,其中显示了非 Looker 用户的收件人的电子邮件地址的外部计数。

在这些情况下,无论您是在输入外部邮箱之前还是之后选择选项,以收件人身份运行时间表选项都将保持启用状态,但您必须取消选择以收件人身份运行时间表或从收件人列表中移除外部邮箱,才能保存时间表。

在特殊情况下,如果用户被列为已启用以收件人身份运行时间表的时间表的收件人,然后该用户的账号被停用,则从下次运行开始,时间表将无法向已停用的用户发送内容。如果该用户的账号被删除,则整个时间表将无法向任何收件人发送。Looker 管理员或拥有 see_schedules 权限的用户将能够在管理面板的调度器历史记录页面中诊断此失败。

此选项仅适用于电子邮件目标位置。

如果 Looker 管理员已将 Looker 实例的电子邮件数据政策设置为发送链接和数据,则安排传送或发送窗口会显示包含链接选项。选择此选项可在数据传送电子邮件中添加查看完整信息中心链接,该链接会转到 Looker 中的信息中心。信息中心链接不包含任何 hide_filter 参数。

收件人必须登录 Looker,并拥有对所交付信息中心所基于模型的访问权限,才能在 Looker 中查看相应内容。如果您想要从数据传送电子邮件中移除此链接,请取消选中包含链接复选框。

此选项仅适用于电子邮件目标位置,且仅适用于嵌入式信息中心。选择包含链接选项后,系统会显示此选项。

通过添加自定义链接选项,您可以配置一个自定义网址,让查看完整信息中心链接指向该网址,而不是指向 Looker 中的信息中心。您还可以视需要更改查看完整信息中心链接文本。

如需使用此选项,Looker 管理员或拥有 schedule_look_emails 或 create_alerts 权限的用户必须先在管理员菜单的嵌入页面中为自定义链接指定允许的网域,并选择自定义链接网址的格式。

网域

从许可清单中配置的网域列表中选择网址网域。例如 app.customer.com。

路径

仅当在管理菜单中嵌入页面的选择内容路径字段中选择用户定义的网址时,系统才会显示路径选项。

请在此处输入链接网址的自定义路径。例如,如果您希望自定义链接指向网址 app.customer.com/my_embed_app,请在此处输入路径 /my_embed_app。

网址标签

使用此字段输入新的链接文本,该文本将替换电子邮件递送中的文本查看完整信息中心。默认情况下,此字段会显示在管理菜单的嵌入页面中的网址标签字段中输入的任何文本,并且可以在此字段中进行更改。

结果

此字段仅适用于 CSV ZIP 文件格式的数字面板传送。其中包含两个选项:应用可视化选项或以数据表中的显示形式。您可以二者选其一。

选择应用可视化选项选项,将信息中心板块中的部分可视化设置应用于信息中心发送。这会导致传送的文件看起来类似于表格图表。在绘图、系列和格式菜单中,为可视化图表配置的以下任何设置都将应用于数据传送:

选择按数据表中的格式显示选项,即可按照每个信息中心图块的从此处探索窗口的数据表中显示的数据格式来传送数据。

值

此字段仅适用于 CSV ZIP 文件格式的数字面板传送。它包含两个选项:Formatted(已设置格式)或 Unformatted(未设置格式)。您可以选择其中一种。

  • 如果您希望数据的显示方式与 Looker 中的探索体验类似,请选择已设置格式,但请注意,并非所有文件类型都支持某些功能(例如关联)。
  • 如果您不想对查询结果应用任何特殊格式(例如对长串数字取整或添加 Looker 开发者可能设置的特殊字符),请选择未设置格式。将数据输送到另一个工具进行处理时,通常建议采用此做法。

展开表以显示所有行

此选项仅适用于 PDF 格式的信息中心传送。

选中展开表以显示所有行复选框,即可显示信息中心内任何表格可视化图表的所有行,而不仅仅是信息中心图块缩略图中显示的那些行。

从 Looker 26.4 开始,如果您的管理员提高了行数上限设置,则 PDF 格式信息中心内每个表格图表的查询结果最多可显示 50,000 行,每个信息中心最多可显示 200,000 个单元格。如果信息中心内表格图表的单元格总数超过 20 万个,表格图表结果可能会被截断。如果达到此上限,用户会看到一条警告,该警告也会显示在呈现的 PDF 底部。

如果选择展开表以显示所有行选项,则包含表格可视化图表的的信息中心图块在交付的 PDF 文件中可能与在 Looker 中略有不同。您可能会在 PDF 中注意到以下差异:

  • 系统会从列标题和部分总计行中移除对背景颜色和字体大小的自定义设置。
  • 表格以白色主题显示。
  • 排序图标不会显示在未手动排序的数据透视表上。
  • 启用了将列调整为合适大小的表格会拉伸至图块的完整宽度。
  • 启用了行分组的表格会显示为平面数据,并且分组列会展开以显示所有列。

此外,对于单元格数量超过 20,000 个的表格,PDF 中可能会出现以下明显差异:

如果您在格式字段中选择 PDF 后没有看到展开表格以显示所有行选项,请咨询您的 Looker 管理员,了解如何为 Looker 实例安装适当版本的 Chromium 渲染程序。

将信息中心板块排列在一列中

此选项仅适用于信息中心传送的 PDF 和 PNG 可视化图表格式。选择 Slack 作为传送目的地时,仅支持 PDF。

选中将信息中心板块排列在一列中复选框,以单列布局设置 PDF 或 PNG 可视化图表的格式。此布局会将信息中心板块显示在单个垂直列中。不选中该复选框,则会按照信息中心内的排列方式显示图块。

纸张大小

此选项仅适用于 PDF 格式的信息中心传送。

您可以从纸张大小下拉菜单中进行选择,指定信息中心 PDF 文件的最佳尺寸和方向。大型可视化图表或重叠的仪表板图块组可能需要调整大小,以便在 PDF 页面上清晰显示。如果您没有看到纸张大小选项,请咨询您的 Looker 管理员,了解如何为 Looker 实例安装最新版本的 Chromium 渲染程序。

表分辨率

此选项仅适用于 PNG 可视化图表格式,并且仅在选中将信息中心图块排列在单列中复选框时可用。

您可以使用表格分辨率下拉菜单自定义可视化图表的宽度。宽度选项包括:

  • 正常:800 像素
  • 宽:1680 像素

对于通过电子邮件发送的内容,如果您选择宽,并且可视化图表宽度超出了电子邮件客户端设置的限制,则电子邮件收件人可能需要水平滚动才能看到整个可视化图表。

投放时区

默认情况下,Looker 会使用与您的账号关联的时区来确定何时发送数据。如果您的账号没有关联的时区,Looker 会使用您的应用时区设置。

如果您想指定其他时区,请从下拉菜单中选择时区。您选择的时区不会影响 Look 或信息中心内的数据,只会影响传送时间。

过滤条件

“安排递送”或“发送”窗口中的“过滤条件”标签页会显示应用于信息中心的所有过滤条件及其值。在此标签页中,您可以修改应用于信息中心的任何现有过滤条件的值,新值将应用于传送。信息中心本身不会受到影响。

您无法在过滤条件标签页中向时间表添加过滤条件,只能查看和修改现有信息中心过滤条件的值。

例如,您可以向区域团队发送按其感兴趣的州/省/自治区/直辖市过滤的结果。

如果信息中心过滤条件需要过滤值,您必须在过滤条件标签页中输入一个值,才能创建或保存对传送设置的任何修改。

信息中心过滤条件发生更改时

有时,信息中心过滤条件会在创建时间表后发生变化。下表说明了这会如何影响应用于定期传送的过滤条件。

操作 对时间表过滤条件的影响
创建了包含过滤条件的时间表。之后,信息中心上的过滤条件值发生了更改。 对时间表过滤条件值没有影响。它仍会是过滤条件标签页中设置的值,即使该值为是任意值。
创建了包含过滤条件的时间表。之后,该过滤条件在信息中心内被重命名。 系统会从传送的数据中移除该过滤条件。
创建了包含过滤条件的时间表。之后,该过滤条件在信息中心内被删除。 系统会从传送的数据中移除该过滤条件。
系统会创建一个时间表。之后,系统会向信息中心添加新的(非必需或必需)过滤条件。 系统会使用过滤条件标签页中设置的过滤条件值,将过滤条件应用于传送的数据。如果未在过滤条件标签页中设置任何值,则该值会被解读为是任何值,这实际上会移除过滤条件。

使用用户属性过滤条件

如果您的 Looker 管理员配置了用户专属值(称为用户属性),并且您拥有信息中心的修改权限,则可以创建使用与用户属性匹配过滤条件选项的信息中心过滤条件。此类过滤器会自动为每位信息中心查看者自定义过滤值。借助这种过滤条件,您可以向每次递送的收件人提供自定义结果。如需详细了解用户属性,请访问用户属性文档页面。

测试时间表

如果您将周期性字段设置为立即发送以外的任何值,计划传送或发送窗口底部会显示立即测试按钮。

选择立即测试按钮,仅向您自己发送一次性测试交付。系统会显示一个绿色对勾标记,确认测试已发送。如果立即测试按钮不可用,您可以将重复字段设置为立即发送,以发送一次性测试递送。

立即测试选项不会考虑某些高级选项设置,但会遵循所有选定的过滤条件。

保存时间表或立即发送

如果您将周期性字段设置为立即发送,请选择窗口底部的立即发送按钮,以便一次性传送到列出的目标位置。

如果您将重复字段设置为立即发送以外的任何值,请选择保存按钮以保存您的时间表并关闭窗口。

选择取消按钮,即可退出窗口,而不保存或发送时间表。

信息中心的已保存时间表会显示在其现有时间表窗口中。您为所有内容保存的排程都会显示在用户个人资料的排程页面上。

修改时间表

您只能修改自己创建的时间表。如要修改时间表,请按以下步骤操作:

  1. 选择信息中心右上角的三点状信息中心操作菜单。
  2. 从下拉菜单中选择安排传送。
  3. 在现有预约时限窗口中,选择要修改的时间表对应的三点状菜单。
  4. 从下拉菜单中选择修改。
  5. 系统会显示该时间表的安排发送或发送窗口。在此窗口中进行修改。
  6. 修改完毕后,选择保存,或选择取消以取消修改。

复制时间表

您可能需要复制时间表,然后对其进行修改。如需复制时间表,请执行以下操作:

  1. 选择信息中心右上角的三点状信息中心操作菜单。
  2. 从下拉菜单中选择安排传送。
  3. 在现有时间表窗口中,选择要修改的时间表对应的三点状菜单。
  4. 从下拉菜单中选择复制。
  5. 系统会显示复制的时间表的安排传送或发送窗口。系统会在时间表名称后附加“副本”字样。
  6. 进行修改。
  7. 修改完毕后,选择保存;或者选择取消,以取消修改并删除重复的时间表。

复制时间表时,原始时间表保持不变。

复制的时间表中的过滤条件将设置为与原始时间表的过滤条件标签页中相同的值,但您可以修改这些值。如果自创建原始时间表以来有任何过滤条件发生变化,这些过滤条件将受到影响,如信息中心过滤条件发生变化时部分所示。如果原始时间表所基于的信息中心后来添加了必填过滤条件,您需要先为该过滤条件选择一个值,然后才能保存复制的时间表。

删除时间表

您只能删除自己创建的时间表。如需删除时间表,请执行以下操作:

  1. 选择信息中心右上角的三点状菜单。
  2. 从下拉菜单中选择安排传送。
  3. 在现有预约时限窗口中,选择要修改的时间表对应的三点状菜单。
  4. 从下拉菜单中选择删除。
  5. 系统即会打开一个新窗口。选择删除以删除时间表,或选择取消以保留时间表。

您还可以从用户个人资料的时间表页面中删除时间表。

删除具有时间表的信息中心的影响

如果您删除信息中心,则与该信息中心关联的所有时间表也会一并删除。时间安排所有者会立即看到,信息中心的名称已从时间安排或您创建的时间安排用户页面中删除。在下一次运行计划查询后,其状态将显示为已停用。

排程挑战

有时,定时发送的邮件可能无法送达一位或多位收件人。如果底层模型存在错误、收件人无权访问数据,或者存在呈现问题或页面错误,就可能会发生这种情况。

请注意内容传送的以下限制:

  • 如果贵公司在 Looker 的管理员部分中设置了自己的电子邮件设置,则 Looker 管理员需要确保设置正确无误,并且电子邮件服务提供商正常运行。外部 SMTP 服务器可能有自己的每日或每封邮件收件人上限。
  • 根据限制设置,数据传送将限制为 5,000 行,或限制为最大文件大小:带附件的电子邮件为 15 MB,带内嵌内容的电子邮件为 20 MB。如果电子邮件中的行数或数据量超出这些限制,则不会发送。
  • 虽然 Looker 没有对您可以在电子邮件递送中指定的收件人数量设置硬性限制,但如果您将递送配置为“以收件人身份运行”,则递送会为每个人触发单独的查询。这种负载可能会严重影响数据库性能,因此不建议用于大型收件人列表。我们建议您尽可能使用电子邮件群组或别名。
  • 如果邮件未在预期时间发送,但最终还是送达了,这可能是因为您的任务与其他 Looker 任务发生了冲突。这些任务可能包括其他定时发送的邮件、多人同时探索数据,或正在构建永久性派生表。如果发生这种情况,请与您的 Looker 管理员联系,了解是否存在竞争任务。
  • 如果某个特定电子邮件地址不断从您的通讯群组列表中消失,很可能是因为有用户退订了该定时发送的邮件。如果您使用群组邮箱别名向多人发送邮件,这可能会成为一个特别棘手的问题,因为任何一位收件人都可以退订该邮箱别名。如需详细了解退订,请参阅这篇关于监控调度器退订事件的 Looker 社区帖子。

如果向 SFTP 服务器提交失败,请考虑以下可能性:

  • 当 Looker 尝试向 SFTP 服务器传送内容时,即使由于网络配置问题(例如目标服务器上的 IP 许可清单不正确或 Looker 实例上的出站端口已关闭)而导致传送失败,传送也可能会在时间表面板和日志中标记为已完成。尽管存在这些错误,但时间表历史记录仍可能会显示 Success 状态,因此,如果您怀疑缺少传送,请务必检查目标 SFTP 服务器日志。

  • Looker 会存储 SFTP 服务器的 SFTP 指纹。如果您在 SFTP 提交过程中遇到错误,则可能是 SFTP 指纹无效。在这种情况下,请与您的 Looker 管理员联系。

  • 错误 Net::SSH::Exception. message: could not settle on host_key algorithm 是由于旧版 Looker(Looker 26.2 之前版本)提供的主机密钥算法与目标 SFTP 服务器(例如 Red Hat 9 或 Azure Blob Storage SFTP)严格执行的现代安全算法不兼容所致。如果您收到此错误,可以将 Looker 升级到 26.2 或更高版本,以支持现代 SHA-2 算法(例如 ecdsa-sha2-nistp256、rsa-sha2-256 和 rsa-sha2-512),从而解决此问题。或者,将目标 SFTP 服务器配置为至少允许一种当前 Looker 版本支持的主机密钥或加密算法。

  • 在 Looker 升级到 26.2.14 或更高版本后,如果通过 SFTP 传送数据,或者实例连接到 Azure Blob Storage SFTP 等主机服务或通过代理连接,则可能会出现错误 OpenSSL::Cipher::CipherError. Error: authentication tag already generated by cipher。此错误是由密码协商期间的已知 JRuby 问题引起的。如需解决此错误,请将目标 SFTP 服务器上允许的加密算法(密码)限制为 aes256-ctr。例如,修改 SFTP 服务器的 sshd_config 文件,以添加或限制 Ciphers 指令:Ciphers aes256-ctr。

  • 如果您在向 SFTP 服务器传送数据时收到错误 Java::JavaLang::NullPointerExceptions,则此错误可能是由 JRuby 中的 bug 导致的,该 bug 会阻止使用椭圆曲线 (EC) 算法或主机密钥进行从 Looker 到 SFTP 目标位置的 SSH 连接。为避免向 SFTP 目标位置发送数据时出现问题,请勿在 ~/.ssh/config 或 /etc/ssh_config 文件中使用 EC 算法,也不要在 Looker 主机上的 ~/.ssh 中存储 EC 主机密钥。

  • 如果 Looker 无法在 SFTP 服务器上正确构建目标路径,则会发生错误 Net::SFTP::StatusException (2, 'no such file')。常见原因包括:地址字段使用相对路径而非绝对路径、地址字段缺少尾部斜杠 (/),或者 Look、信息中心或时间表名称包含空格或特殊字符(例如 /),导致路径构建失败。如需解决此错误,请按以下步骤操作:

    • 使用绝对路径:登录 SFTP 服务器,运行 pwd 以检索完整的绝对路径,然后在时间表的地址字段中输入此值,并确保其以尾部斜杠 (/) 结尾。
    • 移除特殊字符:从 Look、信息中心和时间表名称中移除正斜杠 (/)。
    • 使用机器友好型名称:重命名时间表,使用下划线代替空格(例如 Report_Name)。
  • 当 Looker 和远程 SFTP 服务器无法就双方都支持的密钥交换 (KEX) 算法达成一致时,通常是因为其中一方使用了已弃用的算法,从而导致出现错误 Net::SSH::Exception. Error: could not settle on kex algorithm。如需解决此错误,请查看 SFTP 服务器支持的密钥交换算法,并确保这些算法与 Looker 支持的 KEX 算法(例如 ecdh-sha2-nistp256、ecdh-sha2-nistp384 或 ecdh-sha2-nistp521)一致。

  • 如果您的定期 SFTP 传送失败并显示错误 Net::SSH::Exception: could not settle on encryption_client algorithm,则表示您的 SFTP 服务器和 Looker 无法就共享加密算法达成一致。Looker 已移除对安全性较低的旧版密码(例如 CBC,如 aes256-cbc 和 3des-cbc)的支持。如需解决此出错提示,请将此出错提示提供给 SFTP 服务器管理员,并要求他们更新服务器的 sshd_config 文件,以启用对至少一种与 Looker 兼容的加密和密钥交换算法的支持。

管理员需注意的递送事项

Looker 管理员可以查看、修改、重新分配和删除任何用户的时间表。此外,Looker 管理员在为 Looker 实例设置数据传送以及向用户授予发送或安排数据传送的权限时,应注意一些事项。如需了解详情,请访问以下文档页面: