Подключение Perplexity к Snowflake

Подключите хранилище данных Snowflake к Perplexity с помощью User OAuth или сервисного аккаунта на планах Pro, Max, Enterprise Pro и Enterprise Max.

Это руководство описывает для администраторов Snowflake и Perplexity, как подключить хранилище данных Snowflake к Perplexity, и показывает подписчикам планов Pro, Max, Enterprise Pro и Enterprise Max, как выполнить вход.

​

Обзор

Коннектор Snowflake позволяет запрашивать данные в вашем хранилище данных Snowflake прямо из Perplexity. Вы можете искать и объединять информацию по своим базам данных Snowflake, другим подключённым приложениям и веб-источникам, не написав SQL вручную и не переключаясь в консоль Snowflake.

Snowflake подключается индивидуально каждым пользователем. Никто другой в вашей организации не сможет запрашивать ваши данные, если вы не синхронизируете их в общий проект.

Коннектор Snowflake доступен на планах Pro, Max, Enterprise Pro и Enterprise Max. Для генерации карты данных требуется Enterprise Pro или Enterprise Max. На всех планах администратор Snowflake с ролью ACCOUNTADMIN создаёт security integration или сервисный аккаунт; на планах Enterprise администратор Perplexity один раз настраивает коннектор User OAuth для организации.

​

Конфиденциальность и безопасность данных

Коннектор обращается к вашему аккаунту Snowflake под ролью Snowflake, которой управляете вы, поэтому привилегии Snowflake — это граница того, к чему может получить доступ Perplexity. Выдавайте этой роли только доступ на чтение.

• Область доступа — каждый человек подключает собственный аккаунт. Никто другой в вашей организации не сможет запрашивать ваши данные, если вы не синхронизируете их в общий проект.

• Где хранятся данные — Perplexity не хранит ваши данные Snowflake. Запросы выполняются к вашему собственному аккаунту Snowflake, и коннектор не добавляет никакого собственного хранения сверх операционных данных, которые Perplexity собирает для работы продукта.

• Срок хранения — коннектор не использует кэш, поэтому отдельной копии ваших данных Snowflake, которую нужно было бы хранить или удалять, не существует.

• Контроль администратора — на планах Enterprise администратор вашей организации может отключить коннектор Snowflake для организации, и тогда он не появится в ваших настройках коннекторов.

• Обеспечение доступа только для чтения — обеспечивайте доступ только для чтения через привилегии Snowflake. Не выдавайте роли, которую использует Perplexity, никаких привилегий на запись или создание объектов.

• Использование для обучения — данные, к которым получен доступ через коннектор Snowflake, никогда не используются для обучения моделей Perplexity или каких-либо сторонних моделей.

• Субпроцессоры — трафик аутентификации и API этого коннектора проходит через Merge Agent Handler, который эксплуатирует Merge API, Inc. — субпроцессор Perplexity. Актуальный список опубликован в Trust Center Perplexity.

• Шифрование — учётные данные коннектора и подключённые данные шифруются при передаче по TLS и при хранении по AES-256.

• Соответствие требованиям — механизмы контроля Perplexity проходят аудит по стандарту SOC 2 Type II. Документация по безопасности и соответствию требованиям доступна в Trust Center Perplexity.

​

Как это включить

​

Выбор способа аутентификации

Perplexity предлагает два коннектора Snowflake. Настраивайте только тот, который соответствует способу аутентификации ваших пользователей.

Коннектор	Запросы выполняются от имени	Учётные данные	Журнал аудита	Когда использовать
Snowflake (User OAuth)	Собственный аккаунт Snowflake каждого пользователя	OAuth	Атрибутируется по пользователям в журналах аудита Snowflake	Рекомендуется для большинства организаций
Snowflake (Service Account)	Один общий сервисный аккаунт	Пара ключей	Общая идентичность	Пользователи выполняют запросы через единый аккаунт

Таблица 1 — Два коннектора Snowflake и когда использовать каждый из них.

Perplexity настоятельно рекомендует коннектор User OAuth. Запросы выполняются с собственными разрешениями Snowflake каждого человека и атрибутируются ему в журналах аудита Snowflake.

​

Перед началом работы

• Вы находитесь на плане Pro, Max, Enterprise Pro или Enterprise Max.

