Share via

Een U-SQL-databaseproject gebruiken om een U-SQL-database te ontwikkelen voor Azure Data Lake

Belangrijk

Azure Data Lake Analytics is op 29 februari 2024 buiten gebruik gesteld. Kom meer te weten over via deze aankondiging.

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

U-SQL-database biedt gestructureerde weergaven over ongestructureerde gegevens en beheerde gestructureerde gegevens in tabellen. Het biedt ook een algemeen systeem voor metagegevenscatalogus voor het ordenen van uw gestructureerde gegevens en aangepaste code. De database is het concept dat deze gerelateerde objecten groepeert.

Meer informatie over U-SQL-database en DDL -(Data Definition Language).

Het U-SQL-databaseproject is een projecttype in Visual Studio waarmee ontwikkelaars hun U-SQL-databases snel en eenvoudig kunnen ontwikkelen, beheren en implementeren.

Een U-SQL-databaseproject maken

Azure Data Lake Tools voor Visual Studio heeft een nieuwe projectsjabloon met de naam U-SQL-databaseproject toegevoegd na versie 2.3.3000.0. Als u een U-SQL-project wilt maken, selecteert u File > New > Project. Het U-SQL Database-project vindt u onder Azure Data Lake > U-SQL-knooppunt.

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

U-SQL-databaseobjecten ontwikkelen met behulp van een databaseproject

Klik met de rechtermuisknop op het U-SQL-databaseproject. Selecteer Voeg > Nieuw itemtoe. U vindt alle nieuwe ondersteunde objecttypen in de wizard Nieuw item toevoegen.

Voor een niet-assemblyobject (bijvoorbeeld een tabelwaardefunctie) wordt een nieuw U-SQL-script gemaakt nadat u een nieuw item hebt toegevoegd. U kunt beginnen met het ontwikkelen van de DDL-instructie voor dat object in de editor.

Voor een assembly-object biedt het hulpprogramma een gebruiksvriendelijke UI-editor waarmee u de assembly kunt registreren en DLL-bestanden en andere bestanden kunt implementeren. In de volgende stappen ziet u hoe u een assemblyobjectdefinitie toevoegt aan het U-SQL-databaseproject:

  1. Voeg verwijzingen toe naar het C#-project met de UDO/UDAG/UDF voor het U-SQL-databaseproject.

    Data Lake Tools voor Visual Studio - Referentie toevoegen

    Data Lake Tools voor Visual Studio - Verwijzing naar U-SQL-databaseproject toevoegen

  2. Kies in de ontwerpweergave van de samenstelling de referentiesamenstelling in de vervolgkeuzelijst Samenstelling maken op basis van verwijzing.

    Data Lake Tools voor Visual Studio—assembly maken vanuit referentie

  3. Voeg beheerde afhankelijkheden toe en aanvullende bestanden indien aanwezig. Wanneer u extra bestanden toevoegt, gebruikt het hulpprogramma het relatieve pad om ervoor te zorgen dat de assembly's zowel op uw lokale computer als op de buildcomputer later kunnen worden gevonden.

@_DeployTempDirectory is een vooraf gedefinieerde variabele die het hulpprogramma naar de uitvoermap van de build verwijst. Onder de build-uitvoermap 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 met het achtervoegsel .usqldbpack. Het .usqldbpack-pakket is een .zip-bestand met alle DDL-instructies in één U-SQL-script in de map DDL, en alle DLL's en extra bestanden voor assembly's in de map Temp.

Meer informatie over het bouwen van een U-SQL-databaseproject met de MSBuild-opdrachtregelinterface en een Azure DevOps Services-build-opdracht.

Een U-SQL-database implementeren

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

Een U-SQL-database implementeren in Visual Studio

U kunt een U-SQL-database implementeren via een U-SQL-databaseproject of een .usqldbpack-pakket in Visual Studio.

Implementeren via 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 implementerenhet ADLA-account waarnaar u de database wilt implementeren. Zowel lokale accounts als ADLA-accounts worden ondersteund.

  3. Databasebron, wordt automatisch ingevuld en verwijst naar het .usqldbpack-pakket in de 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 Data Lake Analytics-doelaccount, worden alle objecten die in het databaseproject zijn gedefinieerd, gemaakt zonder de database opnieuw te maken.

  5. Als u de U-SQL-database wilt implementeren, selecteert u Verzenden. Alle resources (assembly's en extra bestanden) worden geüpload en er wordt een U-SQL-taak met alle DDL-instructies verzonden.

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

    Data Lake-hulpprogramma's voor Visual Studio--implementatiewizard voor U-SQL-databaseproject

Implementeren via een U-SQL-database-implementatiepakket

  1. Open Server Explorer-. Vouw vervolgens het Azure Data Lake Analytics-account uit waarin u de database wilt implementeren.

  2. Klik met de rechtermuisknop of houd U-SQL Databasesingedrukt en kies vervolgens Database implementatie.

  3. Stel Database Source in op het pad naar het U-SQL database deployment package (.usqldbpack-bestand).

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

    Data Lake Tools for Visual Studio--Implementeer U-SQL databasepakket

    Data Lake Tools for Visual Studio--Implementatie U-SQL databasepakket wizard

U-SQL-database implementeren met behulp van de SDK

PackageDeploymentTool.exe biedt de programmeer- en opdrachtregelinterfaces waarmee U-SQL-databases kunnen worden geïmplementeerd. De SDK is opgenomen in het U-SQL SDK NuGet-pakket, dat zich in build/runtime/PackageDeploymentTool.exebevindt.

Meer informatie over de SDK en het instellen van CI/CD-pijplijn voor U-SQL-database-implementatie.

Verwijzen naar een U-SQL-databaseproject

Een U-SQL-project kan verwijzen naar een U-SQL-databaseproject. De verwijzing is van invloed op twee workloads:

  • Project-build-: stel de databaseomgevingen waarnaar wordt verwezen in voordat u de U-SQL-scripts bouwt.
  • Lokaal uitvoeren op (een lokaal project)-account: de databaseomgevingen waarnaar wordt verwezen, worden geïmplementeerd in (een lokaal project)-account voordat U-SQL-script wordt uitgevoerd. Leer hiermeer over lokale uitvoeringen en het verschil tussen (de lokale machine) en (een lokaal-projectaccount).

Een U-SQL-databaseverwijzing toevoegen

  1. Klik met de rechtermuisknop op het U-SQL-project in Solution Exploreren kies U-SQL Database-verwijzing toevoegen....

    Data Lake Tools voor Visual Studio - referentiemateriaal voor databaseproject toevoegen

  2. Configureer een databaseverwijzing vanuit een U-SQL-databaseproject in de huidige oplossing of in een U-SQL-databasepakketbestand.

  3. Geef de naam op voor de database.

    Wizard voor databaseprojectreferentie toevoegen voor Data Lake Tools voor Visual Studio

Volgende stappen