{ "$schema": "/products/haybarn/functions/api/v1/function.schema.json", "schemaVersion": 1, "name": "read_ndjson_auto", "schema": "main", "slug": "read_ndjson_auto", "description": null, "category": "json", "kinds": [ "table" ], "aliasOf": [], "snapshot": { "schemaVersion": 1, "id": "duckdb-1.4.4", "engine": "duckdb", "label": "DuckDB 1.4.4", "engineVersion": "v1.4.4", "sourceId": "6ddac802ff", "source": "https://github.com/duckdb/duckdb/releases/tag/v1.4.4", "binarySha256": "8d05bee013ea13d6b5d75272d7ddb52b3d6d9cdaf30d1a3e8e82d42757905182", "capturedAt": "2026-09-05T18:37:36.091Z", "requestedExtensions": [ "core_functions", "icu", "json", "parquet" ], "loadedExtensions": [ { "extension_name": "autocomplete", "extension_version": "v1.4.4", "installed_from": "" }, { "extension_name": "core_functions", "extension_version": "v1.4.4", "installed_from": "" }, { "extension_name": "icu", "extension_version": "v1.4.4", "installed_from": "" }, { "extension_name": "json", "extension_version": "v1.4.4", "installed_from": "" }, { "extension_name": "parquet", "extension_version": "v1.4.4", "installed_from": "" }, { "extension_name": "shell", "extension_version": "v1.4.4", "installed_from": "" } ], "scope": "Built-in functions in the main schema, with the requested extensions loaded. Catalog visibility is not a guarantee of browser support." }, "links": { "html": "/products/haybarn/functions/releases/duckdb-1.4.4/read_ndjson_auto/", "markdown": "/products/haybarn/functions/releases/duckdb-1.4.4/read_ndjson_auto/index.md", "json": "/products/haybarn/functions/api/v1/duckdb-1.4.4/functions/read_ndjson_auto.json" }, "interpretation": [ "Choose a snapshot matching the target engine and build. The default is captured from the published Haybarn WASM package used by the browser playground. Historical native snapshots are also available.", "Availability is an observation in the recorded build and extension profile, not a guarantee of support in every installation or in WASM.", "Types and descriptions are declarations from duckdb_functions(). Binding can specialize result types. Null means not supplied by the catalog; do not invent defaults, optionality, argument mode, or table output columns.", "Raw parameter arrays preserve catalog order for scalar/aggregate/macro functions. Raw table arguments are alphabetical. Use callingConvention for engine-confirmed positional order and named arguments; null modes are unrecorded. Named does not mean optional. Macro defaults and special named variadic behavior are not supplied by duckdb_functions().", "Catalog examples are source material and may require data or extensions. runnableExamples contains separately verified SQL for the pinned WASM package; sample-data adaptations and guide examples are labeled separately.", "Guide annotations and recipes are separate editorial content. The browser runner always uses Haybarn WASM 1.5.5-rc3, independently of the documentation snapshot.", "All URLs beginning with / are relative to the origin hosting this document. Exports require no JavaScript, cookies, API key, or browser engine." ], "overloads": [ { "id": "overload-58df5ad3a4aed536", "url": "/products/haybarn/functions/releases/duckdb-1.4.4/read_ndjson_auto/#overload-58df5ad3a4aed536", "signature": "read_ndjson_auto(col0: VARCHAR, auto_detect := BOOLEAN, columns := ANY, compression := VARCHAR, convert_strings_to_integers := BOOLEAN, date_format := VARCHAR, dateformat := VARCHAR, field_appearance_threshold := DOUBLE, filename := ANY, format := VARCHAR, hive_partitioning := BOOLEAN, hive_types := ANY, hive_types_autocast := BOOLEAN, ignore_errors := BOOLEAN, map_inference_threshold := BIGINT, maximum_depth := BIGINT, maximum_object_size := UINTEGER, maximum_sample_files := BIGINT, records := VARCHAR, sample_size := BIGINT, timestamp_format := VARCHAR, timestampformat := VARCHAR, union_by_name := BOOLEAN) → TABLE", "parameterOrder": "alphabetical-not-call-order", "callingConvention": { "source": "engine-binder", "parameters": [ { "name": "auto_detect", "type": "BOOLEAN", "mode": "named", "position": null }, { "name": "col0", "type": "VARCHAR", "mode": "positional", "position": 0 }, { "name": "columns", "type": "ANY", "mode": "named", "position": null }, { "name": "compression", "type": "VARCHAR", "mode": "named", "position": null }, { "name": "convert_strings_to_integers", "type": "BOOLEAN", "mode": "named", "position": null }, { "name": "date_format", "type": "VARCHAR", "mode": "named", "position": null }, { "name": "dateformat", "type": "VARCHAR", "mode": "named", "position": null }, { "name": "field_appearance_threshold", "type": "DOUBLE", "mode": "named", "position": null }, { "name": "filename", "type": "ANY", "mode": "named", "position": null }, { "name": "format", "type": "VARCHAR", "mode": "named", "position": null }, { "name": "hive_partitioning", "type": "BOOLEAN", "mode": "named", "position": null }, { "name": "hive_types", "type": "ANY", "mode": "named", "position": null }, { "name": "hive_types_autocast", "type": "BOOLEAN", "mode": "named", "position": null }, { "name": "ignore_errors", "type": "BOOLEAN", "mode": "named", "position": null }, { "name": "map_inference_threshold", "type": "BIGINT", "mode": "named", "position": null }, { "name": "maximum_depth", "type": "BIGINT", "mode": "named", "position": null }, { "name": "maximum_object_size", "type": "UINTEGER", "mode": "named", "position": null }, { "name": "maximum_sample_files", "type": "BIGINT", "mode": "named", "position": null }, { "name": "records", "type": "VARCHAR", "mode": "named", "position": null }, { "name": "sample_size", "type": "BIGINT", "mode": "named", "position": null }, { "name": "timestamp_format", "type": "VARCHAR", "mode": "named", "position": null }, { "name": "timestampformat", "type": "VARCHAR", "mode": "named", "position": null }, { "name": "union_by_name", "type": "BOOLEAN", "mode": "named", "position": null } ], "positional": [ { "name": "col0", "type": "VARCHAR", "mode": "positional", "position": 0 } ], "named": [ { "name": "auto_detect", "type": "BOOLEAN", "mode": "named", "position": null }, { "name": "columns", "type": "ANY", "mode": "named", "position": null }, { "name": "compression", "type": "VARCHAR", "mode": "named", "position": null }, { "name": "convert_strings_to_integers", "type": "BOOLEAN", "mode": "named", "position": null }, { "name": "date_format", "type": "VARCHAR", "mode": "named", "position": null }, { "name": "dateformat", "type": "VARCHAR", "mode": "named", "position": null }, { "name": "field_appearance_threshold", "type": "DOUBLE", "mode": "named", "position": null }, { "name": "filename", "type": "ANY", "mode": "named", "position": null }, { "name": "format", "type": "VARCHAR", "mode": "named", "position": null }, { "name": "hive_partitioning", "type": "BOOLEAN", "mode": "named", "position": null }, { "name": "hive_types", "type": "ANY", "mode": "named", "position": null }, { "name": "hive_types_autocast", "type": "BOOLEAN", "mode": "named", "position": null }, { "name": "ignore_errors", "type": "BOOLEAN", "mode": "named", "position": null }, { "name": "map_inference_threshold", "type": "BIGINT", "mode": "named", "position": null }, { "name": "maximum_depth", "type": "BIGINT", "mode": "named", "position": null }, { "name": "maximum_object_size", "type": "UINTEGER", "mode": "named", "position": null }, { "name": "maximum_sample_files", "type": "BIGINT", "mode": "named", "position": null }, { "name": "records", "type": "VARCHAR", "mode": "named", "position": null }, { "name": "sample_size", "type": "BIGINT", "mode": "named", "position": null }, { "name": "timestamp_format", "type": "VARCHAR", "mode": "named", "position": null }, { "name": "timestampformat", "type": "VARCHAR", "mode": "named", "position": null }, { "name": "union_by_name", "type": "BOOLEAN", "mode": "named", "position": null } ], "variadic": null, "evidence": { "query": "EXPLAIN SELECT * FROM \"read_ndjson_auto\"(NULL::VARCHAR, __guide_invalid_named_parameter__ := NULL);", "diagnostic": "Binder Error: Invalid named parameter \"__guide_invalid_named_parameter__\" for function read_ndjson_auto\nCandidates:\n auto_detect BOOLEAN\n columns ANY\n compression VARCHAR\n convert_strings_to_integers BOOLEAN\n date_format VARCHAR\n dateformat VARCHAR\n field_appearance_threshold DOUBLE\n filename ANY\n format VARCHAR\n hive_partitioning BOOLEAN\n hive_types ANY\n hive_types_autocast BOOLEAN\n ignore_errors BOOLEAN\n map_inference_threshold BIGINT\n maximum_depth BIGINT\n maximum_object_size UINTEGER\n maximum_sample_files BIGINT\n records VARCHAR\n sample_size BIGINT\n timestamp_format VARCHAR\n timestampformat VARCHAR\n union_by_name BOOLEAN\n\n\nLINE 1: EXPLAIN SELECT * FROM \"read_ndjson_auto\"(NULL::VARCHAR, __guide_invalid_named_par...\n ^" } }, "syntax": { "kind": "function", "operator": null }, "catalog": { "schema_name": "main", "function_name": "read_ndjson_auto", "function_type": "table", "description": null, "comment": null, "return_type": null, "parameters": [ "auto_detect", "col0", "columns", "compression", "convert_strings_to_integers", "date_format", "dateformat", "field_appearance_threshold", "filename", "format", "hive_partitioning", "hive_types", "hive_types_autocast", "ignore_errors", "map_inference_threshold", "maximum_depth", "maximum_object_size", "maximum_sample_files", "records", "sample_size", "timestamp_format", "timestampformat", "union_by_name" ], "parameter_types": [ "BOOLEAN", "VARCHAR", "ANY", "VARCHAR", "BOOLEAN", "VARCHAR", "VARCHAR", "DOUBLE", "ANY", "VARCHAR", "BOOLEAN", "ANY", "BOOLEAN", "BOOLEAN", "BIGINT", "BIGINT", "UINTEGER", "BIGINT", "VARCHAR", "BIGINT", "VARCHAR", "VARCHAR", "BOOLEAN" ], "varargs": null, "macro_definition": null, "has_side_effects": null, "internal": true, "examples": [], "stability": null, "categories": [], "alias_of": null } }, { "id": "overload-6469e38141e22721", "url": "/products/haybarn/functions/releases/duckdb-1.4.4/read_ndjson_auto/#overload-6469e38141e22721", "signature": "read_ndjson_auto(col0: VARCHAR[], auto_detect := BOOLEAN, columns := ANY, compression := VARCHAR, convert_strings_to_integers := BOOLEAN, date_format := VARCHAR, dateformat := VARCHAR, field_appearance_threshold := DOUBLE, filename := ANY, format := VARCHAR, hive_partitioning := BOOLEAN, hive_types := ANY, hive_types_autocast := BOOLEAN, ignore_errors := BOOLEAN, map_inference_threshold := BIGINT, maximum_depth := BIGINT, maximum_object_size := UINTEGER, maximum_sample_files := BIGINT, records := VARCHAR, sample_size := BIGINT, timestamp_format := VARCHAR, timestampformat := VARCHAR, union_by_name := BOOLEAN) → TABLE", "parameterOrder": "alphabetical-not-call-order", "callingConvention": { "source": "engine-binder", "parameters": [ { "name": "auto_detect", "type": "BOOLEAN", "mode": "named", "position": null }, { "name": "col0", "type": "VARCHAR[]", "mode": "positional", "position": 0 }, { "name": "columns", "type": "ANY", "mode": "named", "position": null }, { "name": "compression", "type": "VARCHAR", "mode": "named", "position": null }, { "name": "convert_strings_to_integers", "type": "BOOLEAN", "mode": "named", "position": null }, { "name": "date_format", "type": "VARCHAR", "mode": "named", "position": null }, { "name": "dateformat", "type": "VARCHAR", "mode": "named", "position": null }, { "name": "field_appearance_threshold", "type": "DOUBLE", "mode": "named", "position": null }, { "name": "filename", "type": "ANY", "mode": "named", "position": null }, { "name": "format", "type": "VARCHAR", "mode": "named", "position": null }, { "name": "hive_partitioning", "type": "BOOLEAN", "mode": "named", "position": null }, { "name": "hive_types", "type": "ANY", "mode": "named", "position": null }, { "name": "hive_types_autocast", "type": "BOOLEAN", "mode": "named", "position": null }, { "name": "ignore_errors", "type": "BOOLEAN", "mode": "named", "position": null }, { "name": "map_inference_threshold", "type": "BIGINT", "mode": "named", "position": null }, { "name": "maximum_depth", "type": "BIGINT", "mode": "named", "position": null }, { "name": "maximum_object_size", "type": "UINTEGER", "mode": "named", "position": null }, { "name": "maximum_sample_files", "type": "BIGINT", "mode": "named", "position": null }, { "name": "records", "type": "VARCHAR", "mode": "named", "position": null }, { "name": "sample_size", "type": "BIGINT", "mode": "named", "position": null }, { "name": "timestamp_format", "type": "VARCHAR", "mode": "named", "position": null }, { "name": "timestampformat", "type": "VARCHAR", "mode": "named", "position": null }, { "name": "union_by_name", "type": "BOOLEAN", "mode": "named", "position": null } ], "positional": [ { "name": "col0", "type": "VARCHAR[]", "mode": "positional", "position": 0 } ], "named": [ { "name": "auto_detect", "type": "BOOLEAN", "mode": "named", "position": null }, { "name": "columns", "type": "ANY", "mode": "named", "position": null }, { "name": "compression", "type": "VARCHAR", "mode": "named", "position": null }, { "name": "convert_strings_to_integers", "type": "BOOLEAN", "mode": "named", "position": null }, { "name": "date_format", "type": "VARCHAR", "mode": "named", "position": null }, { "name": "dateformat", "type": "VARCHAR", "mode": "named", "position": null }, { "name": "field_appearance_threshold", "type": "DOUBLE", "mode": "named", "position": null }, { "name": "filename", "type": "ANY", "mode": "named", "position": null }, { "name": "format", "type": "VARCHAR", "mode": "named", "position": null }, { "name": "hive_partitioning", "type": "BOOLEAN", "mode": "named", "position": null }, { "name": "hive_types", "type": "ANY", "mode": "named", "position": null }, { "name": "hive_types_autocast", "type": "BOOLEAN", "mode": "named", "position": null }, { "name": "ignore_errors", "type": "BOOLEAN", "mode": "named", "position": null }, { "name": "map_inference_threshold", "type": "BIGINT", "mode": "named", "position": null }, { "name": "maximum_depth", "type": "BIGINT", "mode": "named", "position": null }, { "name": "maximum_object_size", "type": "UINTEGER", "mode": "named", "position": null }, { "name": "maximum_sample_files", "type": "BIGINT", "mode": "named", "position": null }, { "name": "records", "type": "VARCHAR", "mode": "named", "position": null }, { "name": "sample_size", "type": "BIGINT", "mode": "named", "position": null }, { "name": "timestamp_format", "type": "VARCHAR", "mode": "named", "position": null }, { "name": "timestampformat", "type": "VARCHAR", "mode": "named", "position": null }, { "name": "union_by_name", "type": "BOOLEAN", "mode": "named", "position": null } ], "variadic": null, "evidence": { "query": "EXPLAIN SELECT * FROM \"read_ndjson_auto\"(NULL::VARCHAR[], __guide_invalid_named_parameter__ := NULL);", "diagnostic": "Binder Error: Invalid named parameter \"__guide_invalid_named_parameter__\" for function read_ndjson_auto\nCandidates:\n auto_detect BOOLEAN\n columns ANY\n compression VARCHAR\n convert_strings_to_integers BOOLEAN\n date_format VARCHAR\n dateformat VARCHAR\n field_appearance_threshold DOUBLE\n filename ANY\n format VARCHAR\n hive_partitioning BOOLEAN\n hive_types ANY\n hive_types_autocast BOOLEAN\n ignore_errors BOOLEAN\n map_inference_threshold BIGINT\n maximum_depth BIGINT\n maximum_object_size UINTEGER\n maximum_sample_files BIGINT\n records VARCHAR\n sample_size BIGINT\n timestamp_format VARCHAR\n timestampformat VARCHAR\n union_by_name BOOLEAN\n\n\nLINE 1: EXPLAIN SELECT * FROM \"read_ndjson_auto\"(NULL::VARCHAR[], __guide_invalid_named_p...\n ^" } }, "syntax": { "kind": "function", "operator": null }, "catalog": { "schema_name": "main", "function_name": "read_ndjson_auto", "function_type": "table", "description": null, "comment": null, "return_type": null, "parameters": [ "auto_detect", "col0", "columns", "compression", "convert_strings_to_integers", "date_format", "dateformat", "field_appearance_threshold", "filename", "format", "hive_partitioning", "hive_types", "hive_types_autocast", "ignore_errors", "map_inference_threshold", "maximum_depth", "maximum_object_size", "maximum_sample_files", "records", "sample_size", "timestamp_format", "timestampformat", "union_by_name" ], "parameter_types": [ "BOOLEAN", "VARCHAR[]", "ANY", "VARCHAR", "BOOLEAN", "VARCHAR", "VARCHAR", "DOUBLE", "ANY", "VARCHAR", "BOOLEAN", "ANY", "BOOLEAN", "BOOLEAN", "BIGINT", "BIGINT", "UINTEGER", "BIGINT", "VARCHAR", "BIGINT", "VARCHAR", "VARCHAR", "BOOLEAN" ], "varargs": null, "macro_definition": null, "has_side_effects": null, "internal": true, "examples": [], "stability": null, "categories": [], "alias_of": null } } ], "editorial": { "argumentNotes": [], "recipes": [] }, "examples": [], "translations": [], "runnableExamples": [], "additionalDocumentation": [ { "title": "JSON Processing Functions", "url": "https://duckdb.org/docs/current/data/json/json_functions" }, { "title": "Loading JSON", "url": "https://duckdb.org/docs/current/data/json/loading_json#functions-for-reading-json-as-a-table" } ], "availability": [ { "snapshot": "haybarn-1.5.5-rc3", "observed": true, "overloadCount": 2, "matchingOverloadIds": [ "overload-58df5ad3a4aed536", "overload-6469e38141e22721" ], "json": "/products/haybarn/functions/api/v1/haybarn-1.5.5-rc3/functions/read_ndjson_auto.json" }, { "snapshot": "duckdb-1.5.5", "observed": true, "overloadCount": 2, "matchingOverloadIds": [ "overload-58df5ad3a4aed536", "overload-6469e38141e22721" ], "json": "/products/haybarn/functions/api/v1/duckdb-1.5.5/functions/read_ndjson_auto.json" }, { "snapshot": "duckdb-1.4.4", "observed": true, "overloadCount": 2, "matchingOverloadIds": [ "overload-58df5ad3a4aed536", "overload-6469e38141e22721" ], "json": "/products/haybarn/functions/api/v1/duckdb-1.4.4/functions/read_ndjson_auto.json" }, { "snapshot": "duckdb-1.3.2", "observed": true, "overloadCount": 2, "matchingOverloadIds": [ "overload-58df5ad3a4aed536", "overload-6469e38141e22721" ], "json": "/products/haybarn/functions/api/v1/duckdb-1.3.2/functions/read_ndjson_auto.json" } ] }