polars.read_json#
- polars.read_json(
- source: str | Path | IOBase | bytes,
- *,
- infer_schema_length: int | None = 100,
- schema: SchemaDefinition | None = None,
- schema_overrides: SchemaDefinition | None = None,
Read into a DataFrame from a JSON file.
- Parameters:
- source
Path to a file or a file-like object (by file-like object, we refer to objects that have a
read()
method, such as a file handler (e.g. via builtinopen
function) orBytesIO
).- infer_schema_length
Infer the schema from the first
infer_schema_length
rows.- schemaSequence of str, (str,DataType) pairs, or a {str:DataType,} dict
The DataFrame schema may be declared in several ways:
As a dict of {name:type} pairs; if type is None, it will be auto-inferred.
As a list of column names; in this case types are automatically inferred.
As a list of (name,type) pairs; this is equivalent to the dictionary form.
If you supply a list of column names that does not match the names in the underlying data, the names given here will overwrite them. The number of names given in the schema should match the underlying data dimensions.
- schema_overridesdict, default None
Support type specification or override of one or more columns; note that any dtypes inferred from the schema param will be overridden. underlying data, the names given here will overwrite them.
See also