管理表和视图
PlaidCloud 支持组织和管理表,包括标签。表可供项目内的所有工作流使用,并提供许多工具和选项。
除表之外,PlaidCloud 还提供基于表数据的视图。使用视图可在底层表发生更改时即时更新,同时节省数据存储空间。
选项包括:
- 同一个表可以存在于层次结构中的多个路径上(备用层次结构)
- 表可以打标签,以便在 PlaidCloud 流程中更容易地搜索和纳入
- 表可以进行版本管理
- 表可以发布,以便用于仪表板可视化
PlaidCloud 使用基于路径的系统来组织表,就像浏览一系列文件夹那样,从而使表的组织更加灵活、合理。借助该系统,表可以在层次结构中移动,也可以从层次结构中的不同位置创建对同一个表的多个引用(备用层次结构)。以这种方式管理表,可使结构反映运营、报表和控制方面的需求。
使用列表底部、行数旁边的筛选器搜索表的名称和标签。按 / 或 Ctrl/Cmd+F 可跳转到该处。同一个筛选器同时适用于树和扁平列表。筛选器旁边的全部 | 已发布开关可将列表缩小为已发布的表;默认设置为全部,并且在树和扁平列表中均适用。
表选项卡末尾的按工作流文件夹会将表归入读取或写入它们的各个工作流之下。打开某个工作流即可查看其表。该文件夹是同一批表的视图,因此无法从中移动或复制任何内容。
在表选项卡的工具栏中选择查找列,可找到具有指定名称的列的表。搜索读取的是列名而非数据,因此速度很快,并且只会找到已构建的表。如果您自打开该项目以来在其中运行过搜索,窗口会打开到您在该项目中最近一次运行的搜索。
至少输入两个字符,结果会随输入实时更新;也可按 Enter 立即搜索。显示所输入内容的结果后,在搜索框中按 Enter 会选中高亮显示的表,与在行上按 Enter 相同。选择名称的匹配方式:
- 精确 — 忽略大小写,匹配整个列名
- 包含 — 忽略大小写,匹配列名的一部分。这是默认设置。
- 模糊 — 匹配相近的名称,忽略大小写、空格、下划线和其他分隔符,并容许小的拼写错误。最接近的匹配排在最前。
窗口会记住您在该浏览器中上次选择的匹配方式。搜索框为空时,窗口会列出该浏览器中您在该项目里最近的五次搜索;选择其中一次可再次运行。按 Enter、从列表中选择它或对其结果执行操作时,该搜索即视为已运行,并加入列表。
每个匹配的表占一行,显示其名称、路径和前三个匹配的列。结果上方的一行会在搜索进行时统计目前找到的表数。使用精确或包含没有匹配项时,选择试试“模糊”? 可使用模糊重新搜索。如果搜索失败或提前停止,请选择重试。如果某些表的列无法读取,结果会说明其可能不完整。
当结果包含多个列名时,列表上方的标签块会列出最多 12 个列名(最常见的排在最前),并标明具有各列名的表数。选择某个标签块只列出具有该列的表,再次选择则列出全部。
展开某一行可查看:
- 匹配的列 — 每个匹配的列,若其类型为文本、整数、数字、日期、时间戳或布尔值则显示类型。以警告色显示的列在结果中的其他表里具有不同的类型;将鼠标悬停在其上可查看这些类型。
- 来源 — 写入此表的步骤所读取的表,每个表附有该步骤的名称
- 供给 — 读取此表的步骤所写入的表,每个表附有该步骤的名称
仅列出同一项目中的步骤。
要对结果执行操作:
- 双击某一行,或在其上按 Enter,可关闭窗口并在表选项卡中选中该表。如果树中显示的列搜索或全部 | 已发布开关隐藏了该表,则会将其清除,并有消息告知。按 Ctrl+Enter(Mac 上按 Cmd+Enter)可改为在表资源管理器中打开该表。在搜索框中按上、下方向键可在行之间移动。
- 选择在树中显示可将树和扁平列表缩小到结果中的表,或所选标签块对应的表,并展开树中包含它们的文件夹。列表上方的标签块会显示该搜索的名称并统计其表数。选择该标签块可再次打开该搜索,选择其上的 × 则显示所有表。刷新表选项卡会再次运行该搜索。
- 选择复制可复制列出的表,每行一个,其名称、路径、匹配的列及其类型以制表符分隔。
在树中显示和复制在搜索完成且至少有一个表时可用。
通过 MCP 连接的 AI 助手可使用 table_find(column=...) 找到相同的表。它可匹配整个名称、其一部分、开头或结尾,也可用 column_match='fuzzy' 匹配相近的名称,并返回匹配列的类型;对于模糊匹配,还会返回最接近的列有多接近。
要查找哪些表包含某个值,请从表选项卡的操作菜单中选择在数据中搜索值…(较慢),或右键单击某个表并选择它,仅在该表中查找。输入值,选择包含可匹配值的一部分,然后选择搜索。每个包含该值的表都会列出,同时显示其出现的列和一些匹配的值。双击某个表,或在其上按 Enter,即可在表资源管理器中打开它。某一列会打开按匹配行筛选的表。
搜索之前,请注意:
- 搜索会读取所搜索的每个表的每一行,因此可能非常慢,并占用大量仓库资源。窗口会对此发出警告,并且在搜索完成之前,搜索按钮保持关闭。
- 您只会看到本来就能打开的行。行级安全适用于每次搜索。
- 仓库的查询历史记录会记录您搜索的值。
- 搜索涵盖表的文本列。尚未构建的表会被跳过,并在警告中指明。
- 结果分页返回。当状态行指出搜索提前停止时,请选择搜索更多,继续搜索尚未搜索的表。
通过 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。当该变量有当前值时,该步骤会出现在前两个列表中,旁边带有信息图标。将鼠标悬停在该行上可查看步骤所存储的路径。
请将这些行视为其本身较弱的答案。它们描述的是现在开始的运行会涉及的内容,而不是曾经涉及该表的所有内容。更改变量后,读取的就是另一个表。
有些变量无法解析。要么根本没有任何东西设置过该变量,要么运行所用的值并非来自所存储的内容:工作流循环在迭代时从数据中获取变量,设置变量步骤在运行期间赋值,宏的变量由调用它的任何步骤传入,而由传感器启动的运行带有该传感器自身的详细信息。在每种情况下,运行之间所存储的内容都是上一次运行的遗留,而不是可信的值。PlaidCloud 不会将这些步骤解析为可能错误的表,而是在可能引用此表下按名称列出这些步骤及其无法解析的变量,以便您打开并检查。
您的角色看不到的步骤仍会列出,让您知道该表正在使用,但不显示其名称或工作流,且您无法打开它。删除表时,它仍会计入。您能看到的步骤列出时,不包含您的角色所隐藏的任何工作流。对架构师不隐藏任何内容。
注意:从表列表中删除表时,通过路径(无论带不带变量)访问某个表的步骤都会被视为正在使用它,即使其变量无法解析。删除窗口会列出该步骤,只有强制删除才会继续进行。
创建新的目录结构
Section titled “创建新的目录结构”添加新文件夹:
- 单击工具栏上的新建文件夹按钮
向现有文件夹中添加文件夹:
- 右键单击该文件夹
- 选择新建文件夹
选中内容位于文件夹内时,新文件夹名称的提示框中还有在顶层创建。勾选它,即可将新文件夹放在项目的顶层。
查看数据(表资源管理器)
Section titled “查看数据(表资源管理器)”使用数据资源管理器查看表数据。数据资源管理器提供数据的网格视图,以及按列汇总的值和统计信息。同时提供点击式筛选以及导出为常用文件格式的功能。筛选选择也可以保存为可在工作流中使用的提取步骤。
发布表以用于报表
Section titled “发布表以用于报表”仪表板可视化有意仅限于已发布的表。发布表时,可以提供一个可区分该数据的唯一名称。当表在生成它的工作流部分中的名称较为晦涩,但需要为构建仪表板的人提供更清晰的名称时,这会很有用。
已发布的表没有关联的路径。它们会显示为一个表列表,供仪表板区域使用。
为查看角色标记表
Section titled “为查看角色标记表”可以通过单击“探索者”或“管理者”复选框来控制各角色对表的查看。如果需要更新多个表,请在层次结构中选择这些表,然后从顶部工具栏的“操作”菜单中选择所需的查看角色。
用备注描述表内容
Section titled “用备注描述表内容”向表添加备注,以帮助理解数据。
查看表的形状、大小和最后更新时间
Section titled “查看表的形状、大小和最后更新时间”表层次结构中显示每个表的行数、列数和数据大小。对于非常大的表(数百万行),行数可能是估算的,并会显示近似行数的指示符。
查看其他表属性
Section titled “查看其他表属性”查看和编辑其他表属性:
- 选择一个表
- 单击以查看右侧的表上下文表单。
复制表:
- 选择该表
- 单击顶部工具栏上的复制按钮。
从表创建 Panel 应用
Section titled “从表创建 Panel 应用”选择表或视图,然后从新建菜单或右键菜单中选择创建 Panel 应用。新建 Studio 应用对话框会打开,并已选好项目和表。应用沿用表的名称,可按需更改,然后选择创建,Panel Studio 会打开它,Weave 已准备好构建其首页。当您选择单个表或视图、对项目具有编辑权限且项目不是只读时,该命令可用。请参阅创建 Panel 应用。
查看表存储的内容
Section titled “查看表存储的内容”表列表在每个表的大小旁边显示当前数据、历史记录、时间回溯天数和备注列。时间回溯天数是表自身的设置;1 表示使用项目的默认值。列表下方的状态栏给出项目的总量:它存储了多少内容,其中多少是当前数据,多少是历史记录。标记为估算的大小来自表的形状,直至 PlaidCloud 对其进行测量。
在操作菜单中选择存储,可打开项目的存储窗口,其中包含释放空间的建议和时间旅行设置。请参阅管理存储。
从表创建数据编辑器
Section titled “从表创建数据编辑器”可以一步将表转换为已配置的数据编辑器:选择该表,然后从新建菜单或右键菜单中选择从表创建数据编辑器。PlaidCloud 会检查表的列并预先构建编辑器的输入控件。有关详细信息,请参阅从表创建数据编辑器。