下载内容

本页介绍了如何从 Looker 下载内容（可视化图表或数据）。

为了下载内容，您必须获得 Looker 管理员的 download_with_limit 或 download_without_limit 权限。

下载内容和设置已下载内容的格式和选项不尽相同，具体取决于您是下载的是样式还是探索、下载信息中心还是合并结果查询。

从 Look 或 Discover 中下载数据

若要从 Look 或 Discover 页面下载数据，请点击右上角的齿轮图标，然后选择下载。

系统会打开 Download 窗口，您可以在其中为下载命名和格式：

以下部分将引导您填写下载窗口中的各个字段：

文件格式

如果您下载的格式采用渲染程序（PNG 和 PDF），系统将使用制作模式返回的结果。如果您下载的内容是其他格式，则下载会显示当前不管是开发模式还是生产模式的结果。

您可以从以下格式从 Looks 和 Discover 中下载数据：

  • TXT（制表符分隔值）
  • Excel 电子表格（Excel 2007 或更高版本）
  • CSV
  • JSON
  • HTML
  • Markdown
  • PNG（可视化图表图片）

在选择数据下载格式时，如果您未看到 HTML 或 PNG（可视化图片）选项（适用于 Looks），请与您的 Looker 管理员联系，了解如何为 Looker 实例安装相应版本的 Chromium 渲染程序。

对于 JSON 格式，Looker 使用字段标签作为其 JSON 输出中的渲染值。如需详细了解 Looker 如何以 JSON 格式呈现字段，请参阅 JSON 格式更改社区帖子。

转置表的格式为“PNG 下载”。

对于 Looker 开发者，如果您处于开发模式，则大多数文件格式下的数据下载都会查询您处于开发模式的模型。PDF 和 PNG 文件格式除外；采用这些文件格式的数据下载始终会查询模型，就像处于生产模式一样。

结果

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

  • 如果您选择已应用可视化选项，Looker 会将部分可视化图表设置应用于您的下载内容。数据可视化图表中针对可视化图表配置的图表、系列和格式菜单中的以下任何设置都将生效：

    只有在应用了遵循缩放规则时，基于条件的图表才会显示包含表格图表的 Looks 和探索。

    部分可视化设置不会应用于下载的结果。例如：

    • 自定义标题文本颜色和背景颜色不会应用于已下载的结果（PNG 文件除外）。
    • 对于包含数据透视和多种衡量结果的表，每个数据透视值将在各列中重复显示，而不是表示为一个合并的列。HTML 和 PNG 下载是一个例外，因此系统会保留合并的列。
    • 当您从信息中心下载文件时，下载的结果中不会包含信息中心图块标题。
    • 下载结果中会包含 Totals 和 Row Totals 值，但不会标记相应的行和列。

    如果查询中包含以下任一元素，那么表格中已手动重新排列的列将以下载文件的原始顺序显示：

  • 如果您选择在数据表中显示，系统将不会应用可视化选项，所下载的数据会以类似于数据表的形式显示在“查看”或“探索”的数据部分中。

值

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

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

限制

您可以按照以下步骤选择下载的数据量：

  • 表格中的结果：根据内容的行数限制指定的行数。
  • 所有结果：查询返回的所有结果。在选择此选项之前，请先查看本页中的所有结果部分。
  • 自定义：自定义行数。拥有 download_with_limit 权限的用户最多只能添加 5000 行数据。通常情况下，其他用户的上限是 100,000，除非您的 Looker 管理员提高此限制（请参阅旧版功能：允许无限制的下载 [Looker 4.14+] 社区帖子）。

所有结果

当您在 Look 或 Discover 中点击 Run 时，Looker 会检查权限，并确定查询和数据库方言的复杂性是否允许下载整个查询。如果您拥有相应权限（针对超出设置上限的结果），且 Looker 确定您的整个查询可供下载，那么下载窗口中会显示所有结果选项。

在以下情况下，系统通常会停用所有结果选项：

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

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

流式查询结果

流式处理是指 Looker 能够分块处理数据，而不是一次性处理所有数据。如果 Looker 可以流式传输结果集，就可以无限制地下载。

Looker 会将下载的结果流式传输到除呈现格式（HTML、PNG）之外的所有格式。

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

  1. 表计算：无法流式传输表计算。因此，如需下载某个查询的无限结果，您必须从该查询中移除表计算。
  2. 数据库限制：如果查询中包含数据透视，则某些数据库将无法流式传输。对于这些数据库，您必须移除数据透视表才能下载不限量的结果。某些数据库无法流式传输任何结果，这意味着无法无限量下载。下面列出了支持流式传输的数据库以及支持应用数据透视的数据库：

