Skip to main content
Conecte seu app Base44 ao Snowflake para consultar dados, rodar analytics e gerenciar data warehouses. Depois, crie dashboards e relatórios sobre os dados do seu warehouse.
Snowflake é um conector para criadores de apps. Você o conecta uma vez com suas próprias credenciais do Snowflake no nível do workspace, e seu app consulta o warehouse por essa conexão. Cada pessoa que usa seu app não conecta o Snowflake individualmente.
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.
Prompts de exemplo para o AI chat

Visão rápida

Identificador de tipo
snowflake
Modelo 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ório

Configurando 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 como ACCOUNTADMIN 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 alterar uma integração que já existe, use ALTER. CREATE OR REPLACE gera um novo Client ID e um novo Client Secret e invalida os antigos.
Para configurar o OAuth no Snowflake:
  1. 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:
  2. 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_2 também aparece na saída como reserva para rotação, então use o primeiro secret.
  3. Obtenha seu identificador de conta:
  4. Confirme que a integração está pronta:
    Confira se ENABLED está true e se OAUTH_REDIRECT_URI corresponde 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 formato orgname-account_name, por exemplo nzajreo-sp04035. Não o account locator legado.
  • Credenciais autorizadas a consultar os bancos de dados que você quer usar.
Para adicionar o Snowflake pelas configurações do workspace:
  1. Clique no nome do seu workspace no canto inferior esquerdo.
  2. Clique em Settings.
  3. Clique em Connectors em Plugins.
  4. Em Connectors For App Builders, encontre Snowflake.
  5. Clique em Add ao lado do conector.
  6. Confirme que a callback URL https://connectors.base44.com/api/oauth/callback está definida na sua integração OAuth do Snowflake.
  7. Insira um Connector name para identificar este conector.
  8. Insira o Client ID e o Client Secret e limpe Additional scopes se já houver algo preenchido.
  9. Insira seu identificador de Snowflake Account, no formato orgname-account_name.
  10. Clique em Add Connector.
Você também pode configurar o Snowflake pelo AI chat em um app. Descreva o que você quer criar e, quando solicitado, forneça os mesmos detalhes do conector. O conector é registrado no nível do workspace e fica disponível em todos os apps desse workspace.

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.
Additional scopes deve estar vazio quando você registra o conector. O campo costuma vir preenchido, então limpe-o antes de salvar. O Snowflake rejeita valores como 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.
Para o padrão completo, incluindo como ler os detalhes da conexão e estruturar a requisição, veja a documentação para desenvolvedores:

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

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.
Insira seu identificador de conta no formato 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:
Você também pode lê-lo na URL do Snowsight: app.snowflake.com/<org>/<account> vira <org>-<account>.
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 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.
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.
Você precisa de permissão para gerenciar conectores do workspace.
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.
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.
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.
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.