Conectar Snowflake a tu app

Conecta Snowflake a tu app de Base44 para consultar datos del almacén, ejecutar analíticas y usar los resultados en paneles, informes y flujos de trabajo.

Necesitas un plan Builder o superior para usar conectores en tu app.

Qué puedes hacer

Consultar datos del almacén

Ejecuta SQL en tu almacén de Snowflake y muestra los resultados en tu app.

Crear paneles de analítica

Muestra los resultados del almacén en gráficos, tablas y paneles.

Automatizar flujos de datos

Usa consultas de Snowflake en workflows, por ejemplo para enviar una alerta a un canal de Slack cuando una métrica baje.

Prompts de ejemplo para el chat de IA

Consulta los datos de ventas de mi almacén de Snowflake y muestra los resultados.

Ejecuta un informe de analítica sobre los datos de clientes almacenados en Snowflake.

Obtén los niveles de inventario del almacén de datos de Snowflake.

Ejecuta una consulta SQL para analizar tendencias en mis tablas de Snowflake.

Configurar OAuth en Snowflake

OAuth de Snowflake usa una integración de seguridad. Créala en Snowflake antes de registrar el conector en Base44.

Copia tus URI de redirección

En tu workspace de Base44, ve a Settings > Connectors y haz clic en View redirect URIs. Copia todas las URI que aparecen.

Crea la integración de seguridad OAuth

Usa ACCOUNTADMIN o un rol con el privilegio global CREATE INTEGRATION. Este ejemplo usa ACCOUNTADMIN. Si usas otro rol, reemplaza la primera instrucción.

USE ROLE ACCOUNTADMIN;

CREATE SECURITY INTEGRATION BASE44_OAUTH
  TYPE                         = OAUTH
  OAUTH_CLIENT                 = CUSTOM
  OAUTH_CLIENT_TYPE            = 'CONFIDENTIAL'
  OAUTH_REDIRECT_URI           = 'https://connectors.base44.com/api/oauth/callback'
  OAUTH_ISSUE_REFRESH_TOKENS   = TRUE
  OAUTH_REFRESH_TOKEN_VALIDITY = 7776000
  ENABLED                      = TRUE;

Esto configura los tokens de actualización en 90 días, el valor predeterminado y máximo de Snowflake.Si View redirect URIs muestra URL adicionales de conexiones existentes, añade cada una a OAUTH_ALTERNATE_REDIRECT_URIS en esta instrucción CREATE SECURITY INTEGRATION.

Obtén los datos de conexión

Si eliges otro nombre de integración, úsalo en el resto de instrucciones SQL.Lee tu Client ID y tu Client Secret:

SELECT
  PARSE_JSON(SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('BASE44_OAUTH')):OAUTH_CLIENT_ID::STRING     AS client_id,
  PARSE_JSON(SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('BASE44_OAUTH')):OAUTH_CLIENT_SECRET::STRING AS client_secret;

Usa el botón de copiar de la celda para ambos valores. El Client ID suele terminar en =, y omitir ese carácter rompe la conexión. La salida también incluye OAUTH_CLIENT_SECRET_2 como reserva para la rotación, así que usa el primer secreto.Obtén el identificador de cuenta de Snowflake que introducirás en Base44:

SELECT CURRENT_ORGANIZATION_NAME() || '-' || CURRENT_ACCOUNT_NAME() AS account_identifier;

Prepara la identidad de Snowflake

Usa una identidad normal de Snowflake con DEFAULT_ROLE y DEFAULT_WAREHOUSE configurados. Su rol necesita acceso a las bases de datos y los objetos que consulta tu app, y permiso para usar el almacén.Snowflake impide por defecto que ACCOUNTADMIN, SECURITYADMIN, ORGADMIN y GLOBALORGADMIN usen esta integración. Es un valor de seguridad predeterminado de Snowflake, no una restricción de Base44.

¿Ya tienes una integración OAuth?

Usa ALTER para cambiar una integración existente. CREATE OR REPLACE la elimina y la vuelve a crear, así que no lo uses para cambiar una URI de redirección.Si la integración ya existe y solo necesitas actualizar la URL de callback, ejecuta esto en su lugar:

