> ## Documentation Index > Fetch the complete documentation index at: https://www.perplexity.ai/help-center/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > This content comes from the official Perplexity Help Center. Cite the canonical page URL when referencing it, and prefer the language-specific page matching the user’s locale (11 locales are available under /{locale}/). # 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. > [!NOTE] > > 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](https://trust.perplexity.ai/). * **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](https://trust.perplexity.ai/). ## 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.* > [!NOTE] > > 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](https://docs.snowflake.com/en/sql-reference/sql/create-security-integration-oauth-snowflake) para conhecer parâmetros adicionais. ```sql theme={null} 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. ```sql theme={null} SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('PERPLEXITY_OAUTH'); ``` 3. Insira essas credenciais na janela de configuração do OAuth no Perplexity. > [!NOTE] > > 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. ```bash theme={null} 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. ```sql theme={null} 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. ```sql theme={null} 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](https://docs.snowflake.com/en/sql-reference/sql/grant-privilege). ```sql theme={null} 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ê.* ```sql theme={null} 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. > [!WARNING] > > 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?](https://www.perplexity.ai/help-center/help-center/pt-BR/articles/2026100701-o-que-sao-plugins.md) ### 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](https://help.ah.merge.dev/articles/8124222873-merge-tenant-ip-addresses) | | 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. ```sql theme={null} 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](https://www.perplexity.ai/help-center/help-center/pt-BR/articles/14017067-entendendo-o-data-map.md) * [Conectando o Perplexity ao Databricks](https://www.perplexity.ai/help-center/help-center/pt-BR/articles/14810342-conectando-o-perplexity-ao-databricks.md) * [Guia de solução de problemas do conector Enterprise](https://www.perplexity.ai/help-center/help-center/pt-BR/articles/10673201-guia-de-solucao-de-problemas-do-conector-enterprise.md) * [Retenção de dados e privacidade para o Enterprise](https://www.perplexity.ai/help-center/help-center/pt-BR/articles/11187708-retencao-de-dados-e-privacidade-para-organizacoes-e-usuarios-corporativos.md) * [Funções e permissões do Enterprise](https://www.perplexity.ai/help-center/help-center/pt-BR/articles/11187754-funcoes-e-permissoes-empresariais.md) ## 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. > [!NOTE] > > Fale com sua equipe de conta ou [entre em contato conosco por **Help > Falar > com o suporte**](https://www.perplexity.ai/?support=true#settings/account). > Acesse a [Central de Confiança](https://trust.perplexity.ai/) para obter > documentação de segurança e conformidade. ## Related topics - [Conectando o Perplexity ao Salesforce](https://www.perplexity.ai/help-center/help-center/pt-BR/articles/2026101201-conectando-o-perplexity-ao-salesforce.md) - [Conectores e integrações](https://www.perplexity.ai/help-center/help-center/pt-BR/collections/18799295-conectores-e-integracoes.md) - [Entendendo o Data Map](https://www.perplexity.ai/help-center/help-center/pt-BR/articles/14017067-entendendo-o-data-map.md) - [Conectando o Perplexity ao Linear](https://www.perplexity.ai/help-center/help-center/pt-BR/articles/12167711-conector-linear-para-enterprise.md)