从查询中移除所有排序

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

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

允许大型结果

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

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

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

文件名

您可以为下载内容输入文件名，也可以使用在该字段中预先填充的默认文件名。Looker 将根据您在文件格式字段中的选择自动附加相应的文件扩展名。

下载或在浏览器中打开

完成选择后，您便可点击下载按钮将文件下载到计算机，也可点击在浏览器中打开以在浏览器中查看文件。

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

要下载合并结果查询，您可以将查询保存到信息中心，然后以 PDF 或 CSV 文件的集合的形式下载信息中心。然而，您必须下载整个数字面板，而不能从基于合并结果查询的单个板块下载数据。

从信息中心下载数据

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

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

以 PDF 格式下载信息中心

下载的 PDF 文件与 Looker 中查看的信息中心布局或尺寸并不完全一致。

您能以 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 内容中可能会存在以下差异：

    • 对列标题和小计行移除对背景颜色和字体大小的自定义。
    • 系统会以白色主题的形式显示表格。
    • 对于未手动排序的数据透视表，排序图标不会显示。
    • 启用了适当大小的列的表可以扩展至图块的全宽。

    此外，如果单元格包含的单元格超过 20,000 个，那么 PDF 中可能会出现以下差异：

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

  5. 选择或取消选择在单个列中排列信息中心图块。如果您选择此选项，PDF 会在单个垂直列中显示信息中心图块。如果您不选择此选项，则信息中心内的数字面板将按照在信息中心内排列的顺序显示。

  6. 点击在浏览器中打开，在浏览器的新标签页中查看 PDF 图片。然后，您可以使用浏览器控件下载 PDF。

  7. 如果您不想再下载该信息中心，请点击取消。

  8. 点击下载，开始下载。浏览器中会打开一个新标签页，显示下载状态。

如果您的 Looker 管理员启用了渲染长表实验室功能，并且展开表格以显示所有行选项，那么包含表格可视化图表的图块在下载的 PDF 中与在 Looker 中的显示效果可能略有不同。如需详细了解区别，请访问实验室文档页面。

以 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 文件集合的形式下载信息中心，则包含合并结果图块中的数据包含在内。

如需从信息中心卡片下载数据，请点击卡片上的三点状图标，然后选择下载：

系统随即会打开一个对话框，其中包含一些类似于外观或探索的选项。展开高级数据选项菜单，查看可供下载的所有选项：

形式

您可以从信息中心图块中下载以下格式的数据：

  • TXT（制表符分隔值）
  • Excel 电子表格（Excel 2007 或更高版本）
  • CSV
  • JSON
  • HTML
  • Markdown
  • PNG（可视化图表图片）

您可能无法使用高级数据选项菜单中的某些选项，具体取决于您选择的格式。

如果缺少 HTML 或 PNG（可视化图片）选项，请联系您的 Looker 管理员，了解如何为 Looker 实例安装合适的 Chromium 渲染程序版本。

对于 JSON 格式，Looker 使用字段标签作为其 JSON 输出中的渲染值。如需详细了解 Looker 如何以 JSON 格式呈现字段，请参阅 JSON 格式更改社区帖子。

转置后的表格可视化效果仅支持 PDF 和 PNG 下载。

PNG 格式的下载始终会从模型返回数据（就像在生产模式下一样），即使您处于开发模式也不例外。

结果

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

  • 如果您选择已应用可视化选项，Looker 会将部分可视化图表设置应用于您的下载内容。数据可视化图表中针对可视化图表配置的图表、系列和格式菜单中的以下任何设置都将生效：

    只有在应用了沿缩放规则的情况下，条件格式才会以 Excel 格式在表格中显示（包含表格图表）。

    如果查询中包含以下任一元素，那么表格中已手动重新排列的列将以下载文件的原始顺序显示：

如果您选择在数据表中显示，系统将不会应用可视化选项，所下载的数据会以类似于数据表的形式显示在“查看”或“探索”的数据部分中。

数据值

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

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

要包含的行数和列数

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

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

Looker 会检查您的权限，并确定查询和数据库方言的复杂性是否允许下载整个查询。如果您有权下载超出指定上限的结果，并且 Looker 确定您的整个查询可供下载，那么下载窗口中会显示所有结果选项。

在以下情况下，系统通常会停用所有结果选项：

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

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

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

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

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

如需详细了解必须分配给用户的权限，他们才能下载（尤其是 download_with_limit 和 download_without_limit 权限），请访问角色文档页面。

对于包含多行表格可视化内容的信息中心，如需缩短 PDF 下载文件的呈现时间，Looker 管理员可以启用 Render Long Tables 实验室功能。