提交外观和探索

本页面简要介绍了如何将 Look 和探索结果传送到 Looker 的内置传送目的地以及适用于您的 Looker 实例的任何集成服务。如需了解如何安排信息中心,请访问安排和发送信息中心文档页面。

Looker 调度器是 Looker 界面的一部分,您可以在其中配置内容传送设置。对于 Look,您可以使用 Scheduler 发送一次性或周期性交付。探索只能作为一次性交付内容发送。如需安排定期发送“探索”内容,您必须先将其保存为 Look。

从文件夹打开调度器

如需从文件夹或子文件夹中打开 Scheduler,请找到包含要发送的信息中心的文件夹或子文件夹。当您前往某个文件夹时,该文件夹中的所有 Look 和信息中心都会以列表视图或网格视图列出。

日历图标表示您已为该内容安排了至少一个周期性投放(在网格视图中,您必须将鼠标悬停在内容缩略图上才能看到日历图标,如果有的话)。

在列表视图中,您可以通过以下方式打开排期工具:

  • 点击商品的日历图标(如果有)
  • 点击某个项的三点状菜单,然后选择修改时间表(如果该项已有时间表)、添加时间表(如果该项还没有时间表)或发送(创建一次性传送)
  • 打开内容,点击右上角的齿轮菜单,然后选择时间安排(对于定期传送)或发送(对于一次性传送)

在网格视图中,您可以通过以下方式打开调度器:

  • 点击商品的日历图标(如果有)
  • 打开内容,点击右上角的齿轮菜单,然后选择时间安排(对于定期传送)或发送(对于一次性传送)

创建配送

如需在 Looker 内容中创建传送,请点击内容右上角的齿轮菜单,然后选择时间安排(针对定期传送)或发送(针对一次性传送),打开旧版时间安排工具。

对于周期性传送,旧版 Scheduler 的左侧面板会显示为内容创建的所有时间表,并突出显示您正在创建或修改的时间表的标题。左侧面板会按上次更新时间倒序列出时间表。您可以分别点击时间表右侧的复制或删除图标,来复制或删除现有时间表。

如果这是您为此内容创建的第一个时间表,主面板会显示设置为默认值的时间表选项。您可以根据需要修改这些值。如果您之前为此内容创建过一个或多个时间安排,主面板会显示列表中最上方时间安排的已保存设置。然后:

  • 如需修改现有时间表的选项,请选择该时间表,然后根据需要更改选项。完成后,点击全部保存。
  • 如需为同一内容创建其他时间表,请点击新建,然后输入该时间表的设置。

完成后,点击全部保存。

以下部分介绍了各项调度设置。

命名交付

在为您的时间表命名字段中,为时间表指定一个不重复的标题。保存时间安排后,标题会显示在左侧面板中、您创建的时间安排列表中,以及管理控制台面板的时间安排管理页面上。

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

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

    对于 SFTP 传送,传送的文件名中仅支持字母数字、下划线 (_) 和连字符 (-) 字符。Looker 会从您在为时间表命名字段中输入的内容中移除 A-Z、a-z、0-9、_ 或 - 以外的所有字符。

选择交付目的地

这些数据应发送到何处?设置可能会显示多个数据传送目标选项。每个目的地提供的配送选项各不相同。

目标平台包括:

选择数据目标位置后,系统会显示一个新的设置字段,供您添加有关该目标位置的具体详细信息,例如电子邮件地址或网络钩子网址。

电子邮件的发送选项

在这些数据应发送到何处?部分中,选择电子邮件。您的内容将发送到您指定的电子邮件地址列表。

在应通过电子邮件将其发送给谁部分,输入收件人的邮箱。输入一个邮箱,或输入多个邮箱(以英文逗号分隔),然后点击添加。您可以添加的收件人数量没有限制。

