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. It supports many resource types such as Machine Learning Lab, Datasets, Projects, Dashboards, Plugins, and more.

Specifically for the Machine Learning - Lab resource and the Update Visual Analysis operation, the node allows updating an existing visual analysis within a Dataiku project. This is useful for automating modifications or enhancements to visual analyses in machine learning projects, such as changing parameters, updating metadata, or refreshing visual components programmatically.

Common scenarios include:

  • Automating updates to visual analyses after retraining models.
  • Integrating visual analysis updates into CI/CD pipelines.
  • Synchronizing visual analysis configurations across environments.

Properties

Name Meaning
Project Key The unique key identifying the Dataiku project where the visual analysis exists.
Analysis ID The identifier of the visual analysis to update.
Request Body JSON object containing the data to update the visual analysis with (e.g., new settings).

These properties are used to specify which visual analysis to update and what changes to apply.

Output

The node outputs the response from the Dataiku DSS API after performing the update operation. The output is a JSON object representing the updated visual analysis details or confirmation of the update.

If the operation involves downloading files or binary content (not typical for this operation), the node would output binary data accordingly, but for "Update Visual Analysis," the output is JSON.

Dependencies

  • Requires an active connection to a Dataiku DSS instance.
  • Needs valid API credentials (an API key) 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.

Troubleshooting

  • Missing Credentials Error: If the API credentials are not set or invalid, the node will throw an error indicating missing credentials.
  • Required Parameter Missing: The node validates required parameters like Project Key, Analysis ID, and ML Task ID. Omitting these will cause errors.
  • API Errors: Any HTTP or API errors returned by Dataiku DSS will be surfaced as node errors with messages prefixed by "Error calling Dataiku DSS API."
  • Invalid JSON in Request Body: Ensure that the JSON provided in the Request Body property is well-formed; otherwise, parsing errors may occur.

To resolve issues:

  • Verify that all required input fields are correctly filled.
  • Check that the API key credential is valid and has sufficient permissions.
  • Confirm the Dataiku DSS server URL is reachable.
  • Validate the JSON syntax in the Request Body.

Links and References


Note: This summary focuses on the "Machine Learning - Lab" resource and the "Update Visual Analysis" operation as requested.

Discussion