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

  • Artikel
  • 3 minuter för att läsa

I den här artikeln får du lära dig att hantera käll koden för U-SQL-sammansättningen med det nyligen introducerade U-SQL Database-projektet. Du lär dig också hur du konfigurerar en pipeline för kontinuerlig integrering och distribution (CI/CD) för sammansättnings registrering med hjälp av Azure-DevOps.

Använd U-SQL Database-projektet för att hantera käll koden för sammansättningen

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

Använd följande om du vill hantera C#-sammansättningens käll kod och DDL-skript för sammansättnings registrering:

  • U-SQL Database-projekt för att hantera U-SQL-skript för sammansättnings registrering.
  • Klass bibliotek (för U-SQL-program) för att hantera C#-källkoden och beroenden för användardefinierade operatorer, Functions och aggregator (Katalogentiteter, UDF: er och UDAGs).
  • U-SQL Database-projekt för att referera till klass biblioteks projektet.

Ett U-SQL Database-projekt kan referera till ett klass bibliotek (för U-SQL Application)-projekt. Du kan skapa sammansättningar som registrerats i U-SQL-databasen med refererad C#-källkod från det här klass biblioteket (för U-SQL Application)-projekt.

Följ dessa steg om du vill skapa projekt och lägga till referenser.

  1. Skapa ett klass bibliotek (för U-SQL Application)-projekt genom att välja Arkiv > nytt > projekt. Projektet finns under Azure Data Lake > U-SQL -noden.

    Data Lake verktyg för Visual Studio – skapa C#-klass biblioteks projekt

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

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

    Data Lake verktyg för Visual Studio – skapa U-SQL Database-projekt

  4. Lägg till en referens i C#-klass biblioteks projektet för U-SQL Database-projektet.

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

    Data Lake verktyg för Visual Studio – Lägg till projekt referens för U-SQL-databasen

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

    Data Lake verktyg för Visual Studio – Lägg till sammansättnings skript

  6. Öppna sammansättnings skriptet i vyn sammansättnings design. Välj den refererade sammansättningen från den nedrullningsbara menyn skapa sammansättning från referens .

    Data Lake verktyg 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 kontrol lera att det går att hitta sammansättningarna på den lokala datorn och på Build-datorn senare.

@ _DeployTempDirectory i redigerings fönstret längst ned är en fördefinierad variabel som pekar på verktyget för mappen för att bygga utdata. Under mappen för att bygga utdata har varje sammansättning en undermapp med namnet med sammansättnings namnet. Alla DLL-filer och ytterligare filer finns i undermappen.

Bygg ett U-SQL Database-projekt

Build-utdata för ett U-SQL Database-projekt är ett U-SQL-databasens distributions paket. Den har namnet med suffixet .usqldbpack . .usqldbpackPaketet är en. zip-fil som innehåller alla DDL-instruktioner i ett enda U-SQL-skript i DDL-mappen. Alla inbyggda DLL-filer och ytterligare filer för sammansättningar finns i Temp-mappen.

Distribuera en U-SQL-databas

.usqldbpackPaketet 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 ett U-SQL Database-projekt eller ett .usqldbpack paket i Visual Studio.

Distribuera med hjälp av ett U-SQL Database-projekt

  1. Högerklicka på U-SQL Database-projektet 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. Databas källan fylls i automatiskt. Den pekar på. usqldbpack-paketet i projektets mapp för build-utdata.

  4. Ange ett namn i databas namn för att skapa en databas. Om det redan finns en databas med samma namn i mål Azure Data Lake Analyticss kontot, skapas alla objekt som definieras i databas projektet utan att databasen skapas igen.

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

    Data Lake verktyg för Visual Studio – distribuera U-SQL Database-projekt

    Data Lake verktyg för Visual Studio – distribuera U-SQL Database projekt guide

Distribuera en U-SQL-databas i Azure DevOps

PackageDeploymentTool.exe tillhandahåller programmerings-och kommando rads gränssnitt som hjälper till att distribuera U-SQL-databaser. SDK ingår i U-SQL SDK NuGet-paketetsom finns på build/runtime/PackageDeploymentTool.exe .

I Azure DevOps kan du använda en kommando rad uppgift och denna SDK för att konfigurera en automatiserings pipeline för U-SQL Database-uppdateringen. Lär dig mer om SDK och hur du konfigurerar en CI/CD-pipeline för distribution av U-SQL-databasen.

Nästa steg