根据 Looker 实例的设置和您获授的权限,您或许能够向未与 Looker 实例上的任何用户账号关联的邮箱发送邮件。这些邮件会被归类为外部邮件。如需向外部用户交付内容,您的 Looker 管理员必须已向您授予向外部用户交付内容的权限,或已将这些收件人的电子邮件网域添加到定时交付内容的电子邮件网域许可名单中。

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

如果所有收件人都退订了定时发送的邮件,系统会从 Looker 中删除该定时发送设置,包括从用户和管理员的定时发送管理页面中删除。如果收件人代表电子邮件群组退订,则该群组的所有成员都不会收到定时发送的邮件。

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

勾选添加自定义消息,在邮件正文中添加自定义消息。Looker 将自定义消息中的字符数限制为 1,500。

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

Webhook 的传送选项

Webhook 是一种越来越常见的触发基于互联网的服务之间交换的方式。借助 Zapier 等网络服务,网络钩子可让 Looker 数据传送到各种应用;例如,您可以安排定期将 Look 或信息中心传送到网络钩子。设置传送时,Looker 会提示您输入 webhook 地址。

在这些数据应发送到何处?部分中,选择 Webhook。在 网络钩子网址部分中,输入 Looker 应向其发送 HTTP 请求以进行此次传送的网址。您可以从用于处理 webhook 的 Web 服务中获取此网址。 如需设置 webhook,请前往您的 Web 服务并执行以下操作:

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

具体过程因您用于传送信息中心数据的 Web 服务和目标应用而异。如需了解如何设置其他应用以接收来自 Looker 的网络钩子数据,请参阅这篇 Looker 社区帖子:使用网络钩子安排 Look 和信息中心 (3.46+)。

Looker 会尝试向 webhook 传送内容,最长持续 30 分钟。确保目标位置可以在 30 分钟内响应 webhook 传送尝试。

Amazon S3 存储桶的发送选项

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

如果您选择 Amazon S3 目标位置选项,Looker 会提示您进行其他设置,包括格式设置和 Amazon S3 存储桶设置,如本页所述。如需详细了解如何使用 Amazon S3 存储桶传送数据,请参阅这篇关于将(无限量)结果安排到 S3 的 Looker 社区帖子。

在这些数据应发送到何处?部分,选择 Amazon S3。系统会显示 S3 详细信息部分,并提示您输入有关 Amazon S3 存储桶的信息:

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

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

第三方集成的发送选项

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

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

以下列表显示了您可以向其传送 Look 或“探索”结果的 Looker Action Hub 服务。

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

  • 自述文件链接列中显示的网址提供了有关如何启用和配置集成服务以使其与 Looker 搭配使用的说明。
  • 如何使用此集成列中显示的网址提供了有关如何将数据从 Looker 发送到集成服务的说明。其中一些文章还包含启用说明。
  • 必需的 LookML 标记列出了必须与内容底层模型中的 tags 参数一起使用的所有必需标记。
  • 操作类型表示集成服务发送的数据级别:字段、查询或信息中心。字段级操作会发送数据表中单个指定单元格的值。查询级操作会发送整个查询的结果,例如“探索”或 Look 中的所有行。信息中心级操作会发送信息中心的图片。
  • 使用 Google OAuth 身份验证表示集成服务是否使用 Google OAuth 凭据进行身份验证。
  • 使用数据流表示集成服务是否支持流式查询结果。
