Dataiku DSS icon

Dataiku DSS

Use the Dataiku DSS API

Actions364

Overview

This node integrates with the Dataiku DSS API, enabling users to perform various operations on Dataiku DSS resources. Specifically for the Notebook resource and the Delete Jupyter Notebook operation, the node allows you to delete a specified Jupyter notebook within a given project on the Dataiku DSS platform. This deletion also stops all active sessions associated with that notebook.

Common scenarios where this node is beneficial include:

  • Automating cleanup of obsolete or temporary Jupyter notebooks in Dataiku projects.
  • Managing notebook lifecycle programmatically as part of larger workflows.
  • Ensuring that no active sessions remain when a notebook is deleted, preventing orphaned processes.

Example use case:

  • A data engineering pipeline automatically deletes notebooks after their results have been exported or processed, keeping the project environment clean.

Properties

Name Meaning
Project Key The unique identifier of the Dataiku project containing the notebook to delete.
Notebook Name The name of the Jupyter notebook to be deleted within the specified project.

Output

The output of this node is a JSON array containing the response from the Dataiku DSS API after attempting to delete the notebook. Typically, for a delete operation, the response may be empty or contain status information confirming the deletion.

  • If the deletion is successful, the output will confirm the action (often an empty JSON or a success message).
  • If there is an error, the node throws an error with details about the failure.

No binary data output is expected for this operation.

Dependencies

  • Requires a valid connection to a Dataiku DSS instance.
  • Requires an API key credential for authenticating requests to 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 key credential is not provided or invalid, the node will throw an error indicating missing credentials.
  • Project Key or Notebook Name Missing: The node requires both the project key and notebook name to construct the API request URL. Omitting either will cause an error.
  • API Request Failures: Network issues, incorrect project keys, or notebook names that do not exist will result in API errors. The node surfaces these errors with messages from the Dataiku DSS API.
  • Active Sessions Not Stopping: Since deleting a notebook also stops its active sessions, if sessions persist, verify permissions and API server health.

Links and References


This summary focuses exclusively on the "Notebook" resource and the "Delete Jupyter Notebook" operation as requested.

Discussion