Entendendo o Data Map

Gere, salve, edite e solucione problemas de uma skill de mapa de dados para o ambiente Snowflake ou Databricks da sua organização.

O mapa de dados é uma descrição do seu ambiente Snowflake ou Databricks, gerada por um administrador para sua organização, que permite ao Perplexity Computer transformar uma pergunta em linguagem natural em uma consulta precisa.

​

Quem pode gerar um mapa de dados

• O mapa de dados está disponível para organizações nos planos Enterprise Pro e Enterprise Max. A conexão com o Snowflake ou o Databricks está disponível de forma mais ampla, mas gerar um mapa de dados é um recurso no nível da organização.

• Um administrador da organização inicia a geração durante a configuração do conector.

• Qualquer pessoa com quem o mapa de dados for compartilhado pode usá-lo em suas próprias tarefas do Computer.

A geração do mapa de dados está sendo disponibilizada gradualmente para organizações Enterprise. Se a opção não aparecer nas configurações do conector, ela ainda não foi habilitada para sua organização.

​

O que o mapa de dados captura

O Computer explora seu modelo de dados usando as permissões da conta conectada. Ele examina esquemas, tabelas, visualizações e, quando disponíveis, padrões históricos de uso para entender quais dados são importantes e como são usados.

O que o mapa de dados registra	O que contém
Tabelas e relacionamentos	O que as principais tabelas contêm, como se relacionam e quais colunas usar nas junções
Definições de negócio	Como sua organização define métricas e conceitos, incluindo cálculos e filtros relevantes
Orientações para consultas	Padrões comuns de consulta, tabelas recomendadas e ressalvas que ajudam a evitar resultados incorretos

Tabela 1 — Os três tipos de conhecimento que um mapa de dados contém.

O mapa de dados é salvo como uma skill: conhecimento reutilizável que o Computer lê ao responder a perguntas relevantes. Uma skill para toda a organização disponibiliza esse conhecimento a todos na sua organização Perplexity. Uma skill pessoal o disponibiliza apenas para você.

​

Tratamento de dados e segurança

Um mapa de dados contém descrições dos seus dados — nomes de tabelas, definições de negócio e padrões de consulta — e não as linhas de dados em si.

• Acesso — Um mapa de dados compartilhado não concede acesso ao warehouse subjacente. As consultas continuam usando as permissões da conta conectada de cada usuário ou da conta de serviço compartilhada, caso sua organização use uma.

• Onde é armazenado — No Amazon S3, na região us-east-1. Uma skill da organização fica restrita à sua organização; uma skill pessoal, à sua própria conta. Um arquivo que você baixa fica fora da Perplexity, portanto suas próprias regras de retenção se aplicam a ele.

• Retenção — Um mapa de dados é mantido até que alguém exclua a skill ou a substitua por meio de uma nova geração. Excluir a skill remove permanentemente a skill e seus arquivos. Desconectar ou remover o conector do Snowflake ou do Databricks não exclui um mapa de dados já gerado.

• Uso para treinamento — Os dados acessados pelos conectores do Snowflake e do Databricks nunca são usados para treinar os modelos da Perplexity ou qualquer modelo de terceiros, conforme descrito em Conectando o Perplexity ao Snowflake.

• Suboperadores — A geração lê seu warehouse por meio do conector, seguindo o fluxo do conector e seu suboperador divulgado: Merge Agent Handler, operado pela Merge API, Inc. A lista atual é publicada na Central de Confiança da Perplexity.

• Criptografia — Seu mapa de dados é criptografado em repouso com AES-256. As credenciais dos conectores e os dados conectados são criptografados em trânsito com TLS e em repouso com AES-256.

• Conformidade — Os controles da Perplexity são auditados segundo o SOC 2 Type II.

• Controles de administrador — Nos planos Enterprise, um administrador da organização habilita ou desabilita cada conector para todos os membros na tela Permissões, em Configurações da organização.

