pyspark.sql.Catalog.createDatabase#

Catalog.createDatabase(dbName, ifNotExists=False, properties=None)[source]#

Creates a namespace (database/schema).

dbName may be a multi-part identifier (for example catalog.schema). Optional properties follow CREATE NAMESPACE (for example comment or location keys).

New in version 4.2.0.

Parameters
dbNamestr

Name of the namespace to create.

ifNotExistsbool, optional

If True, do not fail when the namespace already exists.

propertiesdict, optional

Map of namespace property keys to string values.

Examples

>>> spark.catalog.dropDatabase("db_create_doc", ifExists=True, cascade=True)
>>> spark.catalog.createDatabase("db_create_doc")
>>> spark.catalog.databaseExists("db_create_doc")
True
>>> spark.catalog.dropDatabase("db_create_doc", cascade=True)
>>> spark.catalog.databaseExists("db_create_doc")
False