pyarrow.field¶

pyarrow.field(name, type, bool nullable=True, metadata=None)¶

Create a pyarrow.Field instance.

Parameters:

namestr or bytes: Name of the field.
typepyarrow.DataType: Arrow datatype of the field.
nullablebool, default True: Whether the field’s values are nullable.
metadatadict, default None: Optional field metadata, the keys and values must be coercible to bytes.

Returns:

fieldpyarrow.Field

Examples

Create an instance of pyarrow.Field:

>>> import pyarrow as pa
>>> pa.field('key', pa.int32())
pyarrow.Field<key: int32>
>>> pa.field('key', pa.int32(), nullable=False)
pyarrow.Field<key: int32 not null>

>>> field = pa.field('key', pa.int32(),
...                  metadata={"key": "Something important"})
>>> field
pyarrow.Field<key: int32>
>>> field.metadata
{b'key': b'Something important'}

Use the field to create a struct type:

>>> pa.struct([field])
StructType(struct<key: int32>)

pyarrow.run_end_encoded

pyarrow.schema