⌘+k ctrl+k
1.1.3 (stable)
Search Shortcut cmd + k | ctrl + k
Information Schema

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 YES 如果列可能为空，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: 约束列使用

此视图描述了当前数据库中由某些约束使用的所有列。对于检查约束，此视图标识了检查表达式中使用的列。对于非空约束，此视图标识了定义约束的列。对于外键约束，此视图标识了外键引用的列。对于唯一或主键约束，此视图标识了受约束的列。

Column Description Type Example
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: 关键列使用

Column Description Type Example
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: 引用约束

Column Description Type Example
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。它列出了数据库中的目录和模式，并具有以下布局：

Column Description Type Example
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 数据库的文件系统位置。目前未实现。 VARCHAR NULL

tables: 表和视图

描述表和视图的目录信息的视图是 information_schema.tables。它列出了数据库中存在的表，并具有以下布局：

Column Description Type Example
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: 表约束

Column Description Type Example
constraint_catalog Name of the database that contains the constraint (always the current database). VARCHAR 'my_db'
constraint_schema Name of the schema that contains the constraint. VARCHAR 'main'
constraint_name Name of the constraint. VARCHAR 'exams_exam_id_fkey'
table_catalog 包含表的数据库名称（始终为当前数据库）。 VARCHAR 'my_db'
table_schema 包含表的模式名称。 VARCHAR 'main'
table_name 表的名称。 VARCHAR 'exams'
constraint_type 约束类型：CHECK, FOREIGN KEY, PRIMARY KEY, 或 UNIQUE. VARCHAR 'FOREIGN KEY'
is_deferrable YES 如果约束是可延迟的，NO 如果不是。 VARCHAR 'NO'
initially_deferred 如果约束是可延迟的并且最初是延迟的，则为YES，否则为NO。 VARCHAR 'NO'
enforced 总是 YES. VARCHAR 'YES'
nulls_distinct 如果约束是唯一约束，则YES表示该约束将NULL视为不同的值，NO表示将NULL视为相同的值，否则对于其他类型的约束为NULL。 VARCHAR 'YES'

目录函数

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

函数 描述 示例 结果
current_catalog() 返回当前活动目录的名称。默认为内存。 current_catalog() 'memory'
current_schema() 返回当前活动模式的名称。默认为main。 current_schema() 'main'
current_schemas(boolean) 返回模式列表。传递一个true参数以包含隐式模式。 current_schemas(true) ['temp', 'main', 'pg_catalog']
关于此页面