Connettere Snowflake alla tua app

Connetti Snowflake alla tua app Base44 per interrogare i dati del warehouse, eseguire analisi e usare i risultati in dashboard, report e workflow.

Ti serve un piano Builder o superiore per usare i connettori nella tua app.

Cosa puoi fare

Interroga i dati del warehouse

Esegui SQL sul tuo warehouse Snowflake e mostra i risultati nella tua app.

Costruisci dashboard di analisi

Mostra i risultati del warehouse in grafici, tabelle e dashboard.

Automatizza i workflow dei dati

Usa le query Snowflake nei workflow, ad esempio per inviare un avviso a un canale Slack quando una metrica cala.

Prompt di esempio per la chat AI

Query sales data from my Snowflake warehouse and display results.

Run an analytics report on customer data stored in Snowflake.

Fetch inventory levels from the Snowflake data warehouse.

Execute a SQL query to analyze trends in my Snowflake tables.

Configurare OAuth in Snowflake

L’OAuth di Snowflake usa una security integration. Creala in Snowflake prima di registrare il connettore in Base44.

Copia i tuoi redirect URI

Nel tuo workspace Base44, vai in Settings > Connectors e clicca View redirect URIs. Copia tutti gli URI mostrati.

Crea la security integration OAuth

Usa ACCOUNTADMIN o un ruolo con il privilegio globale CREATE INTEGRATION. Questo esempio usa ACCOUNTADMIN. Se usi un altro ruolo, sostituisci la prima istruzione.

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;

Questo imposta i refresh token a 90 giorni, il valore predefinito e massimo di Snowflake.Se View redirect URIs elenca URL aggiuntivi per connessioni esistenti, aggiungili tutti a OAUTH_ALTERNATE_REDIRECT_URIS in questa istruzione CREATE SECURITY INTEGRATION.

Ottieni i dettagli della connessione

Se scegli un altro nome per l’integrazione, usalo nelle istruzioni SQL successive.Leggi il Client ID e il 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 il pulsante di copia della cella per entrambi i valori. Il Client ID spesso termina con = e omettere quel carattere interrompe la connessione. L’output include anche OAUTH_CLIENT_SECRET_2 come riserva per la rotazione, quindi usa il primo secret.Ottieni l’identificatore dell’account Snowflake da inserire in Base44:

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

Prepara l'identità Snowflake

Usa un’identità Snowflake normale con DEFAULT_ROLE e DEFAULT_WAREHOUSE impostati. Il suo ruolo deve avere accesso ai database e agli oggetti interrogati dalla tua app e il permesso di usare il warehouse.Per impostazione predefinita, Snowflake impedisce a ACCOUNTADMIN, SECURITYADMIN, ORGADMIN e GLOBALORGADMIN di usare questa integrazione. È un’impostazione di sicurezza predefinita di Snowflake, non una restrizione di Base44.

Hai già un'integrazione OAuth?

Usa ALTER per modificare un’integrazione esistente. CREATE OR REPLACE la elimina e la ricrea, quindi non usarlo per cambiare un redirect URI.Se l’integrazione esiste già e devi solo aggiornare l’URL di callback, esegui invece questo:

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

Se View redirect URIs mostra URL per connessioni esistenti, includi tutti gli URL aggiuntivi in OAUTH_ALTERNATE_REDIRECT_URIS. Mantieni gli URL alternativi già registrati.

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

Connettere Snowflake

Registra Snowflake una volta a livello di workspace. Poi usalo come connessione condivisa per i costruttori oppure lascia che ogni utente dell’app si connetta con la propria identità Snowflake.

Prima di iniziare:

Integrazione OAuth di Snowflake: crea una security integration OAuth in Snowflake per ottenere un Client ID e un Client Secret. Consulta Configurare OAuth in Snowflake.
Identificatore dell’account Snowflake: usa il formato orgname-account_name, ad esempio nzajreo-sp04035. Non usare il vecchio account locator. Inserisci questo valore in Snowflake Account. Le funzioni backend lo leggono come connectionConfig.subdomain.
Accesso al workspace Base44: devi essere owner o admin del workspace per registrare il connettore in Base44.
Accesso a Snowflake: ogni persona che si connette deve avere accesso ai database che vuoi interrogare.

Per costruttori di app
Per utenti dell'app

Connetti Snowflake una volta a livello di workspace quando la tua app deve usare un’unica identità Snowflake condivisa.Per aggiungere Snowflake dalle impostazioni del workspace:

Clicca il nome del workspace in basso a sinistra.
Clicca Settings.
Clicca Connectors sotto Build tools.
Sotto Connectors For App Builders, trova Snowflake.
Clicca Add accanto al connettore.
Verifica che l’URL di callback https://connectors.base44.com/api/oauth/callback sia impostato nella tua integrazione OAuth di Snowflake.
Inserisci un Connector name per identificare questo connettore.
Inserisci Client ID e Client Secret, poi svuota Additional scopes se il campo è precompilato.
Inserisci l’identificatore Snowflake Account, nel formato orgname-account_name.
Clicca Add Connector.

Puoi anche configurare la connessione condivisa dalla chat AI in un’app. Descrivi cosa vuoi costruire e, quando richiesto, fornisci gli stessi dettagli del connettore.

