Databricks icon

Databricks

Interact with Databricks API

Actions33

Unity Catalog → Create Catalog

AI-generated

Overview

This node operation creates a new catalog in the Unity Catalog service of Databricks. It is useful for managing data governance by programmatically adding catalogs to organize and control access to data assets. For example, a user can automate the creation of a catalog with an optional descriptive comment to maintain structured data environments.

Use Case Examples

  1. Create a new catalog named 'sales_data' with a comment describing its purpose as 'Sales data for Q2 2024'.
  2. Automate catalog creation in a CI/CD pipeline to ensure data governance standards are met across environments.

Properties

Name Meaning
Catalog The name of the catalog to create, specified either by selecting from a list or entering the name directly.
Comment An optional comment or description for the catalog, providing additional context or metadata.

Output

JSON

  • name - The name of the created catalog.
  • comment - The comment or description associated with the catalog.
  • id - The unique identifier of the created catalog, if provided by the API response.
  • created_at - Timestamp indicating when the catalog was created.

Dependencies

  • Databricks API with authentication token

Troubleshooting

  • Ensure the catalog name is unique and valid according to Databricks Unity Catalog naming rules.
  • Verify that the API authentication token has sufficient permissions to create catalogs.
  • Check network connectivity and API endpoint URL correctness.
  • Common errors include authorization failures, invalid input format, or server errors. Review error messages for specific details and adjust parameters accordingly.

Links

Discussion