本页介绍了如何从 Looker 下载内容（可视化图表或数据）。
如需下载内容，您必须获得 Looker 管理员授予的 download_with_limit 或 download_without_limit 权限。
下载内容和设置下载内容的格式的流程和选项因您是从“探索”或“探索”下载、从信息中心下载还是从合并的结果查询下载而异。
从 Look 或“探索”下载数据
如需从“外观”或“探索”页面下载数据，请选择右上角的齿轮菜单，然后选择下载。
Looker 会显示下载窗口，您可以在其中为下载内容命名并设置格式。
以下部分将引导您完成下载窗口中的每个字段：
格式
下载到使用渲染程序的格式（PNG 和 PDF）时，系统将使用生产模式下的结果。如果您的下载内容采用其他格式，下载内容将显示您所处开发模式或正式版模式的结果。
您可以采用以下文件格式从“探索”和“数据分析”下载数据：
- 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 会在 JSON 输出中使用 labels 字段作为其呈现的值。如需详细了解 Looker 如何以 JSON 格式呈现字段，请参阅 JSON 格式变更 Looker 社区帖子。
- 为以 Excel 格式下载的表格图表可视化内容添加条件格式
只有在应用沿比例规则后，条件格式才会显示在包含表格图表可视化的“探索”和“探索”的 Excel 传送内容中。
部分可视化设置不会应用于下载的结果。例如：
- 自定义标题文本颜色和背景颜色不会应用于下载的结果，但 PNG 文件除外。
- 对于包含数据透视表和多个测量的结果表格，每个数据透视表值都会在各列中重复，而不是表示为一个合并的列。HTML 和 PNG 下载内容是例外情况，因此合并后的列会保留。
- 从信息中心下载时，下载结果中不会包含信息中心功能块标题。
- 总计和行总计值包含在下载的结果中，但相应的行和列没有标签。
- 对于无法流式传输的查询，系统不会下载小计。
如果查询包含以下任一元素，则表格图表中手动重新排列的列将在下载内容中显示为原始顺序：
- 有意从可视化图表中隐藏的字段
底层 SQL 中存在但可视化图表中不存在的字段，例如：
- 可视化图表中存在的维度包含一个
link参数，该参数引用了可视化图表中不存在的其他字段。 - 使用
case参数的字段。 - 在可视化图表中显示的维度，该维度使用
{{ field_name._value }} Liquid variable syntax引用了可视化图表中未显示的另一个字段。
- 可视化图表中存在的维度包含一个
有一个或多个启用了维度填充的字段
三个或更多个数据透视字段
行总计已启用
一个或多个字段，其字段定义中包含
order_by_fieldLookML 参数
如果您选择按数据表中的格式显示，系统不会应用可视化选项，下载内容将以 Look 或探索的数据部分中显示的数据表的形式呈现。
数据值
在数据值部分，选择下载的查询结果的显示方式：
- 如果您选择无格式，Looker 不会对查询结果应用任何特殊格式（例如对长串数字取整或添加 Looker 开发者可能设置的特殊字符）。将数据输送到另一个工具进行处理时，通常建议采用此做法。
- 如果您选择格式化，数据的外观将类似于 Looker 中的探索体验，但并非所有文件类型都支持某些功能（例如关联）。例如，使用
html参数应用的任何格式设置都不会应用于 TXT、CSV、Excel 或 JSON 下载内容。
要包含的行数和列数
您可以按如下方式选择要下载的数据量：
- 当前结果表：内容的行数限制所指定的行数。
- 所有结果：查询返回的所有结果。在选择此选项之前，请参阅本页面上的所有结果部分。
- 自定义：自定义行数。拥有
download_with_limit权限的用户最多只能查看 5,000 行。其他用户的上限通常为 10 万。
所有结果
当您在探索或数据分析中选择运行时，Looker 会检查您的权限，并确定查询的复杂性和数据库方言是否允许下载整个查询。如果您拥有相应权限（针对超出设定上限的结果），并且 Looker 确定可以下载您的整个查询，则下载窗口中会显示所有结果选项。
系统通常会为执行以下任一操作的查询停用所有结果选项：
- 涉及行总计或表计算
- 使用占总数的百分比、占前一时间段的百分比或累计总数类型的测量值
- 从无法流式传输结果的数据库方言检索数据
- 包含 Looker 计算的数据透视列，因为数据来自无法计算数据透视的数据库方言
即使所有结果选项可用，在下载所有结果时，您仍应谨慎小心。有些查询非常大，包含数千或数百万行，这可能会使大多数电子表格程序（甚至您的 Looker 实例）不堪重负。
如果所有结果选项不可用，您可以使用自定义选项指定您的权限允许的最大行数。
流式传输查询结果
流式传输是指 Looker 能够分块处理数据，而不是一次性处理所有数据。如果 Looker 可以流式传输结果集，则可以无限下载。所有结果选项依赖于 Looker 的结果流式传输功能，如果无法流式传输结果，则所有结果将不可用。
除了格式限制之外，还有以下两种情况下无法流式传输：
- 表计算：表计算无法流式传输。因此，如需下载查询的无限结果，您必须从查询中移除表计算。
- 数据库限制：如果查询中包含数据透视，某些数据库将无法流式传输。对于这些数据库，您必须移除数据透视，才能下载无限量结果。某些数据库无法流式传输任何结果，这意味着无法无限下载。
以下数据库支持流式传输：
| 方言 | 是否支持？ |
|---|---|
| Actian Avalanche | 是 |
| 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 Database | 是 |
| 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 及更高版本 | 是 |
| 9.5 之前的 PostgreSQL | 是 |
| PrestoDB | 是 |
| PrestoSQL | 是 |
| SAP HANA 2+ | 否 |
| SingleStore | 是 |
| SingleStore 7+ | 是 |
| Snowflake | 是 |
| TeraData | 是 |
| Trino | 是 |
| 向量 | 是 |
| Vertica | 是 |
以下数据库支持应用了数据透视的流式传输：
| 方言 | 是否支持？ |
|---|---|
| Actian Avalanche | 是 |
| 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 Database | 是 |
| 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 及更高版本 | 是 |
| 9.5 之前的 PostgreSQL | 是 |
| PrestoDB | 是 |
| PrestoSQL | 是 |
| SAP HANA 2+ | 否 |
| SingleStore | 是 |
| SingleStore 7+ | 是 |
| Snowflake | 是 |
| TeraData | 是 |
| Trino | 是 |
| 向量 | 是 |
| Vertica | 是 |
从查询中移除所有排序
选择所有结果后，您可能还会看到从查询中移除所有排序选项。此选项可防止在下载结果之前对查询进行排序。选择此选项可能会加快下载速度，因为对某些数据库类型的查询进行排序可能会对性能造成不利影响。
数据透视结果不支持从查询中移除所有排序选项。
允许大型结果
在 Looker 中使用 Google BigQuery 作为数据库方言下载大型结果集时，如果您选择所有结果，则可能会看到允许大型结果选项。这是因为 Google BigQuery 对查询结果设置了响应大小上限，如 Write query results Google Cloud 文档主题中所述。如需下载超出 BigQuery 响应大小上限的结果，Looker 必须执行其他流程。
如果您选择允许大型结果，下载流程将受到以下影响：
- 查询的
allowLargeResultsBigQuery 选项设置为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 中。信息中心和查询过滤条件仍会应用，以及行数限制、列数限制和使用限制显示的行数选项进行的设置。
如果选择了展开表以显示所有行选项，则包含表格可视化图表的 Dashboard 功能块在下载的 PDF 中的显示效果可能会与在 Looker 中略有不同。PDF 中可能会出现以下明显差异：
- 系统会从列标题和小计行中移除对背景颜色和字体大小的自定义设置。
- 如果未设置任何自定义主题，Tables 将采用白色主题。否则，系统会在下载时应用自定义主题。
- 未手动排序的数据透视表上不会显示排序图标。
- 启用了将列调整为合适大小的表格会延伸到功能块的整个宽度。
此外，对于包含 2 万多个单元格的表格，PDF 中可能会出现以下明显差异：
如果您没有看到展开表格以显示所有行选项，请与您的 Looker 管理员联系，让其为您的 Looker 实例安装适当版本的 Chromium 呈现引擎。
选择或取消选择将信息中心图块排列在一列中。如果您选择此选项，PDF 会在单个垂直列中显示信息中心图块。如果您不选择此选项，信息中心功能块将按其在信息中心中的排列方式显示。
选择在浏览器中打开，即可在浏览器的新标签页中查看 PDF 的图片。然后，您可以选择使用浏览器的控件下载 PDF。
如果您不想再下载信息中心，请选择取消。
选择下载以开始下载。浏览器中会打开一个新标签页，显示下载状态。
以 CSV 格式下载信息中心
您可以将信息中心中的所有查询图块下载为压缩的 CSV 文件集。ZIP 文件不包含文本功能块。如需将信息中心下载为一系列 CSV 文件，请按以下步骤操作：
- 从格式下拉菜单中选择 CSV。
- 如果您不想再下载信息中心，请选择取消。
- 选择下载以开始下载压缩的 CSV 集合。
将信息中心下载为 CSV 文件时，您将无法使用用于设置下载格式的选项，例如设置自定义行数上限或选择所有结果。下载的文件中的行数限制与相应图块的行数限制相关。
Looker 使用 UTF-8 编码生成 ZIP 文件。如果 CSV 文件名中的字符出现乱码，则可能是因为 Looker 的 UTF-8 编码与机器操作系统或第三方应用的默认编码之间存在冲突。Looker 建议您使用能够识别 UTF-8 的文件提取器（例如 7-Zip），并确保所有第三方应用都配置为支持 UTF-8。
从信息中心功能块下载数据
您无法下载基于合并结果查询的信息中心功能块中的数据，但如果您将信息中心下载为 PDF 文件或下载为一系列 CSV 文件，则会包含合并结果功能块中的数据。
如需从信息中心功能块下载数据，请选择功能块上的三点状图标，然后选择下载数据：
这会打开一个对话框，其中包含几个与“外观”或“探索”的选项类似的选项。展开高级数据选项菜单，查看下载时可用的所有选项：
格式
您可以采用以下格式从信息中心功能块下载数据：
- 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 格式呈现字段，请参阅 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 权限），请访问角色文档页面。