Estrarre dati dal task Snowflake

Informazioni sull’attività Estrarre dati da Snowflake

Snowflake è un software cloud dati di terze parti utilizzato per l’archiviazione, la gestione e la condivisione dei dati. È possibile importare dati da Snowflake da utilizzare in un flusso di lavoro Qualtrics.

Integrazione con Snowflake

Per utilizzare questa attività, è necessario creare una nuova integrazione in Snowflake e collegarla a Qualtrics.

Dove soggiornare a Snowflake

1. Accedi a Snowflake.
2. Nella scheda Fogli di lavoro, fare clic sul segno più ( + ) e selezionare Foglio di lavoro SQL.
3. Incollare il seguente codice nel foglio di lavoro:
   

   
   CREATE SECURITY 
   
   INTEGRATIONQUALTRICS_INTEGRATION_NAME_PUBLICAPI_G1TYPE = OAUTH
   
    OAUTH_CLIENT = CUSTOM
   
    OAUTH_CLIENT_TYPE = 'CONFIDENTIAL'
   
    OAUTH_REDIRECT_URI ='https://publicapist3.qualtrics.com/oauth-client-service/redirect'ENABLED
   
    = TRUE
   
    VALIDTH_ISAUENTHE_RE77TRESH_URI = TRUE
   
    VALIDTH_ISAUENTHE_RE77TRESH_URI

4. Sostituire la riga in grassetto QUALTRICS_INTEGRATION_NAME_PUBLICAPI_G1 con un nome per l’integrazione. Utilizzare solo lettere, numeri e trattini bassi per il nome dell’integrazione.
   
   Consiglio Q: copia il nome dell’integrazione perché ti servirà in seguito per completare la configurazione. Snowflake metterà automaticamente in maiuscolo ogni lettera nel nome dell’integrazione. Ad esempio, se chiamo la mia integrazione “Qualtrics ics_Integration”, verrà salvata come “QUALTRICS_INTEGRATION” in Snowflake. Questo è il nome che dovrei salvare per un secondo momento.
5. Sostituisci il bullded publicapist3 con informazioni sul tuo marchio. Queste informazioni saranno diverse a seconda che si desideri configurare una singola connessione all’interno del flusso di lavoro stesso o una connessione a livello di account nella scheda Amministrazione.
   • Se si crea una singola connessione, sostituirla con il proprio brandID.
     Esempio: se il mio brandID è “dsx”, allora il mio valore aggiornato è https://dsx.qualtrics.com/oauth-client-service/redirect’
   • Se si crea una connessione a livello di account, sostituirla con il proprio datacenterID.
     Esempio: se il mio datacenterID è “iad1”, allora il mio valore aggiornato è https://iad1.qualtrics.com/oauth-client-service/redirect’
6. Fare clic su Esegui.
7. Verrà visualizzato il messaggio “Integrazione “Nome dell’integrazione” creata correttamente”.
   
   Qtip: se ricevi un errore “privilegi insufficienti”, allora le tue autorizzazioni Snowflake devono essere aggiornate. Consulta questa pagina di supporto Snowflake per maggiori informazioni sulle autorizzazioni necessarie.
8. Nello stesso foglio di lavoro inserire il seguente codice:

   ​​​​DESCRIBE SECURITY INTEGRATION NAME_OF_SECURITY_INTEGRATION

9. Sostituire INTEGRATION NAME_OF_SECURITY_INTEGRATION in grassetto con il nome dell’integrazione in maiuscolo dalla fase 4.
10. Fare clic su Esegui.
11. Verrà presentata una serie di informazioni sull’integrazione. Copiare i valori per i seguenti campi:
    
    • OAUTH_AUTHORIZATION_ENDPOINT
    • OAUTH_TOKEN_ENDPOINT
    • OAUTH_CLIENT_ID
12. Nello stesso foglio di lavoro inserire il seguente codice:

    SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS(‘NAME_OF_SECURITY_INTEGRATION’)

13. Sostituire NAME_OF_SECURITY_INTEGRATION in grassetto con il nome dell’integrazione in maiuscolo dalla fase 4.
14. Fare clic su Esegui.
15. Copiare uno dei valori Chiave segreta client.