• На планах Enterprise администратор вашей организации не отключил коннектор Snowflake.

• У вашего администратора Snowflake есть доступ ACCOUNTADMIN или эквивалентные привилегии.

• OpenSSL установлен локально — только для настройки сервисного аккаунта.

​

Настройка коннектора User OAuth

1. Попросите администратора Snowflake создать security integration. Дополнительные параметры см. в документации Snowflake по security integration для OAuth.

   USE ROLE ACCOUNTADMIN;
   CREATE SECURITY INTEGRATION PERPLEXITY_OAUTH
     TYPE = OAUTH
     ENABLED = TRUE
     OAUTH_CLIENT = CUSTOM
     OAUTH_CLIENT_TYPE = 'CONFIDENTIAL'
     OAUTH_REDIRECT_URI = 'https://ah.merge.dev/oauth/callback'
     OAUTH_ISSUE_REFRESH_TOKENS = TRUE
     OAUTH_REFRESH_TOKEN_VALIDITY = 7776000
     OAUTH_USE_SECONDARY_ROLES = IMPLICIT
     COMMENT = 'OAuth security integration for Perplexity';
   

2. Получите client ID и client secret.

   SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('PERPLEXITY_OAUTH');
   

3. Введите эти учётные данные в окне настройки OAuth в Perplexity.

Используйте OAUTH_USE_SECONDARY_ROLES = IMPLICIT, чтобы пользователи получали доступ к своим вторичным ролям в дополнение к ролям по умолчанию. Используйте NONE, если пользователи должны быть ограничены только своей DEFAULT_ROLE в Snowflake.

​

Настройка коннектора с сервисным аккаунтом

Сервисный аккаунт — это выделенный пользователь Snowflake, работающий под одной конкретной ролью. У всех, кто использует общий аккаунт, одинаковый доступ, поэтому выдавайте этой роли доступ только к тем данным, которые нужны Perplexity.

1. Сгенерируйте закрытый ключ и соответствующий ему открытый ключ в локальном терминале.

   openssl genrsa 2048 | openssl pkcs8 -topk8 -inform PEM -out snowflake_computer_key.p8 -nocrypt
   openssl rsa -in snowflake_computer_key.p8 -pubout -out snowflake_computer_key.pub
   

2. Создайте выделенную роль и warehouse, выбрав размер warehouse под ваш объём запросов. Вместо создания нового вы также можете использовать существующий warehouse.

   USE ROLE ACCOUNTADMIN;
   CREATE ROLE IF NOT EXISTS PERPLEXITY_ROLE
     COMMENT = 'Role for Perplexity service account';
   CREATE WAREHOUSE IF NOT EXISTS PERPLEXITY_WAREHOUSE
     WAREHOUSE_SIZE = 'SMALL'
     AUTO_SUSPEND = 60
     AUTO_RESUME = TRUE
     COMMENT = 'Warehouse for Perplexity queries';
   GRANT USAGE ON WAREHOUSE PERPLEXITY_WAREHOUSE
     TO ROLE PERPLEXITY_ROLE;
   

3. Создайте пользователя сервисного аккаунта. Замените значение RSA_PUBLIC_KEY содержимым файла snowflake_computer_key.pub, исключив строки BEGIN PUBLIC KEY и END PUBLIC KEY.

   CREATE USER PERPLEXITY_USER
     TYPE = SERVICE
     DEFAULT_ROLE = PERPLEXITY_ROLE
     DEFAULT_WAREHOUSE = PERPLEXITY_WAREHOUSE
     COMMENT = 'Service account for Perplexity'
     RSA_PUBLIC_KEY = 'MIIBIjANBgkqhki...your_public_key_here...IDAQAB';
   GRANT ROLE PERPLEXITY_ROLE TO USER PERPLEXITY_USER;
   

