Dela via

Metodtips för att hantera U-SQL-sammansättningar i en CI/CD-pipeline

  • Artikel

I den här artikeln får du lära dig hur du hanterar U-SQL-sammansättningskällan med det nyligen introducerade U-SQL-databasprojektet. Du får också lära dig hur du konfigurerar en CI/CD-pipeline (kontinuerlig integrering och distribution) för sammansättningsregistrering med hjälp av Azure DevOps.

Viktigt

Azure Data Lake Analytics tillbaka den 29 februari 2024. Läs mer med det här meddelandet.

För dataanalys kan din organisation använda Azure Synapse Analytics eller Microsoft Fabric.

Använda U-SQL-databasprojektet för att hantera sammansättningskällans kod

U-SQL-databasprojektet är en projekttyp i Visual Studio som hjälper utvecklare att snabbt och enkelt utveckla, hantera och distribuera sina U-SQL-databaser. Du kan hantera alla U-SQL-databasobjekt (förutom autentiseringsuppgifter) med U-SQL-databasprojektet.

Om du vill hantera C#-sammansättningens källkod och DDL U-SQL-skript för sammansättningsregistrering använder du:

  • U-SQL-databasprojekt för att hantera U-SQL-skript för sammansättningsregistrering.
  • Klassbibliotek (för U-SQL-program) för att hantera C#-källkoden och beroenden för användardefinierade operatorer, funktioner och aggregeringar (UDF:er, UDF:er och UDAG:er).
  • U-SQL-databasprojekt som refererar till klassbiblioteksprojektet.

Ett U-SQL-databasprojekt kan referera till ett klassbiblioteksprojekt (för U-SQL-program). Du kan skapa sammansättningar som är registrerade i U-SQL-databasen med hjälp av refererad C#-källkod från det här klassbiblioteksprojektet (för U-SQL-program).

Följ de här stegen för att skapa projekt och lägga till referenser.

  1. Skapa ett klassbiblioteksprojekt (för U-SQL-program) genom att välja Nytt filprojekt>>. Projektet finns under Azure Data Lake > U-SQL-noden .

    Data Lake Tools för Visual Studio – Skapa C#-klassbiblioteksprojekt

  2. Lägg till din användardefinierade C#-kod i projektet Klassbibliotek (för U-SQL-program).

  3. Skapa ett U-SQL-projekt genom att välja Arkiv>Nytt>projekt. Projektet finns under Azure Data Lake>U-SQL-noden .

    Data Lake Tools för Visual Studio – Skapa U-SQL-databasprojekt

  4. Lägg till en referens till C#-klassbiblioteksprojektet för U-SQL-databasprojektet.

    Data Lake Tools för Visual Studio – Lägg till referens

    Data Lake Tools för Visual Studio – Lägg till U-SQL-databasprojektreferens

  5. Skapa ett sammansättningsskript i U-SQL-databasprojektet genom att högerklicka på projektet och välja Lägg till nytt objekt.

    Data Lake Tools för Visual Studio – Lägg till sammansättningsskript

  6. Öppna sammansättningsskriptet i vyn sammansättningsdesign. Välj den refererade sammansättningen från den nedrullningsbara menyn Skapa sammansättning från referensen .

    Data Lake Tools för Visual Studio – skapa sammansättning från referens

  7. Lägg till hanterade beroenden och ytterligare filer, om det finns några. När du lägger till ytterligare filer använder verktyget den relativa sökvägen för att se till att det kan hitta sammansättningarna på den lokala datorn och på byggdatorn senare.

@_DeployTempDirectory i redigeringsfönstret längst ned är en fördefinierad variabel som pekar verktyget till utdatamappen för kompilering. Under utdatamappen för kompilering har varje sammansättning en undermapp med namnet med sammansättningsnamnet. Alla DLL:er och ytterligare filer finns i undermappen.

Skapa ett U-SQL-databasprojekt

Byggutdata för ett U-SQL-databasprojekt är ett U-SQL-databasdistributionspaket. Det namnges med suffixet .usqldbpack. Paketet .usqldbpack är en .zip fil som innehåller alla DDL-instruktioner i ett enda U-SQL-skript i DDL-mappen. Alla byggda .dll filer och ytterligare filer för sammansättningar finns i temp-mappen.

Distribuera en U-SQL-databas

Paketet .usqldbpack kan distribueras till antingen ett lokalt konto eller ett Azure Data Lake Analytics-konto. Använd Visual Studio eller SDK för distribution.

Distribuera en U-SQL-databas i Visual Studio

Du kan distribuera en U-SQL-databas med hjälp av ett U-SQL-databasprojekt eller ett .usqldbpack paket i Visual Studio.

Distribuera med hjälp av ett U-SQL-databasprojekt

  1. Högerklicka på U-SQL-databasprojektet och välj sedan Distribuera.

  2. I guiden Distribuera U-SQL Database väljer du det ADLA-konto som du vill distribuera databasen till. Både lokala konton och ADLA-konton stöds.

  3. Databaskällan fylls i automatiskt. Den pekar på .usqldbpack-paketet i projektets utdatamapp.

  4. Ange ett namn i Databasnamn för att skapa en databas. Om det redan finns en databas med samma namn i Azure Data Lake Analytics-målkontot skapas alla objekt som definieras i databasprojektet utan att databasen skapas på nytt.

  5. Om du vill distribuera U-SQL-databasen väljer du Skicka. Alla resurser, till exempel sammansättningar och ytterligare filer, laddas upp. Ett U-SQL-jobb som innehåller alla DDL-instruktioner skickas.

    Data Lake Tools för Visual Studio – Distribuera U-SQL-databasprojekt

    Data Lake Tools för Visual Studio – guiden Distribuera U-SQL-databasprojekt

Distribuera en U-SQL-databas i Azure DevOps

PackageDeploymentTool.exe innehåller de programmerings- och kommandoradsgränssnitt som hjälper dig att distribuera U-SQL-databaser. SDK ingår i U-SQL SDK NuGet-paketet som finns på build/runtime/PackageDeploymentTool.exe.

I Azure DevOps kan du använda en kommandoradsuppgift och denna SDK för att konfigurera en automatiseringspipeline för U-SQL-databasuppdateringen. Läs mer om SDK och hur du konfigurerar en CI/CD-pipeline för distribution av U-SQL-databaser.

Nästa steg