Connessione di Perplexity con Databricks | Centro assistenza Perplexity

Informazioni sul connettore Databricks

Il connettore Databricks consente di eseguire query sui dati archiviati nel tuo Databricks Lakehouse direttamente da Perplexity. Integra Databricks con le funzionalità di produttività di Perplexity, consentendoti di cercare e combinare istantaneamente informazioni pertinenti tra cataloghi, schemi e tabelle Databricks, senza query manuali o cambio di contesto.

Il connettore Databricks è disponibile per Perplexity Pro, Perplexity Max, Enterprise Proe Enterprise Max users.

Cosa fa il connettore Databricks?

Una volta abilitato, il connettore Databricks ti consente di cercare tra cataloghi, schemi e tabelle Databricks autorizzati per fornire risposte basate su tali dati. Il connettore si autentica utilizzando la tua identità Databricks individuale tramite OAuth, il che significa che le query vengono eseguite con le tue autorizzazioni Databricks native, senza bisogno di un account di servizio condiviso.

Puoi usare il connettore per trovare rapidamente informazioni tra tabelle Unity Catalog, dati Delta Lake e viste, senza scrivere manualmente SQL o passare alla console Databricks. Quando i tuoi dati Databricks vengono aggiornati, il connettore riflette automaticamente tali modifiche nelle query successive.

Oggetti dati supportati

Il connettore Databricks supporta:

tabelle e viste di Unity Catalog
Tabelle Delta Lake
Schema e cataloghi
Tabelle esterne registrate in Unity Catalog
Dati strutturati (tabelle basate su CSV, JSON, Parquet)

Al momento, i dati non strutturati (immagini, audio, video e file archiviati in Databricks Volumes) non sono supportati.

Autenticazione

Il Connettore Databricks usa OAuth (utente singolo) autenticazione. Ogni utente Perplexity si connette usando le proprie credenziali Databricks e le query vengono eseguite con le autorizzazioni native di Unity Catalog di quell'utente: non è coinvolto alcun account di servizio condiviso, PAT o service principal.

Questo significa:

L'accesso ai dati è governato dalle autorizzazioni Databricks esistenti di ciascun utente
Ogni query mantiene in Databricks una traccia di audit chiara per utente
Un amministratore dell'organizzazione configura una sola volta l'app OAuth; gli utenti singoli poi si autenticano con i propri account

Note: Poiché i token OAuth sono associati all'identità Databricks di ciascun utente, gli utenti potranno eseguire query solo su cataloghi, schemi e tabelle a cui hanno già accesso in Databricks. Assicurati che le autorizzazioni appropriate di Unity Catalog siano configurate prima della connessione.

Controllo di ciò che Perplexity può fare in Databricks

Il Connettore Databricks esegue SQL tramite una superficie degli strumenti (proveniente dal Connettore Databricks Merge) che include un generico execute_sql_statement strumento. Poiché execute_sql_statement accetta SQL arbitrario — inclusi DDL e DML — il l'unico modo affidabile per applicare la sola lettura o, in alternativa, limitare ciò che Perplexity può fare è a livello di Unity Catalognon nell'interfaccia utente di Perplexity.

Schema consigliato: applicare la sola lettura tramite i grant di Unity Catalog.

Poiché il connettore si autentica per utente tramite OAuth, ogni azione che Perplexity tenta di eseguire viene eseguita sotto l'identità Databricks di quell'utente ed è soggetta alle autorizzazioni Unity Catalog già in essere. Per mantenere un utilizzo in sola lettura, assicurati che ogni utente (o il gruppo di appartenenza) disponga solo di:

USE CATALOG sui cataloghi che vuoi che interrogino
USE SCHEMA sugli schemi che vuoi che interrogino
SELECT su tabelle e viste che vuoi che interrogino

E non disponga esplicitamente di non detenga MODIFY, CREATE, né di OWN su tali oggetti, né CAN MANAGE sul warehouse SQL. Con Unity Catalog configurato in questo modo, Databricks rifiuterà qualsiasi operazione di scrittura che Perplexity tenti di eseguire sugli oggetti per i quali l'utente non dispone dei privilegi di scrittura, a prescindere dallo strumento chiamato.