集成服务 说明 README 文件链接 如何使用此集成 必需的 LookML 标记 操作类型 是否使用 Google OAuth 身份验证(是/否) 使用数据流(是/否)
Airtable 在 Airtable 中向表格添加记录。 在 GitHub 上查看 README 查看社区文章 无 查询 否 否
Amazon SageMaker Infer 使用 Amazon SageMaker 执行推理。 没有可用的自述文件 没有可用的文章 无 查询 否 是
Amazon SageMaker 训练:线性学习器 使用线性学习器算法在 Amazon SageMaker 上启动训练作业。 没有可用的自述文件 没有可用的文章 无 查询 否 是
Amazon SageMaker 训练:Xgboost 使用 Xgboost 算法在 Amazon SageMaker 上启动训练作业。 没有可用的自述文件 没有可用的文章 无 查询 否 是
Amazon Web Services EC2 停止实例 使用 Amazon EC2 API 停止 EC2 实例。 在 GitHub 上查看 README 查看社区文章 aws_resource_id 字段、查询 否 否
螺旋钻 使用查询结果构建预测模型。 在 GitHub 上查看 README 查看自述文件 无 查询 否 是
Azure Storage 在 Azure Storage 上发送和存储数据文件。 在 GitHub 上查看 README 查看社区文章 无 查询 否 是
Braze 借助 Braze 操作,您可以使用 Look 中的 REST API 端点在 Braze 中标记用户。确保结果中有一个标记为 braze_id 的字段。最多可导出 10000 个。 在 GitHub 上查看 README 查看自述文件 braze_id 查询 否 是
DigitalOcean - 停止 Droplet 使用 DigitalOcean API 停止 DigitalOcean 进程。 在 GitHub 上查看 README 查看社区文章 digitalocean_droplet_id 字段、查询 否 否
DigitalOcean Spaces 将数据文件发送到 DigitalOcean Storage 并存储在其中。 在 GitHub 上查看 README 查看社区文章 无 查询 否 是
Dropbox 在 Dropbox 上发送和存储数据文件。 没有可用的自述文件 查看文档 无 查询 是 否
Facebook 自定义受众群体 将数据从客户名单上传到 Facebook Ads 自定义受众群体。 在 GitHub 上查看 README 查看自述文件 无 查询 是 有
Firebase 使用 Firebase 向移动设备发送推送通知。 没有可用的自述文件 没有可用的文章 无 查询 否 否
Google Ads 目标客户匹配 将数据上传到 Google Ads 目标客户匹配。 在 GitHub 上查看 README 查看文档 无 查询 是 是
Google Analytics 中的数据导入功能 将数据上传到 Google Analytics 数据集。 在 GitHub 上查看 README 查看自述文件 无 查询 是 是
Google Cloud Storage 将数据文件写入 Google Cloud Storage 存储桶。 在 GitHub 上查看 README 查看社区文章 无 查询 否 是
Google 云端硬盘 将数据发送到 Google 云端硬盘。 没有可用的自述文件 查看文档 无 查询 是 是
Google 表格 将 CSV 数据发送到 Google 表格。 没有可用的自述文件 查看文档 无 查询 是 是
HubSpot 公司 使用 Hubspot V3 API 向公司添加属性。 在 GitHub 上查看 README 查看自述文件 hubspot_company_id 查询 否 是
HubSpot 联系人 使用 Hubspot V3 API 向联系人添加属性。 在 GitHub 上查看 README 查看自述文件 hubspot_contact_id 查询 否 是
Kloudio 向 Google 表格添加数据。 在 GitHub 上查看 README 查看自述文件 无 查询 否 否
mParticle 将用户或事件数据从 Looker 批量导出到 mParticle。 在 GitHub 上查看 README 查看自述文件 查看自述文件 查询 否 是
Salesforce 广告系列 将联系人或潜在客户添加到 Salesforce 广告系列。 在 GitHub 上查看 README 查看自述文件 sfdc_contact_id 或 sfdc_lead_id 查询 是 否
细分群组 向 Segment 群组添加特征和/或用户。 在 GitHub 上查看 README 查看文档 segment_group_id 和 user_id,或 segment_group_id 和 segment_anonymous_id 查询 否 是
Segment Identify 使用 Identify 向 Segment 用户添加特征。 在 GitHub 上查看 README 查看文档 email、user_id、segment_anonymous_id 或 segment_group_id 查询 否 是
Segment Track 连接到 Segment 提供的多项集成,以便识别和定位用户,从而开展营销工作流。 在 GitHub 上查看 README 查看文档 email、user_id、segment_anonymous_id 或 segment_group_id 查询 否 是
SendGrid 使用 SendGrid 的 API 发送数据并安排将结果发送到电子邮件地址。 在 GitHub 上查看 README 查看社区文章 无 查询 否 否
Slack 使用 OAuth 在 Slack 中通过私信、公共频道和私密频道发送 Looker 内容。它适用于 Looker 托管的 6.24 及更高版本部署,且 IP 许可清单功能处于停用状态。 没有可用的自述文件 查看文档 无 查询 是 是
Slack 附件(API 令牌) 将数据以及用户凭证直接发送到 Slack 频道。您可能还需要参考 Lookerbot 文档,了解其他 Slack 功能。 在 GitHub 上查看 README 查看文档 无 查询 否 否
Teams - 传入 Webhook 使用传入网络钩子将数据发送到 Microsoft Teams。 在 GitHub 上查看 README 查看自述文件 无 查询 否 否
托盘 连接到 Tray.io 提供的多项集成,以实现工作流自动化。 在 GitHub 上查看 README 查看社区文章 无 查询 否 是
Twilio - 发送数据 使用 Twilio 的 API 将 Look 中的数据或定期发送的结果发送到手机号码。 在 GitHub 上查看 README 查看社区文章 无 查询 否 否
Twilio - 发送消息 向 Look 中的一系列手机号码(标记为手机号码的数据列)发送消息。 在 GitHub 上查看 README 查看自述文件 电话 字段、查询 否 否
Zapier 连接到 Zapier 提供的多项集成,以实现工作流自动化。 在 GitHub 上查看 README 查看社区文章 无 查询 否 是

