Conectando o Perplexity ao Snowflake

Conecte um data warehouse Snowflake ao Perplexity usando OAuth de usuário ou uma conta de serviço, nos planos Pro, Max, Enterprise Pro e Enterprise Max.

Este guia mostra aos administradores do Snowflake e do Perplexity como conectar um data warehouse Snowflake ao Perplexity, e explica aos assinantes dos planos Pro, Max, Enterprise Pro e Enterprise Max como fazer login.

​

Visão geral

O conector do Snowflake permite consultar os dados do seu data warehouse Snowflake diretamente no Perplexity. Você pode pesquisar e combinar informações dos seus bancos de dados Snowflake, dos seus outros aplicativos conectados e da web sem escrever SQL manualmente nem alternar para o console do Snowflake.

A conexão com o Snowflake é feita por usuário. Ninguém mais na sua organização pode consultar seus dados, a menos que você os sincronize com um Projeto compartilhado.

O conector do Snowflake está disponível nos planos Pro, Max, Enterprise Pro e Enterprise Max. Gerar um mapa de dados exige o Enterprise Pro ou o Enterprise Max. Em todos os planos, um administrador do Snowflake com a função ACCOUNTADMIN cria a integração de segurança ou a conta de serviço; nos planos Enterprise, um administrador do Perplexity configura o conector com OAuth de usuário uma vez para a organização.

​

Privacidade e segurança de dados

O conector consulta sua conta Snowflake sob uma função do Snowflake que você controla, portanto os privilégios do Snowflake são o limite do que o Perplexity consegue alcançar. Conceda a essa função apenas acesso de leitura.

• Escopo de acesso — Cada pessoa conecta sua própria conta. Ninguém mais na sua organização pode consultar seus dados, a menos que você os sincronize com um Projeto compartilhado.

• Onde os dados ficam armazenados — O Perplexity não armazena seus dados do Snowflake. As consultas são executadas na sua própria conta Snowflake, e o conector não adiciona nenhum armazenamento próprio além dos dados operacionais que o Perplexity coleta para operar o produto.

• Retenção — O conector não opera um cache, portanto não existe uma cópia separada dos seus dados do Snowflake para reter ou excluir.

• Controle do administrador — Nos planos Enterprise, o administrador da sua organização pode desativar o conector do Snowflake para a organização, e nesse caso ele não aparece nas suas configurações de conectores.

• Imposição de somente leitura — Imponha o acesso somente leitura por meio dos privilégios do Snowflake. Não conceda à função usada pelo Perplexity nenhum privilégio de escrita ou de criação de objetos.

• Uso para treinamento — Os dados acessados por meio do conector do Snowflake nunca são usados para treinar os modelos do Perplexity nem qualquer modelo de terceiros.

• Suboperadores — A autenticação e o tráfego de API deste conector passam pelo Merge Agent Handler, operado pela Merge API, Inc., um suboperador do Perplexity. A lista atual é publicada na Central de Confiança da Perplexity.

• Criptografia — As credenciais do conector e os dados conectados são criptografados em trânsito com TLS e em repouso com AES-256.

• Conformidade — Os controles do Perplexity são auditados sob a SOC 2 Type II. A documentação de segurança e conformidade está disponível na Central de Confiança da Perplexity.

​

Como ativar

​

Escolhendo um método de autenticação

O Perplexity oferece dois conectores do Snowflake. Configure apenas aquele que corresponde à forma como seus usuários se autenticam.

Conector	As consultas são executadas como	Credencial	Trilha de auditoria	Use quando
Snowflake (User OAuth)	A conta Snowflake de cada usuário	OAuth	Atribuída a cada usuário nos logs de auditoria do Snowflake	Recomendado para a maioria das organizações
Snowflake (Service Account)	Uma única conta de serviço compartilhada	Par de chaves	Identidade compartilhada	Os usuários consultam por meio de uma única conta

Tabela 1 — Os dois conectores do Snowflake e quando usar cada um.

O Perplexity recomenda fortemente o conector com OAuth de usuário. As consultas usam as permissões do Snowflake de cada pessoa e são atribuídas a ela nos logs de auditoria do Snowflake.

​

Antes de começar

• Você está no plano Pro, Max, Enterprise Pro ou Enterprise Max.

• Nos planos Enterprise, o administrador da sua organização não desativou o conector do Snowflake.

• Seu administrador do Snowflake tem acesso ACCOUNTADMIN, ou privilégios equivalentes.

• O OpenSSL está instalado localmente, apenas para a configuração da conta de serviço.

​