Note: Perplexity mostra un pannello Autorizzazioni degli strumenti nelle impostazioni del connettore Databricks che elenca gli strumenti disponibili. Oggi, questo pannello non non fornisce un'applicazione affidabile delle autorizzazioni di lettura/scrittura/modifica — gestire l'accesso a livello di Unity Catalog (come sopra) è il modo corretto per controllare ciò che Perplexity può fare.

Privacy e sicurezza dei dati

Quando è connesso a Perplexity, il connettore Databricks può eseguire le seguenti azioni per tuo conto:

Eseguire query SQL sui dati di Databricks tramite SQL Warehouse
Interrogare tabelle, viste e schemi di Unity Catalog
Leggere i metadati e i dati delle tabelle Delta Lake

Se revochi l’accesso o rimuovi le autorizzazioni in Databricks, tali dati diventano immediatamente inaccessibili da Perplexity. Se disconnetti il tuo account Databricks in Perplexity, puoi scegliere se conservare o eliminare i dati memorizzati nella cache.

Sicurezza e controllo di livello Enterprise

Per le organizzazioni Enterprise, Perplexity offre la certificazione SOC 2 Type II, crittografia end-to-end, rigorose misure di privacy dei dati e controlli granulari sugli accessi degli utenti. I tuoi dati di Databricks non vengono mai utilizzati per l’addestramento dell’AI.

La connessione di Perplexity a Databricks avviene a livello personale — nessun altro nella tua organizzazione può interrogare i tuoi dati di Databricks. Tuttavia, se sincronizzi i dati in un Progetto condiviso, chiunque abbia accesso a quel Progetto potrà cercarli.

Gli amministratori dell’organizzazione possono abilitare o disabilitare il connettore Databricks per tutti gli utenti dalla schermata Autorizzazioni in Impostazioni dell’organizzazione. L’applicazione di regole di lettura/scrittura è gestita a livello di Unity Catalog (vedi Controllo di ciò che Perplexity può fare in Databricks sopra).

Come attivarlo

La configurazione del connettore Databricks avviene in due fasi: un amministratore configura una sola volta l’app OAuth per l’organizzazione e, successivamente, ogni utente si autentica con il proprio account Databricks.

Parte 1: configurazione dell’amministratore — Configura Databricks per la tua organizzazione

Un amministratore del workspace Databricks deve completare questo passaggio una sola volta. I singoli utenti non devono ripeterlo.

In Impostazioni dell’organizzazione → Connettori → Databricks, vedrai un pannello di configurazione in tre passaggi intitolato "Configura Databricks per la tua organizzazione":

Passaggio 1: gestisci app OAuth — fai clic su Gestisci app OAuth per registrare Perplexity come client OAuth nel tuo workspace Databricks. In questo modo concedi a Perplexity l’autorizzazione ad autenticare gli utenti tramite OAuth nel tuo workspace.
Passaggio 2: autenticati con Databricks — l’amministratore si autentica una volta per verificare che l’integrazione funzioni end-to-end.
Passaggio 3: genera una mappa dei dati (facoltativo) — genera facoltativamente una mappa dei dati per l’organizzazione (vedi la Parte 3 qui sotto e Comprendere la mappa dei dati) e aggiungi contesto supplementare per migliorare l’accuratezza delle query.

Note: Per completare questo passaggio saranno necessari i privilegi di amministratore del workspace Databricks. Se non sai con certezza come registrare un’app OAuth in Databricks, fai riferimento alla documentazione OAuth di Databricks.

Parte 2: Configurazione dell’utente — autenticazione e connessione

Ogni utente completa i seguenti passaggi in modo indipendente:

Vai a Connettori in Impostazioni e individua il connettore Databricks.
Fai clic su Abilita → Aggiungi connettore.
Fai clic su Autenticati con Databricks. Verrai reindirizzato a Databricks per accedere con le tue credenziali.
Autorizza Perplexity ad accedere ai tuoi dati Databricks.
Fai clic su Consenti per completare la configurazione.

Parte 3: Genera una mappa dei dati (facoltativo ma consigliato)

