本页介绍了如何从 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(可视化图像)选项(适用于 Looker),请与您的 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 格式呈现字段,请参阅 Looker 社区中的 JSON 格式的变更帖子。
- 为以 Excel 格式下载的表格图表可视化内容添加条件格式
仅当应用了按比例调整规则时,在 Excel 提交的 Look 和探索中显示表格图表,条件格式才会显示。
部分可视化设置不会应用于下载的结果。例如:
- 自定义标题文字颜色和背景颜色不会应用于下载的结果(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 | 是 |
迪诺多 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 分析 | 是 |
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 购物中心 | 否 |
迪诺多 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 分析 | 是 |
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 | 是 |
从查询中移除所有排序
选择所有结果后,您可能还会看到从查询中移除所有排序选项。此选项可防止在下载结果之前对查询进行排序。选择此选项可能会加快下载速度,因为对某些类型的数据库进行排序可能会对性能造成不利影响。
数据透视结果不支持从查询中移除所有排序选项。
允许大型结果
在 Looker 中使用 Google BigQuery 作为数据库方言下载大型结果集时,如果您选择所有结果,则可能会看到允许大型结果选项。这是因为 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 将字段 labels 用作其 JSON 输出中的呈现值。如需详细了解 {looker_name_short}} 如何呈现 JSON 格式的字段,请参阅 Looker 社区中的 JSON 格式的变更帖子。
- 针对以 Excel 格式下载表格图表可视化内容的条件格式。
仅当应用了 Along a scale Rule(缩放比例规则)时,条件格式才会以 Excel 格式显示在带有表格图表的下载内容中。
如果查询包含以下任何元素,则已手动重新排列的表格图表中的列将在下载内容中按原始顺序显示:
如果您选择如数据表格中所示,系统将不会应用可视化选项,并且下载内容将像 Look 或探索的数据部分的数据表格一样。
数据值
在数据值部分,选择您希望下载的结果的显示方式:
- 如果您选择格式化,数据的显示方式将更类似于 Looker 中的探索体验,但并非所有文件格式都支持某些功能(例如关联)。
- 如果您选择无格式,Looker 不会对结果应用任何特殊格式(例如对长串数字取整或添加 Looker 开发者可能设置的特殊字符)。将数据输送到另一个工具进行处理时,通常建议采用此做法。
要包含的行数和列数
您可以在此部分指定下载内容中包含多少数据。在大多数图块中,下载弹出式窗口的这一部分名为 Number of rows to include;如果并列查询包含任何透视维度,则该部分将被命名为要包含的行数和列数。您可以选择以下选项:
- 当前结果表:由图块底层数据表的行数限制和列数上限(如果图块查询包含至少一个透视维度)指定的行数。
- 所有结果:功能块查询返回的所有结果,即使功能块的数据表指定了限制更为严格的行数上限或列数上限,也是如此。选择此选项之前,请参阅本页面中的使用“所有结果”或“自定义”选项时的注意事项部分。没有
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
权限),请访问角色文档页面。
对于包含多行表格可视化图表的信息中心,为了缩短其 PDF 下载的呈现时间,Looker 管理员可以启用呈现长表实验室功能。