Package com.databricks.sdk.service.catalog

Class CatalogsAPI

java.lang.Object

com.databricks.sdk.service.catalog.CatalogsAPI

@Generated
public class CatalogsAPI
extends Object

A catalog is the first layer of Unity Catalog’s three-level namespace. It’s used to organize your data assets. Users can see all catalogs on which they have been assigned the USE_CATALOG data permission.

In Unity Catalog, admins and data stewards manage users and their access to data centrally across all of the workspaces in a Databricks account. Users in different workspaces can share access to the same data, depending on privileges granted centrally in Unity Catalog.

Constructor Summary

Constructors

Constructor	Description
CatalogsAPI(ApiClient apiClient)	Regular-use constructor
CatalogsAPI(CatalogsService mock)	Constructor for mocks

Method Summary

Modifier and Type	Method	Description
CatalogInfo	create(CreateCatalog request)	Create a catalog.
CatalogInfo	create(String name)
void	delete(DeleteCatalogRequest request)	Delete a catalog.
void	delete(String name)
CatalogInfo	get(GetCatalogRequest request)	Get a catalog.
CatalogInfo	get(String name)
CatalogsService	impl()
Iterable<CatalogInfo>	list()	List catalogs.
CatalogInfo	update(UpdateCatalog request)	Update a catalog.
CatalogInfo	update(String name)

Methods inherited from class java.lang.Object

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

Constructor Detail

CatalogsAPI

public CatalogsAPI(ApiClient apiClient)

Regular-use constructor

CatalogsAPI

public CatalogsAPI(CatalogsService mock)

Constructor for mocks

Method Detail

create

public CatalogInfo create(String name)

create

public CatalogInfo create(CreateCatalog request)

Create a catalog.

Creates a new catalog instance in the parent metastore if the caller is a metastore admin or has the **CREATE_CATALOG** privilege.

delete

public void delete(String name)

delete

public void delete(DeleteCatalogRequest request)

Delete a catalog.

Deletes the catalog that matches the supplied name. The caller must be a metastore admin or the owner of the catalog.

get

public CatalogInfo get(String name)

get

public CatalogInfo get(GetCatalogRequest request)

Get a catalog.

Gets the specified catalog in a metastore. The caller must be a metastore admin, the owner of the catalog, or a user that has the **USE_CATALOG** privilege set for their account.

list

public Iterable<CatalogInfo> list()

List catalogs.

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

update

public CatalogInfo update(String name)

update

public CatalogInfo update(UpdateCatalog request)

Update a catalog.

Updates the catalog that matches the supplied name. The caller must be either the owner of the catalog, or a metastore admin (when changing the owner field of the catalog).

impl

public CatalogsService impl()