Snowflake

Strumenti Alteryx utilizzati per Connect

• Strumento Dati di output (elaborazione flusso di lavoro standard)
• Strumento Connetti In-DB e Strumento Flusso di dati in entrata (elaborazione del flusso di lavoro In-Database)

Strumento Dati di input

1. Seleziona lo strumento Dati di input e accedi al riquadro Dati di input (1) - Configurazione > seleziona l'icona dell'elenco a discesa in Connetti un file o un database.
2. Accedi alla finestra Connessioni dati > Tutte le origini dati > Snowflake > ODBC.
3. Nella finestra pop-up Connessione ODBC Snowflake, immetti il nome utente e la password.
4. Nella finestra Scegli una tabella o specifica una query, seleziona la scheda Tabelle > seleziona una tabella > seleziona OK.

Modalità classica

Se desideri lavorare nella modalità classica, accedi a Opzioni > Impostazioni utente > Modifica impostazioni utente > seleziona la casella di spunta Utilizza la modalità classica per le opzioni di menu degli strumenti di input/output.

1. Per specificare una query, seleziona la scheda Editor SQL > immetti la query nello spazio disponibile > seleziona il pulsante Test query > seleziona OK.
2. Seleziona lo strumento Dati di output e accedi al menu > Opzioni.
3. Seleziona Impostazioni utente > Modifica impostazioni utente > seleziona la casella di spunta Utilizza la modalità classica per le opzioni di menu degli strumenti di input/output.
4. Accedi al riquadro Dati di output (1) - Configurazione > in Scrivi nel file o nel database > seleziona l'icona del menu a discesa.
5. Seleziona Altri database > seleziona Snowflake Bulk....

6. Puoi anche utilizzare lo strumento Dati di input (modalità classica) per selezionare i file e le origini dati. 

Per passare alla modalità classica, sostituisci lo strumento Dati di output con un nuovo strumento > seleziona il canvas o F5 per aggiornare.

Strumento Dati di output

Per supportare completamente la lettura e la scrittura di tabelle e colonne, imposta l'opzione Stile SQL di Tabella/Nome campo di Alteryx Designer su Tra virgolette. L'opzione "Tra virgolette" consente di selezionare specificamente la tabella nel database, mentre l'opzione Nessuno consente di ottenere risultati tutti in lettere maiuscole. 

Prima di configurare una connessione Snowflake Bulk, consulta le seguenti informazioni:

• Puoi scrivere i dati solo con Snowflake Bulk Loader.
• Dopo aver scritto i dati nel nuovo output, Snowflake Bulk Loader rimuove i dati scritti dal contenitore S3.

Configurazione di una connessione ODBC

1. In Amministrazione origine dati ODBC, seleziona il driver Snowflake e scegli Configura.
2. Immetti le credenziali e le impostazioni di connessione.
3. Seleziona OK per salvare la connessione.

Configurazione di una connessione Snowflake Bulk per scrivere dati

1. Seleziona lo strumento Dati di output e accedi al riquadro Dati di output (1) - Configurazione.
2. In Scrivi nel file o nel database, seleziona l'icona del menu a discesa > accedi alla finestra Connessioni dati per selezionare la scheda Origini dati > Tutte le origini dati > Snowflake > seleziona Bulk.
3. Nella finestra Connessione Snowflake Bulk, seleziona la scheda Locale > immetti le tue credenziali negli spazi Nome utente (facoltativo) e Password (facoltativa) > seleziona OK per visualizzare la finestra pop-up Tabella di output.
4. Immetti il nome della tabella (o del foglio di lavoro) per il file di output specificato, con il nome della tabella o nel formato db.schema.tablename: si tratta della tabella completa.
5. In Opzioni, nel riquadro Dati di output (1) - Configurazione, seleziona dal menu a discesa Stile SQL di Tabella/Nome campo Tra virgolette o Nessuno.
6. In Prendi il nome file/tabella dal campo, scegli se selezionare la relativa casella di spunta per il menu a discesa Aggiungi suffisso a nome file/tabella. Se selezioni la casella di spunta, dalle selezioni a discesa scegli...
   1. Aggiungi suffisso a nome file/tabella.
   2. Anteponi un prefisso al nome file/tabella.
   3. Modifica file/nome tabella
   4. Modifica intero percorso del file.
7. Se selezioni la casella di spunta Aggiungi suffisso a nome file/tabella, in Campo che contiene il nome del file o parte del nome del file, scegli di utilizzare una delle seguenti opzioni:
   1. SEQUENCE_CATALOG
   2. SEQUENCE_SCHEMA
   3. SEQUENCE_NAME
   4. SEQUENCE_OWNER
   5. DATA_TYPE
   6. NUMERIC_PRECISION
   7. NUMERIC_PRECISION_RADIX
   8. NUMERIC_SCALE
   9. START_VALUE
   10. MINIMUM_VALUE
   11. MAXIMUM_VALUE
   12. NEXT_VALUE
   13. INCREMENT
   14. CYCLE_OPTION
   15. CREATED
   16. LAST_ALTERED
   17. COMMENT
8. Decidi se selezionare la casella di spunta Mantieni il campo nell'output per l'opzione selezionata dal menu a discesa da utilizzare con i dati della tabella.

Metodi per lo staging dei dati con la connessione di Snowflake Bulk

Configurazione della connessione di Snowflake Bulk per scrivere su Amazon S3

