Skip to main content
Conecte seu app ao Snowflake para consultar dados do warehouse, executar análises e usar os resultados em painéis, relatórios e fluxos.
Você precisa de um Builder plan ou superior para usar conectores no seu app.

O que você pode fazer

Use os dados do seu warehouse para responder perguntas e manter sua equipe informada.

Consultar dados do warehouse

Execute SQL no seu warehouse do Snowflake e mostre os resultados no seu app.

Criar painéis de análise

Exiba os resultados do warehouse em gráficos, tabelas e painéis.

Automatizar fluxos de dados

Use consultas do Snowflake em fluxos, como enviar um alerta para um canal do Slack quando uma métrica cair.
Prompts de exemplo

Configurando o OAuth no Snowflake

O OAuth do Snowflake usa uma security integration. Crie-a no Snowflake antes de registrar o conector na Base44.
1

Obtenha a callback URL da Base44

Obtenha a callback URL da Base44 em Registrando callback URLs. O SQL abaixo a registra como OAUTH_REDIRECT_URI.
2

Crie a security integration de OAuth

Use ACCOUNTADMIN ou uma função com o privilégio global CREATE INTEGRATION. Este exemplo usa ACCOUNTADMIN. Se você usar outra função, substitua a primeira instrução.
Isso define os refresh tokens para 90 dias, o valor padrão e máximo do Snowflake.Se View redirect URIs listar URLs adicionais para conexões existentes, adicione todas elas a OAUTH_ALTERNATE_REDIRECT_URIS nesta instrução CREATE SECURITY INTEGRATION.Se você escolher outro nome para a integração, use-o nas demais instruções SQL.
3

Obtenha os detalhes da conexão

Leia seu Client ID e seu Client Secret.
Use o botão de copiar da célula para os dois valores. O Client ID costuma terminar em =, e omitir esse caractere quebra a conexão. A saída também inclui OAUTH_CLIENT_SECRET_2 como reserva para rotação, então use o primeiro secret.Obtenha o identificador da conta do Snowflake que você vai inserir na Base44.
4

Prepare a identidade do Snowflake

Use uma identidade comum do Snowflake com DEFAULT_ROLE e DEFAULT_WAREHOUSE definidos. A função dela precisa de acesso aos bancos de dados e objetos que seu app consulta e de permissão para usar o warehouse.Por padrão, o Snowflake impede que ACCOUNTADMIN, SECURITYADMIN, ORGADMIN e GLOBALORGADMIN usem esta integração. Esse é um padrão de segurança do Snowflake, não uma restrição da Base44.
Use ALTER para alterar uma integração existente. CREATE OR REPLACE exclui e recria a integração, então não o use para alterar uma redirect URI.Se a integração já existe e só a callback URL precisa ser atualizada, execute isto.
Se View redirect URIs mostrar URLs para conexões existentes, inclua todas as URLs adicionais em OAUTH_ALTERNATE_REDIRECT_URIS. Mantenha as URLs alternativas que já estão registradas.

Conectando o Snowflake

Conecte o Snowflake para que seu app possa consultar seu warehouse.
Antes de começar:
  • Integração de OAuth do Snowflake: Crie uma security integration de OAuth no Snowflake para ter um Client ID e um Client Secret. Veja Configurando o OAuth no Snowflake.
  • Identificador da conta do Snowflake: Obtenha-o com o SQL em Configurando o OAuth no Snowflake.
  • Acesso ao workspace da Base44: Você precisa ser dono ou admin do workspace para registrar o conector na Base44.
  • Acesso ao Snowflake: Cada pessoa que se conecta precisa de acesso aos bancos de dados que você quer consultar.
Para adicionar o Snowflake pela página Connectors:
  1. Clique em Connectors na barra lateral do seu workspace.
  2. Clique em Add connector.
  3. Pesquise Snowflake e clique no resultado.
  4. Insira um Connector name.
  5. Insira o Client ID e o Client Secret da sua integração de OAuth do Snowflake.
  6. Em Scopes, mantenha os padrões. Veja Escopos e permissões.
  7. Em Connection Configuration, insira o identificador da sua Snowflake Account no formato orgname-account_name, por exemplo nzajreo-sp04035. Não use o account locator legado.
  8. Clique em Add Connector.
  9. Abra seu app e peça ao chat de IA para adicionar um recurso do Snowflake.
  10. Autorize a conta quando solicitado.
Seu app pode usar uma conexão compartilhada do Snowflake ou deixar cada pessoa conectar a própria conta. Diga ao chat de IA qual opção você quer.

Escopos e permissões

Suas permissões do Snowflake determinam quais dados do warehouse seu app pode consultar.
1

A Base44 adiciona

  • refresh_token: Atualiza a conexão sem um novo login
2

Você configura

  • Deixe Additional scopes vazio. O Snowflake rejeita valores não suportados, como account:read, com The requested scope is invalid.
  • Não adicione session:role:<role>.
Acesso: O Snowflake usa a função padrão e as permissões da identidade que autoriza a conexão.

Usando o Snowflake em uma função de backend

Depois que o Snowflake está conectado, suas funções de backend podem obter um token de acesso e consultar seu warehouse. A Base44 cuida do fluxo OAuth e do armazenamento das credenciais.
Use getWorkspaceConnection(connectorId) quando seu app usa uma identidade compartilhada do Snowflake.

Conectores (documentação para desenvolvedores)

Obtenha uma conexão, leia os detalhes dela e chame a API do serviço a partir de uma função de backend.

Solução de problemas

Verifique as funções, o acesso ao warehouse e as callback URLs se o Snowflake não conseguir se conectar ou executar consultas.
Verifique o DEFAULT_ROLE e o DEFAULT_WAREHOUSE da identidade do Snowflake conectada. A função precisa de USAGE no warehouse, no banco de dados e no schema, além de SELECT nas tabelas ou views que seu app consulta. Em uma conexão de usuário do app, verifique a função e as permissões de cada pessoa no Snowflake.
A callback URL registrada no Snowflake não corresponde à que a Base44 envia. Confira a URL ou as URLs que sua conexão usa em Registrando callback URLs. As conexões usam a callback URL única ou URLs separadas para cada host de app. Verifique se a integração está ativada e compare as redirect URIs registradas com as URLs que sua conexão usa.
Confirme se todas as URIs que a Base44 mostra estão registradas como OAUTH_REDIRECT_URI ou em OAUTH_ALTERNATE_REDIRECT_URIS. O Snowflake compara as redirect URIs caractere por caractere.
Você entrou com uma função privilegiada. Por padrão, o Snowflake impede que ACCOUNTADMIN, SECURITYADMIN, ORGADMIN e GLOBALORGADMIN usem a integração. Entre com um usuário comum do Snowflake.
Esta página foi traduzida usando IA. Para as informações mais precisas e atualizadas, consulte a versão em inglês.