a.metastores: Account Metastores

class databricks.sdk.service.catalog.AccountMetastoresAPI

These APIs manage Unity Catalog metastores for an account. A metastore contains catalogs that can be associated with workspaces

create([, metastore_info: Optional[CreateMetastore]]) → AccountsMetastoreInfo

Usage:

import os
import time

from databricks.sdk import WorkspaceClient

w = WorkspaceClient()

created = w.metastores.create(name=f'sdk-{time.time_ns()}',
                              storage_root="s3://%s/%s" %
                              (os.environ["TEST_BUCKET"], f'sdk-{time.time_ns()}'))

# cleanup
w.metastores.delete(id=created.metastore_id, force=True)

Create metastore.

Creates a Unity Catalog metastore.

Parameters:

metastore_info – CreateMetastore (optional)

Returns:

AccountsMetastoreInfo

delete(metastore_id: str [, force: Optional[bool]])

Delete a metastore.

Deletes a Unity Catalog metastore for an account, both specified by ID.

Parameters:

• metastore_id – str Unity Catalog metastore ID

• force – bool (optional) Force deletion even if the metastore is not empty. Default is false.

get(metastore_id: str) → AccountsMetastoreInfo

Usage:

import os
import time

from databricks.sdk import WorkspaceClient

w = WorkspaceClient()

created = w.metastores.create(name=f'sdk-{time.time_ns()}',
                              storage_root="s3://%s/%s" %
                              (os.environ["TEST_BUCKET"], f'sdk-{time.time_ns()}'))

_ = w.metastores.get(id=created.metastore_id)

# cleanup
w.metastores.delete(id=created.metastore_id, force=True)

Get a metastore.

Gets a Unity Catalog metastore from an account, both specified by ID.

Parameters:

metastore_id – str Unity Catalog metastore ID

Returns:

AccountsMetastoreInfo

list() → Iterator[MetastoreInfo]

Usage:

from databricks.sdk import WorkspaceClient

w = WorkspaceClient()

all = w.metastores.list()

Get all metastores associated with an account.

Gets all Unity Catalog metastores associated with an account specified by ID.

Returns:

Iterator over MetastoreInfo

update(metastore_id: str [, metastore_info: Optional[UpdateMetastore]]) → AccountsMetastoreInfo

Usage:

import os
import time

from databricks.sdk import WorkspaceClient

w = WorkspaceClient()

created = w.metastores.create(name=f'sdk-{time.time_ns()}',
                              storage_root="s3://%s/%s" %
                              (os.environ["TEST_BUCKET"], f'sdk-{time.time_ns()}'))

_ = w.metastores.update(id=created.metastore_id, new_name=f'sdk-{time.time_ns()}')

# cleanup
w.metastores.delete(id=created.metastore_id, force=True)

Update a metastore.

Updates an existing Unity Catalog metastore.

Parameters:

• metastore_id – str Unity Catalog metastore ID

• metastore_info – UpdateMetastore (optional)

Returns:

AccountsMetastoreInfo