Procedure consigliate per la gestione degli assembly U-SQL in una pipeline CI/CD

Questo articolo illustra come gestire il codice sorgente dell'assembly U-SQL con il progetto di database U-SQL appena introdotto. Si apprenderà anche come configurare una pipeline di integrazione e distribuzione continua (CI/CD) per la registrazione degli assembly usando Azure DevOps.

Usare il progetto di database U-SQL per gestire il codice sorgente dell'assembly

Il progetto di database U-SQL è un tipo di progetto in Visual Studio che consente agli sviluppatori di sviluppare, gestire e distribuire i database U-SQL in modo rapido e semplice. È possibile gestire tutti gli oggetti di database U-SQL (ad eccezione delle credenziali) con il progetto di database U-SQL.

Per gestire il codice sorgente dell'assembly C# e gli script DDL U-SQL di registrazione dell'assembly, usare:

• Progetto di database U-SQL per gestire gli script U-SQL di registrazione dell'assembly.
• Libreria di classi (per l'applicazione U-SQL) per gestire il codice sorgente e le dipendenze C# per operatori, funzioni e aggregatori definiti dall'utente (UDO, UDF e UDAG).
• Progetto di database U-SQL per fare riferimento al progetto Libreria di classi.

Un progetto di database U-SQL può fare riferimento a un progetto libreria di classi (per l'applicazione U-SQL). È possibile creare assembly registrati nel database U-SQL usando il codice sorgente C# a cui si fa riferimento da questo progetto libreria di classi (per l'applicazione U-SQL).

Seguire questa procedura per creare progetti e aggiungere riferimenti.

1. Creare un progetto libreria di classi (per l'applicazione U-SQL) selezionando File>Nuovo>progetto. Il progetto si trova nel nodo U-SQL di Azure Data Lake>.

   

2. Aggiungere il codice C# definito dall'utente nel progetto Libreria di classi (per l'applicazione U-SQL).

3. Creare un progetto U-SQL selezionando File>Nuovo>progetto. Il progetto si trova nel nodoU-SQL di Azure Data Lake>.

   

4. Aggiungere un riferimento al progetto di libreria di classi C# per il progetto di database U-SQL.

   

   

5. Creare uno script di assembly nel progetto di database U-SQL facendo clic con il pulsante destro del mouse sul progetto e scegliendo Aggiungi nuovo elemento.

   

6. Apri lo script di assembly nella visualizzazione progettazione assembly. Selezionare l'assembly di riferimento dal menu a discesa Crea un assembly dal riferimento.

   

7. Aggiungere dipendenze gestite e file aggiuntivi, se presenti. Quando si aggiungono altri file, lo strumento usa il percorso relativo per assicurarsi che possa trovare gli assembly nel computer locale e nel computer di compilazione in un secondo momento.

@_DeployTempDirectory nella finestra dell'editor nella parte inferiore è una variabile predefinita che punta lo strumento alla cartella di output di compilazione. Nella cartella di output di compilazione, ogni assembly ha una sottocartella che porta il nome dell'assembly. Tutte le DLL e i file aggiuntivi si trovano in tale sottocartella.

Compilare un progetto di database U-SQL

L'output di compilazione per un progetto di database U-SQL è un pacchetto di distribuzione del database U-SQL. Viene denominato con il suffisso .usqldbpack. Il .usqldbpack pacchetto è un file .zip che include tutte le istruzioni DDL in un singolo script U-SQL nella cartella DDL. Tutti i file compilati .dll e i file aggiuntivi per gli assembly si trovano nella cartella Temp.

Distribuire un database U-SQL

Il .usqldbpack pacchetto può essere distribuito in un account locale o in un account Azure Data Lake Analytics. Usare Visual Studio o l'SDK di distribuzione.

Distribuire un database U-SQL utilizzando Visual Studio

È possibile distribuire un database U-SQL usando un progetto di database U-SQL o un .usqldbpack pacchetto in Visual Studio.

Eseguire la distribuzione usando un progetto di database U-SQL

1. Fare clic con il pulsante destro del mouse sul progetto di database U-SQL e quindi scegliere Distribuisci.

2. Nella procedura guidata Distribuisci database U-SQL selezionare l'account ADLA in cui si vuole distribuire il database. Sono supportati sia gli account locali che gli account ADLA.

3. L'origine del database viene compilata automaticamente. Punta al pacchetto .usqldbpack nella cartella di output di compilazione del progetto.

4. Immettere un nome in Nome database per creare un database. Se un database con lo stesso nome esiste già nell'account di Azure Data Lake Analytics di destinazione, tutti gli oggetti definiti nel progetto di database vengono creati senza creare nuovamente il database.

5. Per distribuire il database U-SQL, selezionare Invia. Vengono caricate tutte le risorse, ad esempio assembly e file aggiuntivi. Viene inviato un processo U-SQL che include tutte le istruzioni DDL.

   

   

Distribuire un database U-SQL in Azure DevOps

PackageDeploymentTool.exe fornisce le interfacce della programmazione e della riga di comando che consentono di distribuire database U-SQL. L'SDK è incluso nel pacchetto NuGet U-SQL SDK, disponibile in build/runtime/PackageDeploymentTool.exe.

In Azure DevOps è possibile usare un'attività della riga di comando e questo SDK per configurare una pipeline di automazione per l'aggiornamento del database U-SQL. Altre informazioni sull'SDK e su come configurare una pipeline CI/CD per la distribuzione del database U-SQL.

Passaggi successivi

• Configurare una pipeline CI/CD per Azure Data Lake Analytics
• Testare il codice di Azure Data Lake Analytics
• Eseguire script U-SQL nel computer locale