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

Как создать, сохранить и отредактировать навык с картой данных для Snowflake или Databricks вашей организации и устранить неполадки.

Карта данных — это описание вашей среды Snowflake или Databricks, которое администратор создаёт для организации. Оно позволяет Perplexity Computer преобразовывать вопросы на естественном языке в точные запросы.

​

Кто может создать карту данных

• Карта данных доступна организациям на тарифах Enterprise Pro и Enterprise Max. Подключение Snowflake или Databricks доступно более широкому кругу пользователей, но создание карты данных — функция уровня организации.

• Администратор организации запускает создание карты при настройке коннектора.

• Любой пользователь, которому предоставлен доступ к карте данных, может использовать её в своих задачах Computer.

Функция создания карты данных постепенно становится доступна корпоративным организациям. Если вы не видите этот параметр в настройках коннектора, для вашей организации он ещё не включён.

​

Что содержит карта данных

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

Что фиксирует карта данных	Что входит в описание
Таблицы и связи	Содержимое ключевых таблиц, связи между ними и столбцы, которые нужно использовать для их соединения
Бизнес-определения	Принятые в организации определения показателей и понятий, включая соответствующие вычисления и фильтры
Рекомендации по запросам	Распространённые шаблоны запросов, рекомендуемые таблицы и оговорки, позволяющие избежать неверных результатов

Таблица 1 — Три вида знаний, которые содержит карта данных.

Карта данных сохраняется как навык: набор знаний для повторного использования, к которому Computer обращается при ответах на соответствующие вопросы. Навык уровня организации делает эти знания доступными всем в вашей организации Perplexity. Личный навык доступен только вам.

​

Обработка и безопасность данных

Карта данных содержит описания ваших данных — имена таблиц, бизнес-определения и шаблоны запросов, — а не сами строки данных.

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

• Место хранения — Amazon S3 в регионе us-east-1. Область действия навыка организации ограничена вашей организацией, а личного навыка — вашей учётной записью. Файл, который вы забираете отдельно, находится вне Perplexity, поэтому к нему применяются ваши собственные правила хранения.

• Срок хранения — Карта данных хранится, пока кто-либо не удалит навык или не заменит его путём повторного создания. Удаление навыка безвозвратно удаляет его и связанные файлы. Отключение или удаление коннектора Snowflake либо Databricks не удаляет уже созданную карту данных.

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

• Субобработчики — При создании карты данные хранилища считываются через коннектор, поэтому обработка идёт по пути коннектора и включает указанного для него субобработчика: Merge Agent Handler под управлением Merge API, Inc. Актуальный список опубликован в Центре доверия Perplexity.

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

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

• Управление администратором — На корпоративных тарифах администратор организации может включать и отключать каждый коннектор для всех участников на экране Разрешения в разделе Настройки организации.

Карта данных может содержать описания таблиц и бизнес-определения. Проверьте её содержимое, прежде чем предоставлять доступ всей организации.

​

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

Содержимое карты данных зависит от учётной записи, от имени которой запускается создание, поэтому сначала проверьте её права доступа.

Хранилище	Что требуется учётной записи, создающей карту
Snowflake	Доступ на чтение к базам данных, схемам, таблицам и представлениям, которые вы хотите описать. Доступ к SNOWFLAKE.ACCOUNT_USAGE.QUERY_HISTORY и ACCESS_HISTORY позволяет добавить сведения о характере использования
Databricks	Unity Catalog, работающее SQL-хранилище и возможность просматривать каталоги, схемы и таблицы, которые вы хотите описать

Таблица 2 — Требования к доступу для каждого хранилища перед началом создания карты.

По умолчанию доступ к SNOWFLAKE.ACCOUNT_USAGE разрешён только администраторам, поэтому роль, которая может читать ваши обычные базы данных, часто не может читать эту схему. Чтобы включить сведения о характере использования, попросите администратора Snowflake предоставить роли, используемой для подключения, привилегию IMPORTED PRIVILEGES для базы данных SNOWFLAKE.

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

Для ACCESS_HISTORY требуется Snowflake Enterprise Edition или выше. Если это представление недоступно, Computer создаёт карту на основе QUERY_HISTORY. Если недоступны оба представления, он описывает только каталог, поэтому рекомендации о том, какие таблицы и столбцы использует ваша команда, будут менее точными.

​

Как создать карту данных

1. В Perplexity перейдите в Настройки организации → Коннекторы и откройте коннектор Snowflake или Databricks.

2. Выберите Создать карту данных.

3. Во время работы отвечайте на вопросы Computer об области охвата и доступе. Создание выполняется в обычном треде Computer, поэтому вы можете следить за ходом работы и прикреплять файлы с описанием данных.

