本页面介绍了如何从 Looker 下载内容(可视化图表或数据)。
如需下载内容,您必须获得 Looker 管理员为您授予的 download_with_limit
或 download_without_limit
权限。
根据您是通过Look 或探索、信息中心还是合并的结果查询下载,下载内容以及设置下载内容的格式选项会有所不同。
从 Look 或探索中下载数据
如需从 Look 或“探索”页面下载数据,请选择右上角的齿轮菜单,然后选择下载。
Looker 会显示下载窗口,您可以在其中为下载内容命名并设置格式。
以下部分将引导您完成下载窗口中的每个字段:
格式
如果下载到使用渲染程序的格式(PNG 和 PDF),系统将使用生产模式中的结果。如果您的下载内容采用其他格式,下载内容将显示您所处开发模式或正式版模式的结果。
您可以采用以下格式从 Look 和探索中下载数据:
- TXT(制表符分隔值)
- Excel 电子表格(Excel 2007 或更高版本)
- CSV
- JSON
- HTML
- Markdown
- PNG(可视化图片)
在选择数据下载格式时,如果您没有看到 HTML 或 PNG(可视化图片)选项(适用于 Look),请与您的 Looker 管理员联系,了解如何为您的 Looker 实例安装适当版本的 Chromium 渲染程序。
对于 JSON 格式,Looker 会在 JSON 输出中使用字段 labels 作为其呈现的值。如需详细了解 Looker 如何以 JSON 格式呈现字段,请参阅 JSON 格式更改社区帖子。
转置表格仅以 PNG 下载格式呈现。
对于 Looker 开发者,如果您处于开发模式,则大多数文件格式的数据下载都会查询处于开发模式的模型。PDF 和 PNG 文件格式除外;采用这些文件格式下载的数据会始终像在生产模式下一样查询您的模型。
文件名
您可以输入下载文件名,也可以使用预先填充在该字段中的默认文件名。Looker 会根据您在格式字段中的选择自动附加适当的文件扩展名。
结果
在结果部分,选择是否要将可视化设置应用于下载的 TXT、Excel、CSV、JSON、HTML 或 Markdown 数据。
如果您选择应用可视化选项,Looker 会将某些可视化设置应用于您的下载内容。在图表、系列和格式设置菜单中,为可视化图表配置的任意以下设置都将应用于数据下载:
- 显示行号
- 显示总计
- 显示行总计
- 限制显示的行数,最多可显示或隐藏 500 行
- 显示完整字段名称
- 每列的自定义标签(Looker 将字段 labels 用作其 JSON 输出中的呈现值。如需详细了解 Looker 如何以 JSON 格式呈现字段,请参阅 JSON 格式变更 Looker 社区帖子。
- 为以 Excel 格式下载的表格图表可视化内容添加条件格式
只有在应用沿比例规则后,条件格式才会显示在包含表格图表可视化的“探索”和“探索”的 Excel 传送内容中。
某些可视化图表设置不会应用于下载的结果。例如:
- 自定义标题文本颜色和背景颜色不会应用于下载的结果,但 PNG 文件除外。
- 对于包含数据透视表和多个测量的结果表格,每个数据透视表值都会在各列中重复,而不是表示为一个合并的列。HTML 和 PNG 下载内容除外,因此合并后的列会保留。
- 如果您从信息中心下载,则下载的结果中不会包含信息中心图块标题。
- 总计和行总计值包含在下载的结果中,但相应的行和列没有标签。
- 系统不会为无法流式传输的查询下载小计。
如果查询包含以下任一元素,则表格图表中手动重新排列的列将以原始顺序显示在下载内容中:
- 有意从可视化图表中隐藏的字段
存在于底层 SQL 中,但不在可视化图表中的字段,例如:
- 可视化图表中显示的一个维度,其中包含一个
link
参数,该参数引用了可视化图表中不存在的其他字段。 - 使用
case
参数的字段。 - 可视化图表中显示的某个维度引用了另一个字段,该字段带有
{{ field_name._value }} Liquid variable syntax
,但该维度在可视化图表中不存在。
- 可视化图表中显示的一个维度,其中包含一个
启用了维度填充的一个或多个字段
三个或更多透视字段
行总计已启用
字段定义中包含
order_by_field
LookML 参数的一个或多个字段
如果您选择如数据表格中所示,系统不会应用可视化选项,并且下载内容将像 Look 或探索的数据部分的数据表格一样。
数据值
在数据值部分中,选择您希望下载的查询结果的显示方式:
- 如果您选择无格式,Looker 就不会对查询结果应用任何特殊格式,例如对长数字进行四舍五入,或添加 Looker 开发者可能设置的特殊字符。将数据输送到另一个工具进行处理时,通常建议采用此做法。
- 如果您选择格式化,数据的外观将类似于 Looker 中的探索体验,但并非所有文件类型都支持某些功能(例如关联)。例如,通过
html
参数应用的任何格式设置都不会应用于 TXT、CSV、Excel 或 JSON 下载内容。
要包含的行数和列数
您可以按如下方式选择要下载的数据量:
- 当前结果表:内容的行数限制指定的行数。
- 所有结果:查询返回的所有结果。在选择此选项之前,请参阅本页面上的所有结果部分。
- 自定义:自定义行数。拥有
download_with_limit
权限的用户最多只能包含 5,000 行。其他用户的上限通常为 10 万。
所有结果
当您在 Look 或“探索”中选择运行时,Looker 会检查您的权限,并确定查询和数据库方言的复杂性是否允许下载整个查询。如果您拥有相应权限(针对超出设定上限的结果),并且 Looker 确定可以下载您的整个查询,下载窗口中就会显示所有结果选项。
对于执行以下任一操作的查询,所有结果选项通常处于停用状态:
即使所有结果选项可用,您在下载所有结果时仍应格外小心。有些查询非常庞大,包含数千或数百万行,这可能会使大多数电子表格程序甚至 Looker 实例超负荷。
如果所有结果选项不可用,您可以使用自定义选项指定您的权限允许的最大行数。
流式传输查询结果
流式处理是指 Looker 分块处理数据的功能,而不是一次性处理所有数据。如果 Looker 可以流式传输结果集,则可以无限下载。所有结果选项依赖于 Looker 能够流式传输结果,如果无法流式传输结果,则所有结果将不可用。
除了格式限制之外,在两种情况下无法进行流式传输:
- 表计算:表计算无法流式传输。因此,要下载无限量的查询结果,必须从查询中移除表计算。
- 数据库限制:如果查询中包含数据透视,则部分数据库无法进行流式传输。对于这些数据库,您必须移除数据透视才能下载无限量的结果。某些数据库无法流式传输任何结果,这意味着无法无限制下载。
以下数据库支持流式传输:
方言 | 是否支持? |
---|---|
阿克蒂安雪崩 | 是 |
Amazon Athena | 是 |
Amazon Aurora MySQL | 是 |
Amazon Redshift | 是 |
Apache Druid | 否 |
Apache Druid 0.13 及更高版本 | 否 |
Apache Druid 0.18 及更高版本 | 否 |
Apache Hive 2.3 及更高版本 | 是 |
Apache Hive 3.1.2 及更高版本 | 是 |
Apache Spark 3 及更高版本 | 是 |
ClickHouse | 是 |
Cloudera Impala 3.1 及更高版本 | 是 |
带有原生驱动程序的 Cloudera Impala 3.1+ | 是 |
使用原生驱动程序的 Cloudera Impala | 是 |
DataVirtuality | 是 |
Databricks | 是 |
Denodo 7 | 是 |
Denodo 8 | 是 |
Dremio | 是 |
Dremio 11+ | 是 |
Exasol | 是 |
Firebolt | 是 |
Google BigQuery 旧版 SQL | 是 |
Google BigQuery 标准 SQL | 是 |
Google Cloud PostgreSQL | 是 |
Google Cloud SQL | 是 |
Google Spanner | 否 |
Greenplum | 是 |
HyperSQL | 否 |
IBM Netezza | 否 |
MariaDB | 是 |
Microsoft Azure PostgreSQL | 是 |
Microsoft Azure SQL 数据库 | 是 |
Microsoft Azure Synapse Analytics | 是 |
Microsoft SQL Server 2008 及更高版本 | 是 |
Microsoft SQL Server 2012 及更高版本 | 是 |
Microsoft SQL Server 2016 | 是 |
Microsoft SQL Server 2017 及更高版本 | 是 |
MongoBI | 是 |
MySQL | 是 |
MySQL 8.0.12 及更高版本 | 是 |
Oracle | 是 |
Oracle ADWC | 是 |
PostgreSQL 9.5 及更高版本 | 是 |
PostgreSQL 9.5 之前的版本 | 是 |
PrestoDB | 是 |
PrestoSQL | 是 |
SAP HANA 2+ | 否 |
SingleStore | 是 |
SingleStore 7+ | 是 |
Snowflake | 是 |
TeraData | 是 |
Trino | 是 |
矢量 | 是 |
Vertica | 是 |
以下数据库支持应用了数据透视的流式传输:
方言 | 是否支持? |
---|---|
阿克蒂安雪崩 | 是 |
Amazon Athena | 是 |
Amazon Aurora MySQL | 否 |
Amazon Redshift | 是 |
Apache Druid | 否 |
Apache Druid 0.13 及更高版本 | 否 |
Apache Druid 0.18 及更高版本 | 否 |
Apache Hive 2.3 及更高版本 | 否 |
Apache Hive 3.1.2 及更高版本 | 否 |
Apache Spark 3 及更高版本 | 是 |
ClickHouse | 否 |
Cloudera Impala 3.1 及更高版本 | 是 |
带有原生驱动程序的 Cloudera Impala 3.1+ | 是 |
使用原生驱动程序的 Cloudera Impala | 是 |
DataVirtuality | 否 |
Databricks | 是 |
Denodo 7 | 否 |
Denodo 8 | 否 |
Dremio | 否 |
Dremio 11+ | 否 |
Exasol | 是 |
Firebolt | 是 |
Google BigQuery 旧版 SQL | 是 |
Google BigQuery 标准 SQL | 是 |
Google Cloud PostgreSQL | 是 |
Google Cloud SQL | 否 |
Google Spanner | 否 |
Greenplum | 是 |
HyperSQL | 否 |
IBM Netezza | 是 |
MariaDB | 否 |
Microsoft Azure PostgreSQL | 是 |
Microsoft Azure SQL 数据库 | 是 |
Microsoft Azure Synapse Analytics | 是 |
Microsoft SQL Server 2008 及更高版本 | 是 |
Microsoft SQL Server 2012 及更高版本 | 是 |
Microsoft SQL Server 2016 | 是 |
Microsoft SQL Server 2017 及更高版本 | 是 |
MongoBI | 否 |
MySQL | 否 |
MySQL 8.0.12 及更高版本 | 否 |
Oracle | 是 |
Oracle ADWC | 是 |
PostgreSQL 9.5 及更高版本 | 是 |
PostgreSQL 9.5 之前的版本 | 是 |
PrestoDB | 是 |
PrestoSQL | 是 |
SAP HANA 2+ | 否 |
SingleStore | 是 |
SingleStore 7+ | 是 |
Snowflake | 是 |
TeraData | 是 |
Trino | 是 |
矢量 | 是 |
Vertica | 是 |
从查询中移除所有排序
选择所有结果后,您可能还会看到从查询中移除所有排序选项。此选项可防止在下载结果之前对查询进行排序。选择此选项可能会加快下载速度,因为对某些类型的数据库进行排序可能会对性能造成不利影响。
透视结果不支持从查询中移除所有排序选项。
允许大型结果
使用 Google BigQuery 作为数据库方言在 Looker 中下载大型结果集并选择所有结果时,您可能会看到允许大型结果选项。这是因为 Google BigQuery 对查询结果设置了响应大小上限,如 Write query results Google Cloud 文档主题中所述。若要下载超出 BigQuery 响应大小上限的结果,Looker 必须执行其他流程。
如果您选择允许大型结果,下载流程将受到以下影响:
- 查询的
allowLargeResults
BigQuery 选项设置为true
。 - 查询中的
ORDER BY
子句会被移除。 - 该查询将写入 PDT 临时架构,并且需要有写入此架构的权限。
- 查询结果将在随机表名称下存储在此临时暂存架构中一小时。
下载或在浏览器中打开
选好选项后,您可以选择下载按钮将文件下载到您的计算机中,或者选择在浏览器中打开以在浏览器中查看文件。
从合并的结果查询中下载数据
如需下载合并后的结果查询,您可以将查询保存到信息中心,然后将信息中心下载为 PDF 文件或 CSV 文件集。但是,您必须下载整个信息中心 - 您不能仅从基于合并结果查询的单个图块下载数据。
从信息中心下载数据
如需下载整个信息中心,请从信息中心的三点状菜单
中选择下载。系统随即会打开一个对话框,供您选择 PDF 或 CSV 作为下载格式。
以 PDF 格式下载信息中心
您可以将整个信息中心下载为 PDF 文件,这意味着您将获得一个 PDF 文件,其中会显示信息中心标题、所有信息中心过滤条件、部分或全部信息中心图块,以及信息中心运行所在的时区。PDF 文件还会包含一个时间戳,显示信息中心的下载时间。
以 PDF 格式下载时,模型始终会像处于生产模式时一样从模型返回数据,即使您处于开发模式也是如此。
如需将信息中心下载为 PDF 文件,请按以下步骤操作:
- 从格式下拉菜单中选择 PDF。
从纸张大小下拉菜单中选择一个选项:
将页面调整为适合信息中心选项是默认选项;它会将 PDF 的大小调整为信息中心的默认宽度(1260 像素)。其他纸张大小选项会将 PDF 的大小调整为与标准纸张大小相符,并使信息中心的全部或部分内容都适合在其中显示。根据信息中心的布局和所选的纸张大小,在 Looker 中查看时,某些 PDF 输出可能与信息中心布局有所不同。例如,如果所选的纸张大小比信息中心窄,您可能会遇到间距或其他格式问题,需要进行一些调整:
- 大型可视化图表或一组重叠的图块可能需要调整大小,才能放入 PDF 中。
- 包含表格的功能块在 PDF 中可能不会显示所有表格列。
- 功能块的宽度可能会缩小,以适应 PDF 文件。同样,Looker 应用中需要滚动的功能块可能不会展开即可显示所有内容。
如果您没有看到纸张大小选项,请与您的 Looker 管理员联系,让其为您的 Looker 实例安装最新版本的 Chromium 呈现引擎。
如果您在纸张大小下拉菜单中选择的不是将页面调整为适合信息中心,系统会显示方向选项。您可以选择将信息中心的方向设为纵向或横向。
选择或取消选择展开表以显示所有行。如果您选择此选项,对于使用表格可视化图表的信息中心图块,PDF 会显示可视化图表中的所有可用行,而不仅仅是信息中心图块缩略图中显示的行。如果您没有选择此选项,则 PDF 中只会显示缩略图中无需滚动即可看到的行。信息中心和查询过滤条件、可视化设置(例如行数上限、列数上限)以及使用限制显示的行数选项进行的设置仍然适用。
如果选择了展开表格以显示所有行选项,则包含表格可视化图表的信息中心图块在下载的 PDF 文件中可能与在 Looker 中看起来略有不同。PDF 文件中可能会出现以下明显差异:
- 对背景颜色和字体大小的自定义设置已从列标题和小计行中移除。
- 如果未设置任何自定义主题,Tables 将采用白色主题。否则,系统会在下载时应用自定义主题。
- 未手动排序的数据透视表不会显示排序图标。
- 启用了将列调整为合适大小的表格会拉伸至图块的全宽。
此外,如果表格包含的单元格数超过 20,000,则 PDF 文件可能会存在以下明显差异:
如果您没有看到展开表格以显示所有行选项,请与您的 Looker 管理员联系,了解如何为您的 Looker 实例安装适当版本的 Chromium 渲染程序。
选中或保持未选中状态将信息中心图块排列在一列中。如果您选择此选项,PDF 会在单个垂直列中显示信息中心图块。如果您没有选择此选项,数字面板板块会按照其在数字面板中的排列方式显示。
选择在浏览器中打开,即可在浏览器的新标签页中查看 PDF 的图片。在该页面中,您可以选择使用浏览器的控件下载 PDF 文件。
如果您不想再下载信息中心,请选择取消。
选择下载以开始下载。您的浏览器会打开一个新标签页,显示下载状态。
以 CSV 格式下载信息中心
您可以从信息中心下载所有查询图块的 CSV 压缩文件集合。ZIP 文件不包含文本功能块。如需将信息中心下载为一系列 CSV 文件,请按以下步骤操作:
- 从格式下拉菜单中选择 CSV。
- 如果您不想再下载信息中心,请选择取消。
- 选择下载,开始下载压缩的 CSV 集合。
当您将信息中心下载为 CSV 文件时,您无法设置下载内容的格式选项,例如设置自定义行数上限或选择所有结果。下载的文件中的行数限制与相应图块的行数限制相关。
Looker 使用 UTF-8 编码生成压缩文件。如果 CSV 文件名中的字符显示为乱码,可能是因为 Looker 的 UTF-8 编码与您计算机操作系统或第三方应用的默认编码方式存在冲突。Looker 建议您使用能够识别 UTF-8 的文件提取器(例如 7-Zip),并确保所有第三方应用都配置为支持 UTF-8。
从仪表板功能块下载数据
您无法根据合并结果查询从信息中心图块下载数据,但如果您以 PDF 格式下载信息中心或下载 CSV 文件的集合,则合并结果图块中的数据将会包含在内。
如需从信息中心图块下载数据,请选择图块上的三点状图标,然后选择下载数据:
系统会打开一个对话框,其中包含与 Look 或探索类似的选项。展开高级数据选项菜单,查看可供下载的所有选项:
格式
您可以采用以下格式从信息中心功能块下载数据:
- TXT(制表符分隔值)
- Excel 电子表格(Excel 2007 或更高版本)
- CSV
- JSON
- HTML
- Markdown
- PNG(可视化图片)
根据您选择的格式,高级数据选项菜单中的某些选项可能无法使用。
如果缺少 HTML 或 PNG(可视化图片)选项,请与您的 Looker 管理员联系,了解如何为 Looker 实例安装适当版本的 Chromium 渲染程序。
对于 JSON 格式,Looker 会在 JSON 输出中使用字段 labels 作为其呈现的值。如需详细了解 Looker 如何以 JSON 格式呈现字段,请参阅 JSON 格式更改社区帖子。
转置表格可视化图表仅在 PDF 和 PNG 下载内容中呈现。
下载 PNG 格式的文件始终会像在生产模式下一样从模型返回数据,即使您处于开发模式也是如此。
结果
在结果部分,选择是否要对数据下载应用可视化设置:
如果您选择应用可视化选项,Looker 会将某些可视化设置应用于您的下载内容。为可视化图表配置的图表、系列和格式设置菜单中的以下任何设置都将应用于数据下载:
- 显示行号
- 隐藏总计
- 隐藏行总计
- 限制显示的行数:最多可显示或隐藏 500 行。
- 显示完整字段名称
- 每个列的自定义标签(Looker 会在 JSON 输出中使用 labels 字段作为其呈现的值。如需详细了解 {looker_name_short}} 如何呈现 JSON 格式的字段,请参阅 Looker 社区中的 JSON 格式的变更帖子。
- 条件格式:用于下载 Excel 格式的表格图表。
只有在应用沿比例尺规则后,条件格式才会以 Excel 格式显示在下载内容中,并带有表格图表可视化结果。
如果查询包含以下任何元素,则已手动重新排列的表格图表中的列将在下载内容中按原始顺序显示:
- 一个或多个表计算
- 一个或多个从可视化图表中隐藏的字段
- 启用了维度填充的一个或多个字段
- 三个或更多透视字段
- 已启用行总计
如果您选择如数据表格中所示,系统将不会应用可视化选项,并且下载内容将像 Look 或探索的数据部分的数据表格一样。
数据值
在数据值部分,选择您希望下载的结果的显示方式:
- 如果您选择已设置格式,相应数据看起来会更类似于 Looker 中的探索体验,不过部分文件格式可能不支持某些功能(例如链接)。
- 如果您选择无格式,Looker 将不会对结果应用任何特殊格式,例如对长数字进行四舍五入,或添加 Looker 开发者可能设置的特殊字符。将数据输送到另一个工具进行处理时,通常建议采用此做法。
要包含的行数和列数
您可以在此部分指定下载内容中包含多少数据。在大多数图块中,下载弹出式窗口的此部分名为要包含的行数;如果图块查询包含任何经过汇总的维度,此部分名为要包含的行数和列数。您的选项包括:
- 当前结果表:功能块底层数据表的行数(如果功能块查询包含至少一个转换的维度,则还包括列数)由行数限制指定。
- 所有结果:功能块查询返回的所有结果,即使功能块的数据表指定了限制更为严格的行数上限或列数上限,也是如此。在选择此选项之前,请参阅本页上的使用“所有结果”或“自定义”选项时的注意事项部分。没有
download_without_limit
权限的用户无法看到此选项。 - 自定义:要下载的行数(自定义)。拥有
download_with_limit
权限的用户最多只能包含 5,000 行。其他用户的上限通常为 10 万,除非您的 Looker 管理员提高了此上限(请参阅旧版功能:允许无限下载(Looker 4.14 及更高版本)社区帖子)。
使用“所有结果”或“自定义”选项时的注意事项
Looker 会检查您的权限,并确定查询的复杂性和数据库方言是否允许下载整个查询。如果您有权下载超过设定限制的结果,并且 Looker 确定您的整个查询可以下载,则下载窗口中将显示所有结果选项。
通常,对于存在以下情况的查询,系统会停用所有结果选项:
即使所有结果选项可用,您在下载所有结果时仍应谨慎小心。有些查询非常庞大,包含数千或数百万行,这可能会使大多数电子表格程序甚至 Looker 实例超负荷。
如果所有结果选项不可用,您可以使用自定义选项指定您的权限所允许的最大行数。选择自定义时,您可以指定要下载的结果行数。如果您的查询包含任何透视维度,您还可以指定要下载的列数。
对于管理员:为 Looker 实例启用数据下载功能
某些下载选项要求客户托管的 Looker 部署的管理员安装相应版本的 Chromium 渲染程序。如果您的实例由 Looker 托管,则 Chromium 已安装。
管理商家用户功能文档页面提供了有关下载流程的重要管理员信息:
如需详细了解为使用户能够下载而必须获得的权限(特别是 download_with_limit
和 download_without_limit
权限),请访问角色文档页面。