Dopo l’autenticazione, Perplexity può generare una mappa dei dati del tuo ambiente Databricks. Questo aiuta Computer a comprendere la struttura del tuo catalogo e a rispondere con maggiore precisione alle domande sui dati.

Fai clic su Rigenera la mappa dei dati per creare o aggiornare la mappa in qualsiasi momento.
Per ottenere i migliori risultati, aggiungi anche contesto supplementare — carica file o aggiungi note che descrivano i tuoi dati (ad es. cosa rappresentano le tabelle chiave, definizioni aziendali, pattern di query comuni). Questo contesto aggiuntivo aiuta l’agente a interpretare correttamente i tuoi dati.
Fai clic su Visualizza conoscenze per rivedere ciò che Perplexity ha appreso sul tuo ambiente Databricks.

Saltare la mappa dei dati comporterà una minore accuratezza nelle domande complesse sui dati. Consigliamo di generarla durante la configurazione iniziale. Scopri di più in Comprendere la mappa dei dati.

Utilizzo dei dati connessi

Una volta connesso, puoi fare riferimento ai tuoi dati Databricks nelle Computer attività. Menziona cataloghi, schemi o tabelle e Perplexity li interrogherà come parte di flussi di lavoro in più passaggi — tutto in modo asincrono in un sandbox cloud sicuro.

Prova pratica

Una volta connesso, prova a eseguire query come queste:

"Riassumi le tendenze dei ricavi dalla tabella delle vendite del Q4 ed evidenzia i metriche chiave"
"Trova tutti i record dei clienti aggiornati negli ultimi 30 giorni"
"Quali sono i prodotti con le migliori performance in base allo schema analytics?"
"Confronta i dati della pipeline di questo trimestre con quelli del trimestre precedente"

Risoluzione dei problemi

Databricks non è abilitato per la tua organizzazione

Un amministratore dell’organizzazione potrebbe aver disattivato il connettore, oppure l’app OAuth potrebbe non essere ancora configurata. Contatta l’amministratore della tua organizzazione per conferma oppure contatta l’assistenza di Perplexity.

OAuth app non configurata

Se gli utenti visualizzano un errore أثناء l'autenticazione, la configurazione dell'app OAuth dell'amministratore (Parte 1) potrebbe non essere completa. Un amministratore dell'area di lavoro dovrebbe tornare a Impostazioni organizzazione → Connettori → Databricks e completare il Gestisci app OAuth step.

L'utente non può accedere ad alcune tabelle dopo la connessione

Il connettore Databricks rispetta le autorizzazioni esistenti di Unity Catalog di ciascun utente. Se un utente non riesce a eseguire query su una tabella a cui si aspetta di accedere, verifica che la corretta GRANT sia stata applicata in Unity Catalog:

-- Grant access to a catalog
GRANT USE CATALOG ON CATALOG my_catalog TO `user@example.com`;

-- Grant access to a schema
GRANT USE SCHEMA ON SCHEMA my_catalog.my_schema TO `user@example.com`;

-- Grant read access to tables
GRANT SELECT ON TABLE my_catalog.my_schema.my_table TO `user@example.com`;

La mappa dei dati è obsoleta o imprecisa

Se Perplexity sta generando risposte errate o non aggiornate sui tuoi dati Databricks, prova a fare clic su Rigenera la mappa dei dati nelle impostazioni del connettore. Puoi anche aggiungere o aggiornare contesto supplementare per fornire all'agente indicazioni migliori sulla struttura dei tuoi dati.

Problemi di connessione e autenticazione

Verifica che l'app OAuth sia configurata correttamente nel tuo workspace Databricks
Conferma che gli URI di reindirizzamento di Perplexity siano inseriti nella allowlist nelle impostazioni dell'app OAuth di Databricks
Se il tuo workspace utilizza liste di accesso IP, assicurati che gli IP di Perplexity siano inseriti nella allowlist
Chiedi agli utenti di riconnettere il Connettore Databricks dopo eventuali modifiche ai criteri del workspace

Se i problemi persistono dopo l'aggiornamento di queste impostazioni, contatta l'assistenza di Perplexity per ricevere supporto.