本页面介绍了如何从 Looker 下载内容(可视化图表或数据)。
如需下载内容,您必须获得 Looker 管理员的 download_with_limit
或 download_without_limit
权限。
下载内容和下载内容的格式设置流程和选项取决于您是从 Look 或探索、从信息中心还是通过合并结果查询下载。
从 Look 或探索中下载数据
如需从 Look 或“探索”页面中下载数据,请选择右上角的齿轮菜单,然后选择下载。
Looker 会显示下载窗口,您可以在其中为下载内容命名并设置格式。
以下部分将逐步介绍 Download 窗口中的各个字段:
形式
如果要下载使用渲染程序的格式(PNG 和 PDF),将使用生产模式下的结果。如果您的下载内容是其他格式,则下载内容会显示您当前所处的任何模式(开发或正式版)的结果。
您可以通过以下文件格式从 Look 和探索中下载数据:
- TXT(制表符分隔值)
- Excel 电子表格(Excel 2007 或更高版本)
- CSV
- JSON
- HTML
- Markdown
- PNG(可视化图片)
在选择下载数据格式时,如果您没有看到 HTML 或 PNG(可视化图片)选项(适用于 Look),请与您的 Looker 管理员联系,了解如何为您的 Looker 实例安装相应版本的 Chromium 渲染程序。
对于 JSON 格式,Looker 将字段 labels 用作其 JSON 输出中的呈现值。如需详细了解 Looker 如何以 JSON 格式呈现字段,请参阅 JSON 格式变更社区帖子。
转置表格只会以 PNG 下载内容呈现。
对于 Looker 开发者来说,如果您处于开发模式,那么大多数文件格式的数据下载都会像在开发模式下查询模型一样。PDF 和 PNG 文件格式除外;以这些文件格式下载的数据始终会像在生产模式下查询模型一样查询模型。
文件名
您可以为要下载的项输入文件名,也可以使用字段中预填充的默认文件名。Looker 会根据您在格式字段中的选择自动附加适当的文件扩展名。
结果
在 Results 部分,选择是将可视化设置应用于 TXT、Excel、CSV、JSON、HTML 还是 Markdown 数据下载。
如果您选择已应用可视化选项,Looker 会将某些可视化设置应用于您的下载内容。图表、系列和格式设置菜单中为可视化图表配置的任何以下设置都将应用于数据下载:
- 显示行号
- 显示总计
- 显示行总计
- 显示或隐藏的行数限制:显示或隐藏的行数上限为 500
- 显示完整字段名称
- 每列的自定义标签(Looker 将字段 labels 用作其 JSON 输出中的呈现值。如需详细了解 Looker 如何以 JSON 格式呈现字段,请参阅 JSON 格式变更 Looker 社区帖子。
- 条件格式,用于以 Excel 格式下载表格图表
对于采用表格图表可视化内容的 Look 和探索的 Excel 提交内容,只有在应用了“沿袭”缩放规则的情况下,系统才会显示条件格式。
某些可视化设置不适用于下载的结果。例如:
- 自定义标题文本颜色和背景颜色不适用于下载的结果(PNG 文件除外)。
- 对于包含数据透视和多个测量的结果表,每个数据透视值会在多个列中重复,而不是表示为一个合并列。HTML 和 PNG 下载属于例外情况,因此会保留合并的列。
- 从信息中心下载内容时,下载的结果中不会包含信息中心图块标题。
- 下载的结果中包含总计和行总计值,但未标记相应的行和列。
如果查询包含以下任何元素,那么表格图表中已经过手动重新排列的列将在下载内容中按原始顺序显示:
- 被故意在可视化图表中隐藏的字段
存在于底层 SQL 中,但未在可视化图表中显示的字段,例如:
- 可视化图表中显示的维度,其中包含一个
link
参数,该参数引用了可视化图表中不存在的另一个字段。 - 使用
case
参数的字段。 - 可视化图表中引用了另一个字段的维度,该维度在可视化图表中不存在
{{ field_name._value }} Liquid variable syntax
。
- 可视化图表中显示的维度,其中包含一个
启用了维度填充功能的一个或多个字段
3 个或更多透视字段
已启用行总计
在字段定义中包含
order_by_field
LookML 参数的一个或多个字段
如果您选择按数据表中的格式显示,系统不会应用可视化选项,并且下载内容在 Look 或探索的数据部分会显示为数据表。
数据值
在数据值部分中,选择所下载查询结果的显示方式:
- 如果您选择未设置格式,Looker 不会对查询结果应用任何特殊格式,例如对长串数字四舍五入或添加 Looker 开发者可能已设置的特殊字符。将数据输送到另一个工具进行处理时,通常建议采用此做法。
- 如果您选择设置了格式,则数据的外观将与 Looker 中的探索体验类似,但某些功能(例如关联)并非在所有文件类型中受支持。例如,使用
html
参数应用的任何格式设置都不会应用于 TXT、CSV、Excel 或 JSON 下载内容。
要包含的行数和列数
您可以按以下步骤选择要下载的数据量:
- 当前结果表:内容的行数限制指定的行数。
- 所有结果:查询返回的所有结果。在选择此选项之前,请先查看本页面中的所有结果部分。
- 自定义:自定义的行数。拥有
download_with_limit
权限的用户最多可以有 5,000 行。其他用户的邀请数量上限一般为 10 万人。
所有结果
当您在 Look 或探索中选择运行 (Run) 后,Looker 会检查您的权限,并确定是否允许下载整个查询,因为查询的复杂程度和数据库方言不会受到影响。如果您拥有相关权限(即超出所设上限的结果),并且 Looker 确定您的整个查询可供下载,那么下载窗口中将提供所有结果选项。
对于执行以下任一操作的查询,所有结果选项通常处于停用状态:
- 涉及行总计或表格计算
- 使用占总数的百分比、与上一个总数的百分比或运行总计类型的测量
- 从无法流式传输结果的数据库方言中检索数据
- 包含 Looker 会计算的数据透视列,因为数据来自无法计算数据透视的数据库方言
即使提供了所有结果选项,您在下载所有结果时仍应谨慎。有些查询非常庞大,包含数千行或数百万行,可能会让大多数电子表格程序(甚至 Looker 实例)负载过重。
如果所有结果选项不可用,您可以使用自定义选项指定您权限所允许的最大行数。
流式查询结果
流式处理是指 Looker 以块的形式处理数据,而不是一次性处理所有数据。如果 Looker 可以流式传输结果集,则可以无限量下载。所有结果选项依赖于 Looker 流式传输结果的功能,如果无法流式传输结果,则系统不会提供所有结果。
Looker 会将下载的结果流式传输为除呈现格式(HTML、PNG)之外的所有格式。
除了格式限制之外,无法进行流式传输的两种情况还包括:
- 表计算:无法流式传输表计算。因此,要想下载无限量的查询结果,您必须从查询中移除表计算。
- 数据库限制:如果查询中包含数据透视,则某些数据库无法流式传输。对于这些数据库,您必须移除数据透视才能下载任意数量的结果。某些数据库无法流式传输任何结果,这意味着无法进行无限量下载。
以下数据库支持流式传输:
方言 | 是否支持? |
---|---|
艾克蒂安雪崩 | 是 |
Amazon Athena | 是 |
Amazon Aurora MySQL | 是 |
Amazon Redshift | 是 |
阿帕奇·德鲁伊 | 否 |
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 11 及更高版本 | 是 |
Exasol | 是 |
火箭 | 是 |
Google BigQuery 旧版 SQL | 是 |
Google BigQuery 标准 SQL | 是 |
Google Cloud PostgreSQL | 是 |
Google Cloud SQL | 是 |
Google Spanner | 否 |
绿紫红 | 是 |
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 | 否 |
SAP HANA 2 及更高版本 | 否 |
SingleStore | 是 |
SingleStore 7 或更高版本 | 是 |
Snowflake | 是 |
Teradata | 是 |
Trino | 是 |
矢量 | 是 |
Vertica | 是 |
下面列出了支持流式传输并应用数据透视的数据库:
方言 | 是否支持? |
---|---|
艾克蒂安雪崩 | 是 |
Amazon Athena | 是 |
Amazon Aurora MySQL | 否 |
Amazon Redshift | 是 |
阿帕奇·德鲁伊 | 否 |
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 11 及更高版本 | 否 |
Exasol | 是 |
火箭 | 是 |
Google BigQuery 旧版 SQL | 是 |
Google BigQuery 标准 SQL | 是 |
Google Cloud PostgreSQL | 是 |
Google Cloud SQL | 否 |
Google Spanner | 否 |
绿紫红 | 是 |
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 | 否 |
SAP HANA 2 及更高版本 | 否 |
SingleStore | 是 |
SingleStore 7 或更高版本 | 是 |
Snowflake | 是 |
Teradata | 是 |
Trino | 是 |
矢量 | 是 |
Vertica | 是 |
从查询中移除所有排序
选择所有结果后,您可能还会看到从查询中移除所有排序选项。使用此选项可防止在下载结果之前对查询进行排序。选择此选项可能会加快下载速度,因为对于某些数据库类型,对查询进行排序可能会降低性能。
透视结果不支持从查询中移除所有排序选项。
允许大型结果
如果您在 Looker 中使用 Google BigQuery 作为数据库方言下载大型结果集,并选择所有结果,您可能会看到允许大型结果选项。这是因为 Google BigQuery 对查询结果有响应大小上限,如 Google Cloud 文档主题中的写入查询结果部分所述。如需下载超出 BigQuery 响应大小上限的结果,Looker 必须执行不同的流程。
如果您选择允许大型结果,则下载过程会受到以下影响:
- 查询的
allowLargeResults
BigQuery 选项设置为true
。 - 查询中的
ORDER BY
子句已被移除。 - 查询将写入 PDT 临时架构,并且需要有写入权限。
- 查询结果会在随机表名称下的此临时暂存架构中存储一小时。
下载或在浏览器中打开
选中选项后,您便可以选择下载按钮将文件下载到计算机,或选择在浏览器中打开,以在浏览器中查看文件。
从合并结果查询下载数据
如需下载合并后的结果查询,您可以将查询保存到信息中心,然后以 PDF 或 CSV 文件集合的形式下载信息中心。但是,您必须下载整个信息中心,您无法仅从基于合并结果查询的单个功能块下载数据。
从信息中心下载数据
如需下载整个信息中心,请从信息中心的三点状菜单中选择下载。
系统会打开一个对话框,供您选择 PDF 或 CSV 作为下载格式。
以 PDF 格式下载信息中心
下载的 PDF 文件可能与 Looker 中信息中心的布局或大小不完全一致。
您可以将整个信息中心下载为 PDF 文件,这意味着您获取的是一个 PDF 文件,其中会显示信息中心标题、任何信息中心过滤条件、部分或全部信息中心图块,以及运行信息中心的时区。PDF 文件还包含时间戳,用于指明信息中心的下载时间。
PDF 格式的下载内容始终会从模型返回数据,就像在生产模式下一样,即使您处于开发模式也是如此。
要下载 PDF 格式的信息中心,请按以下步骤操作:
- 从格式下拉菜单中选择 PDF。
从纸张大小下拉菜单中选择一个选项:
“调整页面以适合信息中心”选项为默认选项;它会将 PDF 的大小调整为信息中心的默认宽度(1260 像素)。其他纸张大小选项可调整 PDF 以与标准纸张大小一致,使其能够容纳整个或部分信息中心。在 Looker 中查看时,部分 PDF 输出可能与信息中心布局有所不同,具体取决于信息中心的布局和所选的纸张大小。例如,如果所选纸张尺寸比信息中心窄,您可能会遇到间距或其他格式问题,因而需要做一些调整:
- 对于大型可视化图表或多组重叠的图块,可能需要调整尺寸以适应 PDF。
- 包含表格的图块可能不会显示 PDF 中的所有表格列。
- 系统可能会缩小图块的宽度以适应 PDF。同样,在 Looker 应用中需要滚动的图块可能不会展开即可显示所有内容。
如果您没有看到 Paper Size(纸张大小)选项,请与您的 Looker 管理员联系,了解如何为您的 Looker 实例安装最新版本的 Chromium 渲染程序。
如果您在纸张大小下拉菜单中选择了适合信息中心页面以外的设置,则系统会显示方向选项。您可以选择将信息中心的方向设为纵向或横向。
选择或保留展开表格以显示所有行复选框。如果您选择此选项,对于使用表格可视化图表的信息中心图块,PDF 将显示表格可视化图表中提供的所有行,而不仅仅是在信息中心图块缩略图中显示的行。如果您未选择此选项,那么 PDF 中只会显示缩略图中无需滚动即可看到的行。信息中心和查询过滤条件以及行数上限、列数上限和使用限制显示的行数选项进行的设置等可视化设置仍然适用。
如果选择了展开表格以显示所有行选项,则包含表格可视化图表的信息中心图块在下载的 PDF 中看起来可能会与在 Looker 中看起来略有不同。在 PDF 中,可能会明显存在以下差异:
- 从列标题和小计行中移除了背景颜色和字体大小的自定义设置。
- 如果未设置自定义主题,表格将以白色主题显示。否则,系统会在下载时应用自定义主题。
- 对于未手动排序的数据透视表,系统不会显示排序图标。
- 启用了将列调整为合适大小的表会拉伸至图块的全宽。
此外,对于单元格数超过 20,000 的表格,PDF 中可能会存在以下明显差异:
如果您没有看到展开表以显示所有行选项,请与您的 Looker 管理员联系,了解如何为您的 Looker 实例安装相应版本的 Chromium 渲染程序。
选择或保留将信息中心图块排列在一列中。如果您选择此选项,PDF 将在单个垂直列中显示数字面板图块。如果您未选择此选项,数字面板图块将按照其在数字面板中的排列方式显示。
选择在浏览器中打开,即可在浏览器的新标签页中查看 PDF 文件的图片。在此处,您可以使用浏览器的控件选择下载 PDF 文件。
如果您不想再下载信息中心,请选择取消。
选择下载,开始下载。您的浏览器会打开一个新标签页,显示下载状态。
如果您的 Looker 管理员已启用渲染长表格实验室功能,并且已选择展开表格以显示所有行选项,那么包含表格可视化图表的图块在下载的 PDF 中看起来可能会与在 Looker 中看起来略有不同。如需详细了解具体差异,请访问实验室文档页面。
以 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 将字段 labels 用作其 JSON 输出中的呈现值。如需详细了解 Looker 如何以 JSON 格式呈现字段,请参阅 JSON 格式变更社区帖子。
转置表格可视化图表只会以 PDF 和 PNG 下载内容形式呈现。
PNG 格式的下载内容始终会从模型返回数据,就像在生产模式下一样,即使您处于开发模式也是如此。
结果
在结果部分中,选择是否要将可视化设置应用于数据下载:
如果您选择已应用可视化选项,Looker 会将某些可视化设置应用于您的下载内容。图表、系列和格式设置菜单中为可视化图表配置的任何以下设置都将应用于数据下载:
- 显示行号
- 隐藏总计
- 隐藏行总计
- 显示的行数限制:显示或隐藏的行数不得超过 500 行。
- 显示完整字段名称
- 每列的自定义标签(Looker 将字段 labels 用作其 JSON 输出中的呈现值。如需详细了解 Looker 如何以 JSON 格式呈现字段,请参阅 JSON 格式变更 Looker 社区帖子。
- 条件格式,用于以 Excel 格式下载表格图表。
只有在应用了沿缩放比例规则的情况下,以 Excel 格式下载的下载内容才会显示表格图表。
如果查询包含以下任何元素,那么表格图表中已经过手动重新排列的列将在下载内容中按原始顺序显示:
如果您选择按数据表中的格式显示,系统不会应用可视化选项,并且下载内容在 Look 或探索的数据部分显示时会显示为数据表。
数据值
在数据值部分,选择下载的结果的显示方式:
- 如果您选择设置了格式,则数据看起来会更接近 Looker 中的探索体验,但部分文件格式不支持某些功能(例如关联)。
- 如果您选择无格式,Looker 不会对结果应用任何特殊格式,例如对长数字进行四舍五入或添加 Looker 开发者可能已设置的特殊字符。将数据输送到另一个工具进行处理时,通常建议采用此做法。
要包含的行数和列数
您可在此部分指定下载内容中包含多少数据。在大多数图块中,下载弹出式窗口的此部分名称为要包含的行数;如果图块查询包含任何透视维度,此部分的名称为要包含的行数和列数。可供选择的选项包括:
- 当前结果表:图块底层数据表的行数上限和列数上限(如果图块查询包含至少一个透视维度)。
- 所有结果:功能块查询返回的所有结果,即使功能块的数据表指定了更严格的行数上限或列数上限也是如此。在选择此选项之前,请参阅本页中的使用“所有结果”或“自定义”选项时的注意事项部分。没有
download_without_limit
权限的用户无法看到此选项。 - 自定义:要下载的自定义行数。具有
download_with_limit
权限的用户最多可以包含 5,000 行。其他用户的限额通常为 10 万人,除非您的 Looker 管理员提高此限额(请参阅旧版功能:允许无限制下载 (Looker 4.14+) 社区帖子)。
使用“所有结果”或“自定义”选项时的注意事项
Looker 会检查您的权限,并确定是否允许下载整个查询的复杂查询和数据库方言。如果您有权下载超出设定的限制的结果,并且 Looker 确定您的整个查询可以下载,则下载窗口中将提供所有结果选项。
对于符合以下条件的查询,所有结果选项通常处于停用状态:
- 涉及行总计
- 使用占总数的百分比、与上一个总数的百分比或运行总计类型的测量
- 从无法流式传输结果的数据库方言中检索数据
- 包含 Looker 会计算的数据透视列,因为数据来自无法计算数据透视的数据库方言
即使提供了所有结果选项,您在下载所有结果时仍应谨慎。有些查询非常庞大,包含数千行或数百万行,可能会让大多数电子表格程序(甚至 Looker 实例)负载过重。
如果所有结果选项不可用,您可以使用自定义选项指定您权限所允许的最大行数。如果选择自定义,您可以指定要下载的结果行数。如果您的查询包含任何透视维度,您还可以指定要下载的列数。
面向管理员:允许下载 Looker 实例的数据
某些下载选项要求客户托管的 Looker 部署的管理员已安装相应版本的 Chromium 渲染程序。如果您的实例由 Looker 托管,则表明 Chromium 已安装。
管理企业用户功能文档页面包含有关下载流程的重要管理信息:
如需详细了解必须分配给用户才能下载的权限(具体来说是 download_with_limit
和 download_without_limit
权限),请访问角色文档页面。
对于包含多行表格可视化图表的信息中心,如需缩短 PDF 下载文件的呈现时间,Looker 管理员可以启用呈现长表格实验室功能。