データベースの作成
説明
指定した名前のデータベースを作成します。同じ名前のデータベースがすでに存在する場合、例外がスローされます。
構文
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でパスが設定されているデフォルトのwarehouseディレクトリに作成されます。
-
database_comment
そのデータベースの説明を指定します。
-
WITH DBPROPERTIES ( property_name=property_value [ , … ] )
キーバリューペアでそのデータベースのプロパティを指定します。
例
-- Create database `customer_db`. This throws exception if database with name customer_db
-- already exists.
CREATE DATABASE customer_db;
-- Create database `customer_db` only if database with same name doesn't exist.
CREATE DATABASE IF NOT EXISTS customer_db;
-- Create database `customer_db` only if database with same name doesn't exist with
-- `Comments`,`Specific Location` and `Database properties`.
CREATE DATABASE IF NOT EXISTS customer_db COMMENT 'This is customer database' LOCATION '/user'
WITH DBPROPERTIES (ID=001, Name='John');
-- Verify that properties are set.
DESCRIBE DATABASE EXTENDED customer_db;
+-------------------------+--------------------------+
|database_description_item|database_description_value|
+-------------------------+--------------------------+
| Database Name| customer_db|
| Description| This is customer database|
| Location| hdfs://hacluster/user|
| Properties| ((ID,001), (Name,John))|
+-------------------------+--------------------------+