点命令在DuckDB CLI客户端中可用。要使用这些命令之一，请在行首输入一个句点（.），紧接着输入您希望执行的命令名称。命令的附加参数在命令后以空格分隔输入。如果参数必须包含空格，可以使用单引号或双引号包裹该参数。点命令必须在一行内输入，句点前不能有空格。行末不需要分号。要查看可用命令，请使用.help命令。

点命令

使用 .help 命令

.help 文本可以通过传入一个文本字符串作为第二个参数来过滤。

.help m

.maxrows COUNT      Sets the maximum number of rows for display (default: 40). Only for duckbox mode.
.maxwidth COUNT     Sets the maximum width in characters. 0 defaults to terminal width. Only for duckbox mode.
.mode MODE ?TABLE?  Set output mode

.output: 将结果写入文件

默认情况下，DuckDB CLI 将结果发送到终端的标准输出。但是，可以使用 .output 或 .once 命令来修改此行为。将所需的输出文件位置作为参数传递。.once 命令只会输出下一组结果，然后恢复到标准输出，但 .output 会将所有后续输出重定向到该文件位置。请注意，每个结果都会覆盖目标位置的整个文件。要恢复到标准输出，请输入不带文件参数的 .output。

在这个例子中，输出格式被更改为markdown，目标被识别为一个Markdown文件，然后DuckDB将SQL语句的输出写入该文件。然后使用不带参数的.output将输出恢复为标准输出。

.mode markdown
.output my_results.md
SELECT 'taking flight' AS output_column;
.output
SELECT 'back to the terminal' AS displayed_column;

文件 my_results.md 将包含：

| output_column |
|---------------|
| taking flight |

终端将显示：

|   displayed_column   |
|----------------------|
| back to the terminal |

常见的输出格式是CSV，即逗号分隔值。DuckDB支持SQL语法将数据导出为CSV或Parquet，但如果需要，也可以使用CLI特定的命令来写入CSV。

.mode csv
.once my_output_file.csv
SELECT 1 AS col_1, 2 AS col_2
UNION ALL
SELECT 10 AS col1, 20 AS col_2;

文件 my_output_file.csv 将包含：

col_1,col_2
1,2
10,20

通过向.once命令传递特殊选项（标志），查询结果也可以发送到临时文件并自动在用户的默认程序中打开。使用-e标志生成文本文件（在默认文本编辑器中打开），或使用-x标志生成CSV文件（在默认电子表格编辑器中打开）。这对于更详细地检查查询结果非常有用，特别是在结果集相对较大的情况下。.excel命令等同于.once -x。

.once -e
SELECT 'quack' AS hello;

结果随后在系统的默认文本文件编辑器中打开，例如：

查询数据库模式

所有DuckDB客户端都支持使用SQL查询数据库模式，但CLI有额外的点命令，可以使理解数据库内容变得更加容易。 .tables命令将返回数据库中的表列表。它有一个可选参数，可以根据LIKE模式过滤结果。

CREATE TABLE swimmers AS SELECT 'duck' AS animal;
CREATE TABLE fliers AS SELECT 'duck' AS animal;
CREATE TABLE walkers AS SELECT 'duck' AS animal;
.tables

fliers    swimmers  walkers

例如，要过滤仅包含l的表，请使用LIKE模式%l%。

.tables %l%

fliers   walkers

.schema 命令将显示用于定义数据库模式的所有SQL语句。

.schema

CREATE TABLE fliers (animal VARCHAR);
CREATE TABLE swimmers (animal VARCHAR);
CREATE TABLE walkers (animal VARCHAR);

配置语法高亮器

默认情况下，shell 支持语法高亮显示。 可以使用以下命令配置 CLI 的语法高亮器。

关闭高亮显示：

.highlight off

打开高亮显示：

.highlight on

配置用于突出显示常量的颜色：

.constant [red|green|yellow|blue|magenta|cyan|white|brightblack|brightred|brightgreen|brightyellow|brightblue|brightmagenta|brightcyan|brightwhite]

.constantcode [terminal_code]

配置用于突出显示关键字的颜色：

.keyword [red|green|yellow|blue|magenta|cyan|white|brightblack|brightred|brightgreen|brightyellow|brightblue|brightmagenta|brightcyan|brightwhite]

.keywordcode [terminal_code]

从CSV导入数据

已弃用 此功能仅出于兼容性原因包含在内，未来可能会被移除。 使用 read_csv 函数或 COPY 语句 来加载 CSV 文件。

DuckDB 支持 SQL 语法直接查询或导入 CSV 文件，但如果需要，也可以使用 CLI 特定的命令来导入 CSV。.import 命令接受两个参数，并且还支持多个选项。第一个参数是 CSV 文件的路径，第二个是要创建的 DuckDB 表的名称。由于 DuckDB 需要比 SQLite（DuckDB CLI 基于 SQLite）更严格的类型，因此在使用 .import 命令之前必须创建目标表。要自动检测模式并从 CSV 创建表，请参阅 导入文档中的 read_csv 示例。

在这个例子中，通过切换到CSV模式并设置输出文件位置来生成CSV文件：

.mode csv
.output import_example.csv
SELECT 1 AS col_1, 2 AS col_2 UNION ALL SELECT 10 AS col1, 20 AS col_2;

现在CSV文件已经写入，可以使用所需的模式创建表并导入CSV。输出被重置到终端，以避免继续编辑上面指定的输出文件。--skip N选项用于忽略数据的第一行，因为它是标题行，并且表已经用正确的列名创建。

.mode csv
.output
CREATE TABLE test_table (col_1 INTEGER, col_2 INTEGER);
.import import_example.csv test_table --skip 1

请注意，.import 命令在识别要导入的数据结构时，会使用当前的 .mode 和 .separator 设置。可以使用 --csv 选项来覆盖该行为。

.import import_example.csv test_table --skip 1 --csv