4. Проверьте карту и укажите Computer, куда её сохранить.

Computer использует учётную запись хранилища, подключённую для данного запуска. При подключении через OAuth это личная учётная запись Snowflake или Databricks администратора, запустившего создание карты. При подключении Snowflake через служебную учётную запись используется настроенная служебная учётная запись.

Когда создание завершится, Computer спросит, куда сохранить карту:

Куда сохранить	Что это означает
Навыки организации	Доступ предоставляется вашей организации. Участники могут использовать карту в своих задачах Computer
Мои навыки	Карта сохраняется в ваших личных навыках для индивидуального использования или проверки перед предоставлением общего доступа
Только ZIP-файл	Карта предоставляется в виде файла без добавления в навыки

Таблица 3 — Три варианта сохранения готовой карты данных.

Для сохранения в Навыки организации требуется разрешение на управление навыками организации. Для сохранения в Мои навыки или получения файла такое разрешение не требуется.

​

Как проверить результат

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

​

Редактирование карты данных

Администратор может напрямую редактировать сохранённый навык с картой данных или попросить Computer обновить его. Вносите точечные изменения, чтобы исправить определение, изменить рекомендуемую таблицу, добавить обязательный фильтр или описать известную проблему.

Когда просите Computer внести изменение, укажите имя сохранённого навыка и опишите, что нужно изменить:

• Обнови наш навык с картой данных: для запросов о выручке используй новую таблицу заказов. Проверь её столбцы и соединения, прежде чем заменять прежние рекомендации.

• Добавь это определение активного клиента в наш навык с картой данных и сохрани существующие определения других показателей.

Укажите, что нужно изменить и что необходимо сохранить. Если в инструкции упомянуты только новые рекомендации, они могут заменить определения, которые вы хотели оставить.

​

Повторное создание карты данных

Если хранилище существенно изменилось, создайте карту заново, чтобы Computer перестроил её на основе подключённого хранилища и актуального бизнес-контекста. Computer запросит подтверждение, прежде чем перезаписать уже сохранённую карту.

При повторном создании карта строится с нуля, а навык заменяется целиком, без объединения с существующим содержимым. Поэтому внесённые вручную изменения будут потеряны. Чтобы изменить одно определение или таблицу, отредактируйте карту данных. Чтобы сохранить имеющуюся карту, попросите Computer сохранить новую под другим именем навыка.

​

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

Симптом	Наиболее вероятная причина	Как исправить
Участники вашей организации не могут использовать карту данных	Она сохранена в Мои навыки, а не в Навыки организации	Сохраните её ещё раз в Навыки организации
В карте отсутствуют ожидаемые таблицы или схемы	Учётная запись, использованная для создания, не может их просматривать	Предоставьте этой учётной записи доступ и создайте карту заново
В карте нет сведений о характере использования или рекомендуемых запросов	Роль, используемая для подключения, не может читать SNOWFLAKE.ACCOUNT_USAGE	Предоставьте IMPORTED PRIVILEGES для базы данных SNOWFLAKE и создайте карту заново
ACCESS_HISTORY возвращает ошибку	Ваша учётная запись Snowflake использует Standard Edition	Если вам нужны сведения об использовании на уровне столбцов, убедитесь, что учётная запись использует Enterprise Edition или выше
Ответы ссылаются на таблицу, которую вы заменили	Карта данных создана до изменения схемы	Отредактируйте запись об этой таблице или создайте карту заново
При редактировании удалены определения, которые вы хотели сохранить	В инструкции указаны новые рекомендации, но не то, что нужно сохранить	Повторите запрос на изменение, явно указав определения, которые необходимо сохранить

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

​

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

​

Будет ли карта данных доступна всем в моей организации?

Только если она сохранена в Навыки организации. Карта, сохранённая в Мои навыки, доступна лишь вам.

​

Даёт ли общий доступ к карте данных доступ к данным моего хранилища?

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

​

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

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

​

Нужно ли создавать карту заново после каждого изменения схемы?

Нет. Для отдельного определения или таблицы отредактируйте соответствующую запись. Создавайте карту заново только при существенных изменениях хранилища. Повторное создание заменяет всю карту.

​

Можно ли оставить карту данных доступной только мне перед предоставлением общего доступа?

Да. Сохраните её в Мои навыки, проверьте содержимое и, когда будете готовы, сохраните в Навыки организации.

​

Связанные статьи

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

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

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

• Хранение данных и конфиденциальность для корпоративных организаций и пользователей

• Корпоративные роли и разрешения

​

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

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

Обратитесь к вашей команде по работе с аккаунтом или свяжитесь с нами через Справка > Связаться со службой поддержки. Документация по безопасности и соответствию требованиям доступна в Центре доверия.