选择数据格式

Look 和探索会根据传送目的地提供不同的格式选项。如需选择传送格式,请在调度器的将数据格式设置为部分中选择相应的图标。

请参阅下表,了解每种格式如何投放到各个目标平台。

格式 电子邮件 网络钩子 Amazon S3 SFTP
数据表 电子邮件正文中的数据表(HTML 格式) 不适用于此目标平台 不适用于此目标平台 不适用于此目标平台
可视化 电子邮件正文中的可视化图表(PNG 图片格式) 不适用于此目标平台 不适用于此目标平台 不适用于此目标平台
CSV 以逗号分隔的文本文件附件形式提供的数据表 以逗号分隔的文本文件附件形式提供的数据表 以逗号分隔的文本文件附件形式提供的数据表 以逗号分隔的文本文件附件形式提供的数据表
XLSX 以 Excel 文件附件形式提供的数据表 以 Excel 文件附件形式提供的数据表 以 Excel 文件附件形式提供的数据表 以 Excel 文件附件形式提供的数据表
JSON - 简单 数据表(以 JSON 文件附件形式提供)。在此格式中,Looker 会使用维度或测量值的字段名称作为其呈现值,而不是字段的标签。 数据表(作为 JSON 文件附件)。在此格式中,Looker 会使用维度或测量值的字段名称作为其呈现值,而不是字段的标签。 数据表(以 JSON 文件附件形式提供)。在此格式中,Looker 会使用维度或测量值的字段名称作为其呈现值,而不是字段的标签。 数据表(作为 JSON 文件附件)。在此格式中,Looker 会使用维度或测量值的字段名称作为其呈现值,而不是字段的标签。
JSON - 标签 不适用于此目标平台 JSON 格式的数据表。在此格式中,Looker 会使用字段标签作为其 JSON 输出中的呈现值。 不适用于此目标平台 不适用于此目标平台
JSON - 简单、内嵌 不适用于此目标平台 直接以 JSON 格式提交的数据表。在此格式中,Looker 会使用维度或测量值的字段名称作为其呈现值,而不是字段的标签。 不适用于此目标平台 不适用于此目标平台
JSON - 详细、内嵌 不适用于此目标平台 直接以 JSON 格式提交的数据表,其中包含其他详细信息,例如字段元数据、缓存信息、查询完成时间以及查询运行所用时间。在此格式中,Looker 会使用维度或测量值的字段名称作为其呈现值,而不是字段的标签。 直接以 JSON 格式提交的数据表,其中包含其他详细信息,例如字段元数据、缓存信息、查询完成时间以及查询运行所用时间。在此格式中,Looker 会使用维度或测量值的字段名称作为其呈现值,而不是字段的标签。 直接以 JSON 格式提交的数据表,其中包含其他详细信息,例如字段元数据、缓存信息、查询完成时间以及查询运行用时。在此格式中,Looker 会使用维度或测量值的字段名称作为其呈现值,而不是字段的标签。
文本 数据表(以制表符分隔的文本文件附件形式提供) 以制表符分隔的文本文件附件形式提供的数据表 以制表符分隔的文本文件附件形式提供的数据表 数据表(以制表符分隔的文本文件附件形式提供)
HTML 数据表(以 HTML 文件附件形式) 数据表(以 HTML 文件附件形式) 数据表(以 HTML 文件附件形式) 数据表(以 HTML 文件附件形式)

