Connettore a fiocco di neve

Interrogare le informazioni da Snowflake per utilizzarle con le applicazioni Tulip

Il connettore Snowflake semplifica le modalità di interrogazione delle informazioni da Snowflake Data Cloud. La documentazione dell'API REST di Snowflake SQL è disponibile qui.

Contatto di supporto

Questo connettore è stato creato in collaborazione con Spaulding Ridge. Per ulteriori informazioni o domande, contattare Spaulding Ridge all'indirizzo info@spauldingridge.com.

Note sul connettore

Il connettore Snowflake può manipolare singoli record con relativa facilità. Per interrogare più righe di dati o manipolare gli output di Tulip (tabella interattiva, ecc.) possono essere necessari widget personalizzati.

Snowflake OAuth utilizza il servizio OAuth integrato di Snowflake e supporta Tulip come client personalizzato. La documentazione di Snowflake OAuth è disponibile qui. I dettagli sulla configurazione del client personalizzato sono disponibili qui.

Configurazione

Questa sezione fornisce la procedura per configurare un token OAuth dal server OAuth di Snowflake per stabilire la connettività con Tulip come client, nonché i passaggi per impostare il connettore Snowflake in Tulip.

Registrare Tulip come applicazione client in Snowflake

1. Accedere alla propria istanza Snowflake con un utente che abbia il ruolo/privilegio di creare e gestire le integrazioni di sicurezza (ACCOUNTADMIN).
2. Creare un nuovo foglio di lavoro SQL nel magazzino COMPUTE_WH.
3. Eseguire il seguente script per creare un'integrazione di sicurezza di tipo OAuth. Non dimenticate di aggiornare i valori di INTEGRATION_NAME, TULIP_INSTANCE_NAME e TIME_IN_SECONDS.

CREATE OR REPLACE SECURITY INTEGRATION <INTEGRATION_NAME>TYPE = OAUTHENABLED = TRUEOAUTH_CLIENT = CUSTOMAUTH_CLIENT_TYPE = 'CONFIDENTIAL'OAUTH_REDIRECT_URI = 'https://<TULIP_INSTANCE_NAME>.tulip.co/oauth-redirect-handler'OAUTH_ISSUE_REFRESH_TOKENS = TRUEOAUTH_ISSUE_REFRESH_TOKEN_VALIDITY = <TIME_IN_SECONDS>;

Nota: La validità del token di aggiornamento può essere di 1 giorno (86400 secondi).

Raccogliere i dettagli della configurazione di OAuth in Tulip

1. Eseguire i seguenti comandi per descrivere l'integrazione di sicurezza appena creata eDESCRIBE SECURITY INTEGRATION ;
2. Scrivere i seguenti dettagli:OAUTH_CLIENT_IDOAUTH_REDIRECT_URIOAUTH_AUTHORIZATION_ENDPOINTOAUTH_TOKEN_ENDPOINT
3. Eseguire:SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('<NOME_INTEGRAZIONE>);

deve essere completamente capitilisede.es. non tulip_intergazione ma TULIP_INTEGRAZIONE

1. Scrivere:OAUTH_CLIENT_SECRET

Configurare il connettore Snowflake

1. Accedere a Tulip e aggiungere il connettore Snowflake dalla libreria Tulip (Web o Embedded ).
2. Fare clic nell'ambiente di produzione
3. Impostare le seguenti impostazioni:

Esecuzione su: Cloud Connector HostServer address: L'url del server del vostro account Snowflake nel formato .snowflakecomputing.comPercorso base: api/v2AuthenticationSelezionare il servizio o l'utente OAuthCodice di autorizzazione URL - OAUTH_AUTHORIZATION_ENDPOINT dal passaggio 2Access token URL - OAUTH_TOKEN_ENDPOINT dal passaggio 2Client ID - OAUTH_CLIENT_ID dal passaggio 2Client Secret - OAUTH_CLIENT_SECRET dal passaggio 2Selezionare le caselle di controllo perInvia l'intestazione dell'autenticazioneCodifica dell'ID client durante l'autenticazione

1. Fare clic su Test. Verrà visualizzata la finestra di accesso del proprio account Snowflake.

È necessario che un utente effettui il login. Si noti che il suo ruolo predefinito non deve essere ACCOUNTADMIN, SECURITYADMIN o ORGADMIN. È possibile modificare il ruolo predefinito degli utenti per OAuth, come spiegato in questa risorsa Snowflake: Gestire il consenso degli utenti per OAuth.

1. Dopo l'autenticazione, apparirà un messaggio di consenso. Si prega di leggerlo attentamente per comprendere l'operazione che si sta eseguendo, quindi fare clic su Consenti.

Ora siete in grado di connettervi in modo sicuro a Snowflake da Tulip!

Utilizzo

Avete due opzioni per iniziare a usare il connettore:

Iniziare a personalizzare le funzioni del modello di connettore in base alle proprie esigenze specifiche.

Seguire le istruzioni del test unitario di Snowflake per una dimostrazione pratica di come usare il connettore per attività quali: recuperare tutti i record di una tabella Snowflake in Tulip, creare un nuovo record, aggiornare un record esistente e cancellare un record.

Funzioni modello

Il connettore Library include le seguenti funzioni template:Template: Query DatabaseDescrizione: Permette di inviare una o più istruzioni SQL per l'esecuzione.Metodo: POSTEndpoint: /api/v2/statementsReference: https://docs.snowflake.com/en/developer-guide/sql-api/reference#post-api-v2-statementsTemplate: Controllare lo stato della queryDescrizione: Permette di verificare lo stato di esecuzione di un'istruzione.Metodo: GETEndpoint: /api/v2/statements/{statementHandle}Riferimento: https://docs.snowflake.com/en/developer-guide/sql-api/reference#get-api-v2-statements-statementhandleTemplate: Annullamento della queryDescrizione: Permette di annullare l'esecuzione di una dichiarazione.Metodo: POSTEndpoint: /api/v2/statements/{statementHandle}/cancelRiferimento: https://docs.snowflake.com/en/developer-guide/sql-api/reference#post-api-v2-statements-statementhandle-cancel

Riferimenti aggiuntivi

Questa guida di Snowflake Community fornisce un contesto aggiuntivo all'integrazione di Snowflake.