导入固定宽度文件
导入以字符位置而非分隔符来定义列的文本文件——这是经典的大型机 / COBOL 输出格式。按字段配置列边界（起始位置、长度）。
常见于传统 ERP 导出、政府申报文件和银行对账单格式，这些数据按固定列显示排版，而不是按分隔符解析。
固定宽度导入通过临时存储以流式方式处理，而不是将整个文件加载到内存中，因此导入超大文件也不会耗尽内存。
暂无示例…
此转换中的文件选择器用于选择存储在 PlaidCloud 文档位置中的文件进行导入。
也可以选择一个目录进行导入，该目录中的所有文件都将在转换运行时一并导入。
源账户
选择您有权访问的 PlaidCloud 文档账户。这样可以在下一项选择中选取目录或文件。
在项目内，列表顶部还提供 项目默认 — 代表项目当前设置为默认的账户。如果项目设有默认账户，新步骤会预选“项目默认”；现有步骤在您更改之前，会保留其已保存的账户。保持为“项目默认”的步骤，运行时会使用运行当时项目的默认账户 — 如果未设置，则运行失败并指明该项目，而不会回退到其他账户。
搜索选项
搜索 选项可以在指定目录路径下查找所有匹配的文件进行导入。如果需要包含许多文件，但它们存储在嵌套目录中，或与不想导入的其他文件混放在同一目录中，此选项尤其有用。
所选的搜索路径是搜索的起始目录。搜索过程会查找该目录及其子目录中符合指定搜索条件的所有文件。请确保搜索条件同样适用于子目录中的文件。
搜索可以应用以下条件：
- 精确：与搜索文本完全匹配
- 开头为：匹配以搜索文本开头的任何文件
- 包含：匹配包含搜索文本的任何文件
- 结尾为：匹配以搜索文本结尾的任何文件
AI 助手或 REST API 还可以将搜索设置为 glob（一种通配符模式，例如 CO Store*.yxdb，对整个文件名进行匹配且忽略大小写），或 regex（整个文件名必须匹配的正则表达式）。除非以 (?i) 开头，否则正则表达式区分大小写。
源文件路径
当需要导入特定文件或一组目录中的文件时，选择该文件或目录是比使用搜索更好的方式。
要选择文件或目录，只需使用浏览按钮，在上方所选的文档账户中选取路径。
变量替换
无论是搜索选项还是特定文件/目录选项，路径、搜索文本和文件名中都可以使用变量。
以下示例使用 current_month 变量动态指向正确的文件：
legal_entity/inputs/{current_month}/ledger_values.csv目标表
导入的目标只能选择表，因为视图不包含底层数据。
动态选项
动态选项允许使用文本（包括变量）指定表。在由变量驱动的工作流中，表和视图的引用是相对于所指定变量的，此选项非常有用。
以下示例使用 current_month 变量动态指向目标表：
legal_entity/inputs/{current_month}/ledger_values静态选项
如果希望将特定的表作为导入目标，请不要勾选 动态 复选框，然后选择目标表。
如果目标表不存在，请选择 新建表 按钮，在所需位置创建该表。
任何表选择旁边都始终提供表资源管理器。单击表选择右侧的表资源管理器按钮，即可打开表资源管理器窗口。
删除非 ASCII 字符选项
选择此选项后，导入将删除所有非 ASCII 内容。虽然 PlaidCloud 完全支持 Unicode (UTF-8)，但现实中的文件可能包含各种编码和杂散字符，给处理带来困难。
如果文件内容预期仅包含 ASCII，勾选此复选框有助于确保导入过程顺利运行。
导入后删除文件选项
此选项允许导入过程在成功完成导入后，从 PlaidCloud 文档账户中删除该文件。
如果导入文件可以从记录系统重新生成，或者处理完毕后没有理由保留原始输入文件，此选项会很有用。
仅删除已导入的文件。导入期间被跳过或产生警告的文件会保留在文件夹中。
源文件未更改时跳过重新导入选项
启用此选项后，如果源文件和步骤设置自上次成功运行以来没有变化，此步骤的工作流运行会跳过整个导入过程 — 包括下载、转换和表重建。这样可以避免计划工作流在源文件未变化时重复执行相同的工作。
步骤会按路径、大小和最后修改时间（以及源提供的内容哈希，如有）比较每个源文件。如果有任何文件被添加、移除或更改，或步骤的配置发生变化，导入将照常运行。此选项 默认启用 — 取消勾选即可始终重新导入 — 而手动的一次性导入始终会运行。
跳过还要求目标表仍保留上次导入所加载的行。如果该表此后已被清空，或无法读取其行数，则导入会再次运行，而不是跳过，以免下游步骤没有数据。
某些源（例如 SFTP）不提供内容哈希，因此对这些源，变化信号仅为文件的大小和最后修改时间。原地替换且大小和修改时间相同的文件会被视为未更改而被跳过 — 对于源可能以这种方式更新的步骤，请取消勾选此选项。
由于 Excel 文件可能包含也可能不包含标题行，PlaidCloud 提供了三种方式：使用标题行、忽略标题行，或使用列顺序来确定列的对齐方式。
- 无标题行：文件不包含标题行。使用数据映射器中的源列表来确定列的对齐方式
- 有标题行 - 使用标题行并覆盖字段列表：文件有标题行。使用指定的标题名称，并忽略数据映射器中的源列表。
- 有标题行 - 跳过标题行并改用字段列表：文件有标题行，但应忽略。使用数据映射器中源列表指定的标题名称。
对于含有多余记录的输入文件，可以指定在处理数据之前要跳过的行数。如果文件中包含必须先跳过才能到达表格数据的标题块，这一设置会很有用。
输入各列的宽度，以逗号或空格分隔。
| 设置 | 作用 |
|---|---|
| 编码 | 文件的字符集：UTF-8（默认）、EBCDIC（美国，cp037）、EBCDIC（国际，cp500） 或 拉丁字母-1（Latin-1）。大型机文件请选择 EBCDIC 代码页。 |
| 跳过的记录数 | 在标题行或数据之前，从文件开头跳过多少条记录。 |
| 末尾丢弃的记录数 | 从文件末尾丢弃多少条记录，例如尾部记录。 |
| 每行一条记录 | 开启（默认）时，每行为一条记录。对于记录首尾相接、没有换行符的文件，请取消勾选；此时每条记录的长度等于各列宽度之和。 |
| 记录之间的字符数 | 当记录并非每行一条时，每条记录之后要跳过多少个字符，例如分隔符。 |
| 去除空白 | 从每个值中去除的空白：开头和结尾（默认）、仅结尾或无。 |
数据映射器配置
数据映射器用于将源数据中的列映射到目标数据表。
检查并填充映射器
使用 检查源 菜单按钮可以通过更多方式将源中的列映射到目标：
- 填充两个映射表：将源数据表中的所有值传播到目标数据表。这是默认行为。
- 仅填充源映射表：仅映射源数据表中的所有值。当源列结构发生变化而需要修改现有工作流时，此选项很有用。
- 仅填充目标映射表：仅将所有值传播到目标数据表。
如果上述源列和目标列选项仍不够用，还可以通过以下几种方式向目标数据表添加其他列：
- 全部传播 会将所有源列插入目标数据表，无论这些列是否已存在。
- 传播所选项 仅插入所选的源列。
- 在目标侧右键单击并选择 插入行，可在当前所选行的正上方插入一行。
- 在目标侧右键单击并选择 追加行，可在目标数据表的底部（最右侧）插入一行。
删除列
要从目标数据表中删除列，请选择所需的列，然后右键单击并选择 删除。
不再列出的源列
目标行可能指定了某个 源列，而源数据表已不再列出该列，例如在重新检查源之后。步骤绝不会自动移除这样的行，而是将列名显示为红色，并在前面加上 ⚠ 警告标志；将鼠标悬停在其上，会提示该列不在源列中。在包含多个表的步骤（如联合）中，每个表都会分别对照其自身的源列进行检查。
带有 常量、表达式 或 计数（含空值） 汇总的行不会被标记，因为步骤不会读取其源列。当源数据表没有列出任何列时（例如首次检查源之前），也不会标记任何内容。
保存仍含有已标记行的步骤时，会出现 发现过时列 对话框，按其所在的选项卡或表列出这些行，并提供三个选项：
- 全部移除并保存 — 移除已标记的行，然后保存。
- 仍然保存 — 按现状保存步骤。
- 取消 — 返回步骤，不保存。
要保留某一行并清除其警告，请将该列重新添加到源数据表，或选择源数据表中列出的某一列。
列数据类型
每个目标列都带有一个 类型。从源传播而来的列沿用源列的类型；手动添加的行起初为 文本，需要设置 类型 来指明其实际类型 — 打算求和或排序的列需要使用数值或日期类型，因为文本会按文本方式排序和求和。
保存时没有任何类型的列，步骤仍可运行。类型会在步骤启动时根据该列所读取的源列确定。如果无处可读，则视为文本：提取 SQL 步骤的列来自您编写的查询，而不是映射的源；如果多个源中存在同名列但类型不一致，则使用文本，而不是随意选择其中一种 — 猜错会产生仓库可能拒绝的转换，而任何类型都可以转换为文本。
自行设置 类型 仍然是指明列应为何种类型的方式。不设置则意味着接受源列恰好具有的类型。
更改列顺序
要重新排列目标数据表中的列，请选择所需的列。可以使用以下任一方式：
- 批量移动箭头：从右上角的箭头中选择所需的移动选项
- 上下文菜单：右键单击并选择 移到顶部、上移、下移 或 移到底部。
仅返回非重复记录
要仅返回非重复的选项，请选择 非重复 菜单选项。这会为源中的每一列切换显示一组复选框。只需勾选相应列旁边的复选框，即可仅返回非重复的结果。
视情况而定，您可能需要考虑改用汇总。
非重复处理会保留找到的第一条唯一记录，并丢弃其余记录。如果运行之间的一致性很重要，可能需要对数据进行排序。
聚合与分组
要聚合结果，请选择 汇总 菜单选项。这会为目标数据表中的每一列切换显示一组选择框。请为每一列选择合适的汇总方法。
当 检查源 填充列时，如果数值列的名称读起来像标识符（例如 id、customer_id、Order No 或 CustomerKey），或者其所在表将其设为键，或者联接将其用作键，则该列起初为 分组依据，而不是 求和。
- 分组依据
- 求和
- 最小值
- 最大值
- 第一个
- 最后一个
- 计数
- 计数（含空值）
- 平均值
- 标准差
- 样本标准差
- 总体标准差
- 方差
- 样本方差
- 总体方差
- 高级非分组
有关表达式、清理和常量等高级数据映射器用法，请参阅高级数据映射器用法
为了获得最大的灵活性，源数据和目标数据都可以使用数据筛选器。对于较大的数据集，在源端筛选掉部分行尤其有益，这样后续操作只需处理较小的数据集。
选择数据子集
此筛选器类型用于根据指定条件筛选传入的源数据。
对结果数据应用二次筛选器
此筛选器类型用于根据指定条件对转换后的结果数据应用筛选器。 对转换后的结果应用筛选器，可以基于复杂计算、汇总或窗口函数的结果进行排除。
最终数据表切片（限制）
行切片功能可根据范围和起始点限制结果集中的行数。
筛选器语法
筛选器语法使用 Python SQLAlchemy，与其他表达式的语法相同。
有关示例和表达式函数，请参阅表达式部分。