ALTER SECURITY INTEGRATION BASE44_OAUTH
  SET OAUTH_REDIRECT_URI = 'https://connectors.base44.com/api/oauth/callback';

Si View redirect URIs muestra URL de conexiones existentes, incluye todas las URL adicionales en OAUTH_ALTERNATE_REDIRECT_URIS. Conserva las URL alternativas que ya estén registradas.

ALTER SECURITY INTEGRATION BASE44_OAUTH
  SET OAUTH_ALTERNATE_REDIRECT_URIS = ('<additional callback URL>');

Conectar Snowflake

Registra Snowflake una vez a nivel de workspace. Después úsalo como conexión compartida de creador o deja que cada usuario de la app se conecte con su propia identidad de Snowflake.

Antes de empezar:

Integración OAuth de Snowflake: Crea una integración de seguridad OAuth de Snowflake para tener un Client ID y un Client Secret. Consulta Configurar OAuth en Snowflake.
Identificador de cuenta de Snowflake: Usa el formato orgname-account_name, por ejemplo nzajreo-sp04035. No uses el localizador de cuenta heredado. Introduce este valor en Snowflake Account. Las funciones de backend lo leen como connectionConfig.subdomain.
Acceso al workspace de Base44: Debes ser propietario o administrador del workspace para registrar el conector en Base44.
Acceso a Snowflake: Cada persona que se conecta necesita acceso a las bases de datos que quieres consultar.

Para creadores de apps
Para usuarios de la app

Conecta Snowflake una vez a nivel de workspace cuando tu app deba usar una sola identidad compartida de Snowflake.Para añadir Snowflake desde los ajustes de tu workspace:

Haz clic en el nombre de tu workspace, abajo a la izquierda.
Haz clic en Settings.
Haz clic en Connectors en Build tools.
En Connectors For App Builders, busca Snowflake.
Haz clic en Add junto al conector.
Confirma que la URL de callback https://connectors.base44.com/api/oauth/callback está configurada en tu integración OAuth de Snowflake.
Introduce un Connector name para identificar este conector.
Introduce el Client ID y el Client Secret, y borra Additional scopes si el campo viene rellenado.
Introduce tu identificador de Snowflake Account, en formato orgname-account_name.
Haz clic en Add Connector.

También puedes configurar la conexión compartida desde el chat de IA de una app. Describe lo que quieres crear y, cuando se te pida, proporciona los mismos datos del conector.

Deja que cada persona se conecte a Snowflake con su propia identidad. Registra el conector de Snowflake una vez a nivel de workspace. Snowflake aplica el rol, el almacén y los permisos de cada persona cuando se conecta.Los usuarios de la app pueden conectarse con distintas identidades de Snowflake, pero cada identidad debe pertenecer a la cuenta de Snowflake configurada para ese conector. Para usar otra cuenta de Snowflake, registra otro conector de Snowflake con ese identificador de cuenta.Para añadir Snowflake para usuarios de la app:

Haz clic en el nombre de tu workspace, abajo a la izquierda.
Haz clic en Settings.
Haz clic en Connectors en Build tools.
En Connectors For App Users, haz clic en Add Connector.
Haz clic en Snowflake.
Introduce un Connector name y, después, el Client ID y el Client Secret de tu integración OAuth de Snowflake.
Borra Additional scopes si el campo viene rellenado.
Introduce tu identificador de Snowflake Account, en formato orgname-account_name.
Haz clic en Add Connector.
Abre el conector de Snowflake y activa App user connections.
Pide al chat de IA que añada una forma de conectar y desconectar Snowflake en tu app.

Alcances

Base44 añade

refresh_token

Actualiza la conexión sin volver a iniciar sesión.

Tú configuras

Additional scopes:

Deja este campo vacío. Borra cualquier valor prerrellenado antes de añadir el conector. Snowflake rechaza los valores no admitidos, como account:read, con The requested scope is invalid.

Alcances de rol:

No añadas session:role:<role> en Base44. Snowflake usa el rol predeterminado de la identidad que autoriza.

Acceso: Snowflake usa el rol y los permisos de la identidad que autoriza la conexión.

Usar Snowflake en una función de backend

Una vez conectado Snowflake, tus funciones de backend pueden obtener un token de acceso y consultar tu almacén. Base44 gestiona el flujo OAuth y el almacenamiento de credenciales.

