提交外观和探索

本页面简要介绍了如何将 Look 和探索提交到 Looker 的内置提交目标位置,以及如何将其提交到可供您的 Looker 实例使用的任何集成服务。如需了解如何安排信息中心的生成时间,请访问安排和发送信息中心文档页面。

Looker Scheduler 是用于配置内容传送设置的弹出式窗口的名称。对于外观,您可以使用定时发送功能安排一次性或周期性发送。探索只能以一次性交付的形式发送。如需安排“探索”内容定期投放,您必须先将其另存为 Look。

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

您可以使用的提交选项取决于 Looker 管理员授予您的提交相关权限

从文件夹中打开 Scheduler

对于探索,您只能在探索中打开时间管理工具,而不能在文件夹中打开。

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

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

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

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

网格视图中,您可以通过以下方式打开时间表:

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

创建传送

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

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

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

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

完成后,点击全部保存

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

为传送内容命名

为您的时间表命名字段中,为时间表提供一个唯一的标题。保存时间表后,该标题会显示在左侧面板、您创建的时间表列表以及管理面板中的时间表管理页面上。

根据商品的送货目的地,相应影视内容可能还会出现在其他位置:

  • 对于通过电子邮件发送的报告,标题会用作电子邮件的主题行,如果您选择使用电子邮件附件的格式,则还会用作文件名的一部分。
  • 对于 webhook,标题包含在 Title 字段下的 webhook 载荷中。
  • 对于提交到 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-Za-z0-9_- 字符以外的所有字符。

选择送货目的地

您可能无法看到所有目标位置,具体取决于 Looker 管理员配置的权限。

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

目标平台包括:

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

电子邮件递送选项

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

应将报告发送给哪些人部分,输入收件人的电子邮件地址。输入一个电子邮件地址,或多个电子邮件地址(以英文逗号分隔),然后点击添加

根据您的 Looker 实例的设置和您被分配的权限,您或许可以向与 Looker 实例中的任何用户账号无关的电子邮件地址发送电子邮件。这些邮件会被归类为外部邮件。如需向外部用户提交内容,您的 Looker 管理员必须向您授予向外部用户提交内容的权限,或者已将这些收件人的电子邮件网域添加到适用于定时发布内容的电子邮件网域许可名单

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

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

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

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

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

网络钩子的传送选项

越来越多的基于互联网的服务会使用 Webhook 触发数据交换。借助 Zapier 等 Web 服务,您可以使用 webhook 将 Looker 数据传送到各种应用;例如,您可以安排定期将 Look 或信息中心传送到 webhook。设置提交时,Looker 会提示您提供 webhook 地址

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

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

具体步骤因您用于提交信息中心的 Web 服务和目标应用而异。如需了解如何设置其他应用以接收来自 Looker 的 webhook 数据,请参阅这篇关于使用 webhook 安排查看和信息中心的文章 (3.46 及更高版本)

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

Amazon S3 存储分区的传送选项

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

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

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

  • 存储桶:您的 Amazon S3 存储桶的名称。
  • 可选路径:您要将数据保存到的文件夹(如果有)。
  • 访问密钥:Amazon 提供的 S3 存储桶的访问密钥 ID。
  • 密钥:Amazon 提供的 S3 存储桶的私有访问密钥。
  • 区域:托管 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

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

目前,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 错误,这可能是因为 JRuby 中存在 bug,导致无法使用椭圆曲线 (EC) 算法或主机密钥来建立 Looker 与 SFTP 目标位置之间的 SSH 连接。为避免向 SFTP 目的地发送数据时出现问题,请勿在 ~/.ssh/config/etc/ssh_config 文件中使用 EC 算法,也不要在 Looker 主机上的 ~/.ssh 中存储 EC 主机密钥。

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

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

例如:Test_Schedule_2019-04-11T1130_HWkvys.csv

第三方集成的提交选项

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

在时间表的目标字段中选择集成的服务后,系统可能会显示几个新字段,并提示您提供更多信息。

