pyarrow.unify_schemas#

pyarrow.unify_schemas(schemas, *, promote_options='default')#

通过按名称合并字段来统一 Schema。

生成的 Schema 将包含所有输入 Schema 中字段的并集。同名字段将被合并。请注意,默认情况下,类型不同的同名字段无法合并。

  • 统一后的字段将继承首次定义该字段的

    Schema 中的元数据。

  • Schema 中前 N 个字段的顺序将与

    第一个 Schema 中前 N 个字段的顺序相同。

生成的 Schema 将从第一个输入 Schema 继承其元数据。

参数:
schemaslist of Schema

要合并为一个 Schema 的多个 Schema。

promote_optionsstr, 默认 default

接受字符串“default”和“permissive”。Default(默认):null 类型仅能与另一种类型统一。Permissive(宽松):类型会被提升为共同的更高精度类型(greater common denominator)。

返回:
Schema
引发:
ArrowInvalid

如果任何输入 Schema 包含重复名称的字段,或者相同名称的字段无法合并,则抛出此异常。