提交 Look 和探索

本页面简要介绍了如何将 Look 和探索传送到 Looker 的原生传送目的地以及可用于 Looker 实例的任何集成服务。如需了解如何安排信息中心的发送时间,请参阅安排和发送信息中心文档页面。

Looker 调度程序是一个弹出式窗口的名称,您可以在其中配置内容传送设置。对于 Look,您可以使用调度器发送一次性或定期提交的内容。探索内容只能以一次性商品的形式提交。如需安排定期传送“探索”内容,您必须先将其保存为 Look。

如果您是 Looker 开发者,则必须关闭开发模式才能启用这些时间安排选项。

您可以使用的递送选项取决于您的 Looker 管理员向您授予的与递送相关的权限

从文件夹打开 Scheduler

对于探索,您只能从探索(而不是文件夹)中打开调度器。

如需从文件夹或子文件夹中打开调度器,请找到要传送的信息中心所在的文件夹或子文件夹。导航到某个文件夹后,该文件夹中的所有 Look 和信息中心都会以列表视图网格视图的形式列出。

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

列表视图中,您可以通过以下方式打开调度器:

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

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

  • 点击某项的日历图标(如果存在)
  • 打开相应内容,点击右上角的齿轮菜单,然后选择安排(对于定期传送)或发送(对于一次性传送)

创建传送

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

Looker 会显示旧版调度器。

对于周期性传送,旧版调度器的左侧面板会显示为相应内容创建的所有时间表,并突出显示您正在创建或修改的时间表的标题。左侧面板会按照时间逆序从最后更新时间排列时间表。您可以分别点击日程安排右侧的复制删除图标,以复制或删除现有日程安排。

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

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

完成后,点击全部保存

以下部分介绍了各种时间安排设置。

为传送命名

为时间表命名字段中,为时间表指定一个独一无二的标题。在您保存该时间表后,左侧面板、您创建的时间表列表以及管理面板中的时间表管理页面都会显示标题。

根据包裹的目的地,标题也可能会显示在其他位置:

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

    对于 SFTP 提交内容,其文件名只能包含字母数字、下划线 (_) 和连字符 (-)。Looker 会将 A-Za-z0-9_- 字符以外的任何其他字符从您在为时间表命名字段输入的内容中删除。

选择送货目的地

所有目标位置可能不会显示,具体取决于您的 Looker 管理员如何配置您的权限。

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

目标平台包括:

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

电子邮件递送选项

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

收件人部分,输入收件人的电子邮件地址。输入单个电子邮件地址或多个地址(以英文逗号分隔),然后点击添加

您或许可以向未与 Looker 实例中的任何用户帐号关联的电子邮件地址发送电子邮件,具体取决于 Looker 实例的设置和分配的权限。这类邮件会被归类为外部电子邮件。如需向外部用户递送内容,您的 Looker 管理员必须向您授予向外部用户递送内容的权限,或者将这些收件人的电子邮件网域添加到针对安排的内容的电子邮件网域许可名单

如果收件人是另一个 Looker 用户,则此人会看到从电子邮件中链接到信息中心的选项,除非您的 Looker 管理员已将您的 Looker 实例的通过电子邮件发送数据政策设置为仅发送数据包含链接选项处于未选中状态。

如果所有收件人都退订了某个定期发送的电子邮件,则系统会从 Looker 中删除该时间表,甚至可以从用户管理员的时间表管理页面中删除该时间表。如果收件人代表某个电子邮件群组退订,该群组的任何成员都不会收到定时发送的电子邮件。

请参阅此页面上的应用高级递送选项部分,了解有关电子邮件递送的更多信息。

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

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

网络钩子的传送选项

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

Where should this data go? 部分中,选择 Webhook。在网络钩子网址部分,输入 Looker 应该为此次传送发送 HTTPS 请求的网址。您可以从用于处理 webhook 的网络服务中获取此网址。 如需设置 webhook,请转到 Web 服务并执行以下操作:

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

具体过程因用于提供仪表板的网络服务和目标应用程序而异。如需了解如何设置其他应用以从 Looker 接收网络钩子数据,请参阅这篇关于使用网络钩子安排 Look 和信息中心 (3.46+) 的 Looker 社区帖子。

