Een U-SQL-databaseproject gebruiken om een U-SQL-database voor Azure Data Lake te ontwikkelen
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.
U-SQL-database biedt gestructureerde weergaven van ongestructureerde gegevens en beheerde gestructureerde gegevens in tabellen. Het biedt ook een algemeen metagegevenscatalogussysteem voor het ordenen van uw gestructureerde gegevens en aangepaste code. De database is het concept waarmee deze gerelateerde objecten worden gegroepeerd.
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 na versie 2.3.3000.0 een nieuwe projectsjabloon met de naam U-SQL-databaseproject toegevoegd. Als u een U-SQL-project wilt maken, selecteert u Bestand > Nieuw > project. Het U-SQL Database-project vindt u onder Azure Data Lake > U-SQL-knooppunt.
U-SQL-databaseobjecten ontwikkelen met behulp van een databaseproject
Klik met de rechtermuisknop op het U-SQL-databaseproject. Selecteer Nieuw item toevoegen>. U vindt alle nieuwe ondersteunde objecttypen in de wizard Nieuw item toevoegen .
Voor een niet-assembly-object (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 assembly-objectdefinitie toevoegt aan het U-SQL-databaseproject:
Voeg verwijzingen toe naar het C#-project die de UDO/UDAG/UDF voor het U-SQL-databaseproject bevatten.
Kies in de ontwerpweergave assembly de assembly waarnaar wordt verwezen in de vervolgkeuzelijst Assembly maken .
Voeg beheerde afhankelijkheden en eventueel aanvullende bestanden toe. Wanneer u extra bestanden toevoegt, gebruikt het hulpprogramma het relatieve pad om ervoor te zorgen dat het de assembly's zowel op uw lokale computer als later op de buildcomputer kan vinden.
@_DeployTempDirectory is een vooraf gedefinieerde variabele die het hulpprogramma naar de uitvoermap van de build verwijst. Onder de map build-uitvoer heeft elke assembly een submap met de naam van de assembly. Alle DLL's en aanvullende 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 de naam met het achtervoegsel .usqldbpack. Het .usqldbpack pakket is een .zip-bestand dat alle DDL-instructies in één U-SQL-script in de DDL-map bevat, en alle DLL's en aanvullende bestanden voor assembly's in de map Temp .
Meer informatie over het bouwen van een U-SQL-databaseproject met de MSBuild-opdrachtregel en een Azure DevOps Services-buildtaak.
Een U-SQL-database implementeren
Het .usqldbpack-pakket kan worden geïmplementeerd naar 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
Klik met de rechtermuisknop op het U-SQL-databaseproject en selecteer vervolgens Implementeren.
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.
Databasebron wordt automatisch ingevuld en verwijst naar het .usqldbpack-pakket in de map build-uitvoer van het project.
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.
Selecteer Verzenden om de U-SQL-database te implementeren. Alle resources (assembly's en aanvullende bestanden) worden geüpload en er wordt een U-SQL-taak verzonden die alle DDL-instructies bevat.
Implementeren via een U-SQL-database-implementatiepakket
Open Server Explorer. Vouw vervolgens het Azure Data Lake Analytics-account uit waarin u de database wilt implementeren.
Klik met de rechtermuisknop of houd U-SQL-databases ingedrukt en kies Vervolgens Database implementeren.
Stel Databasebron in op het pad naar het U-SQL-databaseimplementatiepakket (.usqldbpack-bestand).
Voer de databasenaam in om een database te maken. Als er een database is met dezelfde naam die al bestaat in het Azure-doelaccount Data Lake Analytics, worden alle objecten die in het databaseproject zijn gedefinieerd, gemaakt zonder de database opnieuw te maken.
U-SQL-database implementeren met behulp van de SDK
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.
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:
- Projectbuild: stel de databaseomgevingen waarnaar wordt verwezen in voordat u de U-SQL-scripts bouwt.
- Lokale uitvoering op account (een lokaal project): de databaseomgevingen waarnaar wordt verwezen, worden geïmplementeerd in (een lokaal project)-account voordat U-SQL-script wordt uitgevoerd. Meer informatie over lokale uitvoeringen en het verschil tussen (de lokale machine) en (een lokaal project)-account vindt u hier.
Een U-SQL-databaseverwijzing toevoegen
Klik met de rechtermuisknop op het U-SQL-project in Solution Explorer en kies vervolgens U-SQL Database verwijzing toevoegen....
Configureer een databaseverwijzing vanuit een U-SQL-databaseproject in de huidige oplossing of in een U-SQL-databasepakketbestand.
Geef de naam op voor de database.
