正在下载内容

本页面介绍了如何从 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 会将部分可视化设置应用于您的下载内容。在图表、系列和格式设置菜单中，为可视化图表配置的任意以下设置都将应用于数据下载：

仅当应用了按比例调整规则时，在 Excel 提交的 Look 和探索中显示表格图表，条件格式才会显示。

某些可视化图表设置不会应用于下载的结果。例如：

  • 自定义标题文字颜色和背景颜色不会应用于下载的结果（PNG 文件除外）。
  • 对于包含数据透视和多个测量的结果表，每个数据透视值都会跨列重复，而不是表示为一个合并的列。HTML 和 PNG 下载是例外，因此合并的列会保留下来。
  • 如果您从信息中心下载，则下载的结果中不会包含信息中心图块标题。
  • 下载的结果中包含总计和行总计值，但相应的行和列均未添加标签。
  • 对于无法流式处理的查询，系统不会下载小计。

如果查询包含以下任何元素，则已手动重新排列的表格图表中的列将在下载内容中按原始顺序显示：

如果您选择如数据表格中所示，系统不会应用可视化选项，并且下载内容将像 Look 或探索的数据部分的数据表格一样。

数据值

在数据值部分中，选择您希望下载的查询结果的显示方式：

  • 如果您选择无格式，Looker 将不会对查询结果应用任何特殊格式，例如对长数字进行四舍五入，或添加 Looker 开发者可能设置的特殊字符。将数据输送到另一个工具进行处理时，通常建议采用此做法。
  • 如果您选择已设置格式，数据的外观将类似于 Looker 中的探索体验，但并非所有文件类型都支持某些功能（例如链接）。例如，通过 html 参数应用的任何格式设置都不会应用于 TXT、CSV、Excel 或 JSON 下载内容。

要包含的行数和列数

您可以选择要下载的数据量，如下所示：

  • 当前结果表：内容的行数限制指定的行数。
  • 所有结果：查询返回的所有结果。在选择此选项之前，请先查看此页面上的所有结果部分。
  • 自定义：自定义行数。拥有 download_with_limit 权限的用户最多只能包含 5,000 行。其他用户的上限通常为 10 万人。

所有结果

当您在 Look 或“探索”中选择运行时，Looker 会检查您的权限，并确定查询和数据库方言的复杂性是否允许下载整个查询。如果您拥有相关权限（结果数量超出设定的上限），并且 Looker 确定您的整个查询可供下载，则下载窗口中将显示所有结果选项。

对于执行以下任一操作的查询，所有结果选项通常处于停用状态：

即使所有结果选项可用，您在下载所有结果时仍应格外小心。有些查询非常庞大，包含数千或数百万行，这可能会使大多数电子表格程序甚至 Looker 实例超负荷。

如果所有结果选项不可用，您可以使用自定义选项指定您的权限所允许的最大行数。

流式查询结果

流式处理是指 Looker 分块处理数据的能力，而不是一次性处理所有数据。如果 Looker 可以流式传输结果集，则下载次数不受限制。所有结果选项依赖于 Looker 流式传输结果的功能，如果无法流式传输结果，则无法使用所有结果。

除了格式限制之外，在以下两种情况下无法进行流式传输：

  1. 表计算：表计算无法流式传输。因此，要下载无限量的查询结果，必须从查询中移除表计算。
  2. 数据库限制：如果查询中包含数据透视，则部分数据库无法进行流式传输。对于这些数据库，您必须移除数据透视才能下载无限量的结果。某些数据库无法流式传输任何结果，这意味着无法无限制下载。

以下数据库支持流式传输：

方言 是否支持？
阿克蒂安雪崩
是
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
是
迪诺多 7
是
迪诺多 8 号星
是
德雷米奥
是
Dremio 11+
是
Exasol
是
火箭
是
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
是
迪诺多 7
否
迪诺多 8 号星
否
德雷米奥
否
Dremio 11+
否
Exasol
是
火箭
是
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
是

从查询中移除所有排序