Looker 会在最多 30 分钟内尝试传送到网络钩子。确保目标位置可以在 30 分钟内对 webhook 传送尝试作出响应。

Amazon S3 存储分区的递送选项

Amazon S3 存储分区是存储大量数据的常见方式。您或您的公司需要先与 Amazon 创建一个 S3 存储桶,然后 Looker 才能使用它。

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

Where should this data go? 部分,选择 Amazon S3。此时,系统会显示 S3 详细信息部分,并提示您输入 Amazon S3 存储桶的相关信息:

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

适用于 SFTP 服务器的递送选项

这些数据应传输到哪些位置?部分中选择 SFTP,将您的信息中心传送到 SFTP 服务器。当您的数据或可视化图表因过大而无法通过电子邮件发送时,将结果发送至 SFTP 服务器不失为一种好的方法。如果您选择此传送选项,Looker 会提示您输入 SFTP 服务器地址、用户名和密码(如下所述)。

请注意以下有关 SFTP 传送的内容:

  • 如需从 Looker 接收 SFTP 传送内容,请确保您的网络管理员已将 Looker 的 IP 地址添加到 SFTP 服务器的 IP 许可名单或入站流量规则中。
  • 在传送到 SFTP 服务器时,其文件名只能包含字母数字、下划线 (_) 和连字符 (-)。Looker 会将 A-Za-z0-9_- 字符以外的任何其他字符从您在为时间表命名字段输入的内容中删除。

如果您选择使用 SFTP,Looker 会提示您输入服务器的网址和登录信息:

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

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

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

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

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

    • diffie-hellman-group-exchange-sha1
    • diffie-hellman-group1-sha1
    • diffie-hellman-group14-sha1
    • diffie-hellman-group-exchange-sha256

    如果五分钟内没有建立连接,请选择其他算法。有些算法需要很长时间才能生成 SSH 密钥。通过此选项,您可以使用所需时间可能更短的算法。选择一种算法,使其成为建立 SSH 连接的首选算法。如果服务器不支持该算法,则会在后续尝试中使用所有其他算法。如果此字段设为 Default,系统将使用连接库中算法的原始顺序。

目前,SFTP 仅支持用户名和密码凭据。不支持 SSH 私钥凭据。

Looker SFTP 提交内容支持的主机密钥算法包括:

  • ssh-rsa
  • ssh-dss
  • ssh-rsa-cert-v01@openssh.com
  • ssh-rsa-cert-v00@openssh.com

Looker 会存储您的 SFTP 服务器的 SFTP 指纹。如果您在进行 SFTP 传送时遇到错误,则可能表示 SFTP 指纹无效。在这种情况下,请与您的 Looker 管理员联系。

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

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

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

例如:Test_Schedule_2019-04-11T1130_HWkvys.csv

第三方集成的交付选项

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

在调度器的目标位置字段中选择集成式服务后,系统可能会显示多个新字段,并提示您提供更多信息。

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

此列表的使用方法如下:

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

选择数据格式

对于“通过电子邮件发送”选项,如果您的 Looker 管理员已将 Looker 实例的通过电子邮件发送数据政策设为仅发送链接,则您无法选择数据格式。

Look 和探索会提供不同的格式选项,具体取决于递送目的地。要选择传送格式,请在调度程序的将数据的格式设置为部分中选择相应的图标。

请参见下表,了解每种格式如何投放到每个目标位置。

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

触发传送

如果您发送探索或一次性提交 Look,则不会看到此选项。

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

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

指定数据组触发器

如果您发送探索、一次性传送 Look,或者为周期性传送指定了重复间隔触发器,则不会看到此选项。

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

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

基于数据组的时间表只有在数据组持久保留的所有 PDT 的重新生成流程完成后才会触发传送,从而确保您的传送数据包含最新的数据。

指定传送重复周期

如果您发送探索、一次性传送 Look,或者为定期传送指定了数据组更新触发器,则不会看到此选项。

对于使用重复间隔的传送,您可以在传送此时间表部分自定义时间表的时间。在调度器的触发器部分中选择重复间隔。显示的时间选项取决于您是选择每天每周每月每小时还是按分钟。您可以在高级选项部分调整时间表的时区。

