Dataiku DSS icon

Dataiku DSS

Use the Dataiku DSS API

Actions364

Overview

This node integrates with the Dataiku DSS API, enabling users to perform a wide range of operations on Dataiku DSS resources. Specifically for the Managed Folder resource and the Download File From Managed Folder operation, the node allows downloading a file stored in a managed folder within a Dataiku project.

Typical use cases include:

  • Automating retrieval of files from managed folders in Dataiku projects.
  • Integrating Dataiku-managed data assets into external workflows or systems.
  • Downloading configuration files, datasets, or other artifacts stored in managed folders for further processing.

For example, you might use this node to download a CSV dataset stored in a managed folder to process it downstream in an n8n workflow.

Properties

Name Meaning
Project Key The key identifier of the Dataiku project containing the managed folder.
Folder ID The unique identifier of the managed folder from which the file will be downloaded.
Path The relative path (within the managed folder) to the file that should be downloaded.

These properties are required to specify exactly which file to download from which managed folder in which project.

Output

The output contains either:

  • Binary data: The actual content of the downloaded file is returned as binary data under the binary.data field. This allows subsequent nodes to handle the file content directly (e.g., saving to disk, uploading elsewhere).
  • JSON data: In some cases, if the response is textual or JSON, it will be parsed and returned in the json field.
  • Text data: If the response is a non-JSON string, it will be returned as plain text in the text field.

For the "Download File From Managed Folder" operation, the output will primarily be binary data representing the downloaded file.

Dependencies

  • Requires an active connection to a Dataiku DSS instance.
  • Requires valid API credentials (an API key token) for authentication with the Dataiku DSS API.
  • The node expects the Dataiku DSS server URL and user API key to be configured in the credentials.
  • No additional environment variables are needed beyond the API credentials.

Troubleshooting

  • Missing Credentials Error: If the node throws an error about missing credentials, ensure that the Dataiku DSS API credentials are properly set up and selected in the node.
  • Required Parameter Errors: The node validates required parameters such as Project Key, Folder ID, and Path. Missing any of these will cause an error. Double-check that all required fields are filled.
  • File Not Found or Access Denied: If the specified file path or folder ID does not exist or the API user lacks permissions, the API will return an error. Verify folder and file existence and user permissions in Dataiku.
  • Network or Server Errors: Connection issues or server errors from the Dataiku DSS API will be surfaced as node errors. Check network connectivity and Dataiku server status.
  • Invalid Response Parsing: If the response cannot be parsed as JSON when expected, the node falls back to returning raw text or binary data. Ensure the API endpoint and parameters are correct.

Links and References

Discussion