Skip to content

Commit

Permalink
reorg
Browse files Browse the repository at this point in the history
  • Loading branch information
comphead committed Sep 19, 2023
1 parent 4369005 commit 20d3298
Showing 1 changed file with 48 additions and 48 deletions.
96 changes: 48 additions & 48 deletions docs/source/user-guide/cli.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,54 +23,6 @@ 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.

```shell
$ echo "a,b" > data.csv
$ echo "1,2" >> data.csv
```

Query that single file (the CLI also supports parquet, compressed csv, avro, json and more)

```shell
$ datafusion-cli
DataFusion CLI v17.0.0
select * from 'data.csv';
+---+---+
| a | b |
+---+---+
| 1 | 2 |
+---+---+
1 row in set. Query took 0.007 seconds.
```
You can also query directories of files with compatible schemas:
```shell
$ ls data_dir/
data.csv data2.csv
```
```shell
$ datafusion-cli
DataFusion CLI v16.0.0
select * from 'data_dir';
+---+---+
| a | b |
+---+---+
| 3 | 4 |
| 1 | 2 |
+---+---+
2 rows in set. Query took 0.007 seconds.
```
## Installation

### Install and run using Cargo
Expand Down Expand Up @@ -136,6 +88,54 @@ OPTIONS:
-V, --version Print version information
```

## Querying data from the 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.

```shell
$ echo "a,b" > data.csv
$ echo "1,2" >> data.csv
```

Query that single file (the CLI also supports parquet, compressed csv, avro, json and more)

```shell
$ datafusion-cli
DataFusion CLI v17.0.0
select * from 'data.csv';
+---+---+
| a | b |
+---+---+
| 1 | 2 |
+---+---+
1 row in set. Query took 0.007 seconds.
```
You can also query directories of files with compatible schemas:
```shell
$ ls data_dir/
data.csv data2.csv
```
```shell
$ datafusion-cli
DataFusion CLI v16.0.0
select * from 'data_dir';
+---+---+
| a | b |
+---+---+
| 3 | 4 |
| 1 | 2 |
+---+---+
2 rows in set. Query took 0.007 seconds.
```
## Creating external tables
It is also possible to create a table backed by files by explicitly
Expand Down

0 comments on commit 20d3298

Please sign in to comment.