Databricks Connector позволяет выполнять запросы к данным, хранящимся в вашем Databricks Lakehouse, напрямую из Perplexity. Он интегрирует Databricks с функциями продуктивности Perplexity, позволяя мгновенно искать и объединять релевантную информацию по вашим каталогам, схемам и таблицам Databricks — без ручных запросов и переключения контекста.
Connector для Databricks доступен для Perplexity Pro, Perplexity Max, Enterprise Pro, и Enterprise Max пользователей.
После включения Databricks Connector позволяет выполнять поиск по вашим авторизованным каталогам, схемам и таблицам Databricks, чтобы предоставлять ответы на основе этих данных. Коннектор выполняет аутентификацию с использованием вашей индивидуальной учетной записи Databricks через OAuth, то есть запросы выполняются с вашими нативными правами Databricks — общий служебный аккаунт не требуется.
С помощью этого коннектора можно быстро находить информацию по таблицам Unity Catalog, данным Delta Lake и представлениям без ручного написания SQL или переключения в консоль Databricks. Когда данные Databricks обновляются, коннектор автоматически отражает эти изменения в последующих запросах.
Коннектор Databricks поддерживает:
Таблицы и представления Unity Catalog
таблицы Delta Lake
Схемы и каталоги
Внешние таблицы, зарегистрированные в Unity Catalog
Структурированные данные (CSV, JSON, таблицы на основе Parquet)
На данный момент неструктурированные данные (изображения, аудио, видео и файлы, хранящиеся в Databricks Volumes) не поддерживаются.
Коннектор Databricks использует OAuth (отдельный пользователь) аутентификация. Каждый пользователь Perplexity подключается со своими собственными учетными данными Databricks, а запросы выполняются в рамках собственных разрешений Unity Catalog этого пользователя — без общих служебных учетных записей, PAT или служебных принципалов.
Это означает:
Доступ к данным регулируется существующими разрешениями каждого пользователя в Databricks
Каждый запрос сопровождается понятным журналом аудита по каждому пользователю в Databricks
Администратор организации настраивает OAuth-приложение один раз; затем отдельные пользователи проходят аутентификацию под своими учетными записями
Примечание: Поскольку токены OAuth привязаны к учетной записи Databricks каждого пользователя, пользователи смогут запрашивать только те каталоги, схемы и таблицы, к которым у них уже есть доступ в Databricks. Перед подключением убедитесь, что заданы соответствующие разрешения Unity Catalog.
Databricks Connector выполняет SQL через интерфейс инструмента (полученный из коннектора Merge Databricks), который включает общий execute\_sql\_statement инструмент. Потому что execute\_sql\_statement принимает произвольный SQL — включая DDL и DML — Единственный надежный способ обеспечить режим только для чтения или иным образом ограничить действия Perplexity — это уровень Unity Catalog, а не в интерфейсе Perplexity.
Поскольку коннектор выполняет аутентификацию для каждого пользователя через OAuth, каждое действие, которое пытается выполнить Perplexity, выполняется под учетной записью Databricks этого пользователя и подчиняется уже имеющимся разрешениям Unity Catalog. Чтобы сохранить режим только для чтения, убедитесь, что у каждого пользователя (или группы, к которой он принадлежит) есть только:
ИСПОЛЬЗОВАТЬ КАТАЛОГ в каталогах, которые они должны запрашивать
ИСПОЛЬЗОВАТЬ СХЕМУ по схемам, которые вы хотите, чтобы они запрашивали
SELECT в таблицах и представлениях, которые вы хотите, чтобы они запрашивали
И явно не удерживает MODIFY, CREATE, или OWN по этим объектам, а также МОЖЕТ УПРАВЛЯТЬ в SQL warehouse. Если Unity Catalog настроен таким образом, Databricks будет отклонять любые попытки Perplexity записи в объекты, где у пользователя нет прав на запись, независимо от используемого инструмента.
Примечание: Perplexity отображает Разрешения для инструментов панель в настройках коннектора Databricks, где перечислены доступные инструменты. Сегодня эта панель не обеспечивает надежное применение правил чтения, записи и изменения — управление доступом на уровне Unity Catalog (выше) — это правильный способ контролировать, что может делать Perplexity.
При подключении к Perplexity коннектор Databricks может выполнять от вашего имени следующие действия:
Выполняйте SQL-запросы к данным Databricks через SQL Warehouses
Запрашивайте таблицы, представления и схемы Unity Catalog
Чтение метаданных и данных таблиц Delta Lake
Если вы отзовете доступ или удалите разрешения в Databricks, эти данные сразу станут недоступны из Perplexity. Если вы отключите учетную запись Databricks в Perplexity, вы сможете выбрать, сохранить ли кэшированные данные или удалить их.
Для организаций Enterprise Perplexity предлагает сертификацию SOC 2 Type II, сквозное шифрование, строгие меры защиты конфиденциальности данных и детализированные элементы управления доступом пользователей. Ваши данные Databricks никогда не используются для обучения ИИ.
Подключение Perplexity к Databricks выполняется на личном уровне — никто другой в вашей организации не сможет выполнять запросы к вашим данным Databricks. Однако если вы синхронизируете данные в общий Проект, любой, у кого есть доступ к этому Проекту, сможет искать в нем.
Администраторы организации могут включать или отключать Databricks Connector для всех пользователей из Разрешения экран в Настройки организации. Принудительное применение прав на чтение/запись выполняется на уровне Unity Catalog (см. Как Perplexity может взаимодействовать с Databricks выше).
Настройка Databricks Connector — это двухэтапный процесс: администратор один раз настраивает приложение OAuth для организации, а затем каждый пользователь проходит аутентификацию с помощью своей учетной записи Databricks.
Администратору рабочей области Databricks нужно выполнить этот шаг один раз. Отдельным пользователям повторять его не требуется.
In Настройки организации → Коннекторы → Databricks, вы увидите панель настройки из трех шагов с названием "Настройка Databricks для вашей организации":
Шаг 1: Управление OAuth-приложением — Нажмите Управлять приложением OAuth чтобы зарегистрировать Perplexity как клиента OAuth в вашем рабочем пространстве Databricks. Это предоставляет Perplexity разрешение на аутентификацию пользователей через OAuth в вашем рабочем пространстве.
Шаг 2: Аутентификация в Databricks — администратор проходит аутентификацию один раз, чтобы проверить, что интеграция работает end-to-end.
Шаг 3: Создайте карту данных (необязательно) — При необходимости создайте карту данных для организации (см. часть 3 ниже и Понимание Data Map) и добавьте Supplementary context, чтобы повысить точность запроса.
Примечание: Чтобы выполнить этот шаг, вам потребуются права администратора рабочей области Databricks. Если вы не уверены, как зарегистрировать OAuth app в Databricks, обратитесь к Документация Databricks OAuth.
Каждый пользователь выполняет следующие шаги самостоятельно:
Перейдите в Коннекторы в Settings и найдите Подключение Databricks.
Нажмите Включить → Добавить коннектор.
Нажмите Аутентификация с Databricks. Вы будете перенаправлены в Databricks, чтобы войти с вашими собственными учетными данными.
Авторизуйте Perplexity для доступа к данным Databricks.
Нажмите Разрешить чтобы завершить настройку.
После аутентификации Perplexity может сгенерировать карту данных вашей среды Databricks. Это помогает Computer лучше понимать структуру вашего каталога и точнее отвечать на вопросы о данных.
Нажмите Пересоздать карту данных в любой момент построить или обновить карту.
Для лучшего результата также добавьте Дополнительный контекст — загрузите файлы или добавьте заметки с описанием ваших данных (например, какие ключевые таблицы они представляют, бизнес-определения, типовые шаблоны запросов). Этот дополнительный контекст помогает агенту корректно интерпретировать ваши данные.
Нажмите Просмотреть знания чтобы просмотреть, что Perplexity узнал о вашей среде Databricks.
Пропуск data map приведет к снижению точности при сложных вопросах о данных. Рекомендуем создать его на этапе первоначальной настройки. Подробнее см. в Понимание Data Map.
После подключения вы можете ссылаться на свои данные Databricks в Computer сессии. Упомяните каталоги, схемы или таблицы, и Perplexity выполнит запрос к ним в рамках многоэтапных рабочих процессов — все асинхронно в защищенной облачной песочнице.
После подключения попробуйте выполнять такие запросы:
"Суммируйте динамику выручки по таблице продаж за 4-й квартал и выделите ключевые показатели."
"Найдите все записи клиентов, обновленные за последние 30 дней"
"Какие продукты показывают наилучшие результаты на основе схемы аналитики?"
"Сравните данные pipeline за этот квартал с показателями за предыдущий квартал"
Администратор организации мог отключить коннектор, либо OAuth-приложение еще не настроено. Свяжитесь с администратором вашей организации для подтверждения или обратитесь в поддержку Perplexity.
Если при попытке аутентификации пользователи видят ошибку, возможно, настройка OAuth-приложения администратора (Часть 1) не завершена. Администратору рабочей области следует вернуться в Organization Settings → Connectors → Databricks и завершить Управлять приложением OAuth шаг.
Connector Databricks учитывает существующие разрешения Unity Catalog каждого пользователя. Если пользователь не может выполнить запрос к таблице, к которой ожидает доступ, проверьте, что соответствующие GRANT применены в Unity Catalog:
-- Предоставить доступ к каталогу
GRANT USE CATALOG ON CATALOG my\_catalog TO `user@example.com`;
-- Предоставить доступ к схеме
GRANT USE SCHEMA ON SCHEMA my\_catalog.my\_schema TO `user@example.com`;
-- Предоставить доступ на чтение к таблицам
GRANT SELECT ON TABLE my\_catalog.my\_schema.my\_table TO `user@example.com`;
Если Perplexity выдает неверные или устаревшие ответы о ваших данных Databricks, попробуйте нажать Пересоздать карту данных в параметрах коннектора. Вы также можете добавить или обновить Дополнительный контекст чтобы дать агенту более точные указания о структуре ваших данных.
Убедитесь, что OAuth-приложение правильно настроено в вашем рабочем пространстве Databricks
Убедитесь, что URI перенаправления Perplexity включены в allowlist в настройках вашего приложения Databricks OAuth
Если в вашем рабочем пространстве используются списки IP-адресов с доступом, убедитесь, что IP-адреса Perplexity добавлены в список разрешенных
Попросите пользователей повторно подключить Databricks Connector после любых изменений политики рабочего пространства
Если после обновления этих настроек проблемы сохраняются, обратитесь в службу поддержки Perplexity за помощью.