下载内容

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

如要下载内容，您必须由 Looker 管理员授予 download_with_limit 或 download_without_limit 权限。

下载内容和设置已下载内容的格式和选项会有所不同，具体取决于您是从“探索”或“探索”、信息中心、旧版信息中心还是合并结果查询中下载的内容。

从 Look 或 Discover 中下载数据

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

此操作会打开一个下载窗口，您可以在其中为下载内容命名并设置格式：

以下部分将引导您查看 Download 窗口中的各个字段：

文件格式

使用这种渲染程序的格式（PNG 和 PDF）下载内容将使用制作模式下的结果。如果您下载的是其他格式，那么无论您选择的是哪种开发模式（开发版或正式版），下载内容都会显示结果。

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

  • 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 不会应用查询结果的任何特殊格式，例如将长整数舍入或添加 Looker 开发者可能已设置的特殊字符。当将数据馈送至另一个工具进行处理时，这通常是首选。
  • 如果您选择格式化，则数据会更加类似于 Looker 中的探索体验，不过并非所有文件类型都支持某些功能（例如关联）。

限制

您可以按如下方式选择要下载的数据量：

  • 表格中的结果：根据内容行数上限指定的行数。
  • 所有结果：查询返回的所有结果。选择此选项之前，请先参阅本页中的所有结果部分。
  • 自定义：自定义行数。拥有 download_with_limit 权限的用户上限为 5000 行。其他用户的上限为 10 万，除非您的 Looker 管理员提高该上限（请参阅旧版功能：允许无限下载（Looker 4.14+）社区主题）。

所有结果

当您在“探索”或“探索”中点击运行时，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 临时架构，并且需要写入架构。
  • 查询结果会存储在随机临时架构下的一个临时临时架构下，存储时间为一小时。

文件名

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

下载或在浏览器中打开

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

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

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

从信息中心下载数据

本部分介绍了如何下载使用新版信息中心的信息中心。如需了解如何下载旧版信息中心，请参阅从旧版信息中心下载数据部分。

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

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

以 PDF 格式下载信息中心

您可以以 PDF 格式下载整个信息中心，这意味着您将获得一个 PDF 图片：信息中心标题、所有信息中心过滤条件、所有信息中心图块和运行信息中心的时区。PDF 还会包含显示信息中心下载时间的时间戳。

当您以 PDF 格式下载信息中心时，PDF 会显示新的信息中心体验或旧版信息中心，具体取决于信息中心的永久格式。换言之，如果您因更改了网址而以另一种格式暂时查看信息中心，任何下载内容都会反映这种永久格式。

即使您处于开发模式，在 PDF 格式的下载内容中也会始终返回模型在生产模式下的数据。

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

  1. 从格式下拉菜单中选择 PDF。
  2. 从纸张大小下拉菜单中选择一个选项。适合页面信息中心选项是默认的选项；它会调整 PDF 的大小，以匹配屏幕上的信息中心布局。其他纸张大小选项将调整 PDF 的大小，以匹配标准纸张大小，并适应其中包含的信息中心。根据信息中心的布局，大型可视化图块或重叠图块组可能需要调整大小，以适应页面大小。



    如果您没有看到纸张大小选项，请与您的 Looker 管理员联系，了解如何为 Looker 实例安装最新版本的 Chromium 渲染程序。
  3. 如果您在纸张大小下拉列表中选择了使页面适合信息中心，系统就会显示方向选项。您可以选择将信息中心调整为纵向或横向。
  4. 选择或取消选择展开表格以显示所有行。如果您选择此选项，那么对于使用表格可视化效果的信息中心图块，PDF 将会显示表格可视化图表中的所有可用行，而不仅仅是信息中心图块缩略图中显示的行。如果您未选择此选项，那么只有缩略图中无需滚动即可看到的行会显示在 PDF 中。信息中心和查询过滤器以及行数限制、列数限制等可视化设置以及通过限制显示的行数选项设定的设置仍然适用。 如果您没有看到展开表格以显示所有行选项，请咨询 Looker 管理员，了解如何为 Looker 实例安装适当版本的 Chromium 渲染程序。
  5. 选择或保留将信息中心卡片排列成一列。如果您选择此选项，那么 PDF 会在单个垂直列中显示信息中心图块。如果您未选择此选项，那么信息中心图块会按照在信息中心内的排列方式显示。
  6. 点击在浏览器中打开，在浏览器的新标签页中查看 PDF 图片。然后，您就可以选择使用浏览器的控件来下载 PDF 文件。
  7. 如果您不想再下载信息中心，请点击取消。
  8. 点击下载以开始下载。您的浏览器会打开一个新标签页，显示下载状态。