触发递送

安排周期性传送时,您可以通过以下两种方式触发传送:

  • 重复间隔:选择此选项可使用您在本页的指定递送周期部分中设置的递送时间表。
  • 数据组更新:如果您的 LookML 开发者配置了数据组,您可以安排在数据组触发、管理缓存并重新构建相关 PDT 后进行传送。

指定数据组触发器

如需使用数据组触发器,请在调度器的触发器部分中选择数据组更新。然后,从选择数据组下拉菜单中选择来源数据组。

如需使用数据组触发器安排内容,内容所基于的模型文件需要包含 datagroup。Looker 会列出给定 Look 或信息中心图块中包含的模型中定义的所有数据组,即使这些数据组不用于处理查询或 PDT 的缓存也是如此。

只有在所有使用该数据组持久化的 PDT 完成重新生成过程后,基于数据组的计划才会触发传送,从而确保传送的内容包含最新数据。

指定传送周期

对于使用重复间隔的传送,您可以在传送此时间安排部分中自定义时间安排。在调度器的触发器部分中选择重复间隔。时间选项会根据您选择的是每天、每周、每月、每小时还是每分钟而发生变化。您可以在高级选项部分中调整时间表的时区。

每小时和每分钟时间间隔的结束时间不包含在内。最后一次发送将在指定结束时间之前、最后一次选定的时间间隔内进行。例如,如果内容安排在凌晨 12:00 到晚上 11:00 之间每小时发送一次,则会在凌晨 12:00 到晚上 10:00 之间每小时整点发送一次。如果内容安排在凌晨 12:00 到晚上 11:00 之间按分钟每 30 分钟发送一次,则该时间范围内的最后一次发送时间为晚上 10:30。

对投放应用过滤条件

如果您要交付包含过滤条件的 Look 或信息中心,可以修改过滤条件,以进一步过滤交付的结果。

点击过滤条件,查看和修改与此 Look 或信息中心关联的过滤条件,以便进行传送。在调度器中更改这些过滤条件选项不会更改 Look 或信息中心内的过滤条件。如果信息中心过滤条件需要过滤条件值,而时间表过滤条件为空,则时间表在交付时不会显示任何结果。

如果您更改了在 Look 或信息中心内用作过滤条件的字段名称,请务必查看已安排的 Look 和信息中心的过滤条件部分,并根据需要更新过滤条件,以反映您所做的更改。如果预定的内容传送包含不再起作用的过滤条件(例如,引用的字段已更改),则预定的传送可能会公开未经过滤的数据。

如需进一步自定义传送,您可以使用与用户属性匹配过滤条件选项(如果您的 Looker 管理员已配置名为用户属性的用户特定值)。将过滤条件设置为其中一个属性后,系统会自动为每位用户自定义结果,这意味着即使您发送的是一次性递送,也可以向多位用户发送自定义结果。如需了解详情,请参阅用户属性文档页面。

