Databricks oauth docs

[tgberkeley]

No description provided.

[greptile-apps]

Greptile Overview

Greptile Summary

Added comprehensive OAuth authentication documentation for Databricks integration as an alternative to Personal Access Token authentication. The PR includes 7 new screenshots walking through the Service Principal creation process in Databricks and restructures the documentation with tabs to present both authentication methods.

Key Changes:

• Reorganized credentials section to present Personal Access Token and OAuth as two authentication options using markdown tabs
• Added detailed step-by-step OAuth setup guide with 7 screenshots covering Service Principal creation, secret generation, and credential retrieval
• Moved catalog/schema configuration before authentication credentials for better logical flow

Issue Found:

• Step 2 (Configure the Integration) only lists DATABRICKS_TOKEN and doesn't mention the OAuth credentials (DATABRICKS_CLIENT_ID and DATABRICKS_CLIENT_SECRET) that users who chose OAuth would need to paste

Confidence Score: 3/5

• This PR is safe to merge but has incomplete documentation that will confuse OAuth users
• Documentation and image additions are non-breaking, but the missing OAuth credentials in Step 2 creates an incomplete user experience that needs to be addressed before users can successfully configure OAuth authentication
• docs/ai_builder/integrations/databricks.md requires updating Step 2 to include OAuth credentials

Important Files Changed

File Analysis

Filename	Score	Overview
docs/ai_builder/integrations/databricks.md	3/5	Added OAuth authentication option with step-by-step guide, but Step 2 configuration section doesn't mention OAuth credentials

Sequence Diagram

sequenceDiagram
    participant User
    participant Docs as Documentation
    participant Databricks as Databricks UI
    participant App as Reflex App
    
    User->>Docs: View Databricks integration guide
    Docs->>User: Show authentication options (PAT or OAuth)
    
    alt Personal Access Token
        User->>Databricks: Navigate to Settings > Developer
        Databricks->>User: Show Access Tokens page
        User->>Databricks: Generate new token
        Databricks->>User: Return DATABRICKS_TOKEN
    else OAuth (New in this PR)
        User->>Databricks: Navigate to Manage Account
        User->>Databricks: Go to Users and Groups > Service Principals
        User->>Databricks: Add Service Principal
        Databricks->>User: Create Service Principal
        User->>Databricks: Generate OAuth secret
        Databricks->>User: Return DATABRICKS_CLIENT_ID and DATABRICKS_CLIENT_SECRET
    end
    
    User->>Databricks: Get HOST, WAREHOUSE_ID, CATALOG, SCHEMA
    Databricks->>User: Return connection details
    User->>App: Configure integration with credentials
    App->>Databricks: Validate connection
    Databricks->>App: Connection confirmed
    App->>User: Integration ready

Loading

Additional Comments (1)

1. docs/ai_builder/integrations/databricks.md, line 252-258 (link)

   logic: Step 2 doesn't mention OAuth credentials. Users who chose OAuth need to paste DATABRICKS_CLIENT_ID and DATABRICKS_CLIENT_SECRET instead of DATABRICKS_TOKEN.

_{1 file reviewed, 1 comment}

_{Edit Code Review Agent Settings | Greptile}