描述
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 EXISTSCREATE DATABASE IF NOT EXISTS customer_db_test;-- 带 COMMENTCREATE DATABASE IF NOT EXISTS customer_db_test2 COMMENT 'This is a test database';-- 带 LOCATIONCREATE DATABASE IF NOT EXISTS customer_schema_test LOCATION 'cosn://<your_cos_bucket>/test_create_db/customer_schema_test';-- 带 COMMENT + DBPROPERTIESCREATE DATABASE IF NOT EXISTS customer_db_test2COMMENT 'Full test database'WITH DBPROPERTIES (ID='001', Name='John');-- 使用 SCHEMA 关键字CREATE SCHEMA IF NOT EXISTS customer_schema_test;-- 查看数据库详情DESCRIBE DATABASE EXTENDED customer_db_test2;