CREATE DATABASE

最近更新时间:2026-05-20 14:11:21

我的收藏

描述

CREATE DATABASE 用于创建具有指定名称的数据库。如果具有相同名称的数据库已存在,将抛出异常。

语法

CREATE { DATABASE | SCHEMA } [ IF NOT EXISTS ] database_name
[ COMMENT database_comment ]
[ LOCATION database_directory ]
[ WITH DBPROPERTIES ( property_name = property_value [ , ... ] ) ]

参数说明

子句/关键字
用途
说明
database_name
数据库名称
指定要创建的目标数据库名
IF NOT EXISTS
幂等创建
数据库不存在时才创建,已存在则跳过(不报错)
database_directory
文件系统路径
指定数据库的存储路径;未指定则使用 spark.sql.warehouse.dir 配置的默认仓库目录
database_comment
数据库描述
指定数据库的注释/说明信息
WITH DBPROPERTIES
数据库属性
以键值对形式设置数据库属性,支持多个 (key=value, ...)

示例

-- 创建数据库
CREATE DATABASE customer_db_test;

-- 重复创建(预期失败:重复创建同名数据库)
CREATE DATABASE customer_db_test;

-- IF NOT EXISTS
CREATE DATABASE IF NOT EXISTS customer_db_test;

-- 带 COMMENT
CREATE DATABASE IF NOT EXISTS customer_db_test2 COMMENT 'This is a test database';

-- 带 LOCATION
CREATE DATABASE IF NOT EXISTS customer_schema_test LOCATION 'cosn://<your_cos_bucket>/test_create_db/customer_schema_test';

-- 带 COMMENT + DBPROPERTIES
CREATE DATABASE IF NOT EXISTS customer_db_test2
COMMENT 'Full test database'
WITH DBPROPERTIES (ID='001', Name='John');

-- 使用 SCHEMA 关键字
CREATE SCHEMA IF NOT EXISTS customer_schema_test;

-- 查看数据库详情
DESCRIBE DATABASE EXTENDED customer_db_test2;