⌘+k ctrl+k
1.4 (LTS)
搜索快捷键 cmd + k | ctrl + k
信息模式

information_schema 中的视图是符合 SQL 标准的视图,用于描述数据库的目录条目。这些视图可以进行筛选,以获取关于特定列或表的信息。DuckDB 的实现基于 PostgreSQL 的信息架构

character_sets:字符集

描述 类型 示例
character_set_catalog 目前尚未实现 – 始终为 NULL VARCHAR NULL
character_set_schema 目前尚未实现 – 始终为 NULL VARCHAR NULL
character_set_name 字符集的名称,目前实现为显示数据库编码的名称。 VARCHAR 'UTF8'
character_repertoire 字符集目录,如果编码为 UTF8 则显示 UCS,否则显示编码名称。 VARCHAR 'UCS'
form_of_use 字符编码形式,与数据库编码相同。 VARCHAR 'UTF8'
default_collate_catalog 包含默认排序规则的数据库名称(始终为当前数据库)。 VARCHAR 'my_db'
default_collate_schema 包含默认排序规则的架构名称。 VARCHAR 'pg_catalog'
default_collate_name 默认排序规则的名称。 VARCHAR 'ucs_basic'

columns:列

用于描述列目录信息的视图是 information_schema.columns。它列出了数据库中存在的列,布局如下:

描述 类型 示例
table_catalog 包含该表的数据库名称(始终为当前数据库)。 VARCHAR 'my_db'
table_schema 包含该表的架构名称。 VARCHAR 'main'
表名 (table_name) 表名称。 VARCHAR 'widgets'
列名 (column_name) 列名称。 VARCHAR 'price'
ordinal_position 列在表中的顺序位置(从 1 开始计数)。 INTEGER 5
column_default 列的默认表达式。 VARCHAR 1.99
is_nullable 如果列可能为 NULL,则为 YES;如果已知不可为 NULL,则为 NO VARCHAR 'YES'
data_type 列的数据类型。 VARCHAR 'DECIMAL(18, 2)'
character_maximum_length 如果 data_type 标识为字符或位串类型,则为声明的最大长度;对于所有其他数据类型,或如果未声明最大长度,则为 NULL INTEGER 255
character_octet_length 如果 data_type 标识为字符类型,则为数据项的最大可能长度(以字节为单位);对于所有其他数据类型,则为 NULL。最大字节长度取决于声明的字符最大长度(见上文)和字符编码。 INTEGER 1073741824
numeric_precision 如果 data_type 标识为数值类型,则此列包含该类型在此列中的(声明或隐含)精度。精度表示有效数字的位数。对于所有其他数据类型,此列为 NULL INTEGER 18
numeric_scale 如果 data_type 标识为数值类型,则此列包含该类型在此列中的(声明或隐含)标度。标度表示小数点后的位数。对于所有其他数据类型,此列为 NULL INTEGER 2
datetime_precision 如果 data_type 标识为日期、时间、时间戳或间隔类型,则此列包含该类型在此列中的(声明或隐含)小数秒精度,即秒值中小数点后的位数。DuckDB 目前不支持小数秒。对于所有其他数据类型,此列为 NULL INTEGER 0

constraint_column_usage:约束列使用情况

此视图描述了当前数据库中被某些约束使用的所有列。对于检查约束 (check constraint),此视图标识检查表达式中使用的列。对于非空约束 (not-null constraint),此视图标识定义约束的列。对于外键约束,此视图标识外键引用的列。对于唯一键或主键约束,此视图标识被约束的列。

描述 类型 示例
table_catalog 包含被约束使用的列的表所在的数据库名称(始终为当前数据库) VARCHAR 'my_db'
table_schema 包含被约束使用的列的表所在的架构名称 VARCHAR 'main'
表名 (table_name) 包含被约束使用的列的表名称 VARCHAR 'widgets'
列名 (column_name) 被约束使用的列名称 VARCHAR 'price'
constraint_catalog 包含该约束的数据库名称(始终为当前数据库) VARCHAR 'my_db'
constraint_schema 包含该约束的架构名称 VARCHAR 'main'
constraint_name 约束名称 VARCHAR 'exam_id_students_id_fkey'

key_column_usage:键列使用情况

描述 类型 示例
constraint_catalog 包含该约束的数据库名称(始终为当前数据库)。 VARCHAR 'my_db'
constraint_schema 包含该约束的架构名称。 VARCHAR 'main'
constraint_name 约束名称。 VARCHAR 'exams_exam_id_fkey'
table_catalog 包含被此约束限制的列的表所在的数据库名称(始终为当前数据库)。 VARCHAR 'my_db'
table_schema 包含被此约束限制的列的表所在的架构名称。 VARCHAR 'main'
表名 (table_name) 包含被此约束限制的列的表名称。 VARCHAR 'exams'
列名 (column_name) 被此约束限制的列名称。 VARCHAR 'exam_id'
ordinal_position 列在约束键中的顺序位置(从 1 开始计数)。 INTEGER 1
position_in_unique_constraint 对于外键约束,引用列在其唯一约束中的顺序位置(从 1 开始计数);否则为 NULL INTEGER 1

