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ório e aplicações de dados usando linguagem natural — sem necessidade de expertise em SQL. A configuração é um processo único que requer um administrador do Snowflake e um administrador do workspace do Replit. Uma vez configurado, qualquer membro da organização pode fazer login e começar a criar com dados do Snowflake. Este guia apresenta a 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 do 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-se no Snowflake.

​
Pré-requisitos

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

​
Executar o script de configuração

1

Faça login no Snowflake

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

Abra uma planilha SQL

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

Execute o script de integração OAuth

Copie e cole o seguinte script SQL e execute-o:
Create OAuth integration
-- 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

Recupere suas credenciais OAuth

Execute esta consulta para obter o Client ID e o Client Secret:
Get OAuth credentials
-- 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 da saída. Você precisará deles na próxima etapa.

​
Configurar o conector no Replit

O Administrador do Workspace do 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

Clique em Fazer Login

Clique em Fazer Login no conector Snowflake.
3

Inserir seu ID de Conta do Snowflake

O prompt OAuth solicita seu ID de Conta do Snowflake.Para encontrar seu ID de Conta, veja o URL do Snowflake:
https://app.snowflake.com/myorg/myaccount
Pegue as duas partes após app.snowflake.com/ e una-as com um hífen:
myorg-myaccount
O URL usa / entre as duas partes, mas o ID de Conta usa - no lugar.
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 conectar, você pode usar o conector Snowflake com o Agent de duas maneiras:
  • 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 com 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 uma aplicação funcional.

​
Solução de problemas

Sua integração do Snowflake pode ter funções bloqueadas por padrão.Verifique se sua integração foi criada com BLOCKED_ROLES_LIST = (). Se você já a criou sem esta configuração, execute:
Fix blocked roles
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:
Set default role
ALTER USER "YOUR_USERNAME" SET DEFAULT_ROLE = 'PUBLIC';
Verifique se o URI de redirecionamento na sua integração do 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 esteja definido como refresh_token apenas. 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:
Verify credentials
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