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

  • Articolo

In questo articolo viene illustrato come gestire il codice sorgente degli assembly U-SQL con il progetto di database U-SQL appena introdotto. Viene anche illustrato come configurare una pipeline di integrazione continua e distribuzione continua (CI/CD) per la registrazione degli assembly tramite Azure DevOps.

Importante

Azure Data Lake Analytics ritirato il 29 febbraio 2024. Altre informazioni con questo annuncio.

Per l'analisi dei dati, l'organizzazione può usare Azure Synapse Analytics o Microsoft Fabric.

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

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

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

  • Il progetto di database U-SQL per gestire gli script U-SQL di registrazione degli assembly.
  • La libreria di classi (per l'applicazione U-SQL) per gestire il codice sorgente C# e le dipendenze per gli operatori, le funzioni e gli aggregatori definiti dall'utente.
  • Il 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 gli assembly registrati nel database U-SQL usando il codice sorgente C# di riferimento da questo progetto libreria di classi (per l'applicazione U-SQL).

Seguire questi passaggi 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>.

    Strumenti Data Lake per Visual Studio - Creare il progetto libreria di classi C#

  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>.

    Progetto di database U-SQL di Data Lake Tools per Visual Studio-Create U-SQL

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

    Data Lake Tools per Visual Studio - Aggiungere informazioni di riferimento

    Data Lake Tools per Visual Studio - Aggiungere informazioni di riferimento sul 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 selezionando Aggiungi nuovo elemento.

    Strumenti Data Lake per Visual Studio - Aggiungere lo script dell'assembly

  6. Aprire lo script di assembly nella visualizzazione di progettazione assembly. Selezionare l'assembly a cui si fa riferimento dal menu a discesa Crea assembly dal menu a discesa di riferimento.

    Strumenti Data Lake per Visual Studio--crea assembly da riferimento

  7. Aggiungere eventuali dipendenze gestite e file aggiuntivi. Quando si aggiungono file, lo strumento usa il percorso relativo per assicurarsi di poter trovare gli assembly sul computer locale e sul computer di compilazione in un momento successivo.

@_DeployTempDirectory nella finestra dell'editor nella parte inferiore è una variabile predefinita che punta lo strumento alla cartella di output della compilazione. Nella cartella di output della compilazione ogni assembly dispone di una sottocartella il cui nome fa riferimento a quello dell'assembly. Tutte le DLL e i file aggiuntivi si trovano in quella sottocartella.

Compilare un progetto di database U-SQL

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

Distribuire un database U-SQL

Il pacchetto .usqldbpack 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 in Visual Studio

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

Distribuire usando un progetto di database U-SQL

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

  2. Nella Distribuzione guidata database U-SQL selezionare l'account ADLA in cui distribuire il database. Gli account locali e gli account ADLA sono entrambi supportati.

  3. Origine database viene compilato automaticamente. Punta al pacchetto .usqldbpack nella cartella di output della compilazione del progetto.

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

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

    Strumenti Azure Data Lake per Visual Studio--Distribuisci progetto di database U-SQL

    Strumenti Azure Data Lake per Visual Studio--Distribuzione guidata progetto di database U-SQL

Distribuire un database U-SQL in Azure DevOps

PackageDeploymentTool.exe offre le interfacce di 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 di database U-SQL.

Passaggi successivi