应用高级投放选项

高级选项部分提供了更多传送自定义选项。点击高级选项旁边的箭头,展开此菜单。可用的选项取决于所选的传送目的地和格式,以及您要传送的是信息中心、Look 还是探索。下表中的链接指向对将 Look 或探索结果递送到 Looker 内置目标位置的每个可用选项的说明。向第三方集成发送数据时,可能会有独特的高级选项。

格式 电子邮件 网络钩子 Amazon S3 SFTP
数据表
符合以下条件时发送此时间表: 不适用于此目标平台 不适用于此目标平台 不适用于此目标平台
限额
电子邮件选项 以收件人身份运行时间表
包含链接
格式选项 应用可视化选项
已设置格式的数据值
时区
可视化
限额 不适用于此目标平台 不适用于此目标平台 不适用于此目标平台
电子邮件选项 以收件人身份运行时间表
包含链接
表分辨率
时区
CSV
符合以下条件时发送此时间表: 符合以下条件时发送此时间表: 符合以下条件时发送此时间表: 符合以下条件时发送此时间表:
限额 限额 限额 限额
电子邮件选项 以收件人身份运行时间表 不适用于此目标平台 不适用于此目标平台 不适用于此目标平台
包含链接
格式选项 应用可视化选项 格式选项 应用可视化选项 格式选项 应用可视化选项 格式选项 应用可视化选项
已设置格式的数据值 已设置格式的数据值 已设置格式的数据值 已设置格式的数据值
时区 时区 时区 时区
XLSX
符合以下条件时发送此时间表: 符合以下条件时发送此时间表: 符合以下条件时发送此时间表: 符合以下条件时发送此时间表:
限额 限额 限额 限额
电子邮件选项 以收件人身份运行时间表 不适用于此目标平台 不适用于此目标平台 不适用于此目标平台
包含链接
格式选项 应用可视化选项 格式选项 应用可视化选项 格式选项 应用可视化选项 格式选项 应用可视化选项
已设置格式的数据值 已设置格式的数据值 已设置格式的数据值 已设置格式的数据值
时区 时区 时区 时区
JSON - 简单;JSON - 标签;JSON - 简单、内嵌
符合以下条件时发送此时间表: 符合以下条件时发送此时间表: 符合以下条件时发送此时间表: 符合以下条件时发送此时间表:
限额 限额 限额 限额
电子邮件选项 以收件人身份运行时间表 不适用于此目标平台 不适用于此目标平台 不适用于此目标平台
包含链接
格式选项 应用可视化选项 格式选项 应用可视化选项 格式选项 应用可视化选项 格式选项 应用可视化选项
已设置格式的数据值 已设置格式的数据值 已设置格式的数据值 已设置格式的数据值
时区 时区 时区 时区
JSON - 详细、内嵌 不适用于此目标平台 限额 限额 限额
不适用于此目标平台 时区 时区 时区
文本
符合以下条件时发送此时间表: 符合以下条件时发送此时间表: 符合以下条件时发送此时间表: 符合以下条件时发送此时间表:
限额 限额 限额 限额
电子邮件选项 以收件人身份运行时间表 不适用于此目标平台 不适用于此目标平台 不适用于此目标平台
包含链接
格式选项 应用可视化选项 格式选项 应用可视化选项 格式选项 应用可视化选项 格式选项 应用可视化选项
已设置格式的数据值 已设置格式的数据值 已设置格式的数据值 已设置格式的数据值
时区 时区 时区 时区
HTML
符合以下条件时发送此时间表: 符合以下条件时发送此时间表: 符合以下条件时发送此时间表: 符合以下条件时发送此时间表:
限额 限额 限额 限额
电子邮件选项 以收件人身份运行时间表 不适用于此目标平台 不适用于此目标平台 不适用于此目标平台
包含链接
格式选项 应用可视化选项 格式选项 应用可视化选项 格式选项 应用可视化选项 格式选项 应用可视化选项
已设置格式的数据值 已设置格式的数据值 已设置格式的数据值 已设置格式的数据值
时区 时区 时区 时区

