Actions33
- Genie Actions
- Databricks SQL Actions
- Unity Catalog Actions
- Model Serving Actions
- Files Actions
- Vector Search Actions
Files → Upload File
AI-generatedOverview
This node operation uploads a file to a specified volume in Databricks Unity Catalog. It is useful for scenarios where users need to programmatically upload binary files to Databricks volumes, such as uploading data files, configuration files, or any binary content to be used within Databricks environment.
Use Case Examples
- Uploading a CSV file to a Unity Catalog volume for data processing.
- Uploading an image or document file to a Databricks volume for storage or further analysis.
Properties
| Name | Meaning |
|---|---|
| Volume Path | Full path to the volume in the format catalog.schema.volume, specifying the target volume for the file upload. |
| File Path | Path to the file within the volume, specifying the destination path and filename inside the volume. |
| Input Data Field Name | Name of the input field that contains the binary data to be uploaded as a file. |
| Overwrite | Boolean flag indicating whether to overwrite an existing file at the destination path. |
Output
JSON
success- Indicates if the file upload was successful.message- Message confirming the file upload status and destination path.
Dependencies
- Requires Databricks API credentials with appropriate permissions to access Unity Catalog volumes and upload files.
Troubleshooting
- Ensure the volume path is correctly formatted as catalog.schema.volume; otherwise, an error is thrown.
- Verify that the input binary data field name matches the actual input data field containing the file data.
- Check API credentials and permissions to ensure the node can authenticate and has rights to upload files.
- If the file already exists and overwrite is false, the upload may fail or be rejected by the API.
Links
- Databricks Unity Catalog Files API - Official documentation for managing files in Unity Catalog volumes via Databricks API.