Share via

Aanbevolen procedures voor het beheren van U-SQL-assembly's in een CI/CD-pijplijn

  • Artikel

In dit artikel leert u hoe u broncode van de U-SQL-assembly beheert met het zojuist geïntroduceerde U-SQL-databaseproject. U leert ook hoe u een CI/CD-pijplijn (continue integratie en implementatie) instelt voor assembly-registratie met behulp van Azure DevOps.

Belangrijk

Azure Data Lake Analytics op 29 februari 2024 buiten gebruik gesteld. Meer informatie over deze aankondiging.

Voor gegevensanalyse kan uw organisatie gebruikmaken van Azure Synapse Analytics of Microsoft Fabric.

Het U-SQL-databaseproject gebruiken om de assemblybroncode te beheren

Het U-SQL-databaseproject is een projecttype in Visual Studio waarmee ontwikkelaars snel en eenvoudig uw U-SQL-databases kunnen ontwikkelen, beheren en implementeren. U kunt alle U-SQL-databaseobjecten (met uitzondering van referenties) beheren met het U-SQL-databaseproject.

Als u de broncode van de C#-assembly en de DDL U-SQL-scripts voor assemblyregistratie wilt beheren, gebruikt u het volgende:

  • U-SQL-databaseproject voor het beheren van U-SQL-scripts voor assembly-registratie.
  • Klassebibliotheek (voor U-SQL-toepassing) voor het beheren van de C#-broncode en afhankelijkheden voor door de gebruiker gedefinieerde operators, functies en aggregators (UDF's, UDF's en UDAGs).
  • U-SQL-databaseproject om te verwijzen naar het klassebibliotheekproject.

Een U-SQL-databaseproject kan verwijzen naar een klassebibliotheekproject (voor U-SQL-toepassing). U kunt assembly's maken die zijn geregistreerd in de U-SQL-database met behulp van de C#-broncode waarnaar wordt verwezen uit dit project class library (voor U-SQL-toepassing).

Volg deze stappen om projecten te maken en verwijzingen toe te voegen.

  1. Maak een klassebibliotheekproject (voor U-SQL-toepassing) door Bestand>Nieuw>project te selecteren. Het project bevindt zich onder het Azure Data Lake > U-SQL-knooppunt .

    Data Lake Tools voor Visual Studio- C#-klassebibliotheekproject maken

  2. Voeg uw door de gebruiker gedefinieerde C#-code toe in het project Class Library (voor U-SQL-toepassing).

  3. Maak een U-SQL-project door Bestand>Nieuw>project te selecteren. Het project bevindt zich onder het Azure Data Lake>U-SQL-knooppunt .

    Data Lake Tools voor Visual Studio- U-SQL-databaseproject maken

  4. Voeg een verwijzing toe naar het C#-klassebibliotheekproject voor het U-SQL-databaseproject.

    Data Lake Tools voor Visual Studio - Verwijzing toevoegen

    Data Lake Tools voor Visual Studio - Referentie voor U-SQL-databaseproject toevoegen

  5. Maak een assemblyscript in het U-SQL-databaseproject door met de rechtermuisknop op het project te klikken en Nieuw item toevoegen te selecteren.

    Data Lake Tools voor Visual Studio- Assemblyscript toevoegen

  6. Open het assemblyscript in de assembly-ontwerpweergave. Selecteer de assembly waarnaar wordt verwezen in de vervolgkeuzelijst Assembly maken vanuit verwijzing .

    Data Lake Tools voor Visual Studio- assembly maken op basis van referentie

  7. Voeg beheerde afhankelijkheden en aanvullende bestanden toe, indien aanwezig. Wanneer u extra bestanden toevoegt, gebruikt het hulpprogramma het relatieve pad om ervoor te zorgen dat het de assembly's op uw lokale computer en later op de buildcomputer kan vinden.

@_DeployTempDirectory in het editorvenster onderaan is een vooraf gedefinieerde variabele die het hulpprogramma naar de uitvoermap van de build wijst. Onder de map build-uitvoer heeft elke assembly een submap met de naam van de assembly. Alle DLL's en extra bestanden bevinden zich in die submap.

Een U-SQL-databaseproject bouwen

De build-uitvoer voor een U-SQL-databaseproject is een U-SQL-database-implementatiepakket. De naam heeft het achtervoegsel .usqldbpack. Het .usqldbpack pakket is een .zip-bestand dat alle DDL-instructies in één U-SQL-script in de DDL-map bevat. Alle ingebouwde .dll-bestanden en extra bestanden voor assembly's bevinden zich in de map Temp.

Een U-SQL-database implementeren

Het .usqldbpack pakket kan worden geïmplementeerd in een lokaal account of een Azure Data Lake Analytics-account. Gebruik Visual Studio of de implementatie-SDK.

Een U-SQL-database implementeren in Visual Studio

U kunt een U-SQL-database implementeren met behulp van een U-SQL-databaseproject of een .usqldbpack pakket in Visual Studio.

Implementeren met behulp van een U-SQL-databaseproject

  1. Klik met de rechtermuisknop op het U-SQL-databaseproject en selecteer vervolgens Implementeren.

  2. Selecteer in de wizard U-SQL Database implementeren het ADLA-account waarin u de database wilt implementeren. Zowel lokale accounts als ADLA-accounts worden ondersteund.

  3. Databasebron wordt automatisch ingevuld. Het verwijst naar het .usqldbpack-pakket in de build-uitvoermap van het project.

  4. Voer een naam in Databasenaam in om een database te maken. Als er al een database met dezelfde naam bestaat in het azure-doelaccount Data Lake Analytics, worden alle objecten die in het databaseproject zijn gedefinieerd, gemaakt zonder de database opnieuw te maken.

  5. Selecteer Verzenden om de U-SQL-database te implementeren. Alle resources, zoals assembly's en aanvullende bestanden, worden geüpload. Er wordt een U-SQL-taak verzonden die alle DDL-instructies bevat.

    Data Lake Tools voor Visual Studio- U-SQL-databaseproject implementeren

    Data Lake Tools voor Visual Studio - Wizard U-SQL-databaseproject implementeren

Een U-SQL-database implementeren in Azure DevOps

PackageDeploymentTool.exe biedt de programmeer- en opdrachtregelinterfaces die helpen bij het implementeren van U-SQL-databases. De SDK is opgenomen in het U-SQL SDK NuGet-pakket, dat zich bevindt op build/runtime/PackageDeploymentTool.exe.

In Azure DevOps kunt u een opdrachtregeltaak en deze SDK gebruiken om een automatiseringspijplijn in te stellen voor het vernieuwen van de U-SQL-database. Meer informatie over de SDK en het instellen van een CI/CD-pijplijn voor de implementatie van een U-SQL-database.

Volgende stappen