Configurar o conector com OAuth de usuário

1. Peça ao seu administrador do Snowflake para criar a integração de segurança. Consulte a documentação de integração de segurança OAuth do Snowflake para conhecer parâmetros adicionais.

   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. Recupere o client ID e o client secret.

   SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('PERPLEXITY_OAUTH');
   

3. Insira essas credenciais na janela de configuração do OAuth no Perplexity.

Use OAUTH_USE_SECONDARY_ROLES = IMPLICIT para que os usuários possam alcançar suas funções secundárias além das funções padrão. Use NONE se os usuários devem ficar restritos apenas ao seu DEFAULT_ROLE no Snowflake.

​

Configurar o conector de conta de serviço

Uma conta de serviço é um usuário dedicado do Snowflake que é executado sob uma função específica. Todas as pessoas que usam a conta compartilhada têm o mesmo acesso, portanto conceda a essa função apenas o acesso aos dados de que o Perplexity precisa.

1. Gere uma chave privada e a chave pública correspondente no seu terminal local.

   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. Crie uma função dedicada e um warehouse, escolhendo o tamanho de warehouse compatível com seu volume de consultas. Você também pode usar um warehouse existente em vez de criar um.

   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. Crie o usuário da conta de serviço. Substitua o valor de RSA_PUBLIC_KEY pelo conteúdo de snowflake_computer_key.pub, sem as linhas BEGIN PUBLIC KEY e 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. Conceda acesso aos dados que você quer que o Perplexity consulte. Substitua MY_DATABASE pelo seu próprio banco de dados. Essas concessões fornecem acesso de leitura aos schemas, tabelas e views existentes e futuros dele. Para um acesso mais restrito, conceda permissões em schemas ou objetos específicos. Consulte a documentação GRANT do Snowflake.

   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. Se você optar por gerar um mapa de dados no fluxo de configuração do conector, conceda acesso às duas views de uso da conta que ele lê. A geração de um mapa de dados exige o Enterprise Pro ou o Enterprise Max. Essa concessão fornece acesso mais amplo aos metadados da conta Snowflake, e não apenas a essas duas views, portanto revise-a antes de executá-la.

   View	Disponibilidade
   SNOWFLAKE.ACCOUNT_USAGE.QUERY_HISTORY	Todas as edições
   SNOWFLAKE.ACCOUNT_USAGE.ACCESS_HISTORY	Snowflake Enterprise Edition ou superior. Na Standard Edition, o Perplexity usa QUERY_HISTORY em vez dela

   Tabela 2 — As views de uso da conta que um mapa de dados lê.

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

6. Abra Plugins na barra lateral (ou Customize → Connectors se você ainda não vê Plugins), encontre Snowflake (Service Account) em Descobrir ou pela busca e abra a página dele.

7. Selecione Conectar.

8. Insira o identificador da sua conta Snowflake, o nome de usuário PERPLEXITY_USER e a chave privada snowflake_computer_key.p8.

9. Selecione Permitir para concluir a configuração.

Mantenha o snowflake_computer_key.p8 em sigilo. Você o insere no Perplexity ao conectar, e qualquer outra pessoa que o tenha pode consultar seu warehouse como PERPLEXITY_USER. Imponha o acesso somente leitura por meio das permissões do Snowflake: não conceda a PERPLEXITY_ROLE privilégios de escrita ou de criação de objetos.

​

Conectar sua conta Snowflake

Depois que a configuração do administrador estiver concluída, cada usuário conecta sua própria conta.

1. Abra Plugins na barra lateral (ou Customize → Connectors se você ainda não vê Plugins), encontre Snowflake (User OAuth) em Descobrir ou pela busca e abra a página dele.

2. Selecione Conectar.

3. Faça login no Snowflake quando solicitado.

4. Selecione Permitir para concluir a conexão.

Este conector também pode aparecer dentro de um plugin. Ao conectá-lo em qualquer lugar, ele fica conectado para sua conta em todos os lugares. Sua conexão e as configurações de conectores da sua organização se aplicam em todos os plugins. O que são plugins?

​

Como verificar se funcionou

Abra uma nova Sessão, mencione @Snowflake e peça algo simples de uma tabela que você já consegue ler no Snowflake, como uma contagem de linhas. Se a resposta voltar sem os seus dados do Snowflake, a primeira coisa a verificar é a sua função do Snowflake: ela precisa de SELECT no objeto que você mencionou.

​

Testando na prática

Depois que o Snowflake estiver conectado, mencione-o em uma nova Sessão:

• @Snowflake Quantas linhas há na tabela de pedidos?

