Package com.databricks.sdk.service.catalog

Class SchemasAPI

java.lang.Object

com.databricks.sdk.service.catalog.SchemasAPI

@Generated
public class SchemasAPI
extends Object

A schema (also called a database) is the second layer of Unity Catalog’s three-level namespace. A schema organizes tables, views and functions. To access (or list) a table or view in a schema, users must have the USE_SCHEMA data permission on the schema and its parent catalog, and they must have the SELECT permission on the table or view.

Constructor Summary

Constructors

Constructor	Description
SchemasAPI(ApiClient apiClient)	Regular-use constructor
SchemasAPI(SchemasService mock)	Constructor for mocks

Method Summary

Modifier and Type	Method	Description
SchemaInfo	create(CreateSchema request)	Create a schema.
SchemaInfo	create(String name, String catalogName)
void	delete(DeleteSchemaRequest request)	Delete a schema.
void	delete(String fullName)
SchemaInfo	get(GetSchemaRequest request)	Get a schema.
SchemaInfo	get(String fullName)
SchemasService	impl()
Iterable<SchemaInfo>	list(ListSchemasRequest request)	List schemas.
Iterable<SchemaInfo>	list(String catalogName)
SchemaInfo	update(UpdateSchema request)	Update a schema.
SchemaInfo	update(String fullName)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SchemasAPI

public SchemasAPI(ApiClient apiClient)

Regular-use constructor

SchemasAPI

public SchemasAPI(SchemasService mock)

Constructor for mocks

Method Detail

create

public SchemaInfo create(String name,
                         String catalogName)

create

public SchemaInfo create(CreateSchema request)

Create a schema.

Creates a new schema for catalog in the Metatastore. The caller must be a metastore admin, or have the **CREATE_SCHEMA** privilege in the parent catalog.

delete

public void delete(String fullName)

delete

public void delete(DeleteSchemaRequest request)

Delete a schema.

Deletes the specified schema from the parent catalog. The caller must be the owner of the schema or an owner of the parent catalog.

get

public SchemaInfo get(String fullName)

get

public SchemaInfo get(GetSchemaRequest request)

Get a schema.

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.

list

public Iterable<SchemaInfo> list(String catalogName)

list

public Iterable<SchemaInfo> list(ListSchemasRequest request)

List schemas.

Gets an array of schemas for a catalog in the metastore. If the caller is the metastore admin or the owner of the parent catalog, all schemas for the catalog will be retrieved. Otherwise, only schemas owned by the caller (or for which the caller has the **USE_SCHEMA** privilege) will be retrieved. There is no guarantee of a specific ordering of the elements in the array.

update

public SchemaInfo update(String fullName)

update

public SchemaInfo update(UpdateSchema request)

Update a schema.

Updates a schema for a catalog. The caller must be the owner of the schema or a metastore admin. If the caller is a metastore admin, only the __owner__ field can be changed in the update. If the __name__ field must be updated, the caller must be a metastore admin or have the **CREATE_SCHEMA** privilege on the parent catalog.

impl

public SchemasService impl()