Overview

This node interacts with the Databricks Unity Catalog API to retrieve detailed information about a specific catalog. It is useful for users who want to programmatically access metadata and properties of a catalog within the Unity Catalog service in Databricks. For example, it can be used to fetch catalog details for auditing, governance, or integration with other data management tools.

Use Case Examples

1. Retrieve metadata of a catalog named 'main' to check its properties and configuration.
2. Use the node in a workflow to automate catalog information retrieval for reporting or monitoring purposes.

Properties

Output

JSON

• name - The name of the catalog.
• comment - Optional comment or description associated with the catalog.
• created_at - Timestamp when the catalog was created.
• updated_at - Timestamp when the catalog was last updated.
• owner - Owner information of the catalog.
• properties - Additional properties or metadata related to the catalog.

Dependencies

• Requires an API authentication token for Databricks to authorize requests.
• Needs access to the Databricks Unity Catalog API endpoint.

Troubleshooting

• Ensure the catalog name is correctly specified and exists in the Unity Catalog.
• Check that the API token has sufficient permissions to access catalog information.
• Verify network connectivity to the Databricks API endpoint.
• Common error: 'API Error 404' indicates the catalog was not found; verify the catalog name.
• Common error: 'Network Error' indicates connectivity issues; check firewall and proxy settings.

Links

• Databricks Unity Catalog Documentation - Official documentation for Unity Catalog in Databricks.
• Unity Catalog API - Get Catalog - API reference for retrieving catalog details.