Dataiku DSS icon

Dataiku DSS

Use the Dataiku DSS API

Actions364

Overview

The node integrates with the Dataiku DSS API, enabling users to perform a wide range of operations on various Dataiku DSS resources. Specifically for the Job resource and the Run Job operation, this node allows starting a job run within a specified project in Dataiku DSS. This is useful for automating job executions as part of data workflows or pipelines.

Common scenarios include:

  • Triggering batch jobs or data processing tasks programmatically.
  • Automating job runs based on external events or schedules.
  • Integrating Dataiku DSS job execution into broader automation workflows.

Example: You can use this node to start a job that builds a dataset or triggers a machine learning model training process in Dataiku DSS, then continue downstream processing based on the job's output.

Properties

Name Meaning
Project Key The key identifier of the Dataiku DSS project where the job will be run.
Request Body JSON object containing parameters or configuration for the job run request body.

These properties are used to specify which project the job belongs to and any additional details required by the API to run the job.

Output

The node outputs the response from the Dataiku DSS API after attempting to run the job. The output is structured as JSON and typically contains information about the started job, such as job ID, status, and other metadata returned by the API.

If the operation involves downloading files or binary content (not applicable specifically for "Run Job"), the node would output binary data accordingly. For the "Run Job" operation, the output is JSON only.

Dependencies

  • Requires an active connection to a Dataiku DSS instance.
  • Needs an API authentication token credential configured in n8n to authorize requests to the Dataiku DSS API.
  • The node uses HTTP requests to communicate with the Dataiku DSS REST API endpoints.

Troubleshooting

  • Missing Credentials Error: If the node throws an error about missing credentials, ensure you have configured the required API authentication token for Dataiku DSS in n8n.
  • Project Key Required: The "Project Key" property must be provided; otherwise, the node will throw an error indicating it is required.
  • API Errors: Errors returned by the Dataiku DSS API (e.g., invalid job parameters, unauthorized access) will be surfaced as node errors with messages from the API. Check the API response and verify your inputs.
  • Invalid JSON in Request Body: Ensure the "Request Body" JSON is well-formed; malformed JSON will cause parsing errors.
  • Network Issues: Connectivity problems to the Dataiku DSS server will result in request failures. Verify network access and server availability.

Links and References


This summary focuses on the "Job" resource and "Run Job" operation as requested, describing how the node constructs the API request, handles input properties, and returns the job run response.

Discussion