Preview
This feature is in Public Preview in the following regions: us-east-1
, us-west-2
, eu-west-1
, ap-southeast-1
, ap-southeast-2
, eu-central-1
, us-east-2
, ap-south-1
.
This page explains how to register your Lakebase database as a read-only Unity Catalog catalog. This allows you to use Unity Catalog privileges to manage data access and leverage integrations like managed data syncing.
Ownership and permissionsâCREATE CATALOG
privileges on the Unity Catalog metastore.To register a database with Unity Catalog, use the Databricks UI or an API call.
databricks_postgres
can be used as the database name.Bash
export PG_DATABASE_NAME="<name of the PG database to sync to UC>"
export CATLAOG_NAME="<name of UC catalog to create>"
Bash
// Optional
export CREATE_DATABASE_IF_NOT_EXISTS="<whether to create a new database>"
Bash
curl -X POST --header "Authorization: Bearer ${DATABRICKS_TOKEN}" https://$WORKSPACE/api/2.0/database/catalogs \
--data-binary @- << EOF
{
"name": "$CATALOG_NAME",
"database_name": "$PG_DATABASE_NAME",
"instance_name": "$INSTANCE_NAME",
"create_database_if_not_exists": "$CREATE_DATABASE_IF_NOT_EXISTS" // optional
}
Limitationsâ
To view the catalog, ensure you have a running serverless SQL warehouse attached.
As you open the catalog, schemas, and tables, syncs should be triggered automatically. However, the UI may cache data to reduce the number of Postgres requests, so new objects may not show up immediately.
To trigger a full refresh, click .
Delete a database catalog in Unity CatalogâYou must be the owner of a database catalog or a metastore admin to delete it.
Databricks recommends that you first delete all synced tables from the database catalog. Each source table can only be used to create 20 synced tables, and it can take up to three days for synced tables to be cleaned up in Unity Catalog after a database catalog is deleted. Synced tables pending deletion in Unity Catalog count toward the 20 synced tables per source table limit.
Use the Databricks UI to delete a database catalog.
After the catalog is deleted, you can rename or drop the Postgres database.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4