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).

Added 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