Um mapa de dados pode conter descrições de tabelas e definições de negócio. Revise seu conteúdo antes de compartilhá-lo com toda a organização.

​

Antes de gerar um mapa de dados

A identidade que inicia a geração determina o que o mapa de dados pode conter, portanto confirme primeiro o acesso dessa identidade.

Warehouse	O que a identidade que gera o mapa precisa ter
Snowflake	Acesso de leitura aos bancos de dados, esquemas, tabelas e visualizações que você quer descrever. O acesso a SNOWFLAKE.ACCOUNT_USAGE.QUERY_HISTORY e ACCESS_HISTORY acrescenta padrões de uso
Databricks	Unity Catalog, um warehouse SQL em execução e visibilidade dos catálogos, esquemas e tabelas que você quer descrever

Tabela 2 — Acesso necessário em cada warehouse antes do início da geração.

Por padrão, SNOWFLAKE.ACCOUNT_USAGE é restrito a administradores, portanto uma função que lê seus bancos de dados comuns muitas vezes ainda não consegue lê-lo. Para incluir padrões de uso, peça ao administrador do Snowflake que conceda IMPORTED PRIVILEGES no banco de dados SNOWFLAKE à função usada na conexão.

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

ACCESS_HISTORY exige Snowflake Enterprise Edition ou superior. Sem ele, o Computer cria o mapa a partir de QUERY_HISTORY; sem nenhuma das duas visualizações, descreve apenas seu catálogo, com orientações menos precisas sobre as tabelas e colunas nas quais sua equipe se baseia.

​

Como gerar o mapa de dados

1. Acesse Configurações da organização → Conectores no Perplexity e abra o conector do Snowflake ou do Databricks.

2. Selecione Gerar mapa de dados.

3. Responda às perguntas do Computer sobre escopo e acesso enquanto ele trabalha. A geração ocorre em um tópico normal do Computer, então você pode acompanhar o progresso e anexar arquivos que descrevem seus dados durante o processo.

4. Revise o mapa e diga ao Computer onde salvá-lo.

O Computer usa a identidade do warehouse conectada para aquela execução. Com uma conexão OAuth, essa identidade é a própria conta do Snowflake ou do Databricks do administrador que inicia a geração. Com uma conexão de conta de serviço do Snowflake, é a conta de serviço configurada.

Quando a geração termina, o Computer pergunta onde salvar o mapa:

Onde salvar	O que significa
Habilidades da organização	Compartilhado com sua organização. Os membros podem usá-lo em suas próprias tarefas do Computer
Minhas habilidades	Mantido nas suas próprias skills, para uso individual ou revisão antes do compartilhamento
Somente ZIP	Entregue como arquivo, sem adicioná-lo às suas skills

Tabela 3 — Os três destinos para um mapa de dados concluído.

Salvar em Habilidades da organização exige permissão para gerenciar as skills da organização. Salvar em Minhas habilidades ou baixar o arquivo não exige essa permissão.

​

Como verificar se funcionou

O mapa de dados aparece como uma skill no destino escolhido. Abra uma nova sessão, faça uma pergunta que dependa de uma tabela descrita no mapa e confirme que a resposta usa a tabela correta e aplica as definições esperadas. Se os membros da sua organização não conseguirem obter essas respostas, o mapa foi salvo em Minhas habilidades, em vez de Habilidades da organização.

​

Como editar o mapa de dados

Um administrador pode editar diretamente a skill de mapa de dados salva ou pedir ao Computer que a atualize. Faça edições pontuais para corrigir uma definição, mudar uma tabela recomendada, adicionar um filtro obrigatório ou documentar um problema conhecido.

Ao pedir ao Computer que faça uma alteração, indique o nome da skill salva e diga o que deve mudar:

• Atualize nossa skill de mapa de dados para usar a nova tabela de pedidos nas consultas de receita. Verifique as colunas e junções antes de substituir as orientações antigas.

• Adicione esta definição de cliente ativo à nossa skill de mapa de dados e preserve as definições existentes para as outras métricas.

