Skip to main content
Version: 1.4.1 (latest)

JSONL - JSON Lines - JSON Delimited

JSON delimited is a file format that stores several JSON documents in one file. The JSON documents are separated by a new line.

Additional data types are stored as follows:

  • datetime and date are stored as ISO strings;
  • decimal is stored as a text representation of a decimal number;
  • binary is stored as a base64 encoded string;
  • HexBytes is stored as a hex encoded string;
  • json is serialized as a string.

This file format is compressed by default.

Supported destinations

This format is used by default by: BigQuery, Snowflake, Filesystem.

How to configure

There are several ways of configuring dlt to use jsonl file format for normalization step and to store your data at the destination:
  1. You can set the loader_file_format argument to jsonl in the run command:
info = pipeline.run(some_source(), loader_file_format="jsonl")
  1. You can set the loader_file_format in config.toml or secrets.toml:
[normalize]
loader_file_format="jsonl"
  1. You can set the loader_file_format via environment variable:
export NORMALIZE__LOADER_FILE_FORMAT="jsonl"
  1. You can set the file type directly in the resource decorator.
@dlt.resource(file_format="jsonl")
def generate_rows(nr):
    pass

This demo works on codespaces. Codespaces is a development environment available for free to anyone with a Github account. You'll be asked to fork the demo repository and from there the README guides you with further steps.
The demo uses the Continue VSCode extension.

Off to codespaces!

DHelp

Ask a question

Welcome to "Codex Central", your next-gen help center, driven by OpenAI's GPT-4 model. It's more than just a forum or a FAQ hub – it's a dynamic knowledge base where coders can find AI-assisted solutions to their pressing problems. With GPT-4's powerful comprehension and predictive abilities, Codex Central provides instantaneous issue resolution, insightful debugging, and personalized guidance. Get your code running smoothly with the unparalleled support at Codex Central - coding help reimagined with AI prowess.