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 directly from n8n workflows. Specifically for the Machine Learning - Lab resource and the Create Visual Analysis operation, it allows creating new visual analyses within a specified project in Dataiku DSS.

Typical use cases include automating the creation of visual analyses as part of machine learning workflows, integrating model exploration and visualization steps into data pipelines, or programmatically managing visual analysis assets in Dataiku DSS projects.

For example, a user might automate the generation of visual analyses after training models, or create visual analyses dynamically based on incoming data or experiment results.

Properties

Name Meaning
Project Key The unique identifier of the Dataiku DSS project where the visual analysis will be created.
Request Body JSON object containing the details and configuration of the visual analysis to create.

The Request Body property expects a JSON structure defining the parameters of the visual analysis, such as its name, description, settings, and any other relevant configuration required by the Dataiku DSS API for creating a visual analysis.

Output

The node outputs the response from the Dataiku DSS API call:

  • The json output contains the parsed JSON response from the API, which typically includes details about the newly created visual analysis, such as its ID, metadata, and status.
  • If the API returns binary data (not typical for this operation), it would be provided in the binary output field, but for "Create Visual Analysis" the output is JSON.

Dependencies

  • Requires an active connection to a Dataiku DSS instance.
  • Requires valid API credentials for Dataiku DSS (an API key credential).
  • The node uses HTTP requests to communicate with the Dataiku DSS REST API.
  • No additional external libraries beyond those bundled with n8n are required.

Troubleshooting

  • Missing Credentials Error: If the node throws an error about missing credentials, ensure that the Dataiku DSS API credentials are properly configured in n8n.
  • Project Key Required: The operation requires a valid project key; if omitted or incorrect, the node will throw an error.
  • Analysis ID and ML Task ID: For some Machine Learning Lab operations, these IDs are mandatory. For "Create Visual Analysis," only the project key and request body are needed.
  • Invalid Request Body: Ensure the JSON in the Request Body is correctly formatted and contains all required fields as per Dataiku DSS API documentation.
  • API Endpoint Errors: Network issues, incorrect server URL, or insufficient permissions can cause errors. Verify the Dataiku DSS server URL and API key permissions.
  • Error Messages: The node surfaces API error messages prefixed with "Error calling Dataiku DSS API:" followed by the message and stack trace if available. Use these messages to diagnose issues.

Links and References


This summary focuses on the "Machine Learning - Lab" resource and the "Create Visual Analysis" operation, describing how the node constructs the API request, required inputs, and expected outputs based on static code analysis.

Discussion