管理表和视图
PlaidCloud 提供组织和管理表的功能，包括标签。表可供项目内的所有工作流使用，并具有许多工具和选项。
除表之外，PlaidCloud 还提供基于表数据的视图。使用视图可以在底层表发生变化时即时更新，同时节省数据存储空间。
选项包括：
- 同一个表可以存在于层次结构中的多个路径上（备用层次结构）
- 表可以添加标记，便于搜索并纳入 PlaidCloud 流程
- 表可以进行版本管理
- 表可以发布，以便用于仪表板可视化
PlaidCloud 使用基于路径的系统来组织表，就像浏览一系列文件夹一样，使表的组织更加灵活合理。借助这一系统，可以在层次结构内移动表，也可以从层次结构中的不同位置创建对同一个表的多个引用（备用层次结构）。以这种方式管理表，可以使结构反映运营、报表和管控的需要。
使用层次结构左下方的筛选框搜索表名称和标签。匹配结果显示在上方的层次结构中。
表选项卡末尾的 By Workflow 文件夹将表按读取或写入它们的每个工作流分组。打开某个工作流即可查看其表。该文件夹只是同一批表的视图，因此无法从中移动或复制任何内容。
在表选项卡的列搜索框中输入列名，即可只显示含有该名称列的表。选择包含可匹配列名的一部分，而不是完整名称。清空该框可再次显示所有表。较长的搜索结果可能分页返回，状态行会说明搜索仍在进行或结果可能不完整。
选择 Column Tree 可在单独的窗口中搜索。每个含有该列的表都会展开为两个列表：
- Fed by：为该列提供数据的表
- Feeds：该列继续为其提供数据的表
通过 MCP 连接的 AI 助手使用 table_find(column=...) 可找到相同的表，匹配完整名称或其中一部分。
若要查找哪些表包含某个值，请在表选项卡上选择 Search Values，或右键点击某个表并选择 Search Value，以仅在该表中查找。输入值，选择包含以匹配值的一部分，然后选择搜索。每个包含该值的表都会列出，同时给出该值出现的列以及若干匹配值。
搜索之前，请注意：
- 您只会看到自己本来就能打开的行。行级安全适用于每一次搜索。
- 您的数据仓库的查询历史会记录您搜索的值。
- 搜索涵盖表的文本列。尚未构建的表会被跳过，并在警告中指明。
- 结果分页返回。当状态行显示搜索提前停止时，选择 Search more 可继续搜索尚未搜索的表。
通过 MCP 连接的 AI 助手使用 table_value_search。它返回包含该值的表和列，绝不返回值本身。当您在项目中请 AI 助手查找某个值时，Weave 会将匹配的表和列的名称发送给语言模型提供商。
导入 CSV 文件
Section titled “导入 CSV 文件”将 CSV 文件转为此项目中的新表：
- 将文件从您的计算机拖到项目的表列表上，或在工具栏上选择新建 > 来自CSV文件的表，然后将文件拖到框中或点击选择 CSV 文件。
- PlaidCloud 会将文件上传到您的 Personal Temp Drive（如果您没有，则上传到工作区的 Temp Drive），并将其导入列表顶层的新表中，表名以文件命名：
Sales Data.csv会变成sales_data。如果项目中已有同名的表，新表会加上编号，例如sales_data_2。 - 列表刷新后会选中新表，并在其上打开数据概览。有关该面板显示的内容，请参阅从您自己的 CSV 开始。
只接受以 .csv 结尾的文件。您需要具有创建表以及写入文档存储的权限，且锁定的项目在解锁之前不接受 CSV。如果导入失败，窗口会说明原因，项目保持原样。导入完成后，无论成功与否，PlaidCloud 都会从临时驱动器中删除上传的文件；如果删除失败，临时驱动器会在一天后将其删除。
移动表：
- 将其拖到您希望其所在的文件夹中
重命名表：
- 右键点击该表
- 选择重命名选项
- 输入新名称并保存
- 该表现已重命名，但保留其原始的唯一标识符。
清除表：
- 在层次结构中选择表
- 点击顶部工具栏上的清除按钮。
备注：您可以清除单个表，也可以清除多个表
删除表：
- 在层次结构中选择表
- 点击顶部工具栏上的删除按钮
- 删除操作会检查该表是否正被工作流步骤或视图使用。如果是，系统会要求您先移除这些关联，然后才能删除。
备注：您也可以强制删除表。强制删除会使引用失效，因此应谨慎使用。
删除窗口会显示该表上次被读取的时间，例如 Last read 3 days ago by 某个人员或步骤，以便您区分无人使用的表和仍在使用的表。PlaidCloud 从您的数据仓库自身的查询历史中获取这些信息，并排除其自身维护操作产生的读取。
| 数据仓库 | 所需条件 |
|---|---|
| Snowflake | 读取记录来自 Access History，Snowflake 记录它最多会延迟约 3 小时。连接的角色需要 SNOWFLAKE.GOVERNANCE_VIEWER 数据库角色（对 SNOWFLAKE 数据库授予 IMPORTED PRIVILEGES 也可以）。Snowflake Standard 版没有 Access History。 |
| Databricks | 读取记录来自血缘表，Databricks 记录它同样有延迟，因此最近的读取可能尚未显示。连接的身份需要具有 system 的 USE CATALOG、system.access 的 USE SCHEMA，以及 system.access.table_lineage 的 SELECT。 |
| PlaidCloud Lakehouse | 读取历史记录暂不可用。窗口显示 Read history incomplete。 |
连接数据仓库时，连接检查会建议补充缺失的上述授权，并附上要运行的语句。这些授权是建议项而非必需项：没有它们，数据仓库也能连接，窗口会显示 Read history incomplete。
当 PlaidCloud 无法读取完整历史记录时，该行会显示 Read history incomplete，绝不会以“无读取”代替。任何对您的数据仓库拥有直接 SQL 访问权限的人，都可以设置会话标记，从而改变其自身读取的标注方式。
通过 MCP 连接的 AI 助手使用 table_describe(include=['last_read']) 可得到相同的结果。
查看表的使用位置
Section titled “查看表的使用位置”选择一个表会打开其详细信息面板，其中列出涉及该表的工作流步骤：
- 表创建者：写入该表的步骤
- 表的贡献目标：从该表读取的步骤
- 可能引用此表：通过无法解析的变量访问某个表的步骤。仅当存在此类步骤时才会显示此部分。
步骤可以直接指定表名，也可以通过包含变量的路径访问表，例如 /Periods/{period}/Sales。如果该变量当前有值，该步骤会出现在前两个列表中，旁边带有一个信息图标。将鼠标悬停在该行上可查看步骤所存储的路径。
请将这些行视为较弱的答案。它们描述的是此刻开始的运行将涉及的内容，而不是曾经涉及该表的所有内容。更改变量后，读取的就是另一个表。
有些变量无法解析。要么根本没有任何内容设置过该变量，要么运行所用的值并非来自存储的内容：Workflow Loop 在迭代时从数据中获取其变量，Set Variable 步骤在运行期间赋值，宏的变量由调用它的任何步骤传入，而由传感器启动的运行带有该传感器自己的详细信息。在这些情况下，运行之间所存储的内容都是上一次运行遗留的，而不是值得信赖的值。PlaidCloud 不会将它们解析为可能有误的表，而是在可能引用此表下按名称列出这些步骤，并附上它无法解析的变量，以便您打开并检查。
您的角色看不到的步骤仍会列出，这样您就知道该表正在使用，但不显示其名称或工作流，也无法打开。删除表时它仍会计入。您能看到的步骤会列出，但不包含您的角色所隐藏的任何工作流。对架构师不隐藏任何内容。
备注：从表列表中删除表时，通过路径（无论是否带变量）访问某个表的步骤都算作使用了它，即使其变量无法解析也是如此。删除窗口会列出该步骤，只有在您强制删除时才会继续。
创建新的目录结构
Section titled “创建新的目录结构”添加新文件夹：
- 点击工具栏上的新建文件夹按钮
将文件夹添加到现有文件夹中：
- 右键点击该文件夹
- 选择新建文件夹
查看数据（表资源管理器）
Section titled “查看数据（表资源管理器）”使用数据资源管理器查看表数据。数据资源管理器提供数据的网格视图，以及按列汇总的值和统计信息。既可以通过点选进行筛选，也可以导出为常见的文件格式。筛选选择还可以保存为可在工作流中使用的 Extract 步骤。
发布表用于报表
Section titled “发布表用于报表”仪表板可视化有意仅限于已发布的表。发布表时，可以提供一个唯一名称来区分数据。当表在生成它的工作流部分中名称较为晦涩，而构建仪表板的人需要更清晰的名称时，这会很有用。
已发布的表没有关联的路径。它们会显示为一个表列表，供仪表板区域使用。
为查看角色标记表
Section titled “为查看角色标记表”可以通过点击探索者或管理者复选框来控制各角色对表的查看。如果需要更新多个表，请在层次结构中选择这些表，然后从顶部工具栏的操作菜单中选择所需的查看角色。
用备忘录描述表内容
Section titled “用备忘录描述表内容”为表添加备忘录，帮助理解数据。
查看表的形状、大小和最后更新时间
Section titled “查看表的形状、大小和最后更新时间”层次结构中会显示每个表的行数、列数和数据大小。对于非常大的表（数百万行），行数可能是估算值，并会显示表示近似行数的标识。
查看其他表属性
Section titled “查看其他表属性”查看和编辑其他表属性：
- 选择一个表
- 点击右侧的查看表上下文表单。
复制表：
- 选择该表
- 点击顶部工具栏上的复制按钮。
从表创建数据编辑器
Section titled “从表创建数据编辑器”只需一步即可将表转换为已配置的数据编辑器：选择该表，然后从新建菜单或右键菜单中选择从表创建数据编辑器。PlaidCloud 会检查表的列并预先构建编辑器的输入控件。详情请参阅从表创建数据编辑器。