符合以下条件时发送此时间表:

对于 Look 的定期传送,您可以自定义时间表,以便仅在满足特定条件时才传送 Look 内容。提醒为信息中心功能块提供类似的功能。

在在以下情况下发送此时间表下拉菜单中,指定您是希望仅在有结果时、仅在没有结果时,还是在有结果或没有结果时都发送 Look 内容。例如,您可以使用过滤条件为要监控的情况创建条件,例如库存商品少于特定数量、支出超过特定值等,然后仅在达到该条件时才传送内容。

您还可以选中自上次运行后结果有变化旁边的复选框,指定仅当自上次发送数据后查询结果有变化时才进行发送。如果您想使用所有结果 限制选项,则此选项不可用。

限制

您可以通过为数据选择以下限制选项之一来限制传送的数据大小:

  • 表格中的结果:数据会一次性发送。
  • 所有结果:数据在返回时会以流式传输,发送查询结果中的所有数据行。所有结果选项仅对拥有包含 schedule_without_limit 权限的角色的用户可见。

如果您选择表中的结果,Looker 将遵循您在已保存 Look 或探索中设置的所有行数限制。如果您选择所有结果,Looker 将返回查询的所有行,而不考虑任何已保存的 Look 设置,也不考虑 Looker 的常规 5,000 行限制。在检索超大型数据集时,启用此设置可能很有用,但您应谨慎操作,确保查询不会超出数据库的处理能力。

电子邮件限制选项

发送 Look 和探索时,您可以限制电子邮件的大小,确保其不会超过电子邮件服务器的邮件大小限制。为您的数据选择以下限制选项之一:

  • 表格中的结果:发送的数据最多为 5,000 行。对于使用数据表或可视化图表 格式选项的电子邮件,此选项是唯一可用的选择。Looker 不会发送数据行数超过 5,000 行的电子邮件。
  • 所有结果:如果您使用的是文本、CSV、JSON - 简单、XLSX 或 HTML 格式选项,则可以发送已保存 Look 的结果中的所有行。选择此选项时,系统会忽略针对已保存 Look 设置的任何限制,也会忽略 Looker 的常规 5,000 行限制。不过,电子邮件应用存在总数据量上限。Looker 不会发送正文包含超过 20 MB 数据或附件包含超过 15 MB 数据的电子邮件。如果您指定数据表或可视化图表格式,然后选择所有结果,Looker 会自动更改格式,以使用文本附件来支持发送所有结果。所有结果选项仅对拥有包含 schedule_without_limit 权限的角色的用户可见。

如需验证您是否在定时发送的邮件的行数或数据量限制范围内,您可以输入自己的邮箱作为收件人,然后点击发送测试,立即将数据发送给自己。如果您没有收到电子邮件,则可能是因为您已达到电子邮件的行数上限或数据上限。

电子邮件选项

电子邮件递送方式还有其他递送选项,即以收件人身份运行时间表和包含链接。

以收件人身份运行时间表

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

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

例如,Looker 管理员需要安排一个查询,该查询会统计按州分组的用户数量,并将其发送给一系列用户,每个用户都有不同的访问权限过滤条件值。

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

此选项会考虑创建时间表的用户权限,以及添加到应通过电子邮件发送给谁?文本字段中的邮箱类型。

