Microsoft Excel - Alteryx 驱动程序
Alteryx 内置了 Microsoft Excel 的本地读写驱动程序。在 Alteryx Designer 中读写 .xlsx 工作表无需安装驱动程序或进行其他系统配置。
配置
通过 Alteryx 驱动程序可用于 Microsoft Excel (.xlsx) 文件的 输出数据工具 中的 文件格式选项 提供以下功能:
创建新的工作表
覆盖文件(移除)
覆盖工作表(删除)
附加到现有工作表
长度和限制
在读取和写入 .xlsx 文件时,Alteryx 驱动程序完全支持已经记录的 Excel 行数和列数限制。
最大行数(Excel 规定的限制) | 1,048,575 |
最大列数(Excel 规定的限制) | 16,384 |
列名称长度和字段名称限制 | 建议使用 256,以便与其他格式兼容 |
超出记录限制(1,048,575 行和 16,384 列) | 超出列限制会导致错误,超出行限制会导致文件被截断 |
超出文件大小限制(4,294,967,295 字节,大约 4GB) | 显示错误信息:“要写入至表格的数据太大。正在中止进程。” |
数据类型
Alteryx 驱动程序会分析工作表数据,以确定每列的数据类型和字段名称。
解析数据类型 | 如果某一列中有多种数据类型,则该列的数据类型将设置为 String/WString。 |
字符串值 | 尽可能返回窄字符串。 |
数字舍入 | 指定给单元格的格式将被忽略。例如,如果一个单元格中包含数值 1.27952,并且该单元格的格式设置为显示小数点后 2 位,则系统将返回完整的数值 1.27952,而不是 1.28。 |
日期、时间和日期时间 | 所有“日期”和“时间”都以 Alteryx 格式显示。“日期”数据类型的格式将取决于对列中数据的分析。
|
字段名称
字段/列名重复 | 原始 Excel 文件中的列名如下: abc, abc, abc, 123, 123, 123 读取的值如下: abc, abc2, abc3, 123, 123_2, 123_3 警告 这一更改可能会影响在 9.5 之前版本中创建的工作流。 |
格式为日期的列名 | 原始 Excel 文件中格式为日期的列名: 1/1/2014, 2/1/2014, 3/1/2014 将生成使用 Alteryx 默认日期格式的列名,如下所示: 2014-01-01, 2014-02-01, 2014-03-01 警告 这一更改可能会影响在 9.5 之前版本中创建的工作流。 |
工作表和范围名称中的特殊字符 | 对于工作表名称,Alteryx 现在支持 Excel 支持的所有字符。如果 Excel 支持在命名工作表时使用该字符,新的驱动程序就可以读取该字符,并且不会转换或更改任何字符。以下字符不适用于工作表名称:\ / ? * [ 和 ]。 警告 这一更改可能会影响在 9.5 之前版本中创建的工作流。如果输入指向由处理特殊字符的输出工具创建的 xlsx 文件,则工作表名称将有所不同。 |
公式错误
当工作表中的公式出错时,Alteryx 将为非字符串类型的字段返回一个 NULL 值,为字符串类型的字段返回实际错误字符串。
范围
用于 Microsoft Excel 的 Alteryx 驱动程序提供以下功能:
支持读取命名范围和显式范围。
支持写入显式范围。支持覆盖命名范围,但不能创建新的范围。
小心
Alteryx 支持在覆盖期间保留单元格格式(不包括模板)。
数据输出工作表名称
用于 Microsoft Excel 的 Alteryx 驱动程序支持读取工作表名称列表。
FileTables 支持
Alteryx 驱动程序支持读写 Microsoft SQL Server FileTable 中的 Excel 文件,方法是浏览 FileTable 的 UNC 路径,并对文件进行映射(就像存储在网络驱动器上的文件一样)。要将 Excel 文件写入 Microsoft SQL Server FileTable,必须在输出工具中选中格式特定选项 启用 SQL Server FileTable 支持 。
XLSX 写入支持的输出选项
创建工作表 | 附加工作表 | 覆盖工作表 | 覆盖文件 |
---|---|---|---|
如果存在现有文件:将创建一个新工作表。如果已有同名工作表,则会显示错误。 | 如果存在现有文件:数据将写入指定的工作表中。如果指定的工作表不存在,将出现错误。 | 如果存在现有文件:如果指定的工作表存在,系统会将其删除,然后将数据写入具有指定名称的新工作表中 | 如果存在现有文件:系统会删除现有文件,然后将数据写入新文件的新工作表中。 |
如果不存在现有文件:系统将创建一个新文件和新工作表。 | 如果不存在现有文件:将不会写入数据。 | 如果不存在现有文件:系统将创建一个新文件和新工作表。 | 如果不存在现有文件:系统将创建一个新文件和新工作表。 |
使用范围时的 XLSX 写入支持的其他信息
创建工作表/覆盖文件 | 附加工作表 | 覆盖工作表 |
---|---|---|
可以使用显式范围。 无法使用命名范围,因为命名范围与工作表绑定,而工作表不存在。 | 显式范围和命名范围都可以使用。 必须事先为工作表定义命名范围。 | 显式范围和命名范围都可以使用。 必须事先为工作表定义命名范围。 |
数据包含的列数不能超过指定范围,但可以少于指定范围。 如果传入的数据不足以填满范围,则列将被填入 null。 | 数据包含的列数不能超过指定范围,但可以少于指定范围。 如果该范围内的传入列较少,则未映射的列将被填入 null。 | 数据包含的列数不能超过指定范围,但可以少于指定范围。 如果传入的数据不足以填满范围,则列将被填入 null。 |
数据从指定范围第一行的左上角单元格开始写入。 | 数据将从原始数据之后的第一个可用行开始附加。附加时,不会覆盖任何现有数据。 无法将数据写入包含合并单元格的工作表。 列名应包含在范围中。如果范围中的第一行为空,则范围中包含数据的第一行将被用作列名。如果列名与传入数据不匹配,则必须使用输出数据工具中的“自定义附加映射器”手动将其映射到输出名称。 | 数据从指定范围第一行的左上角单元格开始写入。 无法将数据写入包含合并单元格的工作表 |
数据包含的行数可以超过指定范围。 数据将写入指定范围之外,直至:
| 数据包含的行数可以超过指定范围。 数据将写入指定范围之外,直至:
| 数据包含的行数可以超过指定范围。 数据将写入指定范围之外,直至:
|