Interface CatalogsService
-
@Generated public interface CatalogsService
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.
This is the high-level interface, that contains generated methods.
Evolving: this interface is under development. Method signatures may change.
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description CatalogInfocreate(CreateCatalog createCatalog)Create a catalog.voiddelete(DeleteCatalogRequest deleteCatalogRequest)Delete a catalog.CatalogInfoget(GetCatalogRequest getCatalogRequest)Get a catalog.ListCatalogsResponselist()List catalogs.CatalogInfoupdate(UpdateCatalog updateCatalog)Update a catalog.
-
-
-
Method Detail
-
create
CatalogInfo create(CreateCatalog createCatalog)
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
void delete(DeleteCatalogRequest deleteCatalogRequest)
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
CatalogInfo get(GetCatalogRequest getCatalogRequest)
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
ListCatalogsResponse 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
CatalogInfo update(UpdateCatalog updateCatalog)
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).
-
-