referential_constraints:引用约束

描述 类型 示例
constraint_catalog 包含该约束的数据库名称(始终为当前数据库)。 VARCHAR 'my_db'
constraint_schema 包含该约束的架构名称。 VARCHAR main
constraint_name 约束名称。 VARCHAR exam_id_students_id_fkey
unique_constraint_catalog 包含外键约束所引用的唯一键或主键约束的数据库名称。 VARCHAR 'my_db'
unique_constraint_schema 包含外键约束所引用的唯一键或主键约束的架构名称。 VARCHAR 'main'
unique_constraint_name 外键约束所引用的唯一键或主键约束的名称。 VARCHAR 'students_id_pkey'
match_option 外键约束的匹配选项。始终为 NONE VARCHAR NONE
update_rule 外键约束的更新规则。始终为 NO ACTION VARCHAR NO ACTION
delete_rule 外键约束的删除规则。始终为 NO ACTION VARCHAR NO ACTION

schemata:数据库、目录和架构

顶层目录视图是 information_schema.schemata。它列出了数据库中存在的目录和架构,布局如下:

描述 类型 示例
catalog_name 该架构所在的数据库名称。 VARCHAR 'my_db'
schema_name 架构名称。 VARCHAR 'main'
schema_owner 架构所有者的名称。尚未实现。 VARCHAR 'duckdb'
default_character_set_catalog 适用于 DuckDB 中不可用的功能。 VARCHAR NULL
default_character_set_schema 适用于 DuckDB 中不可用的功能。 VARCHAR NULL
default_character_set_name 适用于 DuckDB 中不可用的功能。 VARCHAR NULL
sql_path 适用于 DuckDB 中不可用的功能。 VARCHAR NULL

tables:表和视图

描述表和视图目录信息的视图是 information_schema.tables。它列出了数据库中存在的表,布局如下:

描述 类型 示例
table_catalog 表或视图所属的目录。 VARCHAR 'my_db'
table_schema 表或视图所属的架构。 VARCHAR 'main'
表名 (table_name) 表或视图的名称。 VARCHAR 'widgets'
table_type 表类型。值包括:BASE TABLE, LOCAL TEMPORARY, VIEW VARCHAR 'BASE TABLE'
self_referencing_column_name 适用于 DuckDB 中不可用的功能。 VARCHAR NULL
reference_generation 适用于 DuckDB 中不可用的功能。 VARCHAR NULL
user_defined_type_catalog 如果表是类型表,则为包含底层数据类型的数据库名称(始终为当前数据库),否则为 NULL。目前未实现。 VARCHAR NULL
user_defined_type_schema 如果表是类型表,则为包含底层数据类型的架构名称,否则为 NULL。目前未实现。 VARCHAR NULL
user_defined_type_name 如果表是类型表,则为底层数据类型的名称,否则为 NULL。目前未实现。 VARCHAR NULL
is_insertable_into 如果表可以插入数据,则为 YES,否则为 NO(基础表总是可以插入数据,视图则不一定)。 VARCHAR 'YES'
is_typed 如果表是类型表,则为 YES,否则为 NO VARCHAR 'NO'
commit_action 尚未实现。 VARCHAR 'NO'

table_constraints:表约束

描述 类型 示例
constraint_catalog 包含该约束的数据库名称(始终为当前数据库)。 VARCHAR 'my_db'
constraint_schema 包含该约束的架构名称。 VARCHAR 'main'
constraint_name 约束名称。 VARCHAR 'exams_exam_id_fkey'
table_catalog 包含表的数据库名称(始终为当前数据库)。 VARCHAR 'my_db'
table_schema 包含表的架构名称。 VARCHAR 'main'
表名 (table_name) 表名称。 VARCHAR 'exams'
constraint_type 约束类型:CHECK, FOREIGN KEY, PRIMARY KEYUNIQUE VARCHAR 'FOREIGN KEY'
is_deferrable 如果约束可延迟,则为 YES,否则为 NO VARCHAR 'NO'
initially_deferred 如果约束可延迟且初始为延迟状态,则为 YES,否则为 NO VARCHAR 'NO'
enforced 始终为 YES VARCHAR 'YES'
nulls_distinct 如果约束是唯一约束,则如果约束将 NULL 值视为不同,则为 YES;如果不视为不同,则为 NO;对于其他类型的约束,则为 NULL VARCHAR 'YES'

目录函数

还提供了几个函数来查看数据库中配置的目录和架构的详细信息。

函数 描述 示例 结果
current_catalog() 返回当前活动目录的名称。默认为 memory。 current_catalog() 'memory'
current_schema() 返回当前活动架构的名称。默认为 main。 current_schema() 'main'
current_schemas(boolean) 返回架构列表。传入参数 true 可包含隐式架构。 current_schemas(true) ['temp', 'main', 'pg_catalog']
© 2025 DuckDB 基金会,阿姆斯特丹,荷兰
行为准则 商标使用指南