Dataiku DSS icon

Dataiku DSS

Use the Dataiku DSS API

Actions364

Overview

This node integrates with the Dataiku DSS API, enabling users to interact programmatically with various Dataiku DSS resources and operations. Specifically, for the Machine Learning - Lab resource and the Get Scoring PMML of Trained Model operation, it retrieves the Predictive Model Markup Language (PMML) scoring file of a trained machine learning model within a project.

This functionality is useful when you want to export or use the PMML representation of a trained model for deployment, integration with other systems, or further analysis outside Dataiku DSS. For example, you might extract the PMML to deploy the model in a real-time scoring engine that supports PMML or to share the model with stakeholders who require a standardized format.

Properties

Name Meaning
Project Key The unique identifier of the Dataiku DSS project containing the ML model.
Analysis ID The identifier of the analysis context within the project related to the ML task.
ML Task ID The identifier of the specific machine learning task associated with the trained model.
Model Full ID The full identifier of the trained model whose scoring PMML is to be retrieved.

These properties are required to specify exactly which trained model's PMML scoring file should be fetched.

Output

The output contains the binary data of the PMML scoring file for the specified trained model. This binary data represents the PMML XML content, which can be saved as a .pmml file or used directly in downstream processes that consume PMML models.

The output structure is:

  • binary.data: Contains the raw PMML file data prepared for further use or download.

No JSON output is expected for this operation since the response is a binary PMML 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 uses HTTP requests to communicate with the Dataiku DSS REST API endpoints.
  • No additional external libraries beyond those bundled with n8n are required.

Troubleshooting

  • Missing Credentials Error: If the node throws "Missing Dataiku DSS API Credentials," ensure that the API key credential is configured correctly in n8n.
  • Required Parameter Missing: Errors like "Project Key is required" or "Model Full ID is required" indicate that mandatory input parameters were not provided. Verify all required fields are filled.
  • Permission Issues: Accessing PMML scoring files requires appropriate permissions on the Dataiku DSS project and model. Ensure the API key has sufficient rights.
  • Model Compatibility: The model must support PMML scoring and the user must have the license to access PMML scoring files; otherwise, the request may fail.
  • Network/Connectivity Issues: Ensure that the n8n instance can reach the Dataiku DSS server URL and that no firewall or network restrictions block the API calls.

Links and References


Note: This summary focuses on the "Machine Learning - Lab" resource and the "Get Scoring PMML of Trained Model" operation as requested. The node supports many other resources and operations not covered here.

Discussion