将 Google 表格与 Metabase 同步
Google 表格同步仅适用于安装了 Metabase 云存储 附加组件的 Metabase 云实例。
如果您已设置 Metabase 云存储，管理员可以设置 Metabase 以同步 Google Drive 文件夹中的 Google 表格。Metabase 将为同步的 Google 表格在您的 Metabase 云存储中创建表。
目前，您无法将 Google 表格同步到您自己的数据库中。
如何将 Google 表格与 Metabase 同步
管理员可以设置 Metabase 以同步以下任一内容：
- 您的 Google Drive 中的单个文件夹。Metabase 将同步此文件夹中保存的所有 Google 表格文件，每 15 分钟自动刷新数据。
- 单个 Google 表格。Metabase 将与该表格（及其所有工作表）同步，每 15 分钟刷新一次。
以下是设置方法
- 在左侧导航栏中，点击 添加数据 > 连接 Google 表格。
- 选择 整个文件夹 或 单个表格。
- Metabase 将要求您共享 Google Drive 文件夹或表格。您一次只能与 Metabase 共享一个文件夹或表格。
- 在 Google Drive 中，将文件夹或表格与 Metabase 提供的服务账户共享。
- 授予服务账户 查看者 权限。Metabase 只能访问此文件夹或表格；它无法访问您的 Google Drive 中的任何其他文件。如果您选择文件夹，Metabase 还会同步其在任何子文件夹中找到的所有表格。
- 点击 发送 将文件夹共享给 Metabase 服务账户。
- 复制文件夹或表格的共享链接。
- 返回 Metabase，将共享链接粘贴到要求输入“此文件夹/文件的共享链接”的字段中。
如果您同步了 Google Drive 文件夹，Metabase 将与 Google Drive 文件夹（及其子文件夹）同步并导入所有 Google 表格，为每个表格在您的 Metabase 云存储数据库中创建一个新表。对于具有多个工作表的表格，Metabase 将为每个工作表创建一个表。Metabase 只会同步 Google 表格；它会忽略文件夹中的其他文件类型。首次同步后，Metabase 将每 15 分钟同步一次。
如果您同步了单个表格，Metabase 将为该表格中的所有工作表创建表。
您可以通过点击左侧导航栏中的 数据库 并导航到 Metabase 云存储数据库来查找已同步的 Google 表格。
断开与 Google Drive 文件夹或表格的连接
要断开您的 Google Drive 与文件夹或表格的连接
- 在左侧导航栏中转到 数据库。
- 点击 Metabase 云存储。
- 点击 断开连接。
- 确认断开连接。
断开连接不会删除您现有的表。管理员需要手动删除 上传设置 中的表。
删除表格
断开与 Google Drive 文件夹的连接不会删除您导入的表格。管理员需要手动删除 上传设置 中的这些表。
更改 Google Drive 文件夹或表格
要更改 Google Drive 文件夹，您需要先断开当前连接，然后连接新的文件夹或表格。
如果您更改了同步目标，Metabase 将
- 保留之前文件夹/表格中的表
- 停止更新这些表
- 开始与新的文件夹/表格同步
如果您想删除旧文件夹中的表，管理员需要在 上传设置 中手动删除它们。
限制和注意事项
以下是您在同步 Google 表格时需要了解的事项
- 仅同步 Google 表格。我们只能导入 Google 表格格式文件——其他文件类型，如 CSV 或 Parquet 文件将不起作用，即使它们在您的 Google Drive 文件夹中。
- 列标题处理。如果我们在列标题（如空标题或重复名称）中遇到任何问题，我们会将该行视为数据并使用通用名称，如 Col1、Col2 等。
- 特殊字符替换。某些字符与数据库不兼容（例如“?”）。当我们在列名称中找到这些字符时，我们会将它们替换为“x”以确保运行顺畅。
- 重命名的文件将创建新表。如果您重命名文件夹中的文件或表格中的工作表，我们会将其视为全新的表并重新导入。
- 新列自动同步。向您的表格添加新列？没问题——它们将按预期显示在 Metabase 中。
- 空表格不会导入。我们不会导入完全空的表格或仅包含列标题的表格。其中需要有一些实际数据。
- Google 表格必须具有唯一的名称。如果同步的 Google Drive 文件夹（及其子文件夹）中的文件具有相同的名称（例如，一个表格在根文件夹中，另一个表格在子文件夹中），则表格可能无法正确同步。
Metabase 云存储配额管理
与上传的 CSV 数据一样，您的 Google 表格中的数据计入您的存储配额。
要检查您正在使用多少存储空间
- 登录到您的 Metabase。
- 点击右上角的“齿轮”图标。
- 选择管理员设置。
- 在 设置 选项卡中，点击 许可证和账单。
- 查看
- 当前存储的行数
- 最大存储行数
配额数字每 6 小时更新一次，因此可能会有轻微延迟。一旦您达到配额限制，您将无法上传/同步更多数据，直到您释放一些空间或增加您的存储。
要存储更多行，请参阅 增加 Metabase 云存储。