4. Выдайте доступ к данным, которые Perplexity должен запрашивать. Замените MY_DATABASE на вашу базу данных. Эти гранты дают доступ на чтение к её существующим и будущим схемам, таблицам и представлениям. Для более узкого доступа выдавайте разрешения на конкретные схемы или объекты. См. документацию Snowflake по GRANT.

   GRANT USAGE ON DATABASE MY_DATABASE TO ROLE PERPLEXITY_ROLE;
   GRANT USAGE ON ALL SCHEMAS IN DATABASE MY_DATABASE
     TO ROLE PERPLEXITY_ROLE;
   GRANT USAGE ON FUTURE SCHEMAS IN DATABASE MY_DATABASE
     TO ROLE PERPLEXITY_ROLE;
   GRANT SELECT ON ALL TABLES IN DATABASE MY_DATABASE
     TO ROLE PERPLEXITY_ROLE;
   GRANT SELECT ON FUTURE TABLES IN DATABASE MY_DATABASE
     TO ROLE PERPLEXITY_ROLE;
   GRANT SELECT ON ALL VIEWS IN DATABASE MY_DATABASE
     TO ROLE PERPLEXITY_ROLE;
   GRANT SELECT ON FUTURE VIEWS IN DATABASE MY_DATABASE
     TO ROLE PERPLEXITY_ROLE;
   

5. Если вы решите сгенерировать карту данных в процессе настройки коннектора, выдайте доступ к двум представлениям account usage, которые она читает. Для генерации карты данных требуется Enterprise Pro или Enterprise Max. Этот грант даёт более широкий доступ к метаданным аккаунта Snowflake, а не только к этим двум представлениям, поэтому проверьте его перед выполнением.

   Представление	Доступность
   SNOWFLAKE.ACCOUNT_USAGE.QUERY_HISTORY	Все выпуски
   SNOWFLAKE.ACCOUNT_USAGE.ACCESS_HISTORY	Snowflake Enterprise Edition или выше. На Standard Edition Perplexity использует QUERY_HISTORY

   Таблица 2 — Представления account usage, которые читает карта данных.

   USE ROLE ACCOUNTADMIN;
   GRANT IMPORTED PRIVILEGES ON DATABASE SNOWFLAKE
     TO ROLE PERPLEXITY_ROLE;
   

6. Откройте Плагины на боковой панели (или Customize → Connectors, если вы пока не видите Plugins), найдите Snowflake (Service Account) на вкладке Обзор или через поиск и откройте его страницу.

7. Выберите Подключить.

8. Введите идентификатор вашего аккаунта Snowflake, имя пользователя PERPLEXITY_USER и закрытый ключ snowflake_computer_key.p8.

9. Нажмите Allow, чтобы завершить настройку.

Храните snowflake_computer_key.p8 в секрете. Вы вводите его в Perplexity при подключении, и любой другой человек, у кого он есть, сможет выполнять запросы к вашему warehouse от имени PERPLEXITY_USER. Обеспечивайте доступ только для чтения через разрешения Snowflake: не выдавайте PERPLEXITY_ROLE привилегий на запись или создание объектов.

​

Подключение вашего аккаунта Snowflake

После завершения настройки администратором каждый пользователь подключает собственный аккаунт.

1. Откройте Плагины на боковой панели (или Customize → Connectors, если вы пока не видите Plugins), найдите Snowflake (User OAuth) на вкладке Обзор или через поиск и откройте его страницу.

2. Выберите Подключить.

3. Войдите в Snowflake, когда появится запрос.

4. Нажмите Allow, чтобы завершить подключение.

Этот коннектор также может входить в плагин. При подключении в одном месте он подключается для вашего аккаунта везде. Подключение и настройки коннекторов вашей организации действуют внутри каждого плагина. Что такое плагины?

​

Как проверить, что всё работает

Откройте новый Сеанс, упомяните @Snowflake и запросите что-нибудь небольшое из таблицы, которую вы уже можете читать в Snowflake, например количество строк. Если ответ приходит без ваших данных Snowflake, в первую очередь проверьте роль Snowflake: ей нужен SELECT на указанный вами объект.

​

Попробуйте на практике

После подключения Snowflake упомяните его в новом Сеансе:

• @Snowflake Сколько строк в таблице orders?

• @Snowflake Какие столбцы есть в таблице customers?

• @Snowflake Перечисли схемы, которые я могу запрашивать в MY_DATABASE

​

Разрешения и области доступа

Коннектору нужны только привилегии на чтение. Выдавайте их выделенной роли, а не существующей роли аналитика.

Привилегия	Выдаётся на	Зачем она нужна коннектору
USAGE	Warehouse	Выполнять запросы, отвечающие на вопрос
USAGE	База данных и схемы	Обращаться к объектам, которые ему разрешено запрашивать
SELECT	Таблицы и представления	Читать строки. Привилегии на запись не запрашиваются
IMPORTED PRIVILEGES	База данных SNOWFLAKE	Читать два представления account usage, необходимых карте данных. Опционально
Refresh token	Security integration	Сохранять подключение пользователя без повторной аутентификации в течение заданного вами срока действия

