Conectores Snowflake

O conector Snowflake está disponível exclusivamente no plano Enterprise.

Os Conectores de Warehouse permitem que o Replit Agent consulte os data warehouses da sua organização. Com o conector Snowflake, os desenvolvedores podem criar dashboards, ferramentas de relatórios e aplicativos de dados usando linguagem natural — sem necessidade de conhecimento em SQL. A configuração é um processo único que requer um administrador do Snowflake e um administrador do workspace Replit. Uma vez configurado, qualquer membro da organização pode fazer login e começar a criar com os dados do Snowflake. Este guia orienta você pela configuração completa. Três funções estão envolvidas:

Administrador de conta do Snowflake — Cria a integração OAuth no Snowflake
Administrador do workspace Replit — Configura o conector no Replit
Desenvolvedor — Faz login e começa a criar

Criar a integração OAuth no Snowflake

O Administrador de conta do Snowflake cria uma Integração de Segurança OAuth que permite ao Replit autenticar com o Snowflake.

Pré-requisitos

Função ACCOUNTADMIN no Snowflake
Acesso para executar SQL nas planilhas do Snowflake

Executar o script de configuração

Fazer login no Snowflake

Abra sua conta do Snowflake e certifique-se de estar usando a função ACCOUNTADMIN. Você pode verificar isso no menu suspenso de funções no canto superior direito.

Abrir uma planilha SQL

Clique em Planilhas na barra lateral esquerda e crie uma nova planilha.

Executar o script de integração OAuth

Copie e cole o seguinte script SQL e execute-o:

Criar integração OAuth

-- Remover integração existente, se necessário
DROP INTEGRATION IF EXISTS REPLIT_OAUTH;

-- Criar integração OAuth para o Replit
CREATE SECURITY INTEGRATION REPLIT_OAUTH
  TYPE = OAUTH
  ENABLED = TRUE
  OAUTH_CLIENT = CUSTOM
  OAUTH_CLIENT_TYPE = 'CONFIDENTIAL'
  OAUTH_REDIRECT_URI = 'https://replit.com/connectors/oauth/callback'
  OAUTH_ISSUE_REFRESH_TOKENS = TRUE
  OAUTH_REFRESH_TOKEN_VALIDITY = 7776000
  OAUTH_ALLOW_NON_TLS_REDIRECT_URI = FALSE
  BLOCKED_ROLES_LIST = ()
  COMMENT = 'OAuth integration for Replit connector';

O URI de redirecionamento deve ser exatamente https://replit.com/connectors/oauth/callback. Qualquer outro valor causa um erro 404 durante a autenticação.

Definir BLOCKED_ROLES_LIST = () garante que nenhuma função seja bloqueada de usar a integração. Sem isso, você pode receber erros de “solicitação de consentimento inválida” ou “função bloqueada” ao conectar.

Recuperar suas credenciais OAuth

Execute esta consulta para obter o Client ID e o Client Secret:

Obter credenciais OAuth

-- Ver detalhes da integração
DESCRIBE INTEGRATION REPLIT_OAUTH;

-- Obter Client ID e Secret
WITH secrets AS (
  SELECT PARSE_JSON(
    SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('REPLIT_OAUTH')
  ) as creds
)
SELECT
  creds:OAUTH_CLIENT_ID::STRING as CLIENT_ID,
  creds:OAUTH_CLIENT_SECRET::STRING as CLIENT_SECRET
FROM secrets;

Copie o Client ID e o Client Secret do resultado. Você precisará desses valores na próxima etapa.

Permitir o tráfego do conector quando há restrições de rede

Se sua conta do Snowflake restringe o acesso por endereço IP, peça ao administrador do Snowflake para verificar a política de rede de REPLIT_OAUTH. O login pelo navegador e as solicitações do conector seguem políticas de rede diferentes:

O login pelo navegador usa a política de rede do usuário do Snowflake ou, se não houver política de usuário, a política da conta.
As solicitações de token e as consultas do conector usam a política de rede da integração de segurança OAuth ou, se não houver política de integração, a política da conta.

Um login bem-sucedido pelo navegador não confirma que o Snowflake permite solicitações do conector. O Replit não publica uma lista de IPs estáticos para os conectores. Entre em contato com o suporte do Replit ou com a equipe da sua conta para obter os endereços IP de saída atuais do conector Snowflake antes de atualizar sua lista de permissões. Peça ao administrador do Snowflake para criar ou revisar uma política de rede que permita esses endereços e atenda aos requisitos de segurança da sua organização. Para associar essa política à integração OAuth existente, substitua YOUR_CONNECTOR_NETWORK_POLICY pelo nome dela:

Definir política de rede OAuth

ALTER SECURITY INTEGRATION REPLIT_OAUTH
  SET NETWORK_POLICY = 'YOUR_CONNECTOR_NETWORK_POLICY';

Uma política no nível da integração tem precedência sobre a política da conta para essas solicitações do conector. Mantenha suas políticas de conta e de usuário ativas; não desative as restrições de rede para solucionar problemas. Consulte a orientação do Snowflake sobre políticas de rede OAuth para mais detalhes.

Configurar o conector no Replit

O Administrador do workspace Replit adiciona as credenciais do Snowflake ao Replit. Uma vez configurado, qualquer pessoa na organização pode fazer login.

Esta etapa requer um plano Enterprise com acesso de administrador.