选择所有结果后，您可能还会看到从查询中移除所有排序选项。此选项可防止在下载结果之前对查询进行排序。选择此选项可能会加快您的下载速度，因为对于某些数据库类型，对查询进行排序可能会使性能下降。

透视结果不支持从查询中移除所有排序选项。

允许大型结果

使用 Google BigQuery 作为数据库方言在 Looker 中下载大型结果集并选择所有结果时，您可能会看到允许大型结果选项。这是因为 Google BigQuery 设有查询结果的响应大小上限，如写入查询结果 Google Cloud 文档主题中所述。为了下载超过 BigQuery 响应大小上限的结果，Looker 必须执行不同的过程。

如果您选择允许大型结果，则下载流程会受到如下影响：

  • 查询的 allowLargeResults BigQuery 选项设置为 true。
  • 查询中的 ORDER BY 子句会被移除。
  • 该查询将写入 PDT 临时架构，并需要具有写入权限。
  • 查询结果将在随机表名称下存储在此临时暂存架构中一小时。

下载或在浏览器中打开

选定选项后，您可以选择下载按钮将文件下载到您的计算机中，或者选择在浏览器中打开以在浏览器中查看文件。

下载合并结果查询中的数据

如需下载合并结果查询，您可以将查询保存到信息中心，然后以 PDF 或 CSV 文件的集合形式下载信息中心。但是，您必须下载整个信息中心 - 您不能仅从基于合并结果查询的单个图块下载数据。

从信息中心下载数据

如需下载整个信息中心，请从信息中心的三点状菜单 中选择下载。

系统会打开一个对话框，供您选择 PDF 或 CSV 作为下载格式。

以 PDF 格式下载信息中心

您可以将整个信息中心下载为 PDF 文件，这意味着您将获得一个 PDF 文件，其中会显示信息中心标题、所有信息中心过滤条件、部分或全部信息中心图块以及运行信息中心的时区。PDF 文件还包含一个时间戳，显示信息中心的下载时间。

以 PDF 格式下载时，模型始终会像处于生产模式时一样从模型返回数据，即使您处于开发模式也是如此。

要下载 PDF 格式的信息中心，请按以下步骤操作：

  1. 从格式下拉菜单中选择 PDF。

  2. 从纸张大小下拉菜单中选择一个选项：

    默认选项为使页面适应信息中心，该选项可将 PDF 文件调整为信息中心的默认宽度（1260 像素）。其他纸张大小选项可将 PDF 的大小调整为与标准纸张大小一致，并可适应整个或部分信息中心。根据信息中心的布局和所选的纸张大小，在 Looker 中查看时，某些 PDF 输出可能与信息中心布局有所不同。例如，如果所选纸张大小比信息中心窄，那么您可能会遇到间距或其他格式方面的问题，需要进行一些调整：

    • 大型可视化图表或成组的重叠图块可能需要调整大小以适应 PDF。
    • 包含表格的图块可能不会显示 PDF 中的所有表格列。
    • 系统可能会缩小图块宽度以适应 PDF 大小。同样，Looker 应用中需要滚动的功能块可能不会展开即可显示所有内容。

    如果您没有看到纸张大小选项，请与您的 Looker 管理员联系，了解如何为 Looker 实例安装最新版本的 Chromium 渲染程序。

  3. 如果您在纸张大小下拉菜单中选择了适合页面大小以外的选项，则系统会显示方向选项。您可以选择将信息中心调整为纵向或横向。

  4. 选中或保持未选中状态展开表格以显示所有行。如果您选择此选项，对于使用表格可视化图表的信息中心图块，PDF 会显示可视化图表中的所有可用行，而不仅仅是信息中心图块缩略图中显示的行。如果您没有选择此选项，则 PDF 中只会显示缩略图中无需滚动即可看到的行。信息中心和查询过滤条件、可视化设置（例如行数上限、列数上限）以及通过限制显示的行数选项进行的设置仍然适用。

    如果选择了展开表格以显示所有行选项，则包含表格可视化图表的信息中心图块在下载的 PDF 文件中可能与在 Looker 中看起来略有不同。PDF 文件中可能会存在以下明显差异：

    • 对背景颜色和字体大小的自定义设置已从列标题和小计行中移除。
    • 如果未设置自定义主题，Tables 会以白色主题显示。否则，系统会在下载后应用自定义主题。
    • 未手动排序的数据透视表不会显示排序图标。
    • 启用了将列调整为合适大小的表格会拉伸至图块的全宽。

    此外，如果表格包含的单元格数超过 20,000，则 PDF 文件可能会存在以下明显差异：

    如果您没有看到展开表格以显示所有行选项，请与您的 Looker 管理员联系，了解如何为您的 Looker 实例安装适当版本的 Chromium 渲染程序。

  5. 选中或保持未选中状态将信息中心图块排列在一列中。如果您选择此选项，PDF 会在单个垂直列中显示信息中心图块。如果您没有选择此选项，数字面板板块会按照其在数字面板中的排列方式显示。

  6. 选择在浏览器中打开，即可在浏览器的新标签页中查看 PDF 文件的图片。在该页面中，您可以选择使用浏览器的控件下载 PDF 文件。

  7. 如果您不想再下载信息中心，请选择取消。

  8. 选择下载以开始下载。您的浏览器会打开一个新标签页，显示下载状态。

