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.
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 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
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.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.Já tem uma integração de OAuth?
Já tem uma integração de OAuth?
Use Se View redirect URIs mostrar URLs para conexões existentes, inclua todas as URLs adicionais em
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.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.
- Clique em Connectors na barra lateral do seu workspace.
- Clique em Add connector.
- Pesquise Snowflake e clique no resultado.
- Insira um Connector name.
- Insira o Client ID e o Client Secret da sua integração de OAuth do Snowflake.
- Em Scopes, mantenha os padrões. Veja Escopos e permissões.
- Em Connection Configuration, insira o identificador da sua Snowflake Account no formato
orgname-account_name, por exemplonzajreo-sp04035. Não use o account locator legado. - Clique em Add Connector.
- Abra seu app e peça ao chat de IA para adicionar um recurso do Snowflake.
- Autorize a conta quando solicitado.
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.- Conector compartilhado
- Conector de usuário do app
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.As consultas falham com um erro de warehouse ou de acesso
As consultas falham com um erro de warehouse ou de acesso
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 conexão falha com uma incompatibilidade de redirect URI
A conexão falha com uma incompatibilidade de redirect URI
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.A conexão falha porque sua função está bloqueada
A conexão falha porque sua função está bloqueada
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.