1. Dalla finestra Dati di output - Configurazione, seleziona Scrivi nel file o nel database e seleziona Altri database > Snowflake Bulk per visualizzare la finestra Connessione di Snowflake Bulk.
2. Seleziona un Nome origine dati o Amministratore ODBC per crearne uno. Vedere Connessioni al database ODBC e OLEDB.
3. Immetti nome utente e password, se necessario.
4. In Amazon S3, immetti la chiave di accesso AWS e la chiave segreta AWS.
5. Da Crittografia chiave segreta, seleziona un'opzione di crittografia:
   • Nascondi: nasconde la password utilizzando la crittografia minima.
   • Crittografa per computer: qualsiasi utente del computer ha accesso completo alla connessione.
   • Crittografa per l'utente: l'utente connesso ha accesso completo alla connessione su qualsiasi computer.
6. Da Endpoint, seleziona una delle seguenti opzioni:
   • Predefinito: Amazon determina l'endpoint in base al contenitore selezionato.
   • Endpoint specifico: per specificare un'area S3 in cui risiede il contenitore, specifica un endpoint personalizzato o selezionalo dagli endpoint precedentemente immessi.
     • Il contenitore S3 deve trovarsi nell'area S3 specificata. In caso contrario, viene visualizzato il seguente errore: Il contenitore a cui stai tentando di accedere deve essere gestito utilizzando l'endpoint specificato. Invia tutte le richieste future a questo endpoint.
     • Seleziona Predefinito per chiudere la finestra di errore.
7. (Facoltativo) Seleziona Usa Signature V4 per l'autenticazione per aumentare il livello di sicurezza fornito dalla versione Signature 2 predefinita. Questa opzione è abilitata automaticamente per le aree che richiedono Signature Version 4. Le aree create dopo il 30 gennaio 2014 supportano solo Signature Version 4. Le aree seguenti richiedono l'autenticazione Signature Version 4:
   • Regione degli Stati Uniti orientali (Ohio)
   • Regione Canada (centrale)
   • Regione Asia-Pacifico (Mumbai)
   • Regione Asia-Pacifico (Seul)
   • Regione UE (Francoforte)
   • Regione UE (Londra)
   • Regione Cina (Pechino)
8. Seleziona un metodo di crittografia lato server per il caricamento in un contenitore Amazon S3 crittografato. Consulta la Guida per gli sviluppatori di Amazon Simple Storage Service.
   • Nessuno (opzione predefinita): non viene utilizzato alcun metodo di crittografia.
   • SSE-KMS: utilizzare la crittografia lato server con le chiavi gestite da AWS KMS. Puoi fornire anche un ID chiave KMS. Quando selezioni questo metodo, l'opzione Usa Signature V4 per l'autenticazione è abilitata per impostazione predefinita.
9. Immetti il nome contenitore del contenitore AWS in cui sono archiviati gli oggetti dati.
10. Configura ulteriori opzioni di formato file nel riquadro Dati di output (1) - Configurazione. Consulta Opzioni formato file.

Configurazione della connessione di Snowflake Bulk per scrivere nell'archivio locale

Ora hai tre opzioni avanzate tra cui scegliere quando esegui lo staging dei dati nell'archivio locale.

Seleziona lo strumento Dati di output e accedi al riquadro Dati di output (1) - Configurazione > in Scrivi nel file o nel database, accedi alla finestra Connessioni dati e seleziona la scheda Origini dati > Tutte le origini dati > Snowflake > seleziona Bulk. Nella finestra Connessione di Snowflake Bulk > seleziona la scheda Locale >

1. Fase utente: la fase interna fornita da Snowflake, associata all'utente.
   1. Seleziona Utente > seleziona OK.  Nella finestra pop-up Tabella di output, immetti il nome della tabella (o del foglio di lavoro) per il formato del file di output specificato con il nome della tabella o nel formato db.schema.tablename: si tratta della tabella completa. Seleziona OK. In Opzioni nel riquadro Dati di output (1) - Configurazione seleziona dal menu a discesa Stile SQL di Tabella/Nome campo Tra virgolette o Nessuno.
2. Fase tabella: la fase interna fornita da Snowflake, associata alla tabella.
   1. Seleziona Fase tabella > seleziona OK.  Nella finestra pop-up Tabella di output, immetti il nome della tabella (o del foglio di lavoro) per il formato del file di output specificato con il nome della tabella o nel formato db.schema.tablename: si tratta della tabella completa. Seleziona OK. In Opzioni nel riquadro Dati di output (1) - Configurazione seleziona dal menu a discesa Stile SQL di Tabella/Nome campo Tra virgolette o Nessuno.
      1. Fase nome interno: nel database Snowflake, crea ed esegui un comando CREATE STAGE, quindi fornisci il nome della fase alla configurazione dello strumento.

         La dimensione massima del campo è di 16 MB. Se la soglia delle dimensioni del campo viene superata, viene generato un errore e non vengono scritti dati.

          

3. Tipo di compressione: le opzioni sono "Nessuna compressione" o "Comprimi con GZip".
   1. Nessuna compressione: viene eseguito lo staging dei file e questi vengono caricati come CSV
   2. Compressione con GZIP: i file CSV sono compressi con GZIP
4. Dimensione blocco in MB (1-999): questa opzione consente di selezionare le dimensioni di ogni CSV per cui viene eseguito lo staging localmente.

   Le dimensioni effettive del file possono variare rispetto alle dimensioni del blocco selezionato a causa della formattazione e della compressione sottostanti.

    

5. Numero di thread (1-99): questa opzione specifica il numero di thread da utilizzare per caricare i file su Snowflake. Le prestazioni possono migliorare per i file più grandi quando questo valore aumenta. Se immetti 0, viene utilizzata l'impostazione predefinita di Snowflake (4).

Ulteriori informazioni sulle opzioni per tipo di compressione, dimensione del blocco in MB enumero di thread sono disponibili nel portale Snowflake.