Таблица 3 — Привилегии Snowflake, которые запрашивает коннектор, и зачем.

Привилегии Snowflake — это граница обеспечения доступа. Какая бы задача ни была поставлена коннектору, он работает под выданной вами ролью, поэтому роль без привилегий на запись не сможет писать.

​

Устранение неполадок

Что вы наблюдаете	Наиболее вероятная причина	Как исправить
Snowflake не включён для вашей организации или не отображается в списке коннекторов	На планах Enterprise его отключил администратор организации. В остальных случаях ваш план может его не включать	На планах Enterprise обратитесь к администратору организации. В остальных случаях проверьте ваш план в Settings
Вход или запросы не выполняются, а ваш аккаунт Snowflake ограничивает входящие подключения по IP	Адреса тенанта Merge не добавлены в список разрешённых в вашей сетевой политике Snowflake	Попросите администратора Snowflake добавить в список разрешённых адреса тенанта в США со страницы IP-адресов тенантов Merge
Пользователю доступно меньше данных, чем ему выдано в Snowflake	Сеанс OAuth активировал только его DEFAULT_ROLE	Убедитесь, что в security integration задано OAUTH_USE_SECONDARY_ROLES = IMPLICIT
ACCESS_HISTORY недоступен при генерации карты данных	Ваш аккаунт Snowflake на Standard Edition	Для ACCESS_HISTORY нужен Enterprise Edition или выше. На Standard Edition Perplexity использует QUERY_HISTORY

Таблица 4 — Симптом, причина и решение для самых частых проблем с коннектором Snowflake.

Для сервисного аккаунта в этом примере создаётся сетевая политика на уровне пользователя с использованием текущих опубликованных адресов в США. Перед применением политики сверьтесь с актуальным списком на странице IP-адресов тенантов Merge.

USE ROLE ACCOUNTADMIN;
CREATE NETWORK POLICY PERPLEXITY_COMPUTER_POLICY
  ALLOWED_IP_LIST = ('3.216.101.38', '52.20.242.81');
ALTER USER PERPLEXITY_USER
  SET NETWORK_POLICY = PERPLEXITY_COMPUTER_POLICY;

​

Часто задаваемые вопросы

​

К каким данным получает доступ этот коннектор?

К базам данных, схемам, таблицам и представлениям, которые разрешено читать выданной вами роли Snowflake. Он не может обратиться к тому, к чему не может обратиться эта роль.

​

Будут ли мои данные Snowflake использоваться для обучения моделей ИИ?

Нет. Данные, к которым получен доступ через коннектор Snowflake, никогда не используются для обучения моделей Perplexity или каких-либо сторонних моделей.

​

Может ли администратор ограничить, кто включает этот коннектор?

Да, на планах Enterprise. Администратор организации может отключить коннектор Snowflake для всей организации, и тогда он не появится в ваших настройках коннекторов.

​

Может ли Perplexity выполнять запись в мои данные Snowflake?

Нет, при условии что вы обеспечиваете это в Snowflake. Выдайте роли, которую использует Perplexity, только USAGE и SELECT — и Snowflake будет отклонять любую запись независимо от того, какая задача поставлена Perplexity.

​

Доступен ли этот коннектор на моём плане?

Да, на планах Pro, Max, Enterprise Pro и Enterprise Max. Для генерации карты данных требуется Enterprise Pro или Enterprise Max.

​

Похожие статьи

• Понимание карты данных

• Подключение Perplexity к Databricks

• Руководство по устранению неполадок коннекторов Perplexity Enterprise

• Хранение данных и конфиденциальность для Enterprise

• Роли и разрешения Enterprise

​

Нужна дополнительная помощь?

Когда пишете нам, укажите название коннектора, точный текст ошибки, время возникновения и шаги из этой статьи, которые не помогли.

Обратитесь в вашу команду по работе с аккаунтом или свяжитесь с нами через пункт Help > «Связаться со службой поддержки». Посетите Trust Center, чтобы ознакомиться с документацией по безопасности и соответствию требованиям.