DatabricksInstall

Overview

This node integrates with the Databricks Genie API to manage and interact with Genie spaces and conversations. Specifically, the "Get Genie Space" operation retrieves detailed information about a specified Genie space by its ID. This is useful for users who want to programmatically access metadata or configuration details of a Genie space within Databricks.

Common scenarios include:

• Fetching space details before starting or managing conversations.
• Auditing or monitoring Genie spaces in an automated workflow.
• Integrating Genie space data into broader data pipelines or dashboards.

Example: A user can input a Genie space ID to retrieve its properties and use that information to decide how to route messages or start conversations within that space.

Properties

Output

The output is a JSON object containing the response from the Genie API for the requested space. It typically includes all metadata and details related to the Genie space identified by the provided Space ID.

Example output structure (simplified):

{
  "id": "string",
  "name": "string",
  "description": "string",
  "createdAt": "timestamp",
  "updatedAt": "timestamp",
  // other space-specific properties
}

No binary data output is produced by this operation.

Dependencies

• Requires an API authentication token credential for Databricks with appropriate permissions to access Genie spaces.
• The node makes HTTP requests to the Databricks API endpoint configured via credentials.
• No additional external services are required beyond the Databricks environment.

Troubleshooting

• Common issues:

  • Invalid or missing Space ID will cause the API request to fail.
  • Insufficient permissions on the API token may result in authorization errors.
  • Network connectivity problems can prevent successful API calls.

• Error messages:

  • API Error: <status code> <status text>: Indicates the API responded with an error status. Check the Space ID validity and API token permissions.
  • Network Error: No response received from server: Suggests network issues or incorrect API endpoint configuration.
  • Other generic errors will be reported with their message and stack trace if the node is set to continue on failure.

To resolve errors:

• Verify the Space ID is correct and exists.
• Ensure the API token has the necessary scopes/permissions.
• Confirm network connectivity and correct API host configuration.

Links and References

• Databricks Genie API Documentation (for detailed API endpoints and payloads)
• n8n HTTP Request Node Documentation (for understanding HTTP request handling in n8n)