Databricks icon

Databricks

Interact with Databricks API

Actions33

Unity Catalog → Create Volume

AI-generated

Overview

This node operation creates a new volume within the Unity Catalog in Databricks. It allows users to specify the catalog and schema under which the volume will be created, along with the volume's name and type (Managed or External). Additional optional fields such as a comment and external storage location can also be provided. This operation is useful for managing data storage volumes in a governed data environment, enabling structured data organization and access control.

Use Case Examples

  1. Creating a managed volume named 'my_volume' in the 'main' catalog and 'default' schema for Databricks to manage storage.
  2. Creating an external volume with a specified storage location for integrating external storage systems into Unity Catalog.

Properties

Name Meaning
Catalog The catalog to use for the volume creation, selectable from a list or by name.
Schema The schema to use within the catalog, selectable from a list or by name.
Volume Name The name of the volume to create.
Volume Type The type of volume to create, either Managed (Databricks manages storage) or External (points to external storage).
Additional Fields Optional additional fields for the volume such as comment and storage location.

Output

JSON

  • catalog_name - The catalog name where the volume is created.
  • schema_name - The schema name where the volume is created.
  • name - The name of the created volume.
  • volume_type - The type of the created volume (Managed or External).
  • comment - Optional comment or description of the volume.
  • storage_location - The external storage location if the volume is external.

Dependencies

  • Databricks API with appropriate authentication token

Troubleshooting

  • Ensure the catalog and schema names are correct and exist in Unity Catalog.
  • For EXTERNAL volume types, the storage location must be provided and valid.
  • Check API authentication token and permissions to create volumes in Unity Catalog.
  • Error messages from the API will indicate issues such as invalid parameters or authorization failures.

Links

Discussion