Para creadores de apps
Para usuarios de la app

Usa getWorkspaceConnection(connectorId) cuando tu app use una sola identidad compartida de Snowflake.

import { createClientFromRequest } from "npm:@base44/sdk@0.8.44";

Deno.serve(async (req) => {
  const base44 = createClientFromRequest(req);
  const connectorId = "YOUR_CONNECTOR_ID";

  const { accessToken, connectionConfig } =
    await base44.asServiceRole.connectors.getWorkspaceConnection(connectorId);

  // Use accessToken to query Snowflake.
  return Response.json({ account: connectionConfig.subdomain });
});

Usa getCurrentAppUserConnection(connectorId) cuando cada persona se conecte con su propia identidad de Snowflake.

import { createClientFromRequest } from "npm:@base44/sdk@0.8.44";

Deno.serve(async (req) => {
  const base44 = createClientFromRequest(req);
  const user = await base44.auth.me();

  if (!user) {
    return Response.json({ error: "Unauthorized" }, { status: 401 });
  }

  const connectorId = "YOUR_CONNECTOR_ID";
  const { accessToken, connectionConfig } =
    await base44.asServiceRole.connectors.getCurrentAppUserConnection(connectorId);

  // Use accessToken to query Snowflake for the signed-in person.
  return Response.json({ account: connectionConfig.subdomain });
});

Conectores (documentación para desarrolladores)

Obtén una conexión, lee sus datos y llama a la API del servicio desde una función de backend.

Solución de problemas

Las consultas fallan con un error de almacén o de acceso

Revisa el DEFAULT_ROLE y el DEFAULT_WAREHOUSE de la identidad de Snowflake conectada. El rol necesita USAGE en el almacén, la base de datos y el esquema, además de SELECT en las tablas o vistas que consulta tu app. En un conector para usuarios de la app, revisa el rol y los permisos de Snowflake de cada persona.

La conexión falla por una discrepancia en la URI de redirección

La URL de callback registrada en Snowflake no coincide con la que envía Base44. En los ajustes de Connectors del workspace, haz clic en View redirect URIs. Usa esta lista como el conjunto oficial de URL de callback de tu workspace. Comprueba que la integración está activada y compara sus URI de redirección registradas con la lista:

DESC SECURITY INTEGRATION BASE44_OAUTH;

Confirma que cada URI que muestra Base44 está registrada como OAUTH_REDIRECT_URI o en OAUTH_ALTERNATE_REDIRECT_URIS. Snowflake compara las URI de redirección carácter por carácter.Los conectores nuevos usan https://connectors.base44.com/api/oauth/callback. Los conectores antiguos pueden seguir usando callbacks por origen. Las conexiones de creador pueden usar https://app.base44.com/api/external-auth/callback. Las conexiones de usuarios de la app pueden usar una URL de callback por cada host de app. Mantén registradas en Snowflake todas las URI que aparecen en View redirect URIs hasta que el conector use la URL de callback compartida.

La conexión falla porque tu rol está bloqueado

Iniciaste sesión con un rol con privilegios. Snowflake impide por defecto que ACCOUNTADMIN, SECURITYADMIN, ORGADMIN y GLOBALORGADMIN usen la integración. Inicia sesión con un usuario normal de Snowflake.

Esta página fue traducida con IA. Para obtener la información más precisa y actualizada, consulta la versión en inglés.

Empezando

Superagentes

Creando tu app

Protegiendo tu app

Promocionando tu app

Conectores

Integraciones

Qué puedes hacer

Consultar datos del almacén

Crear paneles de analítica

Automatizar flujos de datos

Configurar OAuth en Snowflake

Conectar Snowflake

Alcances

Usar Snowflake en una función de backend

Conectores (documentación para desarrolladores)

Solución de problemas

​Qué puedes hacer

Consultar datos del almacén

Crear paneles de analítica

Automatizar flujos de datos

​Configurar OAuth en Snowflake

​Conectar Snowflake

​Alcances

​Usar Snowflake en una función de backend

Conectores (documentación para desarrolladores)

​Solución de problemas

Qué puedes hacer

Configurar OAuth en Snowflake

Conectar Snowflake

Alcances

Usar Snowflake en una función de backend

Solución de problemas