以 CSV 格式下载信息中心

您可以从信息中心下载所有查询图块的 CSV 压缩文件集合。ZIP 文件中不包含文本图块。要以 CSV 文件集合的形式下载信息中心，请按以下步骤操作：

  1. 从格式下拉菜单中选择 CSV。
  2. 如果您不想再下载信息中心，请选择取消。
  3. 选择下载，开始下载压缩的 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 格式的文件始终会像在生产模式下一样从模型返回数据，即使您处于开发模式也是如此。

结果

在结果部分，选择是否要对数据下载应用可视化设置：

如果您选择如数据表格中所示，系统将不会应用可视化选项，并且下载内容将像 Look 或探索的数据部分的数据表格一样。

数据值

在数据值部分，选择您希望下载的结果的显示方式：

  • 如果您选择已设置格式，相应数据看起来会更类似于 Looker 中的探索体验，不过部分文件格式可能不支持某些功能（例如链接）。
  • 如果您选择无格式，Looker 就不会对结果应用任何特殊格式，例如对长数字进行四舍五入，或添加 Looker 开发者可能设置的特殊字符。将数据输送到另一个工具进行处理时，通常建议采用此做法。

要包含的行数和列数

您可以在此部分指定下载的数据中包含多少数据。在大多数图块中，下载弹出式窗口的此部分名为要包含的行数；如果图块查询包含任何透视维度，则此部分的名称为要包含的行数和列数。您可以选择以下选项：

使用“所有结果”或“自定义”选项时的注意事项

Looker 会检查您的权限，并确定查询的复杂性和数据库方言是否允许下载整个查询。如果您有权下载超过设定限制的结果，并且 Looker 确定您的整个查询可以下载，则下载窗口中将显示所有结果选项。

对于符合以下条件的查询，所有结果选项通常处于停用状态：

即使所有结果选项可用，您在下载所有结果时仍应格外小心。有些查询非常庞大，包含数千或数百万行，这可能会使大多数电子表格程序甚至 Looker 实例超负荷。

如果所有结果选项不可用，您可以使用自定义选项指定您的权限所允许的最大行数。选择自定义时，您可以指定下载的结果行数。如果您的查询包含任何透视维度，您还可以指定要下载的列数。

面向管理员：启用为 Looker 实例下载数据的功能

某些下载选项要求客户托管的 Looker 部署的管理员安装相应版本的 Chromium 渲染程序。如果您的实例由 Looker 托管，则表明 Chromium 已安装。

管理企业用户功能文档页面包含有关下载流程的重要管理员信息：

如需详细了解为使用户能够下载而必须获得的权限（特别是 download_with_limit 和 download_without_limit 权限），请访问角色文档页面。

对于包含多行表格可视化图表的信息中心，为了缩短其 PDF 下载的呈现时间，Looker 管理员可以启用呈现长表实验室功能。