以下列表显示了您可以将 Look 或探索结果提交到的 Looker Action Hub 服务。

列表的使用方法如下:

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

选择数据格式

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

外观和探索会根据传送目的地显示不同的格式选项。如需选择提交内容的格式,请在时间表的将数据格式设置为部分中选择相应的图标。

下表说明了每种格式如何提交到每个目标位置。

格式 电子邮件 网络钩子 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 文件附件)

触发传送

如果您要发送探索广告系列或一次性投放外观,则不会看到此选项。

安排定期提交时,您可以通过以下两种方式触发提交:

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

指定数据组触发器

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

如需使用数据集触发器,请在时间表的触发器部分中选择数据集更新。然后,从选择数据集群下拉菜单中选择来源数据集群。

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

只有在与该数据集群一起保留的所有 PDT 的重新生成流程完成后,系统才会触发基于数据集群的时间表以进行传送,从而确保传送的数据包含最新的数据。

指定投放频率

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

对于使用重复间隔时间的提交内容,您可以在按此时间表提交部分自定义时间表的时间。在时间安排工具的触发器部分中,选择重复间隔。时间选项会因您选择的周期(每天每周每月每小时每分钟)而异。您可以在高级选项部分调整投放时间的时区。

按小时按分钟间隔的结束时间不含该时间。系统会在指定结束时间之前,按照上次选择的时间间隔发送最后一批数据。例如,如果内容的投放时间安排为凌晨 12:00 到晚上 11:00 之间的每小时一次,则系统会在凌晨 12:00 到晚上 10:00 之间每小时发送一次。如果内容的投放时间安排为凌晨 12:00 到晚上 11:00 之间的每 30 分钟一次,则系统会在该时间范围内的最后一次发送时间为晚上 10:30。

对提交内容应用过滤条件

如果您发送的是探索内容,则不会看到此选项。

如果您要提交包含过滤条件的数据分析探索或信息中心,则可以修改过滤条件,以进一步过滤所提供的结果。

点击过滤条件,查看和修改与此外观或信息中心关联的传送过滤条件。在时间表中更改这些过滤条件选项不会更改数据洞见或信息中心中的过滤条件。如果信息中心过滤条件要求提供过滤条件值,而时间表过滤条件为空,则时间表在提交时将不显示任何结果。

如果您更改了作为数据分析探索或信息中心过滤条件的字段名称,请务必查看定期生成的数据分析探索和信息中心的过滤条件部分,并根据需要更新过滤条件以反映所做更改。如果安排的定期内容提交包含不再有效的过滤条件(例如,引用的字段已更改),则定期提交的内容可能会泄露未经过滤的数据。

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

应用高级传送选项

高级选项部分可让您对提交内容进行进一步自定义。点击高级选项旁边的箭头以展开此菜单。可供选择的选项取决于您选择的目标位置和提交内容的格式,以及您要提交的是信息中心、外观主题还是探索。下表中的链接会指向可用于将外观或探索提交到 Looker 内置目标位置的每个选项的说明。向第三方集成提交内容时,可能有独特的高级选项可用。

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

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

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

在以下情况下发送此时间表下拉菜单中,指定您希望在有结果时、没有结果时还是无论有无结果时都投放外观内容。例如,您可以使用过滤条件针对要监控的情况(例如库存商品少于特定数量、支出超过特定值等)创建条件,然后仅在满足相应条件时提交内容。

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

限制

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

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

如果您选择表格中的结果,Looker 将遵循您在已保存的 Look 或“探索”中设置的行数限制。如果您选择所有结果,Looker 将返回查询的所有行,无论任何已保存的 Look 设置如何,也无论 Looker 的常规 5,000 行限制如何。这对于检索非常大型的数据集来说可能是理想的做法,但您应谨慎行事,确保查询不会对数据库造成过大负担。

