polars.read_json

polars.read_json(
    source: str | Path | IOBase | bytes,
    *,
    schema: SchemaDefinition | None = None,
    schema_overrides: SchemaDefinition | None = None,
    infer_schema_length: int | None = 100,
) → DataFrame

Считать данные из файла JSON в DataFrame.

Параметры:

source

Путь к файлу или объекту, подобному файлу (под «объектом, подобным файлу» подразумеваются объекты, у которых есть метод read(), например файловый обработчик, такой как встроенная функция open, или экземпляр BytesIO). Для объектов, подобных файлам, позиция потока после чтения может обновиться некорректно.

schemaSequence of str, (str,DataType) pairs, or a {str:DataType,} dict

Схему DataFrame можно задать несколькими способами:

• В виде словаря пар {имя:тип}; если тип равен None, он будет определён автоматически.
• В виде списка имён столбцов; в этом случае типы определяются автоматически.
• В виде списка пар (имя,тип); это эквивалентно форме словаря.

Если вы передадите список имён столбцов, не совпадающий с именами в исходных данных, указанные здесь имена заменят их. Количество имён в схеме должно соответствовать размерности исходных данных.

schema_overridesdict, default None

Поддерживает указание или переопределение типа одного или нескольких столбцов; обратите внимание, что любые типы данных, определённые на основе параметра schema, будут переопределены.

infer_schema_length

Максимальное количество строк для сканирования при определении схемы. Если задано значение None, может быть просканирован весь набор данных (это медленно).

См. также

read_ndjson

Примеры

>>> from io import StringIO
>>> json_str = '[{"foo":1,"bar":6},{"foo":2,"bar":7},{"foo":3,"bar":8}]'
>>> pl.read_json(StringIO(json_str))
shape: (3, 2)
┌─────┬─────┐
│ foo ┆ bar │
│ --- ┆ --- │
│ i64 ┆ i64 │
╞═════╪═════╡
│ 1   ┆ 6   │
│ 2   ┆ 7   │
│ 3   ┆ 8   │
└─────┴─────┘

Со схемой, заданной явно.

>>> pl.read_json(StringIO(json_str), schema={"foo": pl.Int64, "bar": pl.Float64})
shape: (3, 2)
┌─────┬─────┐
│ foo ┆ bar │
│ --- ┆ --- │
│ i64 ┆ f64 │
╞═════╪═════╡
│ 1   ┆ 6.0 │
│ 2   ┆ 7.0 │
│ 3   ┆ 8.0 │
└─────┴─────┘