From 0baef1ba284badc979697ad0cbb54b394ec733db Mon Sep 17 00:00:00 2001 From: Tchoupinax Date: Thu, 11 Jun 2026 14:27:00 +0200 Subject: [PATCH 1/2] Revise example usage section headings Updated section headings to include '(example 2)' for clarity. --- docs/source/user-guide/example-usage.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/source/user-guide/example-usage.md b/docs/source/user-guide/example-usage.md index f91beded036a1..66698de208cca 100644 --- a/docs/source/user-guide/example-usage.md +++ b/docs/source/user-guide/example-usage.md @@ -125,7 +125,7 @@ Please be aware that all identifiers are effectively made lower-case in SQL, so To illustrate this behavior, consider the [`capitalized_example.csv`](../../../datafusion/core/tests/data/capitalized_example.csv) file: -## Run a SQL query against data stored in a CSV: +## Run a SQL query against data stored in a CSV (example 2) ```rust use datafusion::prelude::*; @@ -145,7 +145,7 @@ async fn main() -> datafusion::error::Result<()> { } ``` -## Use the DataFrame API to process data stored in a CSV: +## Use the DataFrame API to process data stored in a CSV (example 2) ```rust use datafusion::prelude::*; From aed9c28954a084bbc3aa1521ff1cb583313c3599 Mon Sep 17 00:00:00 2001 From: Tchoupinax Date: Wed, 19 Aug 2026 14:01:10 +0200 Subject: [PATCH 2/2] docs: nest identifier examples under capitalization section Convert the SQL and DataFrame examples to list items and mention datafusion.sql_parser.enable_ident_normalization, per review feedback. Co-authored-by: Cursor --- docs/source/user-guide/example-usage.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/docs/source/user-guide/example-usage.md b/docs/source/user-guide/example-usage.md index afcefba7ef1a7..1cc6a3b91331f 100644 --- a/docs/source/user-guide/example-usage.md +++ b/docs/source/user-guide/example-usage.md @@ -123,9 +123,11 @@ unexpectedly. Please be aware that all identifiers are effectively made lower-case in SQL, so if your csv file has capital letters (ex: `Name`) you must put your column name in double quotes or the examples won't work. +This behavior can be disabled by setting the `datafusion.sql_parser.enable_ident_normalization` config to `false`. See [Configuration Settings](configs.md) for details. + To illustrate this behavior, consider the [`capitalized_example.csv`](../../../datafusion/core/tests/data/capitalized_example.csv) file: -## Run a SQL query against data stored in a CSV (example 2) +- Using the SQL API: ```rust use datafusion::prelude::*; @@ -145,7 +147,7 @@ async fn main() -> datafusion::error::Result<()> { } ``` -## Use the DataFrame API to process data stored in a CSV (example 2) +- Using the DataFrame API: ```rust use datafusion::prelude::*; @@ -170,7 +172,7 @@ async fn main() -> datafusion::error::Result<()> { } ``` -## Output from both examples +Output from both examples: ```text +---+--------+