Acerca del conector de Databricks
El conector de Databricks le permite consultar directamente desde Perplexity los datos almacenados en su Lakehouse de Databricks. Integra Databricks con las funciones de productividad de Perplexity, lo que le permite buscar y combinar al instante información relevante en sus catálogos, esquemas y tablas de Databricks, sin consultas manuales ni cambio de contexto.
El conector de Databricks está disponible para Perplexity Pro, Perplexity Max, Enterprise Pro y Enterprise Max users.
¿Qué hace el conector de Databricks?
Una vez habilitado, el conector de Databricks le permite buscar en sus catálogos, esquemas y tablas autorizados de Databricks para ofrecer respuestas basadas en esos datos. El conector se autentica mediante su identidad individual de Databricks a través de OAuth, lo que significa que las consultas se ejecutan con sus permisos nativos de Databricks; no se requiere una cuenta de servicio compartida.
Puede usar el conector para encontrar rápidamente información en tablas de Unity Catalog, datos de Delta Lake y vistas sin escribir SQL manualmente ni cambiar a la consola de Databricks. Cuando sus datos de Databricks se actualizan, el conector refleja esos cambios automáticamente en consultas posteriores.
Objetos de datos compatibles
El conector de Databricks admite:
Tablas y vistas de Unity Catalog
Tablas de Delta Lake
Esquemas y catálogos
Tablas externas registradas en Unity Catalog
Datos estructurados (CSV, JSON, tablas respaldadas por Parquet)
En este momento, no se admiten datos no estructurados (imágenes, audio, video y archivos almacenados en Databricks Volumes).
Autenticación
El conector de Databricks utiliza Autenticación OAuth (usuario individual) . Cada usuario de Perplexity se conecta con sus propias credenciales de Databricks, y las consultas se ejecutan con los permisos nativos de Unity Catalog de ese usuario; no intervienen una cuenta de servicio compartida, PAT ni un principal de servicio.
Esto significa que:
El acceso a los datos está determinado por los permisos existentes de cada usuario en Databricks
Cada consulta deja una pista de auditoría clara por usuario en Databricks
Un administrador de la organización configura la aplicación OAuth una vez; luego, cada usuario se autentica con su propia cuenta
Nota: Debido a que los tokens de OAuth están vinculados a la identidad de Databricks de cada usuario, los usuarios solo podrán consultar los catálogos, esquemas y tablas a los que ya tengan acceso en Databricks. Asegúrese de que los permisos adecuados de Unity Catalog estén configurados antes de conectar.
Controlar lo que Perplexity puede hacer en Databricks
El conector de Databricks ejecuta SQL a través de una superficie de herramientas (procedente de la fusión del conector de Databricks), que incluye una herramienta general execute_sql_statement. Debido a que execute_sql_statement acepta SQL arbitrario —incluidos DDL y DML—, la única forma fiable de imponer solo lectura o, de otro modo, restringir lo que Perplexity puede hacer es a nivel de Unity Catalog; no en la interfaz de Perplexity.
Patrón recomendado: aplique solo lectura mediante permisos de Unity Catalog.
Debido a que el conector se autentica por usuario mediante OAuth, cada acción que Perplexity intenta ejecutar se realiza bajo la identidad de Databricks de ese usuario y está sujeta a sus permisos existentes de Unity Catalog. Para mantener el uso en modo de solo lectura, asegúrese de que cada usuario (o el grupo al que pertenezca) solo tenga:
USE CATALOGen los catálogos que desea que consultenUSE SCHEMAen los esquemas que desea que consultenSELECTen las tablas y vistas que desea que consulten
Y explícitamente no posea MODIFY, CREATE, ni OWN sobre esos objetos, ni CAN MANAGE sobre el warehouse de SQL. Con Unity Catalog configurado de esta manera, Databricks rechazará cualquier escritura que Perplexity intente realizar en objetos para los que el usuario no tenga privilegios de escritura, independientemente de la herramienta que se invoque.
Nota: Perplexity muestra un panel de Permisos de herramientas en la configuración del conector de Databricks que enumera las herramientas disponibles. Actualmente, este panel no proporciona una aplicación fiable de lectura/escritura/edición; gobernar el acceso a nivel de Unity Catalog (arriba) es la forma correcta de controlar lo que Perplexity puede hacer.
Privacidad y seguridad de los datos
Cuando está conectado a Perplexity, el Conector de Databricks puede realizar las siguientes acciones en su nombre:
Ejecutar consultas SQL sobre datos de Databricks mediante SQL Warehouses
Consultar tablas, vistas y esquemas de Unity Catalog
Leer metadatos y datos de tablas de Delta Lake
Si revoca el acceso o elimina permisos en Databricks, esos datos dejan de estar disponibles de inmediato desde Perplexity. Si desconecta su cuenta de Databricks en Perplexity, puede elegir conservar o eliminar cualquier dato almacenado en caché.
Seguridad y control de nivel empresarial
Para las organizaciones Enterprise, Perplexity ofrece certificación SOC 2 Type II, cifrado de extremo a extremo, estrictas medidas de privacidad de datos y controles granulares de acceso de usuarios. Sus datos de Databricks nunca se utilizan para el entrenamiento de IA.
La conexión de Perplexity con Databricks se realiza a nivel personal — nadie más en su organización puede consultar sus datos de Databricks. Sin embargo, si sincroniza datos con un Proyecto compartido, cualquier persona con acceso a ese Proyecto podrá buscar en ellos.
Los administradores de la organización pueden habilitar o deshabilitar el Conector de Databricks para todos los usuarios desde la pantalla de Permisos en Configuración de la organización. La aplicación de lectura/escritura se gestiona a nivel de Unity Catalog (vea Controlar lo que Perplexity puede hacer en Databricks arriba).
Requisitos previos de red
Esta sección solo se aplica si su espacio de trabajo de Databricks usa listas de acceso por IP o una restricción equivalente del tráfico entrante (por ejemplo, una política de entrada de Azure Databricks o un firewall delante del espacio de trabajo). Si su espacio de trabajo acepta tráfico entrante desde cualquier dirección, no es necesario realizar cambios en la red y puede pasar directamente a Cómo activarlo.
El conector de Databricks funciona con Merge Agent Handler, el socio de autenticación e integración de Perplexity para Databricks. Cuando un usuario hace clic en Autenticarse con Databricks, su navegador carga la página de inicio de sesión de Databricks, pero el intercambio del código OAuth con el endpoint de tokens de su espacio de trabajo (/oidc/v1/token) lo realiza Merge de servidor a servidor. Después de la vinculación, Merge también retransmite a su espacio de trabajo las llamadas de Perplexity a las API de SQL Warehouse y Unity Catalog. Estas solicitudes se originan en la infraestructura de Merge, no en la red del usuario ni en los rangos de IP publicados por Perplexity.
Si su espacio de trabajo restringe el tráfico entrante, añada lo siguiente a su lista de acceso por IP (o a una lista de permitidos equivalente) antes de realizar la configuración del administrador:
Merge Agent Handler (tenant de EE. UU.):
3.216.101.38y52.20.242.81. Estas direcciones son estáticas y se usan para el intercambio de tokens OAuth durante la autenticación y, después de la vinculación, para el tráfico continuo de la API de Databricks (llamadas a SQL Warehouse y Unity Catalog).Perplexity: los rangos de salida publicados en perplexity-user.json. Manténgalos en la lista de permitidos junto con las direcciones de Merge.
Nota: Si las direcciones de Merge no están en la lista de permitidos, los usuarios normalmente verán que la página de inicio de sesión y la pantalla de consentimiento de Databricks se cargan con normalidad y, después, recibirán un error token_exchange_failed cuando Perplexity intente completar la conexión.
Cómo activarlo
Configurar el conector de Databricks es un proceso de dos partes: un administrador configura la app de OAuth una sola vez para la organización y, luego, cada usuario se autentica con su propia cuenta de Databricks.
Parte 1: Configuración del administrador — Configure Databricks para su organización
Un administrador del espacio de trabajo de Databricks debe completar este paso una sola vez. Los usuarios individuales no necesitan repetirlo.
En Configuración de la organización → Conectores → Databricks, verá un panel de configuración de tres pasos titulado “Configurar Databricks para su organización” :
Paso 1: Administrar la app de OAuth — Haga clic en Administrar la app de OAuth para registrar Perplexity como cliente OAuth en su espacio de trabajo de Databricks. Esto concede a Perplexity permiso para autenticar a los usuarios mediante OAuth en su espacio de trabajo.
Paso 2: Autenticarse con Databricks — El administrador se autentica una vez para verificar que la integración funciona de principio a fin.
Paso 3: Generar un mapa de datos (opcional) — Opcionalmente, genere un mapa de datos para la organización (consulte la Parte 3 a continuación y Comprender el mapa de datos) y agregue contexto complementario para mejorar la precisión de las consultas.
Nota: Necesitará privilegios de administrador del espacio de trabajo de Databricks para completar este paso. Si no está seguro de cómo registrar una app de OAuth en Databricks, consulte la documentación de OAuth de Databricks.
Parte 2: Configuración del usuario — Autenticarse y conectar
Cada usuario completa los siguientes pasos de forma independiente:
Abra Plugins en la barra lateral (o Customize → Connectors si todavía no ves Plugins), busque Databricks en Descubrir o mediante la búsqueda y abra su página.
Seleccione Conectar.
Haga clic en Autenticarse con Databricks. Se le redirigirá a Databricks para iniciar sesión con sus propias credenciales.
Autorice a Perplexity para acceder a sus datos de Databricks.
Haga clic en Permitir para completar la configuración.
Este conector también puede aparecer dentro de un plugin. Al conectarlo en cualquier lugar, queda conectado para su cuenta en todas partes. Su conexión y los ajustes de conectores de su organización se aplican dentro de cada plugin. ¿Qué son los plugins?
Parte 3: Generar un mapa de datos (opcional pero recomendado)
Después de autenticarse, Perplexity puede generar un mapa de datos de su entorno de Databricks. Esto ayuda a Computer a comprender la estructura de su catálogo y a responder las preguntas sobre datos con mayor precisión.
Haga clic en Regenerar mapa de datos para generar o actualizar el mapa en cualquier momento.
Para obtener los mejores resultados, agregue también contexto complementario — cargue archivos o añada notas que describan sus datos (por ejemplo, qué representan las tablas clave, definiciones empresariales, patrones de consulta comunes). Este contexto adicional ayuda al agente a interpretar correctamente sus datos.
Haga clic en Ver conocimientos para revisar lo que Perplexity ha aprendido sobre su entorno de Databricks.
Omitir el mapa de datos dará lugar a una menor precisión en preguntas complejas sobre datos. Recomendamos generarlo como parte de la configuración inicial. Más información en Comprender el mapa de datos.
Uso de datos conectados
Una vez conectado, puede hacer referencia a sus datos de Databricks en Computer tareas. Mencione catálogos, esquemas o tablas y Perplexity los consultará como parte de flujos de trabajo de varios pasos, todo de forma asíncrona en un espacio aislado seguro en la nube.
Probarlo
Una vez conectado, pruebe a ejecutar consultas como estas:
“Resuma las tendencias de ingresos de la tabla de ventas del cuarto trimestre y destaque las métricas clave"
"Encuentre todos los registros de clientes actualizados en los últimos 30 días"
"¿Cuáles son los productos con mejor rendimiento según el esquema de analytics?"
"Compare los datos del pipeline de este trimestre con las cifras del trimestre anterior”
Solución de problemas
Databricks no está habilitado para su organización
Es posible que un administrador de la organización haya deshabilitado el conector, o que la aplicación OAuth aún no esté configurada. Póngase en contacto con el administrador de su organización para confirmarlo, o comuníquese con el soporte de Perplexity.
Aplicación OAuth no configurada
Si los usuarios ven un error al intentar autenticarse, es posible que la configuración de la aplicación OAuth del administrador (Parte 1) no esté completa. Un administrador del espacio de trabajo debe volver a Configuración de la organización → Conectores → Databricks y completar el Administrar la app de OAuth step.
El usuario no puede acceder a ciertas tablas después de conectarse
El conector de Databricks respeta los permisos existentes de Unity Catalog de cada usuario. Si un usuario no puede consultar una tabla a la que espera tener acceso, verifique que el GRANT se haya aplicado en Unity Catalog:
— Grant access to a catalog
GRANT USE CATALOG ON CATALOG my_catalog TOuser@example.com;
— Grant access to a schema
GRANT USE SCHEMA ON SCHEMA my_catalog.my_schema TOuser@example.com;
— Grant read access to tables
GRANT SELECT ON TABLE my_catalog.my_schema.my_table TOuser@example.com;
La autenticación falla con un error de intercambio de tokens
Si un usuario completa las pantallas de inicio de sesión y consentimiento de Databricks, pero la conexión falla después con un error token_exchange_failed, el intercambio del código OAuth entre Merge y su espacio de trabajo no se completó correctamente. Revise lo siguiente con el administrador de su espacio de trabajo de Databricks y su equipo de red:
Confirme que las direcciones de salida de Merge indicadas en Requisitos previos de red están permitidas en cualquier lista de acceso por IP, política de entrada o firewall que proteja el espacio de trabajo. Los administradores de Databricks pueden buscar solicitudes denegadas a
/oidc/v1/tokenen la tabla del sistemasystem.access.inbound_network.Verifique que la aplicación OAuth registrada en la Parte 1 sigue habilitada y que sus URI de redirección coinciden con los valores que se muestran en Configuración de la organización → Conectores → Databricks.
Pida al usuario que vuelva a intentar la conexión después de cualquier cambio en la red o en la aplicación OAuth.
Si el error persiste, póngase en contacto con el soporte de Perplexity e indique la hora aproximada del intento fallido y la URL del espacio de trabajo para que podamos investigar el intercambio con nuestro socio de integración.
El mapa de datos está desactualizado o es inexacto
Si Perplexity está generando respuestas incorrectas o desactualizadas sobre sus datos de Databricks, intente hacer clic en Regenerar mapa de datos en la configuración del conector. También puede agregar o actualizar contexto complementario para darle al agente una mejor orientación sobre la estructura de sus datos.
Problemas de conexión y autenticación
Verifique que la aplicación OAuth esté correctamente configurada en su espacio de trabajo de Databricks
Confirme que los URI de redirección de Perplexity estén incluidos en la lista de permitidos en la configuración de la aplicación OAuth de Databricks
Si su espacio de trabajo usa listas de acceso por IP, una política de entrada o un firewall, asegúrese de que las direcciones de Merge y Perplexity indicadas en Requisitos previos de red estén permitidas
Pida a los usuarios que vuelvan a conectar el conector de Databricks después de cualquier cambio en las políticas del espacio de trabajo
Si los problemas persisten después de actualizar esta configuración, póngase en contacto con el soporte de Perplexity para recibir ayuda.