Você precisa do Builder plan ou superior para usar conectores no seu app.
O que você pode fazer
Consulte dados do warehouse
Rode SQL no seu warehouse do Snowflake e exiba os resultados no seu app.
Crie dashboards de analytics
Transforme consultas do warehouse em gráficos, tabelas e dashboards que seu time pode ler.
Dispare com mudanças nos dados
Combine o Snowflake com outros conectores, por exemplo alertando um canal do Slack quando uma métrica cai.
Visão rápida
Identificador de tipo
snowflakeModelo de autenticação
OAuth, com suas próprias credenciais
Tipo de conector
Para criadores de apps (nível do workspace)
Configuração da conexão
subdomain (seu identificador de conta do Snowflake, no formato orgname-account_name), obrigatórioConfigurando o OAuth no Snowflake
O Snowflake não tem um aplicativo OAuth central. O cliente OAuth fica dentro da sua própria conta Snowflake. Você o cria lá e depois fornece as credenciais dele à Base44. Não há como fazer isso no Snowsight, então execute as instruções abaixo comoACCOUNTADMIN em uma worksheet SQL.
Quando você autorizar a conexão depois, entre com um usuário comum que tenha DEFAULT_ROLE e DEFAULT_WAREHOUSE definidos. O Snowflake bloqueia ACCOUNTADMIN, SECURITYADMIN e ORGADMIN de autorizar aplicativos externos. Esse é um padrão de segurança do Snowflake, não uma restrição da Base44.
Para configurar o OAuth no Snowflake:
-
Crie a security integration OAuth:
Se a integração já existe e só a callback URL precisa ser atualizada, execute isto no lugar, o que mantém o Client ID e o Client Secret existentes:
-
Leia seu Client ID e Client Secret:
Copie cada valor com o botão de copiar da célula, em vez de selecioná-lo manualmente. O Client ID costuma terminar em
=, e perder esse caractere quebra a conexão.OAUTH_CLIENT_SECRET_2também aparece na saída como reserva para rotação, então use o primeiro secret. -
Obtenha seu identificador de conta:
-
Confirme que a integração está pronta:
Confira se
ENABLEDestá true e seOAUTH_REDIRECT_URIcorresponde exatamente à callback URL.
Conectando o Snowflake
Snowflake é um conector para criadores de apps. Você o conecta uma vez no nível do workspace com suas próprias credenciais do warehouse.Antes de começar, você precisa de:
- Uma security integration OAuth do Snowflake na sua conta Snowflake, para ter um Client ID e um Client Secret. Veja Configurando o OAuth no Snowflake.
- Seu identificador de conta do Snowflake (o
subdomain), no formatoorgname-account_name, por exemplonzajreo-sp04035. Não o account locator legado. - Credenciais autorizadas a consultar os bancos de dados que você quer usar.
- Clique no nome do seu workspace no canto inferior esquerdo.
- Clique em Settings.
- Clique em Connectors em Plugins.
- Em Connectors For App Builders, encontre Snowflake.
- Clique em Add ao lado do conector.
- Confirme que a callback URL
https://connectors.base44.com/api/oauth/callbackestá definida na sua integração OAuth do Snowflake. - Insira um Connector name para identificar este conector.
- Insira o Client ID e o Client Secret e limpe Additional scopes se já houver algo preenchido.
- Insira seu identificador de Snowflake Account, no formato
orgname-account_name. - Clique em Add Connector.
Escopos
Você não escolhe escopos do Snowflake na Base44. O Snowflake não expõe escopos selecionáveis. Um admin do Snowflake define o acesso dentro do Snowflake, de acordo com os papéis de usuário.
account:read e session:role:select com The requested scope is invalid.
Com o campo vazio, o Snowflake aplica o papel padrão da conta que conecta, e a Base44 adiciona o escopo refresh_token automaticamente, listado em Always included.
Usando o Snowflake em uma backend function
Depois que o Snowflake está conectado, suas backend functions podem obter um access token e consultar seu warehouse. A Base44 cuida do fluxo OAuth e do armazenamento de credenciais.Connectors (docs para desenvolvedores)
Obtenha uma conexão, leia os detalhes dela e chame a API do serviço a partir de uma backend function.
Solução de problemas
Não vejo o Snowflake nas configurações do workspace
Não vejo o Snowflake nas configurações do workspace
Confirme que você está no workspace correto e que tem permissão para gerenciar conectores do workspace. Se ainda não vir o Snowflake, entre em contato com o suporte.
Minha Snowflake Account não é aceita
Minha Snowflake Account não é aceita
Insira seu identificador de conta no formato Você também pode lê-lo na URL do Snowsight:
orgname-account_name, por exemplo nzajreo-sp04035. Não inclua .snowflakecomputing.com.O formato legado de account locator, como xy12345.us-east-1, não é suportado para OAuth. Usá-lo falha com OAuth client integration with the given client id is not found. A mensagem cita o Client ID, mas o campo da conta é a causa real.Para encontrar seu identificador, execute isto em uma worksheet do Snowflake:app.snowflake.com/<org>/<account> vira <org>-<account>.A conexão não funciona após a configuração
A conexão não funciona após a configuração
Confira se a callback URL
https://connectors.base44.com/api/oauth/callback foi adicionada à sua integração OAuth do Snowflake. Depois, confirme que o Client ID, o Client Secret e a Snowflake Account estão corretos e que o papel do Snowflake tem acesso aos bancos de dados que você está consultando.A conexão falha com um redirect URI mismatch
A conexão falha com um redirect URI mismatch
A callback URL registrada no Snowflake não corresponde à que a Base44 envia. Execute
DESC SECURITY INTEGRATION BASE44_OAUTH; e confirme que OAUTH_REDIRECT_URI é exatamente https://connectors.base44.com/api/oauth/callback. O Snowflake permite uma redirect URI por integração e a compara caractere por caractere.A conexão falha porque seu papel está bloqueado
A conexão falha porque seu papel está bloqueado
Você entrou com um usuário admin. O Snowflake bloqueia
ACCOUNTADMIN, SECURITYADMIN e ORGADMIN de autorizar aplicativos externos por padrão. Entre com um usuário comum.Perguntas frequentes
Perguntas comuns sobre como conectar o Snowflake ao seu app.Quem pode adicionar o conector do Snowflake?
Quem pode adicionar o conector do Snowflake?
Você precisa de permissão para gerenciar conectores do workspace.
Onde encontro a redirect URI da Base44?
Onde encontro a redirect URI da Base44?
O Snowflake usa uma única callback URL para todos os apps do seu workspace:
https://connectors.base44.com/api/oauth/callback. Adicione-a à sua integração OAuth do Snowflake. Se você está configurando o conector pelo AI chat, o formulário de configuração também a mostra.Conectores adicionados antes de a Base44 migrar para uma callback URL única ainda usam https://app.base44.com/api/external-auth/callback. Mantenha essa URL registrada no Snowflake enquanto o conector usar URLs por app.O que devo inserir em Snowflake Account?
O que devo inserir em Snowflake Account?
Insira seu identificador de conta no formato
orgname-account_name, por exemplo nzajreo-sp04035. Não inclua .snowflakecomputing.com e não use o formato legado de account locator, como xy12345.us-east-1, que não é suportado para OAuth.Posso adicionar o Snowflake pelo AI chat?
Posso adicionar o Snowflake pelo AI chat?
Sim. Você pode começar pelo AI chat em um app específico. Se o conector ainda não estiver configurado, a Base44 pede os detalhes do conector antes de continuar.
As pessoas que usam meu app precisam conectar o Snowflake?
As pessoas que usam meu app precisam conectar o Snowflake?
Não. O conector do Snowflake é configurado uma vez no nível do workspace e pode ser usado nos apps desse workspace.
Esta página foi traduzida usando IA. Para as informações mais precisas e atualizadas, consulte a versão em inglês.