将 CSV 文件上传到 Looker 报告

您可以将提供 CSV（逗号分隔值）文件的任何来源的数据导入到 Looker 报告中。您可以直接从计算机上传 CSV 文件。

创建 CSV 文件数据源

Looker 报告会将上传的 CSV 文件存储在数据集中。一个数据集可以包含一个或多个具有相同列标题的 CSV 文件。CSV 文件数据源可以包含一个或多个数据集。

如需创建新的 CSV 文件数据源，请按以下步骤操作：

  1. 打开 Looker 报告。
  2. 点击创建按钮，然后选择数据源。
  3. 选择 CSV 文件上传 Google 连接器。
  4. 点击添加数据集按钮，创建新数据集。
    • 您还可以将一个或多个 CSV 文件拖到可用的数据集部分，Looker 报告将创建一个包含上传文件的新数据集。
  5. 上传完文件后，点击关联按钮。

您上传的数据存储在 Cloud Storage 中。这种存储设置有很多好处，包括能够从云端访问和下载数据，以及能够将数据用于其他 Google Cloud 服务。

详细了解 Cloud Storage。

向数据集添加 CSV 文件

只要列标题一致，您就可以将多个文件上传到数据集。添加新文件时，相应数据会附加到数据集中。这样，您就可以随着时间的推移更新数据。

如需向数据集添加 CSV 文件，请按以下步骤操作：

  1. 打开 Looker 报告。
  2. 点击数据源标签页。
  3. 选择包含 CSV 文件的数据源。
  4. 点击 Edit Connection。
  5. 在可用的数据集部分中，选择要从中添加文件的数据集。
  6. 点击添加文件按钮。
    • 您还可以将一个或多个 CSV 文件拖动到数据集中的文件部分。
  7. 上传完文件后，点击重新连接按钮。

共享数据集

您创建的数据集归您所有，无法共享。不过，在基于数据集创建数据源后，您可以与其他用户共享该数据源。这意味着，您的数据集可用于共享数据源和报告，但只有您本人可以访问数据集本身。

上传文件格式

确认您上传的文件的格式正确无误。否则，上传过程中可能会出现错误，或者报告中的数据可能看起来不正确。

内容错误的一个常见原因是，上传的数据中分隔符、英文引号和换行符的使用不当。了解 CSV 文件上传功能如何处理这些问题，有助于您日后避免麻烦。

UTF-8 编码

您上传的文件应采用 UTF-8 编码。这是网络上大多数应用的常用编码。

不过，如果您要从某些桌面产品（例如 Microsoft Excel™）导出数据，可能需要先将文件转换为 UTF-8 格式，然后再将其上传到 Looker 报告。否则，Looker 报告可能会返回错误消息，例如 File is Invalid.

仅限表格数据

CSV 文件上传只能导入表格数据文件。这意味着，您的文件必须具有规则的行和列结构。即使表格中某个单元格的数据缺失，每行也必须具有相同的列数。如果尝试上传包含合并单元格或结构不一致的文件，系统会显示上传错误，并导致上传失败。

分隔符

数据中的所有字段必须以英文逗号分隔。

如果您要上传的字段中的实际数据包含英文逗号，则必须用英文引号将该字段括起来。如果您的数据包含双引号，您可以使用单引号字符将相应字段括起来。

标题行

文件中的第一行必须是标题行。此行将告知 Looker 报告如何命名您的字段。字段名称必须是唯一的，因此标题行中不能有重复的值。

列名称必须：

  • 只能包含字母、数字或下划线。不允许使用其他标点符号或特殊字符。
  • 以字母或下划线开头
  • 长度不得超过 128 个字符

标题行还必须遵循分隔符规则。

换行符

文件中的每一行都必须以换行符结尾。即使使用英文引号转义了数据中的换行符，CSV 文件上传功能也不支持这些换行符。

问题排查

以下部分介绍了您在上传 CSV 文件时可能会遇到的常见错误。

错误：文件无效

如果 Looker 在尝试上传 CSV 文件后显示 File is Invalid 错误，请检查以下可能的原因：

  • 文件包含无效的 UTF-8 字符。
  • 相应文件实际上不是 CSV 文件。例如，如果您将 PDF 文件重命名为使用“.csv”扩展名，则 Looker 报告将无法正确解析该文件。

CSV 文件上传限制

CSV 文件上传受到以下限制：

  • 每位用户 1,000 个数据集
  • 每位用户 2 GB 总存储空间
  • 每个数据集每天 100 次上传
  • 每个数据集的文件大小上限为 100MB

数据源简介