在某些情况下,以收件人身份运行时间表选项不可用:

  1. 非管理员添加非本人邮箱时
  2. 当 Looker 管理员添加已停用用户的电子邮件地址时
  3. 当 Looker 管理员添加不属于 Looker 用户的电子邮件地址时(Looker 账号由收件人旁边的 Looker 图标表示)
  • 如果电子邮件地址是在选择以收件人身份运行时间表选项之前添加的,则该选项会自动停用。如果从收件人列表中删除该电子邮件地址,则该地址会再次变为可用。
  • 如果邮箱是在选择以收件人身份运行时间表选项之后添加的,则添加邮箱会产生错误,并且邮箱会自动从应通过电子邮件发送给谁?字段中移除。以收件人身份运行时间表选项将保持启用状态。

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

如果您的 Looker 管理员已将 Looker 实例的通过电子邮件发送的数据政策设置为发送链接和数据,则计划程序会显示包含链接选项。选中此选项后,数据传送电子邮件中会包含一个返回 Looker 的链接,对于传送的 Look 和探索,该链接会显示为“查看完整报告”;对于传送的信息中心,该链接会显示为“查看完整信息中心”。

借助此链接,电子邮件收件人可以进一步探索相应 Looker 实例中的数据。收件人必须登录 Looker,并有权访问所交付内容基于的模型,才能在 Looker 中查看该内容。如果您想要从数据传送电子邮件中移除此链接,请取消选中包含链接复选框。

格式选项

不使用可视化图表格式的发送选项还有其他发送选项,即应用可视化图表选项和设置了格式的数据值。

应用可视化选项

此选项不适用于以可视化图表格式传送的 Look 或探索。

  • 选择应用可视化选项,使传送的数据以类似于表格图表的形式呈现。系统会应用在绘图、序列和格式菜单中为可视化图表配置的以下任何设置:

  • 取消选中应用可视化选项,让 Looker 按照 Look 的数据部分或信息中心图块的从此处探索窗口中显示的数据进行发送。JSON - 标签使用字段标签,即使未选择应用可视化选项也是如此。

已设置格式的数据值

您可以配置数据的格式:

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

表分辨率

以可视化图表格式将内容发送到电子邮件时,您可以使用表格分辨率下拉菜单自定义可视化图表的宽度。宽度选项包括:

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

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

时区

默认情况下,Looker 会使用与您的账号关联的时区来确定何时发送数据。如果您的账号没有关联的时区,Looker 会使用您的应用时区。如果您想指定其他时区,请选择使用自定义时区。您选择的时区不会影响 Look 或信息中心内的数据,只会影响传送时间。

测试传送

点击发送测试按钮,向指定目标位置发送一次性测试交付。立即测试选项不会考虑某些高级选项设置,但会遵循所有选定的过滤条件。

正在保存传送

您的递送设置摘要会显示在计划工具底部。

对于一次性传送,完成传送选项配置后,点击发送按钮即可立即将内容传送到指定目的地。

对于周期性传送,在完成传送选项配置后,点击全部保存按钮以保存时间表并关闭窗口。内容将根据您的投放设置进行投放。如果您重新打开 Scheduler,则已保存的时间安排会显示在左侧面板中。您可以选择复制或删除时间表,只需分别点击复制或删除图标即可。

您保存的时间安排还会显示在用户个人资料中的您创建的时间安排页面,以及管理控制台面板中的时间安排和时间安排历史记录页面。如需了解详情,请参阅本页上的查看传送部分。

查看配送

您可以查看自己创建的时间表,如果拥有适当的权限,还可以查看 Looker 实例的所有时间表。

查看您创建的配送

您可以在您创建的时间表页面上查看您创建的所有时间表的列表,只需点击您的用户个人资料图标并选择时间表即可访问该页面。如需详细了解如何查看和管理您创建的时间表,请参阅查看预定的数据传送页面。

查看其他用户创建的递送

如果您的 Looker 管理员已向您授予查看时间表和时间表历史记录管理页面的权限,您就可以查看整个 Looker 实例的所有时间表列表。不过,您将无法修改或删除这些时间表。

注意事项

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

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

  • 如果贵公司在 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 兼容的加密和密钥交换算法的支持。