Overview

This node operation creates a new directory within a specified volume in Databricks Unity Catalog. It is useful for organizing files and folders programmatically within a data volume, allowing users to manage directory structures dynamically. For example, you can automate the creation of project-specific folders or archive directories within your data storage volumes.

Use Case Examples

1. Create a directory 'project_data' inside the volume 'main.default.my_volume' to organize project files.
2. Automate directory creation for new client data uploads within a specified volume path.

Properties

Output

JSON

• success - Indicates if the directory creation was successful (true/false).
• message - Confirmation message about the directory creation.
• volumePath - The volume path where the directory was created.
• directoryPath - The path of the directory that was created within the volume.

Dependencies

• Requires Databricks API credentials with appropriate permissions to manage Unity Catalog volumes and directories.

Troubleshooting

• Ensure the 'Volume Path' is correctly formatted as 'catalog.schema.volume'. An incorrect format will cause an error.
• Verify that the API credentials have sufficient permissions to create directories in the specified volume.
• Check network connectivity and API endpoint accessibility if requests fail.
• Common error messages include 'Volume path must be in format: catalog.schema.volume' indicating input format issues, and HTTP errors from the Databricks API indicating permission or network problems.

Links

• Databricks Files API Documentation - Official documentation for managing files and directories in Databricks Unity Catalog volumes.