本页面概述了如何将 Look 和探索发送到 Looker 的内置发送目的地,以及适用于您的 Looker 实例的任何集成服务。如需了解如何安排信息中心,请访问安排和发送信息中心文档页面。
Looker 调度程序是用于配置内容传送设置的弹出式窗口的名称。对于 Look,您可以使用调度程序发送一次性或周期性交付。探索只能作为一次性交付发送。如需安排定期传送探索内容,您必须先将其另存为 Look。
如果您是 Looker 开发者,则必须关闭开发模式才能启用这些调度选项。
您可以使用的传送选项取决于 Looker 管理员授予您的与传送相关的权限。
从文件夹中打开调度器
对于探索,您只能从探索中打开调度程序,而不能从文件夹中打开。
如需从文件夹或子文件夹中打开调度程序,请找到包含要交付的信息中心的文件夹或子文件夹。当您前往某个文件夹时,该文件夹中的所有 Look 和信息中心都会以列表视图或网格视图列出。
日历图标表示您已为相应内容安排至少一次定期投放(在网格视图中,您必须将鼠标悬停在内容缩略图上才能看到日历图标,如果有的话)。
在列表视图中,您可以通过以下方式打开调度程序:
- 点击商品的日历图标(如果有)
- 点击某个商品的三点状菜单,然后选择修改时间表(如果该商品已有时间表)、添加时间表(如果该商品尚无时间表)或发送(创建一次性配送)
- 打开内容,点击右上角的齿轮菜单,然后选择安排(用于定期交付)或发送(用于一次性交付)
在网格视图中,您可以通过以下方式打开调度程序:
- 点击商品的日历图标(如果有)
- 打开内容,点击右上角的齿轮菜单,然后选择安排(用于定期交付)或发送(用于一次性交付)
创建交付
如需在 Looker 内容中创建传送,请点击内容右上角的齿轮菜单,然后选择安排(用于定期传送)或发送(用于一次性传送),以打开旧版调度程序。
对于定期交付,旧版调度程序的左侧面板会显示为相应内容创建的所有安排,并突出显示您正在创建或修改的安排的标题。左侧面板会按时间倒序(从上次更新时间开始)列出日程。您可以点击时间表右侧的复制或删除图标,分别复制或删除现有时间表。
如果您是首次为此内容创建排期,主面板会显示设置为默认值的排期选项。您可以根据需要修改这些值。如果您之前为此内容创建了一个或多个安排,则主面板会在列表顶部显示相应安排的已保存排期设置。然后:
- 如需修改现有时间表的选项,请选择相应时间表,然后根据需要更改选项。完成后,点击全部保存。
- 如需为同一内容创建其他时间安排,请点击新建,然后输入相应时间安排的设置。
完成后,点击全部保存。
以下部分介绍了每项调度设置。
命名交付内容
在为您的时间表命名字段中,为时间表指定一个独一无二的名称。保存时间安排后,该时间安排的标题会显示在左侧面板中您创建的时间安排列表中,以及管理面板中的时间安排管理页面上。
根据配送目的地,该商品还可能会显示在其他位置:
- 对于电子邮件传送,标题会用作电子邮件的主题行,如果您选择使用电子邮件附件的格式,标题还会用作文件名的一部分。
- 对于 Webhook,标题包含在 Webhook 载荷的 Title 字段中。
- 对于向 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 管理员配置的权限,您可能无法看到所有目的地。
这些数据应发送到何处?设置可能会显示多个数据传送目标选项。每个目的地都提供不同的配送选项。
目标平台包括:
- 电子邮件
- webhook
- Amazon S3 存储桶
- SFTP
- Looker 管理员为您的实例启用的任何集成服务 - 您可以在本页面的第三方集成的交付选项部分中查看可用于交付 Look 和探索的可用服务列表
选择数据目的地后,系统会显示一个新的设置字段,您可以在其中添加有关该目的地的具体详细信息,例如电子邮件地址或网络钩子网址。
电子邮件的递送选项
在这些数据应发送到何处?部分中,选择电子邮件。您的内容将发送到您指定的一系列电子邮件地址。
在应发送给哪些人部分,输入收件人的电子邮件地址。输入单个电子邮件地址或多个以英文逗号分隔的电子邮件地址,然后点击添加。
根据 Looker 实例的设置和您获分配的权限,您或许能够向未与 Looker 实例中的任何用户账号相关联的电子邮件地址发送电子邮件。这些电子邮件会被归类为外部电子邮件。如需向外部用户传送内容,Looker 管理员必须已向您授予向外部用户传送内容的权限,或者已将这些收件人的电子邮件网域添加到预定内容的电子邮件网域许可名单。
如果收件人是其他 Looker 用户,那么除非您的 Looker 管理员已将 Looker 实例的电子邮件数据政策设置为仅发送数据或取消选中包含链接选项,否则该收件人将看到电子邮件中包含可链接回信息中心的选项。
如果所有收件人都退订了某个预定电子邮件,那么该预定电子邮件会从 Looker 中删除,即使是用户和管理员的预定管理页面中也会删除。如果收件人代表电子邮件群组退订,则该群组的任何成员都不会收到预定的电子邮件。
如需详细了解电子邮件递送,请参阅本页面的应用高级递送选项部分。
选中添加自定义消息,以便在电子邮件正文中添加自定义消息。Looker 将自定义消息的字符数限制为 1,500 个。
通过电子邮件发送的交付内容不得超过 20 MB(对于以电子邮件正文形式交付的格式)和 15 MB(对于以附件形式交付的格式)。
网络钩子的传送选项
Webhook 是一种越来越常见的触发基于互联网的服务之间交换的方式。借助 Zapier 等 Web 服务,Webhook 可以将 Looker 数据传递给各种应用;例如,您可以安排定期将 Look 或信息中心传递给 Webhook。设置传送时,Looker 会提示您输入 webhook 地址。
在这些数据应发送到何处?部分中,选择 Webhook。在网络钩子网址部分中,输入 Looker 应向其发送 HTTPS 请求以进行此传送的网址。您可以从用于处理 Webhook 的 Web 服务中获取此网址。 如需设置 Webhook,请前往您的 Web 服务并执行以下操作:
- 获取 Looker 应向其发送 HTTPS 请求的网址。
- 为 Looker 数据传送指定目标应用。目标应用可能需要进行额外配置,才能接收来自 Looker 的数据。
具体步骤因您用于交付信息中心的 Web 服务和目标应用而异。如需了解如何设置其他应用以接收来自 Looker 的 Webhook 数据,请参阅这篇 Looker 社区帖子:使用 Webhook 安排 Look 和信息中心 (3.46+)。
Looker 将尝试向 Webhook 传送内容,最长尝试时间为 30 分钟。确保目标可以在 30 分钟内响应网络钩子传送尝试。
Amazon S3 存储分区的交付选项
Amazon S3 存储分区是存储大量数据的常用方式。您或您的公司需要先通过 Amazon 创建一个 S3 存储桶,然后 Looker 才能使用该存储桶。
如果您选择 Amazon S3 目标选项,Looker 会提示您输入有关格式设置和 Amazon S3 存储桶的其他设置,如本页所述。如需详细了解如何使用 Amazon S3 存储桶传送数据,请参阅这篇 Looker 社区帖子:将结果(无限制)安排到 S3。
在这些数据应发送到何处?部分,选择 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-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 密钥交换算法。受支持的选项有:
diffie-hellman-group-exchange-sha1
diffie-hellman-group1-sha1
diffie-hellman-group14-sha1
diffie-hellman-group-exchange-sha256
如果连接在 5 分钟内未建立,请选择其他算法。某些算法需要很长时间才能生成 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
错误,这可能是因为 JRuby 中的 bug 阻止 Looker 使用椭圆曲线 (EC) 算法或主机密钥来建立从 Looker 到 SFTP 目的地的 SSH 连接。为避免向 SFTP 目标位置发送数据时出现问题,请勿在~/.ssh/config
或/etc/ssh_config
文件中使用 EC 算法,也不要在 Looker 主机上的~/.ssh
中存储 EC 主机密钥。
Looker 会将文件上传到 SFTP 服务器上的指定目录,并使用以下文件名惯例:
<name>_<timestamp>_<token>.<file extension>
- 您在为时间表命名字段中提供的名称,在 Looker 移除
A-Z
、a-z
、0-9
、_
或-
以外的所有字符后 - 发送安排的时间戳,格式为
%Y-%m-%dT%H%M
- 由随机的六个字符组成的令牌
- 文件扩展名
例如:Test_Schedule_2019-04-11T1130_HWkvys.csv
第三方集成的交付选项
您可以将 Look 或探索结果安排在指定时间发送到与 Looker 集成的服务(例如 Slack、Dropbox、Google 云端硬盘等)。集成必须由 Looker 管理员启用。Looker 管理员必须明确授予用户和嵌入式用户向第三方集成发送数据和安排数据发送时间的权限。
在调度程序的目的地字段中选择集成服务后,系统可能会显示几个新字段,并提示您提供更多信息。
下表列出了您可以将 Look 或探索结果发送到的 Looker Action Hub 服务。
以下是使用该列表的方法:
- README 文件链接列中显示的网址提供了有关如何启用和配置集成服务以与 Looker 搭配使用的说明。
- 如何使用此集成列中显示的网址提供了有关如何将数据从 Looker 发送到集成服务的说明。其中一些文章还包含启用说明。
- 必需的 LookML 标记列出了必须与内容的基础模型中的
tags
参数搭配使用的所有必需标记。 - 操作类型表示集成服务发送的数据级别:字段、查询或信息中心。字段级操作会发送数据表中单个指定单元格的值。查询级操作会发送整个查询的结果,例如探索或 Look 中的所有行。信息中心级操作会发送信息中心的图片。
- 使用 Google OAuth 身份验证表示集成服务是否使用 Google OAuth 凭据进行身份验证。
- 使用数据流:表示集成服务是否支持流式查询结果。
集成服务 | 说明 | 指向 README 文件的链接 | 如何使用此集成 | 必需的 LookML 标记 | 操作类型 | 是否使用 Google OAuth 身份验证(是/否) | 是否使用数据流(是/否) |
---|---|---|---|---|---|---|---|
Airtable | 向 Airtable 中的表格添加记录。 | 在 GitHub 上查看 README | 查看社区文章 | 无 | 查询 | 否 | 否 |
Amazon SageMaker Infer | 使用 Amazon SageMaker 执行推理。 | 没有可用的 README | 没有可用的文章 | 无 | 查询 | 否 | 是 |
Amazon SageMaker Train:线性学习器 | 使用线性学习器算法在 Amazon SageMaker 上启动训练作业。 | 没有可用的 README | 没有可用的文章 | 无 | 查询 | 否 | 是 |
Amazon SageMaker Train: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 | 借助 Braze 操作,您可以使用 Look 中的 REST API 端点在 Braze 中标记用户。确保结果中包含标记为 braze_id 的字段。最多导出 10000 个。 |
在 GitHub 上查看 README | 请参阅 README | braze_id | 查询 | 否 | 是 |
DataRobot | 将数据发送到 DataRobot 并创建新项目。 | 在 GitHub 上查看 README | 请参阅 README | 无 | 查询 | 否 | 是 |
DigitalOcean - 停止 Droplet | 使用 DigitalOcean API 停止 DigitalOcean 进程。 | 在 GitHub 上查看 README | 查看社区文章 | digitalocean_droplet_id | 字段、查询 | 否 | 否 |
DigitalOcean Spaces | 将数据文件发送到 DigitalOcean Storage 并存储在其中。 | 在 GitHub 上查看 README | 查看社区文章 | 无 | 查询 | 否 | 是 |
Dropbox | 在 Dropbox 上发送和存储数据文件。 | 没有可用的 README | 查看文档 | 无 | 查询 | 是 | 否 |
Facebook 自定义受众群体 | 将数据从客户名单上传到 Facebook 广告自定义受众群体。 | 在 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 | 查询 | 否 | 是 |
Kloudio | 向 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 | 查询 | 否 | 是 |
Segment Identify | 使用 Identify 向 Segment 用户添加特征。 | 在 GitHub 上查看 README | 查看文档 | 电子邮件地址或 user_id 或 segment_anonymous_id 或 segment_group_id | 查询 | 否 | 是 |
细分轨道 | 连接到 Segment 提供的一些集成,以识别用户并针对营销工作流程定位用户。 | 在 GitHub 上查看 README | 查看文档 | 电子邮件地址或 user_id 或 segment_anonymous_id 或 segment_group_id | 查询 | 否 | 是 |
SendGrid | 使用 SendGrid 的 API 发送数据,并安排结果发送到电子邮件地址。 | 在 GitHub 上查看 README | 查看社区文章 | 无 | 查询 | 否 | 否 |
Slack | 使用 OAuth 在 Slack 中的私信、公开频道和私人频道中发送 Looker 内容。此功能适用于 Looker 托管的 6.24 及更高版本部署,但前提是已停用 IP 许可名单功能。 | 没有可用的 README | 查看文档 | 无 | 查询 | 是 | 是 |
Slack 附件(API 令牌) | 将数据直接发送到 Slack 频道,并附带用户凭据。您可能还想参考 Lookerbot 文档,了解其他 Slack 功能。 | 在 GitHub 上查看 README | 查看文档 | 无 | 查询 | 否 | 否 |
Teams - 传入 Webhook | 使用传入的网络钩子将数据发送到 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 和 Explore 会根据交付目的地提供不同的格式设置选项。如需选择交付格式,请在调度工具的将数据格式化为部分中选择相应的图标。
如需了解每种格式如何传递到每个目的地,请参阅下表。
格式 | 电子邮件 | 网络钩子 | 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 文件附件形式提供的数据表格 |
触发递送
如果您要发送探索或一次性传送 Look,则不会看到此选项。
安排定期配送时,您可以通过以下两种方式触发配送:
指定数据组触发器
如果您要发送探索、一次性传送 Look,或者为周期性传送指定了重复间隔触发器,则不会看到此选项。
如需使用数据组触发器,请在调度程序的触发器部分中选择数据组更新。然后,从选择数据组下拉菜单中选择源数据组。
如需使用数据组触发器安排内容,内容所依据的模型文件需要包含数据组。Looker 会列出指定 Look 或信息中心图块中包含的模型中定义的所有数据组,即使这些数据组未用于处理查询或 PDT 的缓存也是如此。
基于数据组的时间表仅在完成对该数据组中所有持久性派生表 (PDT) 的重新生成流程后才会触发,以确保您的交付内容包含最新数据。
指定分发重复周期
如果您要发送探索、一次性传送 Look,或者为定期传送指定了数据组更新触发器,则不会看到此选项。
对于使用重复间隔的交付,您可以在交付此安排部分自定义安排的时间。在调度程序的触发器部分中,选择重复间隔。时间安排选项会根据您选择每天、每周、每月、每小时或每分钟而变化。您可以在高级选项部分调整安排的时区。
每小时和每分钟间隔的结束时间不包含在内。系统会在指定结束时间之前的最后一个所选间隔发送最后一封电子邮件。例如,如果内容安排在凌晨 12:00 至晚上 11:00 之间每小时发送一次,那么系统会从凌晨 12:00 开始,每小时在整点发送一次,直到晚上 10:00。如果内容安排在凌晨 12:00 至晚上 11:00 之间每分钟发送一次,那么在该时间范围内的最后一次发送时间将是晚上 10:30。
对交付内容应用过滤条件
如果您要交付包含过滤条件的 Look 或信息中心,可以修改过滤条件,进一步过滤交付的结果。
点击过滤条件,查看并修改与此 Look 或信息中心关联的过滤条件,以便进行数据递送。在调度程序中更改这些过滤条件选项不会更改 Look 或信息中心内的过滤条件。如果信息中心过滤条件需要过滤条件值,但安排的过滤条件为空,则安排在交付时不会显示任何结果。
如果您更改了作为 Look 或信息中心内的过滤条件的字段名称,请务必查看已安排的 Look 和信息中心的过滤条件部分,并根据需要更新过滤条件以反映您的更改。如果预定的内容交付包含不再起作用的过滤条件(例如,如果引用的字段已更改),则预定的交付可能会公开未经过滤的数据。
如需进一步自定义交付,您可以使用与用户属性匹配过滤条件选项(前提是 Looker 管理员已配置称为用户属性的用户专用值)。将过滤条件设置为上述任一属性后,系统会自动为每位用户自定义结果,这意味着即使您发送的是一次性交付,也可以向多位用户发送自定义结果。如需详细了解此功能,请参阅用户属性文档页面。
应用高级递送选项
高级选项部分可让您对递送进行更多自定义。点击高级选项旁边的箭头,以展开此菜单。可供选择的选项取决于所选的目标平台和交付格式,以及您要交付的是信息中心、Look 还是 Explore。下表中的链接指向对每种选项的说明,这些选项适用于将 Look 或探索结果传送至 Looker 的内置目标位置。向第三方集成平台交付内容时,可能需要使用一些独特的高级选项。
符合以下条件时发送此时间表:
对于定期传送的 Look,您可以自定义时间表,以便仅在满足特定条件时传送 Look 内容。提醒可为信息中心功能块提供类似的功能。
在在以下情况下发送此安排下拉菜单中,指定您希望仅在有结果时、仅在没有结果时还是在有结果或没有结果时传送 Look 内容。例如,您可以使用过滤条件来创建要监控的情况的条件,例如库存商品少于特定数量、支出超过特定值等,然后仅在达到该条件时投放内容。
您还可以指定仅当自上次发送数据传送后查询结果有变化时才进行传送,只需选中自上次运行后结果有变化旁边的复选框即可。如果您想使用所有结果 限制选项,则无法使用此选项。
限制
您可以为数据选择以下限制选项之一,以限制交付的大小:
- 以表格形式呈现结果:数据以单次交付的形式发送。
- 所有结果:系统会流式传输数据(如需了解详情,请参阅 Looker 中的所有行数限制是什么?最佳实践页面)。这对于大型数据集非常有用,因为它可以绕过文件大小、浏览器和内存限制。
如果您选择表中的结果,Looker 将遵循您在已保存的 Look 或探索中设置的任何行数限制。如果您选择所有结果,Looker 将返回查询的所有行,而无论已保存的 Look 设置如何,也无论 Looker 的常规 5,000 行限制如何。这对于检索非常大的数据集可能很有用,但您应谨慎使用,确保查询不会对数据库造成过大负担。
电子邮件的限制选项
发送 Look 和探索时,您可以限制电子邮件的大小,确保其不会超过电子邮件服务器的邮件大小限制。为数据选择以下一种限制选项:
- 表格中的结果:系统会发送数据,但行数上限为 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。结果将仅显示加利福尼亚州的一行。
此选项会考虑创建日程的用户所拥有的权限,以及添加到应发送给哪些人?文本字段中的电子邮件地址类型。
在某些情况下,以收件人身份运行时间表选项不可用:
- 当非管理员用户添加的电子邮件地址不是自己的地址时
- 当 Looker 管理员添加已停用用户的电子邮件地址时
- 当 Looker 管理员添加不属于 Looker 用户的电子邮件地址时(Looker 账号通过收件人旁边的 Looker 图标指示)
- 如果电子邮件地址是在选择以收件人身份运行安排选项之前添加的,则该选项会自动处于停用状态。如果从收件人列表中删除该电子邮件地址,则该电子邮件地址会再次变为可用状态。
- 如果电子邮件地址是在选择以收件人身份运行安排选项后添加的,那么添加该电子邮件地址会导致错误,并且该电子邮件地址会自动从应发送给哪些人?字段中移除。以收件人身份运行时间表选项将保持启用状态。
在特殊情况下,如果用户被列为已启用以收件人身份运行时间表的时间表的收件人,然后该用户的账号被停用,则时间表在下次运行时将无法向该停用的用户发送内容。如果该用户的账号被删除,整个日程将无法发送给任何收件人。Looker 管理员或拥有 see_schedules
权限的用户将能够在管理面板的调度程序历史记录页面中诊断此失败。
包含链接
如果 Looker 管理员已将 Looker 实例的电子邮件数据政策设置为发送链接和数据,调度程序将显示包含链接选项。选中此选项后,数据传送电子邮件中会包含一个返回 Looker 的链接,对于传送的 Look 和探索,该链接显示为“查看完整报告”;对于传送的信息中心,该链接显示为“查看完整信息中心”。
借助此链接,电子邮件收件人可以进一步探索相应 Looker 实例中的数据。收件人必须登录 Looker,并且有权访问所交付内容所基于的模型,才能在 Looker 中查看相应内容。如果您想要从数据传送电子邮件中移除此链接,请取消选中包含链接复选框。
格式选项
不使用可视化图表格式的交付内容具有其他交付选项,即应用可视化图表选项和格式化数据值。
应用可视化选项
此选项不适用于以可视化格式交付的 Look 或探索。
选择应用可视化选项,使数据传送结果看起来类似于表格图表。在图表、序列和格式菜单中为可视化图表配置的任何以下设置都将应用:
- 显示行号
- 隐藏总计
- 隐藏行总计
- 限制显示的行数:最多显示或隐藏 500 行
- 显示完整字段名称
- 每列的自定义标签(JSON - 详细信息,内嵌格式始终使用原始字段名称,而不是字段标签 - 如需详细了解 Looker 如何以 JSON 格式呈现字段,请参阅JSON 格式的更改社区帖子)
- 以 Excel 格式交付表格图表可视化的条件格式
只有在应用沿刻度规则的情况下,包含表格图表可视化的 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 社区帖子。