Especifique a alteração desejada e o que deve permanecer. Uma instrução que menciona apenas as novas orientações pode substituir definições que você queria manter.

​

Como gerar novamente o mapa de dados

Se seu warehouse tiver mudado substancialmente, gere o mapa novamente para que o Computer o reconstrua a partir do warehouse conectado e do contexto de negócio mais recente. O Computer pede sua confirmação antes de sobrescrever um mapa já salvo.

Gerar novamente reconstrói o mapa do zero e substitui toda a skill, em vez de incorporar as alterações a ela, portanto as edições manuais são perdidas. Para mudar uma única definição ou tabela, edite o mapa de dados. Para manter o mapa que você já tem, peça ao Computer que salve o novo com um nome de skill diferente.

​

Solução de problemas

Sintoma observado	Causa mais provável	Como corrigir
Os membros da sua organização não conseguem usar o mapa de dados	Ele foi salvo em Minhas habilidades, em vez de Habilidades da organização	Salve-o novamente em Habilidades da organização
Tabelas ou esquemas esperados não aparecem no mapa	A identidade que inicia a geração não consegue vê-los	Conceda acesso a essa identidade e gere o mapa novamente
O mapa não tem padrões de uso nem consultas recomendadas	A função usada na conexão não consegue ler SNOWFLAKE.ACCOUNT_USAGE	Conceda IMPORTED PRIVILEGES no banco de dados SNOWFLAKE e gere o mapa novamente
ACCESS_HISTORY retorna um erro	Sua conta do Snowflake usa Standard Edition	Confirme que a conta usa Enterprise Edition ou superior se precisar de informações de uso no nível de coluna
As respostas fazem referência a uma tabela que você substituiu	O mapa de dados é anterior à alteração do esquema	Edite a entrada dessa tabela ou gere o mapa novamente
Uma edição removeu definições que você queria manter	A instrução mencionou as novas orientações, mas não o que deveria ser preservado	Reformule a alteração, especificando as definições que devem permanecer

Tabela 4 — Sintoma, causa e solução para os problemas mais comuns do mapa de dados.

​

Perguntas frequentes

​

Todos na minha organização recebem o mapa de dados?

Somente se ele for salvo em Habilidades da organização. Um mapa salvo em Minhas habilidades fica disponível apenas para você.

​

Compartilhar o mapa de dados dá às pessoas acesso aos dados do meu warehouse?

Não. As consultas continuam sendo executadas com as permissões da conta conectada de cada usuário ou da conta de serviço compartilhada, caso sua organização use uma. Assim, o mapa de dados descreve seu warehouse sem ampliar o acesso a ele.

​

Os dados do meu warehouse serão usados para treinar modelos de IA?

Não. Os dados acessados pelos conectores do Snowflake e do Databricks nunca são usados para treinar os modelos da Perplexity ou qualquer modelo de terceiros.

​

Preciso gerar o mapa novamente após cada alteração de esquema?

Não. Edite a entrada de uma única definição ou tabela e gere o mapa novamente apenas quando o warehouse tiver mudado substancialmente. Gerar novamente substitui o mapa inteiro.

​

Posso manter um mapa de dados só para mim antes de compartilhá-lo?

Sim. Salve-o em Minhas habilidades, revise o conteúdo e salve-o em Habilidades da organização quando estiver pronto.

​

Artigos relacionados

• Conectando o Perplexity ao Snowflake

• Conectando o Perplexity ao Databricks

• Guia de solução de problemas dos conectores Enterprise

• Retenção de dados e privacidade para organizações e usuários Enterprise

• Funções e permissões do Enterprise

​

Precisa de mais ajuda?

Ao entrar em contato, inclua o warehouse, a mensagem de erro exata, o horário em que a geração foi iniciada e as etapas deste artigo que não resolveram o problema.

Entre em contato com a equipe responsável pela sua conta ou fale conosco em Central de ajuda > Falar com o suporte. Visite a Central de Confiança para consultar a documentação de segurança e conformidade.