From 81592dba2b03a0b8c920cd67de36067cf46f185c Mon Sep 17 00:00:00 2001 From: comphead Date: Mon, 18 Sep 2023 15:54:03 -0700 Subject: [PATCH] Minor: add more example for Create Table doc --- docs/source/user-guide/cli.md | 26 ++++++++++++++++++++------ 1 file changed, 20 insertions(+), 6 deletions(-) diff --git a/docs/source/user-guide/cli.md b/docs/source/user-guide/cli.md index e3a8cd74c33b..3d834f63331e 100644 --- a/docs/source/user-guide/cli.md +++ b/docs/source/user-guide/cli.md @@ -23,6 +23,11 @@ The DataFusion CLI is a command-line interactive SQL utility for executing queries against any supported data files. It is a convenient way to try DataFusion's SQL support with your own data. +## Selecting files directly + +Files can be queried directly by enclosing the file or +directory name in single `'` quotes as shown in the example. + ## Example Create a CSV file to query. @@ -131,17 +136,14 @@ OPTIONS: -V, --version Print version information ``` -## Selecting files directly - -Files can be queried directly by enclosing the file or -directory name in single `'` quotes as shown in the example. +## Creating external tables It is also possible to create a table backed by files by explicitly -via `CREATE EXTERNAL TABLE` as shown below. +via `CREATE EXTERNAL TABLE` as shown below. Filemask wildcards supported ## Registering Parquet Data Sources -Parquet data sources can be registered by executing a `CREATE EXTERNAL TABLE` SQL statement. It is not necessary to provide schema information for Parquet files. +Parquet data sources can be registered by executing a `CREATE EXTERNAL TABLE` SQL statement. The schema information will be derived automatically. ```sql CREATE EXTERNAL TABLE taxi @@ -149,6 +151,18 @@ STORED AS PARQUET LOCATION '/mnt/nyctaxi/tripdata.parquet'; ``` +```sql +CREATE EXTERNAL TABLE taxi +STORED AS PARQUET +LOCATION '/mnt/nyctaxi/'; +``` + +```sql +CREATE EXTERNAL TABLE taxi +STORED AS PARQUET +LOCATION '/mnt/nyctaxi/*.parquet'; +``` + ## Registering CSV Data Sources CSV data sources can be registered by executing a `CREATE EXTERNAL TABLE` SQL statement.