Sobre o conector do Databricks
O Conector do Databricks permite consultar dados armazenados no seu Databricks Lakehouse diretamente do Perplexity. Ele integra o Databricks aos recursos de produtividade do Perplexity, permitindo que você pesquise e combine instantaneamente informações relevantes em seus catálogos, esquemas e tabelas do Databricks — sem consultas manuais ou troca de contexto.
O Conector do Databricks está disponível para Perplexity Pro, Perplexity Max, Enterprise Pro, e Enterprise Max usuários.
O que faz o conector do Databricks?
Depois de ativado, o Conector do Databricks permite que você pesquise em seus catálogos, esquemas e tabelas autorizados do Databricks para fornecer respostas com base nesses dados. O conector se autentica usando sua identidade individual do Databricks via OAuth, o que significa que as consultas são executadas sob suas permissões nativas do Databricks — sem necessidade de uma conta de serviço compartilhada.
Você pode usar o conector para encontrar rapidamente informações em tabelas do Unity Catalog, dados do Delta Lake e views sem escrever SQL manualmente nem alternar para o console do Databricks. Quando seus dados do Databricks são atualizados, o conector reflete essas alterações automaticamente nas consultas subsequentes.
Objetos de dados compatíveis
O conector do Databricks oferece suporte a:
-
Tabelas e views do Unity Catalog
-
Tabelas Delta Lake
-
Esquemas e catálogos
-
Tabelas externas registradas no Unity Catalog
-
Dados estruturados (tabelas com suporte a CSV, JSON, Parquet)
No momento, dados não estruturados (imagens, áudio, vídeo e arquivos armazenados em Databricks Volumes) não são compatíveis.
Autenticação
O conector do Databricks usa autenticação OAuth (usuário individual). Cada usuário do Perplexity se conecta usando suas próprias credenciais do Databricks, e as consultas são executadas sob as permissões nativas do Unity Catalog desse usuário — não há conta de serviço compartilhada, PAT nem service principal envolvidos.
Isto significa:
-
O acesso aos dados é regido pelas permissões existentes de cada usuário no Databricks
-
Toda consulta mantém um rastro de auditoria claro por usuário no Databricks
-
Um administrador da organização configura o aplicativo OAuth uma vez; depois, os usuários individuais se autenticam com suas próprias contas
Observação: Como os tokens OAuth estão vinculados à identidade Databricks de cada usuário, os usuários só poderão consultar catálogos, esquemas e tabelas aos quais já tenham acesso no Databricks. Certifique-se de que as permissões apropriadas do Unity Catalog estejam configuradas antes de conectar.
Controlando o que o Perplexity pode fazer no Databricks
O Conector do Databricks executa SQL por meio de uma interface de ferramentas (proveniente do conector Databricks da Merge) que inclui uma ferramenta geral execute_sql_statement. Como execute_sql_statement aceita SQL arbitrário — incluindo DDL e DML — a única maneira confiável de impor somente leitura ou, de outra forma, restringir o que o Perplexity pode fazer é no nível do Unity Catalog, não na interface do Perplexity.
Padrão recomendado: impor somente leitura por meio de concessões do Unity Catalog.
Como o conector autentica por usuário via OAuth, toda ação que a Perplexity tenta executar ocorre sob a identidade Databricks desse usuário e está sujeita às permissões já existentes dele no Unity Catalog. Para manter o uso somente leitura, garanta que cada usuário (ou o grupo ao qual ele pertence) tenha apenas:
-
USE CATALOGnos catálogos que você quer que eles consultem -
USE SCHEMAnos esquemas que você quer que eles consultem -
SELECTnas tabelas e visualizações que você quer que eles consultem
E explicitamente não possua MODIFY, CREATE ou OWN nesses objetos, nem CAN MANAGE no warehouse de SQL. Com o Unity Catalog configurado dessa forma, o Databricks rejeitará qualquer tentativa de gravação que o Perplexity faça em objetos nos quais o usuário não tenha privilégios de gravação, independentemente da ferramenta usada.
Observação: O Perplexity apresenta um painel de Permissões da ferramenta nas configurações do conector do Databricks que lista as ferramentas disponíveis. Hoje, este painel não oferece aplicação confiável de leitura/gravação/edição — governar o acesso no nível do Unity Catalog (acima) é a forma correta de controlar o que o Perplexity pode fazer.
Privacidade e Segurança de Dados
Quando conectado ao Perplexity, o Conector do Databricks pode realizar as seguintes ações em seu nome:
-
Execute consultas SQL em dados do Databricks por meio de SQL Warehouses
-
Consultar tabelas, visualizações e esquemas do Unity Catalog
-
Ler metadados e dados da tabela Delta Lake
Se você revogar o acesso ou remover permissões no Databricks, esses dados ficam imediatamente inacessíveis no Perplexity. Se você desconectar sua conta do Databricks no Perplexity, poderá escolher se deseja manter ou excluir quaisquer dados em cache.
Segurança e controle de nível empresarial
Para organizações Enterprise, a Perplexity oferece certificação SOC 2 Type II, criptografia de ponta a ponta, medidas rigorosas de privacidade de dados e controles granulares de acesso de usuários. Seus dados do Databricks nunca são usados para treinamento de IA.
Conectar o Perplexity ao Databricks é feito em um nível pessoal — ninguém mais na sua organização poderá consultar seus dados do Databricks. No entanto, se você sincronizar dados com um projeto compartilhado, qualquer pessoa com acesso a esse projeto poderá pesquisá-los.
Os administradores da organização podem ativar ou desativar o Conector do Databricks para todos os usuários na tela Permissões em Configurações da organização. A aplicação de leitura/gravação é tratada no nível do Unity Catalog (veja Controlando o que o Perplexity pode fazer no Databricks acima).
Como ativá-lo
Configurar o Conector do Databricks é um processo em duas etapas: um administrador configura o app OAuth uma vez para a organização, e depois cada usuário se autentica com sua própria conta do Databricks.
Parte 1: Configuração de administrador — Configure o Databricks para sua organização
Um administrador do workspace da Databricks precisa concluir esta etapa uma vez. Usuários individuais não precisam repeti-la.
Em Configurações da organização → Conectores → Databricks, você verá um painel de configuração em três etapas intitulado “Configure o Databricks para sua organização”:
-
Etapa 1: Gerenciar app OAuth — Clique em Gerenciar app OAuth para registrar o Perplexity como um cliente OAuth no seu workspace do Databricks. Isso concede ao Perplexity permissão para autenticar usuários por meio de OAuth no seu workspace.
-
Etapa 2: Autenticar com o Databricks — O administrador se autentica uma única vez para verificar se a integração funciona de ponta a ponta.
-
Etapa 3: Gerar um mapa de dados (opcional) — Opcionalmente, gere um mapa de dados para a organização (veja a Parte 3 abaixo e Entendendo o Mapa de Dados) e adicione contexto suplementar para melhorar a precisão da consulta.
Observação: Você precisará de privilégios de administrador do workspace do Databricks para concluir esta etapa. Se você não souber como registrar um app OAuth no Databricks, consulte o documentação OAuth do Databricks.
Parte 2: Configuração do usuário — autenticar e conectar
Cada usuário conclui as seguintes etapas de forma independente:
-
Vá para Conectores nas Configurações e localize o Conector Databricks.
-
Clique em Enable → Adicionar conector.
-
Clique em Autenticar com Databricks. Você será redirecionado para o Databricks para entrar com suas próprias credenciais.
-
Autorize a Perplexity a acessar seus dados do Databricks.
-
Clique em Allow para concluir a configuração.
Parte 3: Gere um mapa de dados (opcional, mas recomendado)
Após a autenticação, o Perplexity pode gerar um mapa de dados do seu ambiente Databricks. Isso ajuda o Computer a entender a estrutura do seu catálogo e responder perguntas sobre dados com mais precisão.
-
Clique em Regenerar mapa de dados para criar ou atualizar o mapa a qualquer momento.
-
Para melhores resultados, adicione também Contexto suplementar — envie arquivos ou adicione notas descrevendo seus dados (por exemplo, o que as principais tabelas representam, definições de negócio, padrões de consulta comuns). Esse contexto adicional ajuda o agente a interpretar seus dados corretamente.
-
Clique em Ver conhecimento para revisar o que o Perplexity aprendeu sobre o seu ambiente Databricks.
Pular o mapa de dados resultará em menor precisão em perguntas complexas sobre dados. Recomendamos gerá-lo como parte da configuração inicial. Saiba mais em Entendendo o Mapa de Dados.
Usando dados conectados
Depois de conectado, você pode referenciar seus dados do Databricks em tarefas do Computer. Mencione catálogos, schemas ou tabelas e o Perplexity os consultará como parte de fluxos de trabalho em várias etapas — tudo de forma assíncrona em um sandbox seguro na nuvem.
Testando
Depois de conectado, tente executar consultas como estas:
-
"Resuma as tendências de receita da tabela de vendas do 4º trimestre e destaque as principais métricas"
-
"Encontre todos os registros de clientes atualizados nos últimos 30 dias"
-
"Quais são os produtos com melhor desempenho com base no esquema de análises?"
-
"Compare os dados do pipeline deste trimestre com os números do trimestre anterior"
Solução de problemas
Databricks não está habilitado para sua organização
Um administrador da organização pode ter desativado o conector, ou o aplicativo OAuth talvez ainda não tenha sido configurado. Entre em contato com o administrador da sua organização para confirmar ou fale com o suporte da Perplexity.
Aplicativo OAuth não configurado
Se os usuários virem um erro ao tentar autenticar, talvez a configuração do aplicativo OAuth de administrador (Parte 1) não esteja concluída. Um administrador do workspace deve voltar para Configurações da organização → Conectores → Databricks e concluir a etapa Gerenciar app OAuth.
O usuário não consegue acessar determinadas tabelas após conectar
O Conector do Databricks respeita as permissões existentes do Unity Catalog de cada usuário. Se um usuário não conseguir consultar uma tabela à qual espera ter acesso, verifique se a permissão apropriada GRANT foi aplicado no Unity Catalog:
-- Conceder acesso a um catálogo
GRANT USE CATALOG ON CATALOG my_catalog TO `user@example.com`;
-- Conceder acesso a um schema
GRANT USE SCHEMA ON SCHEMA my_catalog.my_schema TO `user@example.com`;
-- Conceder acesso de leitura às tabelas
GRANT SELECT ON TABLE my_catalog.my_schema.my_table TO `user@example.com`;
O mapa de dados está desatualizado ou impreciso
Se o Perplexity estiver gerando respostas incorretas ou desatualizadas sobre seus dados do Databricks, tente clicar em Regenerar mapa de dados nas configurações do conector. Você também pode adicionar ou atualizar Contexto suplementar para fornecer ao agente orientações melhores sobre a estrutura dos seus dados.
Problemas de conexão e autenticação
-
Verifique se o aplicativo OAuth está configurado corretamente no seu workspace do Databricks
-
Confirme que os URIs de redirecionamento do Perplexity estão na lista de permissões nas configurações do seu aplicativo OAuth do Databricks
-
Se o seu workspace usa listas de acesso de IP, verifique se os IPs do Perplexity estão na lista de permissões
-
Peça aos usuários que reconectem o conector do Databricks após qualquer alteração na política do workspace
Se os problemas persistirem após a atualização dessas configurações, entre em contato com o suporte da Perplexity para obter ajuda.