Imposta in Qualtrics

1. Se crei una connessione a livello di brand (ad esempio, un account Snowflake disponibile a tutti gli utenti nella tua licenza Qualtrics), vai al Estensioni sezione del Amministrazione e cercare l’integrazione Estrai dati da Snowflake.
2. Se si crea una singola connessione (ad esempio, un account Snowflake disponibile solo per te), naviga fino a Flussi di lavoro e creare un nuovo workflow ETL. Quando si seleziona il task dell’estrattore, selezionare il task Estrarre dati da Snowflake.
3. Fare clic su Aggiungi account se nella scheda Amministrazione o su Aggiungi un account utente se nell’attività del workflow. I passaggi rimanenti sono gli stessi indipendentemente dal punto in cui si sta configurando l’account.
   
4. Assegna un nome al tuo account in modo da poterlo identificare in un secondo momento.
   
5. Selezionare Codice di autorizzazione per il Tipo di sovvenzione.
6. Inserire i propri dettagli di autorizzazione:
   • ID client: OAUTH_CLIENT_ID copiato nel passo 10 della configurazione in Snowflake.
   • Chiave client segreta: il CLIENT_SECRET copiato nel passaggio 14 di Setup in Snowflake.
   • Punto di accesso token: OAUTH_TOKEN_ENDPOINT copiato nel passo 10 della configurazione in Snowflake.
   • Punto di accesso di autorizzazione: OAUTH_AUTHORIZATION_ENDPOINT copiato nel passo 10 della configurazione in Snowflake.
   • Ambiti (facoltativo): è possibile utilizzare gli ambiti per limitare il livello di accesso. Per la maggior parte dei casi di utilizzo, è possibile lasciarlo vuoto.
7. Fare clic su Connetti account.
8. Si aprirà una finestra per accedere a Snowflake. Immettere il nome utente e la password Snowflake.
9. Fare clic su Accedi.

Configurazione di un’estrazione di dati dal task Snowflake

1. Seguire le istruzioni collegate per creare un nuovo flusso di lavoro ETL.
2. Per il task del workflow, selezionare il task Estrarre dati da Snowflake.
3. Scegli l’account Snowflake che hai collegato in precedenza.
   
4. Fare clic su Successivo.
5. Immettere le seguenti informazioni sui dati da importare da Snowflake:
   
   • Modello nome file: stringa di testo utilizzata per identificare i file da importare.
     Consiglio Q: ti consigliamo di includere “Qualtrics” all’inizio di tutti i file che desideri importare. È quindi possibile inserire “Qualtrics” per questo campo per importare tutti i file rilevanti.
   • Directory di prelievo: la directory Snowflake che contiene i file.
     Consiglio Q: se il file si trova nello stadio base, è possibile lasciare vuoto questo campo.
   • Identificatore account: l’identificatore dell’account Snowflake del database che contiene i file da importare.
   • Identificatore del database: l’identificatore del database Snowflake del database che contiene i file da importare.
   • Identificatore schema: l’identificatore dello schema Snowflake dello schema che contiene il file da importare.
   • Nome fase: il nome della fase Snowflake che contiene i file da importare.
6. Se lo si desidera, attivare Skip bad files. Quando sono abilitati, i file danneggiati e i file che non corrispondono alle intestazioni vengono ignorati.
7. È necessario caricare un file campione che contenga il formato generale dei dati che si desidera importare in Qualtrics. Fai clic su Scegli file e seleziona il file sul computer.
   Consiglio Q: Se necessario, è possibile scaricare uno dei file di esempio elencati all’interno nella finestra delle attività.
8. Fare clic su Carica.
9. Rivedi il tuo file di esempio per assicurarti che tutto sia corretto.
   Consiglio Q: Se è necessario modificare il file, fare clic su Indietro nell’angolo in alto a sinistra.
10. Fai clic su Salva.
11. Selezionare il task del caricatore, che determina dove vengono salvati i dati. Consultare Attività caricatore disponibile per ulteriori informazioni sulle opzioni disponibili.