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