Conectar Perplexity con Databricks | Perplexity Help Center

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 Proy 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 herramienta. 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 CATALOG en los catálogos que desea que consulten
USE SCHEMA en los esquemas que desea que consulten
SELECT en las tablas y vistas que desea que consulten

Y explícitamente no tenga 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 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).

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:

Vaya a Conectores en Configuración y localice el Conector de Databricks.
Haga clic en Habilitar → Agregar conector.
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.

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 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`;

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 अनुमति en la configuración de la aplicación OAuth de Databricks
Si su workspace usa listas de acceso por IP, asegúrese de que las IP de Perplexity estén incluidas en la lista de अनुमति
Pida a los usuarios que vuelvan a conectar el conector de Databricks después de cualquier cambio en las políticas del workspace

Si los problemas persisten después de actualizar esta configuración, póngase en contacto con el soporte de Perplexity para recibir ayuda.