Saltar para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.replit.com/llms.txt

Use this file to discover all available pages before exploring further.

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:
  1. Administrador de conta do Snowflake — Cria a integração OAuth no Snowflake
  2. Administrador do workspace Replit — Configura o conector no Replit
  3. 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

1

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.
2

Abrir uma planilha SQL

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

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.
4

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.

​
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.
1

Abrir Integrações

Acesse as configurações da sua organização e selecione a aba Integrações.
2

Adicionar o conector Snowflake

Clique em Adicionar novo conector e selecione Snowflake.
3

Inserir credenciais

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

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”.
5

Salvar

Clique em Salvar para ativar o conector.

​
Fazer login no Snowflake

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.
1

Encontrar o conector Snowflake

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

Clicar em Entrar

Clique em Entrar no conector Snowflake.
3

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.
4

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

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';
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.
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.
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