每小时按分钟间隔的结束时间不包括在内。最后一次传送的内容将在指定结束时间之前的最后一个所选间隔时间发送。例如,如果内容安排在每小时的午夜 12:00 到晚上 11:00 之间发送,那么系统会在每小时午夜 12:00 到晚上 10:00 发送相应内容。如果内容安排每 30 分钟按分钟在午夜 12:00 到晚上 11:00 发送,那么系统会在午夜 12:00 到晚上 11:00 的最后一刻发送内容

对传送内容应用过滤条件

发送探索时,您不会看到此选项。

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

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

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

如需进一步自定义交付,您可以使用匹配用户属性过滤条件选项(如果您的 Looker 管理员已配置特定于用户的值(称为用户属性)。如果将过滤条件设置为其中一个属性,系统会自动自定义每个用户的结果,也就是说,即使您发送一次性传送,也可以将自定义结果发送给许多用户。如需了解详情,请参阅用户属性文档页面。

应用高级分发选项

高级选项部分提供了额外的自定义内容传送选项。点击高级选项旁边的箭头以展开此菜单。具体有哪些可用选项取决于所选的目标位置和提交方式,以及提交的是信息中心、Look 还是探索。下表中的链接指向关于将 Look 或探索提交到 Looker 原生目标页面的每个选项的说明。向第三方集成提交内容可能会提供独特的高级选项。

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

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

对于定期提交 Look,您可以自定义时间表,让系统仅在满足特定条件时才投放 Look 内容。提醒为信息中心图块提供类似的功能。

符合以下条件时发送此时间表下拉菜单中,指定您是想仅在有结果时、仅在没有结果时,还是有结果或没有结果时投放 Look 内容。例如,您可以使用过滤条件针对您想监控的情况创建条件(如库存低于特定数量的商品、支出超过特定价值等),然后仅在满足该条件时才投放内容。

此外,您还可以勾选且结果自上次运行以来有变化旁边的复选框,指定仅在查询结果自上次发送数据以来有变化时传送。如果您想使用所有结果 限制选项,则无法使用此选项。

限额

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

  • 表中的结果:数据以单次传送的形式发送。
  • 所有结果:数据是流式插入的(如需了解详情,请参阅 Looker 中的所有行数上限是什么?最佳做法页面)。这对于大型数据集非常有用,因为它可以绕过文件大小、浏览器和内存方面的限制。

如果您选择表中的结果,Looker 将遵循您在已保存的 Look 或探索中设置的行限制。如果您选择所有结果,Looker 将返回查询的所有行,无论任何已保存的 Look 设置如何,也无论 Looker 通常有 5,000 行的上限是怎样的。这对于检索非常大的数据集是可取的,但应谨慎确保查询对于您的数据库而言不会过大。

限制电子邮件选项

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

  • 表中的结果:发送的数据时,行数上限为 5,000。对于使用数据表可视化 格式选项的电子邮件,您只能使用此选项。行数超过 5,000 的电子邮件将不会发送。
  • 所有结果:如果您使用的是 Text、CSV、JSON - Simple、XLSX 或 HTML 格式选项,则可以发送已保存 Look 的所有结果行。此选项会忽略针对已保存 Look 设置的任何限制,也不会忽略 Looker 的常规 5,000 行限制。不过,系统存在 15 MB 的总数据量上限,以便电子邮件应用能接受附件。超过 15 MB 且带有附件的电子邮件将不会发送。如果您指定了数据表或可视化格式,然后选择所有结果,Looker 会自动将格式更改为使用文本附件,以支持发送所有结果。

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

电子邮件选项

通过电子邮件发送内容时,还有如下所述的其他递送选项。

以收件人身份运行时间表

此选项仅适用于电子邮件目标帐号。

通过以收件人身份运行时间表选项,管理员可以根据其权限指定一个用户列表,让每个用户都能收到内容传送内容,就像运行了查询一样。非管理员用户也可以输入自己的电子邮件地址来接收递送内容,就像查询内容一样,具体取决于其权限。也就是说,每个用户的访问权限过滤条件用户属性会应用于每封电子邮件中包含的数据。

例如,Looker 管理员需要安排定期生成报告,将按状态分组的用户数统计为一系列用户,并且每个用户都具有不同的访问权限过滤条件值。

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

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

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

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

此特殊情况是,如果某个时间表启用了以收件人身份运行时间表,但该用户的帐号被停用,该时间表便被列为收件人,但该时间表会在下次运行时开始无法递送给已停用的用户。如果该用户的帐号被删除,则整个日程将无法递送至任何收件人。拥有 see_schedules 权限的 Looker 管理员或用户将能够在管理面板的调度器历史记录页面中诊断此故障。

如果您的 Looker 管理员已将您的 Looker 实例的通过电子邮件发送数据政策设为发送链接和数据,调度程序将会显示包含链接选项。选中此选项后,数据传送电子邮件会包含一个返回 Looker 的链接,其中会显示“查看完整报告”(适用于已提交的 Look 和探索)和“查看完整信息中心”(适用于提供的信息中心)。

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

格式选项

未使用可视化格式的提交内容具有如下所述的其他提交选项。

应用可视化选项

此选项不适用于以可视化格式显示的“查看”或“探索”传送内容。

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

    对于以表格形式直观呈现的 Look 和探索的 Excel 格式文件,仅当应用了按比例显示规则时,系统才会显示条件格式。

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

已设置格式的数据值

此选项不适用于以可视化格式显示的“查看”或“探索”传送内容。

您可以配置数据的格式:

  • 如果您希望数据看起来更类似于 Looker 中的探索体验,请选择设置了格式的数据值,但部分文件类型并不支持某些功能(例如关联)。
  • 如果您不想对查询结果应用任何特殊格式(例如对长数字进行四舍五入或添加 Looker 开发者可能已设置的特殊字符),请取消选中已设置格式的数据值。将数据输送到另一个工具进行处理时,通常建议采用此做法。

表分辨率

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

  • 标准:800 像素
  • :1680 像素

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

时区

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

测试交付

点击发送测试按钮,向指定目的地发送一次性测试邮件。

正在保存传送内容

时间安排工具的底部会显示投放设置摘要。

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

对于周期性递送,在完成递送选项配置后,请点击全部保存按钮以保存时间安排并关闭窗口。系统会根据您的传送设置传送相关内容。如果重新打开调度器,您保存的时间表会显示在左侧面板中。您可以通过分别点击复制删除图标来复制或删除时间表。

您保存的时间表也会显示在用户个人资料的您创建的时间表页面上,以及管理面板中的时间表时间表历史记录页面上。有关详情,请参阅本页面中的查看传送内容部分。

查看传送内容

您可以查看自己创建的时间表,并获得相应 Looker 实例的所有时间表。

查看您创建的传送

您可以在您创建的时间表页面上查看自己已创建的所有时间表的列表,点击用户个人资料图标并选择时间表,即可前往该页面。请参阅查看已安排的数据传送页面,详细了解如何查看和管理已创建的时间表。

查看其他用户创建的提交内容

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

注意事项

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

后续可能还会出现一些其他挑战:

  • 如果贵公司在 Looker 的管理部分自行设置了电子邮件设置,那么您的 Looker 管理员需要确保这些设置正确无误,并且您的电子邮件服务提供商可正常运行。
  • 根据限制设置,数据传输的大小上限为 5,000 行,对于带有附件的电子邮件,最大文件大小为 15 MB,对于包含内嵌内容的电子邮件,最大文件大小为 20 MB。行数或数据量超出这些限制的电子邮件将不会发送。
  • 如果某封电子邮件在预期时间未发送,但最终送达,可能是因为您正在与其他 Looker 任务争用资源。这些任务可能包括其他定期发送的电子邮件、许多人同时探索数据或构建永久性派生表。如果发生这种情况,请与您的 Looker 管理员联系,了解其他相互冲突的任务。
  • 如果某个特定电子邮件一直从您的通讯组列表中消失,可能是因为用户正在退订该定期发送的电子邮件。如果您使用群组电子邮件别名向多人发送邮件,可能就会面临更大的挑战,因为任何一个收件人都可以退订整个电子邮件别名。如果您需要了解退订情况,请参阅这篇关于监控调度器退订事件的 Looker 社区帖子。