电子邮件限制选项

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

  • 表格中的结果:发送的数据行数上限为 5,000 行。对于使用数据表格可视化图表 格式选项的电子邮件,这是唯一的选择。系统不会发送行数超过 5,000 的电子邮件。
  • 所有结果:如果您使用的是“文本”“CSV”“JSON - 简单”“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 图标)
  • 如果电子邮件地址是在选择以收件人身份运行时间表选项之前添加的,则该选项会自动停用。如果您从收件人名单中删除该电子邮件地址,该地址就会恢复可用状态。
  • 如果是在选择以收件人身份运行时间表选项之后添加的电子邮件地址,则添加该电子邮件地址会导致出现错误,并且系统会自动从应将电子邮件发送给谁?字段中移除该电子邮件地址。以收件人身份运行时间表选项将保持启用状态。

在特殊情况下,如果某个用户被列为已启用以收件人身份运行时间表的某个时间表的收件人,但该用户的账号随后被停用,那么从下次运行时起,该时间表将无法向已停用的用户传送内容。如果该用户的账号被删除,则整个时间表都将无法向任何收件人发送。Looker 管理员或具有 see_schedules 权限的用户可以在管理面板的调度程序历史记录页面中诊断此失败问题。

如果您的 Looker 管理员已将 Looker 实例的通过电子邮件发送的数据政策设为发送链接和数据,则时间表工具会显示包含链接选项。选中此选项后,数据传送电子邮件中会包含指向 Looker 的链接,其中会显示“查看完整报告”(对于传送的 Look 和探索)和“查看完整信息中心”(对于传送的信息中心)。

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

格式选项

不使用“可视化”格式的传送内容具有其他传送选项,即应用可视化选项格式化的数据值

应用可视化选项

此选项不适用于以可视化格式提交的 Look 或探索数据。

  • 选择应用可视化选项,以使传送的数据看起来类似于表格图表。系统会应用为可视化图表配置的图表系列格式设置菜单中的以下任一设置:

    只有在应用沿尺度规则后,条件格式才会显示在使用表格图表可视化结果的“探索”和“探索”的 Excel 传送内容中。

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

已设置格式的数据值

此选项不适用于以可视化格式提交的 Look 或探索数据。

您可以配置数据的格式:

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

表分辨率

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

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

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

时区

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

测试传送

点击发送测试按钮,向指定目标发送一次性测试传送内容。

保存传送内容

投放设置摘要会显示在时间表工具底部。

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

对于周期性提交,配置完提交选项后,点击全部保存按钮保存时间表并关闭窗口。系统会根据您的提交设置提交内容。如果您重新打开时间表,已保存的时间表会显示在左侧面板中。您可以选择点击复制删除图标,分别复制或删除时间表。

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

查看传送内容

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

查看您创建的提交内容

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

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

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

注意事项

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

还可能出现一些其他问题:

  • 如果贵公司已在 Looker 的管理部分设置了自己的电子邮件设置,则 Looker 管理员需要确保这些设置正确无误,并且电子邮件服务提供商正常运行。
  • 根据上限设置,系统会将数据传送限制为 5,000 行,或者将附件电子邮件的文件大小上限设为 15 MB,将内嵌内容电子邮件的文件大小上限设为 20 MB。如果电子邮件中的行数或数据量超出这些限制,系统将不会发送。
  • 如果电子邮件未在预期时间发送,但最终还是送达了,则可能是因为它与其他 Looker 任务发生了竞争。这些任务可能包括其他定时发送的电子邮件、许多用户同时探索数据,或正在构建永久派生表。如果发生这种情况,请与您的 Looker 管理员联系,了解是否存在竞争任务。
  • 如果某个电子邮件地址一直从您的分发名单中消失,可能是因为用户退订了该定时发送的电子邮件。如果您使用群组电子邮件别名向多人发送电子邮件,这可能会造成特别大的麻烦,因为任何单个收件人都可以退订该整个电子邮件别名。如需了解取消订阅,请参阅这篇关于监控调度程序取消订阅事件的 Looker 社区帖子。