如果您的 Looker 管理员启用了 Render Long Tables 实验室功能，并且选择了展开表格以显示所有行选项，那么包含表格可视化图表的图块在外观上可能与 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 中的探索体验更接近，不过某些文件格式可能不支持某些功能（例如关联）。
  • 如果您选择无格式， Looker 不会应用结果的任何特殊格式，例如将数字四舍五入或添加由 Looker 开发者设置的特殊字符。当将数据馈送至另一个工具进行处理时，这通常是首选。

要包含的行数和列数

您可以在此部分指定下载内容包含多少数据。在大多数图块中，此部分的下载弹出式窗口的名称为 Number of rows to include；如果图块查询包含任何透视维度，此部分将命名为 Number of rows and columns to include（要包含的行数和列数）。可用的选项包括：

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

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

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

即使所有结果选项可用，您仍应谨慎下载所有结果。有些查询非常庞大，包含数千或数百万行，这可能会使大多数电子表格程序（甚至 Looker 实例）不堪重负。

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

从旧版信息中心下载数据

本部分将介绍旧版信息中心。如需了解如何使用新版信息中心下载信息中心，请参阅从信息中心下载数据部分。

Looker 可让您下载旧版信息中心，以便存储或分享当前数据。您可以将旧版信息中心下载为 PDF 或 CSV 压缩文件集。

以 PDF 格式下载旧版信息中心

要以 PDF 格式下载旧版信息中心，请执行以下操作：

  1. 点击页面右上角的齿轮图标。

  2. 选择下载为 PDF 文件。

    系统会打开下载窗口，您可以在其中为下载内容命名并设置格式。

  3. （可选）使用文件名框更改 PDF 文件的名称。

  4. （可选）展开高级选项菜单以进一步自定义 PDF。

    如果您希望 PDF 文件在单个垂直列中显示旧版信息中心图块，请选择单列格式复选框。如果您希望 PDF 按照旧版信息中心中的排列方式显示图块，请勿选中此复选框。

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

    您还可以选择打印纸大小下拉菜单来指定 PDF 的最佳尺寸和方向。大型可视化内容或重叠的信息中心图块组可能需要调整大小以适应 PDF 页面。

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

  5. 点击下载或在浏览器中打开。

即使您处于开发模式，在 PDF 格式的下载内容中也会始终返回模型在生产模式下的数据。

以 PDF 格式下载信息中心后，PDF 会显示新版信息中心或旧版信息中心，具体取决于信息中心的永久格式。换言之，如果您因更改了网址而以另一种格式暂时查看信息中心，任何下载内容都会反映这种永久格式。

以 CSV 格式下载旧版信息中心

要从旧版信息中心下载 CSV 文件，请点击信息中心右上角的齿轮图标，然后选择下载为 CSV 文件以开始下载：

压缩后的目录中的每个信息中心版块都有一个单独的 CSV 文件。每个 CSV 文件都包含用于在信息中心内创建卡片的格式化数据：

以 CSV 文件格式下载信息中心时，您将无法使用格式设置下载选项，例如设置自定义行数上限或选择所有结果。已下载文件中的行限制与相应图块的行限制相关联。

Looker 使用 UTF-8 编码生成压缩文件。如果 CSV 文件名中的字符显示为乱码，则 Looker 的 UTF-8 编码与计算机操作系统或第三方应用的默认编码之间可能存在冲突。Looker 建议您使用能够识别 UTF-8（例如 7-Zip）的文件提取器，并确保任何第三方应用都配置为支持 UTF-8。

从旧版信息中心图块下载数据

如需下载特定图块中的数据，请点击三点状图标，然后选择下载数据：

图块下载窗口和选项与 Look 或 Discover 类似。如需详细了解可用于自定义数据下载的选项，请参阅从 Look 或 Discover 中下载数据部分。如果您下载的是所有结果，则不会看到从查询中移除排序选项，这与查看“探索”或“探索”时一样。

您无法根据合并结果查询从旧版信息中心图块中下载数据，但如果您将旧版信息中心下载为 PDF 或以 CSV 文件集合的形式下载，则包含合并结果图块中的数据。

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

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

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

如需详细了解用户必须授予哪些权限才能下载（尤其是 download_with_limit 和 download_without_limit 权限），请访问角色文档页面。

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