Dataiku DSS icon

Dataiku DSS

Use the Dataiku DSS API

Actions364

Overview

This node integrates with the Dataiku DSS API, allowing users to interact programmatically with various Dataiku DSS resources. Specifically for the Dataset resource and the Get Data - Alternative Version operation, it streams the content of a dataset's alternative version from a specified project in Dataiku DSS.

This operation is useful when you want to retrieve dataset data that may represent an alternative or specific version different from the default dataset view. It can be used in scenarios such as:

  • Extracting historical or experimental versions of datasets.
  • Accessing snapshot data for auditing or comparison.
  • Feeding alternative dataset versions into downstream workflows or analyses.

Example use case: You have multiple versions of a dataset representing different stages of data processing, and you want to fetch a particular version to validate or analyze it without affecting the main dataset.

Properties

Name Meaning
Project Key The unique key identifying the Dataiku DSS project containing the dataset.
Dataset Name The name of the dataset within the specified project whose alternative version data is fetched.
Request Body A JSON object representing additional request parameters or filters to customize the data retrieval.

Output

The output contains the streamed content of the dataset's alternative version. The data is returned in the json field of the output items.

  • If the response is JSON, it will be parsed and returned as structured JSON.
  • If the response is binary (e.g., file content), it will be prepared as binary data under the binary.data property with an appropriate filename extension.
  • For this operation, the typical output is JSON data representing the dataset content.

Dependencies

  • Requires a valid connection to a Dataiku DSS instance.
  • Requires an API key credential 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 other external dependencies are required.

Troubleshooting

  • Missing Credentials Error: If the API key or server URL is not provided, the node throws an error indicating missing credentials. Ensure the API key credential is properly set up.
  • Required Parameters Missing: The node validates required parameters like Project Key and Dataset Name. Omitting these will cause errors. Provide all mandatory fields.
  • API Errors: If the Dataiku DSS API returns an error (e.g., unauthorized, not found), the node surfaces the error message. Check your permissions and parameter correctness.
  • Parsing Errors: If the response is expected to be JSON but cannot be parsed, the raw text is returned instead. Verify the API endpoint and request body.
  • Binary Data Handling: For operations returning files, ensure the binary data is handled correctly downstream.

Links and References


This summary focuses on the Dataset resource and the "Get Data - Alternative Version" operation as requested.

Discussion