Lascia che ogni persona si connetta a Snowflake con la propria identità. Registra il connettore Snowflake una volta a livello di workspace. Snowflake applica ruolo, warehouse e permessi di ciascuna persona quando si connette.Gli utenti dell’app possono connettersi con identità Snowflake diverse, ma ogni identità deve appartenere all’account Snowflake configurato per quel connettore. Per usare un altro account Snowflake, registra un connettore Snowflake separato con quell’identificatore di account.Per aggiungere Snowflake per gli utenti dell’app:

Clicca il nome del workspace in basso a sinistra.
Clicca Settings.
Clicca Connectors sotto Build tools.
Sotto Connectors For App Users, clicca Add Connector.
Clicca Snowflake.
Inserisci un Connector name, poi Client ID e Client Secret della tua integrazione OAuth di Snowflake.
Svuota Additional scopes se il campo è precompilato.
Inserisci l’identificatore Snowflake Account, nel formato orgname-account_name.
Clicca Add Connector.
Apri il connettore Snowflake e attiva App user connections.
Chiedi alla chat AI di aggiungere un modo per connettere e disconnettere Snowflake nella tua app.

Scope

Base44 aggiunge

refresh_token

Aggiorna la connessione senza un nuovo accesso.

Tu configuri

Additional scopes:

Lascia vuoto questo campo. Cancella qualsiasi valore precompilato prima di aggiungere il connettore. Snowflake rifiuta i valori non supportati, come account:read, con The requested scope is invalid.

Role scopes:

Non aggiungere session:role:<role> in Base44. Snowflake usa il ruolo predefinito dell’identità che autorizza.

Accesso: Snowflake usa il ruolo e i permessi dell’identità che autorizza la connessione.

Usare Snowflake in una funzione backend

Una volta connesso Snowflake, le tue funzioni backend possono recuperare un token di accesso e interrogare il warehouse. Base44 gestisce il flusso OAuth e l’archiviazione delle credenziali.

Per costruttori di app
Per utenti dell'app

Usa getWorkspaceConnection(connectorId) quando la tua app usa un’unica identità Snowflake condivisa.

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) quando ogni persona si connette con la propria identità 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 });
});

Connettori (documentazione per sviluppatori)

Recupera una connessione, leggi i suoi dettagli e chiama l’API del servizio da una funzione backend.

Risoluzione dei problemi

Le query falliscono con un errore di warehouse o di accesso

Controlla DEFAULT_ROLE e DEFAULT_WAREHOUSE dell’identità Snowflake connessa. Il ruolo ha bisogno di USAGE su warehouse, database e schema, più SELECT sulle tabelle o viste interrogate dalla tua app. Per un connettore per utenti dell’app, controlla ruolo e grant Snowflake di ciascuna persona.

La connessione fallisce per una mancata corrispondenza del redirect URI

L’URL di callback registrato in Snowflake non corrisponde a quello inviato da Base44. Nelle impostazioni Connectors del workspace, clicca View redirect URIs. Usa questo elenco come riferimento ufficiale degli URL di callback del tuo workspace. Verifica che l’integrazione sia attiva e confronta i redirect URI registrati con l’elenco:

DESC SECURITY INTEGRATION BASE44_OAUTH;

Verifica che ogni URI mostrato da Base44 sia registrato come OAUTH_REDIRECT_URI o in OAUTH_ALTERNATE_REDIRECT_URIS. Snowflake confronta i redirect URI carattere per carattere.I nuovi connettori usano https://connectors.base44.com/api/oauth/callback. I connettori meno recenti possono ancora usare callback per origine. Le connessioni dei costruttori possono usare https://app.base44.com/api/external-auth/callback. Le connessioni degli utenti dell’app possono usare un URL di callback per ogni host dell’app. Mantieni registrati in Snowflake tutti gli URI mostrati in View redirect URIs finché il connettore non usa l’URL di callback condiviso.

La connessione fallisce perché il tuo ruolo è bloccato

Hai effettuato l’accesso con un ruolo privilegiato. Per impostazione predefinita, Snowflake impedisce a ACCOUNTADMIN, SECURITYADMIN, ORGADMIN e GLOBALORGADMIN di usare l’integrazione. Accedi invece con un utente Snowflake normale.

Questa pagina è stata tradotta con l’AI. Per le informazioni più accurate e aggiornate, consulta la versione inglese.

Per iniziare

Superagenti

Creare la tua app

Proteggere la tua app

Promuovere la tua app

Connettori

Integrazioni

Cosa puoi fare

Interroga i dati del warehouse

Costruisci dashboard di analisi

Automatizza i workflow dei dati

Configurare OAuth in Snowflake

Connettere Snowflake

Scope

Usare Snowflake in una funzione backend

Connettori (documentazione per sviluppatori)

Risoluzione dei problemi

​Cosa puoi fare

Interroga i dati del warehouse

Costruisci dashboard di analisi

Automatizza i workflow dei dati

​Configurare OAuth in Snowflake

​Connettere Snowflake

​Scope

​Usare Snowflake in una funzione backend

Connettori (documentazione per sviluppatori)

​Risoluzione dei problemi

Cosa puoi fare

Configurare OAuth in Snowflake

Connettere Snowflake

Scope

Usare Snowflake in una funzione backend

Risoluzione dei problemi