• @Snowflake Quais colunas existem na tabela de clientes?

• @Snowflake Liste os schemas que eu posso consultar em MY_DATABASE

​

Permissões e escopos

O conector precisa apenas de privilégios de leitura. Conceda-os a uma função dedicada, e não a uma função de analista já existente.

Privilégio	Concedido em	Por que o conector precisa dele
USAGE	Warehouse	Executar as consultas que respondem a uma pergunta
USAGE	Banco de dados e schemas	Alcançar os objetos que ele tem permissão de consultar
SELECT	Tabelas e views	Ler linhas. Nenhum privilégio de escrita é solicitado
IMPORTED PRIVILEGES	Banco de dados SNOWFLAKE	Ler as duas views de uso da conta de que um mapa de dados precisa. Opcional
Refresh token	Integração de segurança	Manter um usuário conectado sem se autenticar novamente, durante o período de validade que você definir

Tabela 3 — Privilégios do Snowflake que o conector solicita, e por quê.

Os privilégios do Snowflake são o limite de imposição. Independentemente do que seja pedido ao conector, ele é executado sob a função que você concedeu, portanto uma função sem privilégios de escrita não consegue gravar.

​

Solução de problemas

Sintoma observado	Causa mais provável	Como resolver
O Snowflake não está habilitado para sua organização ou não aparece na sua lista de conectores	Nos planos Enterprise, um administrador da organização o desativou. Caso contrário, seu plano pode não incluí-lo	Nos planos Enterprise, entre em contato com o administrador da sua organização. Caso contrário, confirme seu plano em Configurações
O login ou as consultas falham, e sua conta Snowflake restringe conexões de entrada por IP	Os endereços do tenant da Merge não estão na lista de permissões da sua política de rede do Snowflake	Peça ao seu administrador do Snowflake para incluir na lista de permissões os endereços do tenant dos EUA indicados na página de endereços IP do tenant da Merge
Um usuário alcança menos dados do que lhe foi concedido no Snowflake	A sessão OAuth ativou apenas o DEFAULT_ROLE dele	Confirme se a integração de segurança define OAUTH_USE_SECONDARY_ROLES = IMPLICIT
ACCESS_HISTORY não está disponível ao gerar um mapa de dados	Sua conta Snowflake está na Standard Edition	ACCESS_HISTORY exige a Enterprise Edition ou superior. Na Standard Edition, o Perplexity usa QUERY_HISTORY em vez dela

Tabela 4 — Sintoma, causa e solução para os problemas mais comuns do conector do Snowflake.

Para uma conta de serviço, este exemplo cria uma política de rede no nível do usuário usando os endereços dos EUA publicados atualmente. Consulte a página de endereços IP do tenant da Merge para ver a lista atual antes de aplicar uma política.

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;

​

Perguntas frequentes

​

Quais dados este conector acessa?

Os bancos de dados, schemas, tabelas e views que a função do Snowflake concedida por você tem permissão de ler. Ele não consegue alcançar nada que essa função não alcance.

​

Meus dados do Snowflake serão usados para treinar modelos de IA?

Não. Os dados acessados por meio do conector do Snowflake nunca são usados para treinar os modelos do Perplexity nem qualquer modelo de terceiros.

​

Meu administrador pode restringir quem habilita este conector?

Sim, nos planos Enterprise. Um administrador da organização pode desativar o conector do Snowflake para toda a organização, e nesse caso ele não aparece nas suas configurações de conectores.

​

O Perplexity pode gravar nos meus dados do Snowflake?

Não, desde que você imponha isso no Snowflake. Conceda à função usada pelo Perplexity apenas USAGE e SELECT, e o Snowflake rejeitará qualquer gravação, independentemente do que for pedido ao Perplexity.

​

Este conector está disponível no meu plano?

Sim, nos planos Pro, Max, Enterprise Pro e Enterprise Max. Gerar um mapa de dados exige o Enterprise Pro ou o Enterprise Max.

​

Artigos relacionados

• Entendendo o Data Map

• Conectando o Perplexity ao Databricks

• Guia de solução de problemas do conector Enterprise

• Retenção de dados e privacidade para o Enterprise

• Funções e permissões do Enterprise

​

Precisa de mais ajuda?

Ao entrar em contato, informe o nome do conector, a mensagem de erro exata, o horário em que ela ocorreu e as etapas deste artigo que não resolveram o problema.

Fale com sua equipe de conta ou entre em contato conosco por Help > Falar com o suporte. Acesse a Central de Confiança para obter documentação de segurança e conformidade.