О коннекторе Databricks
Databricks Connector позволяет выполнять запросы к данным, хранящимся в вашем Databricks Lakehouse, напрямую из Perplexity. Он интегрирует Databricks с функциями продуктивности Perplexity, позволяя мгновенно искать и объединять релевантную информацию по вашим каталогам, схемам и таблицам Databricks — без ручных запросов и переключения контекста.
Connector для Databricks доступен для Perplexity Pro, Perplexity Max, Enterprise Pro, и Enterprise Max пользователи.
Что делает коннектор Databricks?
После включения 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.
Как Perplexity может взаимодействовать с Databricks
Databricks Connector выполняет SQL через интерфейс инструмента (полученный из Объединить коннектор Databricks) , который включает общий execute_sql_statement инструмент. Потому что execute_sql_statement принимает произвольный SQL — включая DDL и DML — Единственный надежный способ обеспечить режим только для чтения или иным образом ограничить действия Perplexity — это уровень Unity Catalog, а не в интерфейсе Perplexity.
Рекомендуемый подход: обеспечьте доступ только для чтения с помощью прав Unity Catalog.
Поскольку коннектор выполняет аутентификацию для каждого пользователя через 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
Для организаций Enterprise Perplexity предлагает сертификацию SOC 2 Type II, сквозное шифрование, строгие меры защиты конфиденциальности данных и детализированные элементы управления доступом пользователей. Ваши данные Databricks никогда не используются для обучения ИИ.
Подключение Perplexity к Databricks выполняется на личном уровне — никто другой в вашей организации не сможет выполнять запросы к вашим данным Databricks. Однако если вы синхронизируете данные в общий Проект, любой, у кого есть доступ к этому Проекту, сможет искать в нем.
Администраторы организации могут включать или отключать Databricks Connector для всех пользователей из Разрешения экран в Настройки организации. Принудительное применение прав на чтение/запись выполняется на уровне Unity Catalog (см. Как Perplexity может взаимодействовать с Databricks выше).
Как это активировать
Настройка Databricks Connector — это двухэтапный процесс: администратор один раз настраивает приложение OAuth для организации, а затем каждый пользователь проходит аутентификацию с помощью своей учетной записи Databricks.
Часть 1: Настройка для администратора — настройте 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.
Часть 2: настройка пользователя — аутентификация и подключение
Каждый пользователь выполняет следующие шаги самостоятельно:
-
Перейдите в Коннекторы в Settings и найдите Подключение Databricks.
-
Нажмите Включить → Добавить коннектор.
-
Нажмите Аутентификация с Databricks. Вы будете перенаправлены в Databricks, чтобы войти с вашими собственными учетными данными.
-
Авторизуйте Perplexity для доступа к данным Databricks.
-
Нажмите Разрешить чтобы завершить настройку.
Часть 3: создайте карту данных (необязательно, но рекомендуется)
После аутентификации Perplexity может сгенерировать карта данных вашей среды Databricks. Это помогает Computer лучше понимать структуру вашего каталога и точнее отвечать на вопросы о данных.
-
Нажмите Пересоздать карту данных в любой момент построить или обновить карту.
-
Для лучшего результата также добавьте Дополнительный контекст — загрузите файлы или добавьте заметки с описанием ваших данных (например, какие ключевые таблицы они представляют, бизнес-определения, типовые шаблоны запросов). Этот дополнительный контекст помогает агенту корректно интерпретировать ваши данные.
-
Нажмите Просмотреть знания чтобы просмотреть, что Perplexity узнал о вашей среде Databricks.
Пропуск data map приведет к снижению точности при сложных вопросах о данных. Рекомендуем создать его на этапе первоначальной настройки. Подробнее см. в Понимание Data Map.
Использование подключенных данных
После подключения вы можете ссылаться на свои данные Databricks в Computer сессии. Упомяните каталоги, схемы или таблицы, и Perplexity выполнит запрос к ним в рамках многоэтапных рабочих процессов — все асинхронно в защищенной облачной песочнице.
Пробное использование
После подключения попробуйте выполнять такие запросы:
-
"Суммируйте динамику выручки по таблице продаж за 4-й квартал и выделите ключевые показатели."
-
"Найдите все записи клиентов, обновленные за последние 30 дней"
-
"Какие продукты показывают наилучшие результаты на основе схемы аналитики?"
-
"Сравните данные pipeline за этот квартал с показателями за предыдущий квартал"
Устранение неполадок
Databricks не включен для вашей организации
Администратор организации мог отключить коннектор, либо OAuth-приложение еще не настроено. Свяжитесь с администратором вашей организации для подтверждения или обратитесь в поддержку Perplexity.
OAuth-приложение не настроено
Если при попытке аутентификации пользователи видят ошибку, возможно, настройка 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 за помощью.