Microsoft Azure Data Lake Store

Gli strumenti Azure Data Lake consentono di connetterti a una risorsa Azure Data Lake Store ed eseguire la lettura/scrittura dei dati.
Utilizza lo strumento Input del file Azure Data Lake (ADL) per leggere i dati dai file contenuti in un Azure Data Lake Store (ADLS) nel flusso di lavoro Alteryx.
Per scrivere dati dal flusso di lavoro Alteryx in un file contenuto in un ADLS, utilizza lo strumento Output del file ADL. 
I formati di file supportati sono CSV, XLSX, JSON o Avro (per lo strumento Output, l'azione Aggiungi è supportata solo per il formato CSV).
Tutti questi strumenti, tranne quando si utilizza Chiave condivisa, eseguono l'autenticazione con un endpoint Azure Active Directory.

Autenticazione e autorizzazione

Gli endpoint Azure Data Lake per gli archivi Gen1 e Gen2 sono diversi, per cui durante l'autenticazione devi specificare a quale tipo di archivio desideri connetterti. In caso di dubbi sul tipo di archiviazione utilizzato, puoi rivolgerti all'amministratore di Azure o controllare sul portale di Microsoft Azure.

È necessario disporre delle autorizzazioni di lettura e scrittura dei dati all'interno di un account Azure Data Lake Store. Per ulteriori informazioni sull'assegnazione e l'applicazione di queste autorizzazioni, consulta la documentazione ufficiale Microsoft.

Single-tenancy e multi-tenancy

Le applicazioni single-tenant sono disponibili solo nel tenant in cui sono state registrate, noto anche come tenant principale. Tu o l'amministratore Azure potete creare applicazioni e storage Azure single-tenant sotto il vostro account che utilizzerete durante l'autenticazione in Designer. Le applicazioni multi-tenant sono disponibili per gli utenti sia nel proprio tenant principale che in altri tenant.

Utente finale (base)

L'autenticazione Utente finale di base costituisce il metodo più pratico per accedere ai dati ADLS in Designer. Contatta l'amministratore di Azure per consentire le applicazioni Alteryx pubbliche nel tenant di Azure dell'organizzazione. Consulta la documentazione Microsoft che ne descrive i passaggi. 

Tenant: common
ADLS Client ID for the Gen1 Alteryx application: 7fa1a397-27aa-40ad-b47c-a47fa9e600bd
ADLS Client ID for the Gen2 Alteryx application: 2584cace-63ff-47cb-96d2-d153704f4d75

Dopo questa configurazione, tu e i tuoi colleghi potete utilizzare le normali credenziali Microsoft per accedere ai dati ADLS.

Utente finale (avanzate)

L'autenticazione Utente finale (avanzate) supporta l'autenticazione single-tenant e multi-tenant e può essere utilizzata con applicazioni sia pubbliche che private.
Per la configurazione delle credenziali, consulta le istruzioni nella documentazione Microsoft.

Configurazione dell'autenticazione

• ID tenant: puoi ottenere l'ID tenant dal portale di Azure o affidarti al meccanismo di rilevamento automatico in Azure digitando "common" nel campo ID tenant. In caso di accesso a più tenant, puoi specificare l'ID tenant. Per ulteriori informazioni sul multi-tenancy, consulta la sezione Single-tenancy e multi-tenancy.
• ID client: l'identificatore univoco di un'applicazione Azure. Il campo ID client è obbligatorio. 
• Segreto client: se la tua applicazione è privata, è necessario fornire un segreto client. Se utilizzi un'applicazione pubblica, lascia vuoto il campo.

Da servizio a servizio

L'autenticazione Da servizio a servizio è adatta per la pubblicazione di flussi di lavoro su Server e Hub.
Per la configurazione delle credenziali, consulta le istruzioni nella documentazione Microsoft.

Chiave condivisa

Con un account di archiviazione di Azure, Microsoft genera due chiavi di accesso che possono essere utilizzate per autorizzare l'accesso ad Azure Data Lake tramite l'autenticazione Chiave condivisa. Ulteriori informazioni sulla chiave condivisa e sul suo utilizzo sono disponibili nella documentazione Microsoft. 

Cloud nazionali Azure ed endpoint personalizzati

A partire dalla versione v2.0, i connettori ADLS supportano l'accesso agli endpoint personalizzati. Gli URL per i cloud nazionali degli Stati Uniti e della Cina possono essere selezionati nella schermata di autenticazione dei connettori nel campo Endpoint dell'autorità di certificazione.

Configurazione dell'applicazione

Gli archivi file sono accessibili tramite applicazioni registrate. La registrazione dell'applicazione è necessaria per tutti i metodi di autenticazione, ad eccezione dell'autenticazione Utente finale (base) e Chiave condivisa. Per registrare l'applicazione sul portale di Azure, consulta le istruzioni sul portale della documentazione Microsoft.

Utilizza delle applicazioni Microsoft Azure in Alteryx Designer

1. Aggiungi Input del file Azure Data Lake o Output del file Azure Data Lake sul canvas di Designer.
2. Seleziona lo strumento per visualizzare il pannello Configurazione sulla destra.
3. Compila i dati di autenticazione con quelli disponibili su http://portal.azure.com/. Per spostarti nel portale di Azure, consulta la documentazione Microsoft.
4. Copia l'ID directory (tenant) e l'ID applicazione (client) in Designer
5. (Opzionale) Seleziona Usa Gen1 se desideri connetterti a un archivio Azure Data Lake Gen1.
6. Incolla il Segreto client se esegui la connessione in modalità Da servizio a servizio.
7. Seleziona Connetti.

Selezione dei dati e opzioni di configurazione

Nella scheda Dati puoi specificare i dati che desideri utilizzare:

1. Specifica il Nome account di archiviazione. Questo archivio deve essere dello stesso tipo (Gen1, Gen2) selezionato nella pagina di autenticazione. 
2. Per gli archivi Gen2 specifica il Nome file system.
3. Una volta selezionati l'archivio e il file system per Gen2, puoi configurare il percorso del file da leggere o scrivere. È possibile specificare il percorso tramite input diretto nel campo Percorso file oppure utilizzando l'utilità di selezione file. Per lo strumento Output del file Azure Data Lake, puoi utilizzare lo stesso meccanismo per creare un nuovo file. 
4. Per i file di Excel, puoi specificare il nome del foglio nel campo Foglio al di sotto dell'utilità di selezione file. Se lo lasci vuoto, verrà selezionato automaticamente il primo foglio. In caso di nuovi file, al foglio verrà assegnato il nome predefinito "Foglio".

Formati e configurazione dei file

Gli strumenti ADLS supportano i seguenti formati di dati: .csv, .avro, .json e .xlsx.

• File CSV
  • Leggere
  • Scrittura: puoi sovrascrivere un file esistente o aggiungervi dati 

• File JSON
  • Lettura: per leggere correttamente i file JSON, devono utilizzare la codifica UTF-8 senza BOM. 
  • Scrittura: la conversione del tipo di dati durante la scrittura nei file JSON presenta una limitazione: le celle di tipo Decimal, DateTime e Time vengono restituite come String.
• File Avro
  • Leggere
  • Scrivi
• File Excel
  • Lettura: tutti i dati vengono letti come V_Wstrings. 
  • Scrivi

Ulteriori dettagli

• In caso di stato senza accesso (lettura/scrittura) a una determinata cartella creata da un altro account, il problema è dovuto alle autorizzazioni.
• Se si verifica un errore che indica che il token potrebbe essere stato revocato, è necessario disconnettersi e quindi tornare al pannello di configurazione per eseguire nuovamente l'autenticazione.

In Azure Data Lake Explorer è necessario che siano state concesse autorizzazioni di lettura e scrittura dei dati all'interno di un account Azure Data Lake Store. Per ulteriori informazioni sull'assegnazione e l'applicazione di queste autorizzazioni, consulta la documentazione ufficiale Microsoft.