Abrir Integrações

Selecione o workspace da sua organização e acesse Integrações em Configurações.

Adicionar o conector Snowflake

Clique em Adicionar novo conector e selecione Snowflake.

Inserir credenciais

Forneça o Client ID e o Client Secret da etapa anterior.

Definir o escopo

Defina o escopo do conector como refresh_token.

Use apenas o escopo refresh_token. Outros escopos como session:role-any ou session:role:PUBLIC podem causar um erro de “escopo inválido”.

Salvar

Clique em Salvar para ativar o conector.

Qualquer membro da organização com acesso ao conector pode fazer login. Faça login pela página de Integrações primeiro para verificar a conexão antes de usá-la com o Agent.

Encontrar o conector Snowflake

Acesse Integrações no Replit. Em Conectores, encontre Snowflake.

Clicar em Entrar

Clique em Entrar no conector Snowflake.

Inserir seu ID de conta Snowflake

O prompt OAuth solicita seu ID de conta do Snowflake.Para encontrar seu ID de conta, observe a URL do seu Snowflake:

https://app.snowflake.com/minhaorg/minhaconta

Pegue as duas partes após app.snowflake.com/ e junte-as com um hífen:

minhaorg-minhaconta

A URL usa / entre as duas partes, mas o ID de conta usa - em vez disso.

Autenticar

O Snowflake redireciona você para a página de login. Insira suas credenciais do Snowflake para concluir o fluxo OAuth.

Começar a criar com seus dados do Snowflake

Após a conexão, você pode usar o conector Snowflake com o Agent de duas formas:

Comando de barra — Digite /snowflake no prompt para usar o conector
Linguagem natural — Peça ao Agent para usar seus dados do Snowflake diretamente

Aqui está um exemplo de prompt:

Crie um dashboard usando meus dados do Snowflake. Mostre a receita total
por região em um gráfico de barras, uma linha de tendência por trimestre e uma tabela
dos 10 principais clientes. Tema escuro, limpo e moderno.

O Agent escreve e executa consultas SQL nos seus dados do Snowflake e cria um aplicativo funcional.

Solução de problemas

Erro de solicitação de consentimento inválida ou função bloqueada

Sua integração Snowflake pode ter funções bloqueadas por padrão.Verifique se a integração foi criada com BLOCKED_ROLES_LIST = (). Se você já a criou sem essa configuração, execute:

Corrigir funções bloqueadas

CREATE OR REPLACE SECURITY INTEGRATION REPLIT_OAUTH
  TYPE = OAUTH
  ENABLED = TRUE
  OAUTH_CLIENT = CUSTOM
  OAUTH_CLIENT_TYPE = 'CONFIDENTIAL'
  OAUTH_REDIRECT_URI = 'https://replit.com/connectors/oauth/callback'
  OAUTH_ISSUE_REFRESH_TOKENS = TRUE
  OAUTH_REFRESH_TOKEN_VALIDITY = 7776000
  OAUTH_ALLOW_NON_TLS_REDIRECT_URI = FALSE
  BLOCKED_ROLES_LIST = ()
  COMMENT = 'OAuth integration for Replit connector';

Se o erro persistir, verifique se sua função padrão não está bloqueada:

Definir função padrão

ALTER USER "SEU_NOME_DE_USUARIO" SET DEFAULT_ROLE = 'PUBLIC';

Erro 404 na autenticação

Verifique se o URI de redirecionamento na sua integração Snowflake é exatamente:

https://replit.com/connectors/oauth/callback

Qualquer divergência causa um erro 404 durante o fluxo OAuth.

Erro de escopo inválido

Certifique-se de que o escopo do conector no Replit está definido apenas como refresh_token. Remova quaisquer outros escopos como session:role-any ou session:role:PUBLIC.

Erro de falha na conexão

Se o login pelo navegador funciona, mas o conector não consegue se conectar, as restrições de rede ainda podem estar bloqueando as solicitações do conector. Peça ao administrador do Snowflake para verificar a política de REPLIT_OAUTH, e não apenas a política de usuário ou de conta. Siga Permitir o tráfego do conector quando há restrições de rede e tente fazer login no conector novamente.Verifique se o Client ID e o Client Secret no Replit correspondem ao que o Snowflake gerou. Verifique novamente executando:

Verificar credenciais

WITH secrets AS (
  SELECT PARSE_JSON(
    SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('REPLIT_OAUTH')
  ) as creds
)
SELECT
  creds:OAUTH_CLIENT_ID::STRING as CLIENT_ID,
  creds:OAUTH_CLIENT_SECRET::STRING as CLIENT_SECRET
FROM secrets;

Documentação relacionada

Visão geral dos conectores de warehouse — Visão geral de todos os conectores de warehouse suportados
Conectar Databricks — Configuração passo a passo do Databricks
Gerenciando seus conectores — Gerenciamento e configuração de conectores
Snowflake — Configurar OAuth para clientes personalizados — Documentação OAuth do Snowflake

Overview

Workspace Essentials

Enterprise

Warehouse Connectors

Gestão de identidade e acesso

Faturamento empresarial

Conectores Snowflake

Criar a integração OAuth no Snowflake

Pré-requisitos

Executar o script de configuração

Permitir o tráfego do conector quando há restrições de rede

Configurar o conector no Replit

Começar a criar com seus dados do Snowflake

Solução de problemas

Documentação relacionada