SchemasService

Gets the specified schema within the metastore. The caller must be a metastore admin, the owner of the schema, or a user that has the USE_SCHEMA privilege on the schema.

get/schemas/{name}

Path parameters

namestring required

Query parameters

fullNamestring

Full name of schema.

Format: catalog_name.schema_name

Response

OK

namestring required

Name of schema, relative to parent catalog.

catalogNamestring required

Name of parent catalog.

commentstring

User-provided free-form text description.

propertiesobject

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

fullNamestring

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

ownerstring

Username of current owner of schema.

createdAtstring

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

createdBystring

Username of schema creator.

updatedAtstring

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

updatedBystring

Username of user who last modified schema.

schemaIdstring

Unique identifier for the schema.

Changes

Changed in 4 of the 9 revisions of this API.128

  • 60220bae69ec26See the full diff
    • removed the optional property createAt from the response with the 200 status

      response-optional-property-removed

    • removed the optional property updateAt from the response with the 200 status

      response-optional-property-removed

    • api tag SchemasService added

      api-tag-added

    • api tag CatalogService removed

      api-tag-removed

    • api tag schemas removed

      api-tag-removed

    • api tag unity removed

      api-tag-removed

    • added the optional property createdAt to the response with the 200 status

      response-optional-property-added

    • added the optional property updatedAt to the response with the 200 status

      response-optional-property-added

    This revision also has 9 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • added the new optional query request parameter fullName

      new-optional-request-parameter

    • endpoint added

      endpoint-added

    This revision also has 16 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • api path removed without deprecation

      api-path-removed-without-deprecation

    This revision also has 38 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog