Schemas

Creates a new schema in the specified catalog.

post/schemas

Request

  • Base URL
    http://localhost:8080/api/2.1/unity-catalog
  • Auth
    none declared

Request body

namestring required

Name of schema, relative to parent catalog.

catalog_namestring required

Name of parent catalog.

commentstring

User-provided free-form text description.

propertiesSecurablePropertiesMap

A map of key-value properties attached to the securable.

storage_rootstring

Storage root URL for managed storage location of schema. If not set, managed securables under this schema will try to use the storage_location of the parent catalog instead. Example: s3://bucket/ucroot

Response

The new schema was successfully created.

namestring

Name of schema, relative to parent catalog.

catalog_namestring

Name of parent catalog.

commentstring

User-provided free-form text description.

propertiesSecurablePropertiesMap

A map of key-value properties attached to the securable.

full_namestring

Full name of schema, in form of catalog_name.schema_name.

ownerstring

Username of current owner of schema.

created_atinteger

Time at which this schema was created, in epoch milliseconds.

created_bystring

Username of schema creator.

updated_atinteger

Time at which this schema was last modified, in epoch milliseconds.

updated_bystring

Username of user who last modified schema.

schema_idstring

Unique identifier for the schema.

storage_rootstring

Storage root URL for managed storage location of schema. This can be set when creating a schema. Example: s3://bucket/ucroot

storage_locationstring

Storage Location URL (full path) for managed storage location of schema. This is an automatically generated unique path under storage_root. If it is absent, managed securables under this schema will try to use storage_location of the parent catalog instead. Example: s3://bucket/ucroot/__unitystorage/schemas/{schema_id}

Changes

    • info

      added the new optional request property

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status