U-SQL-scripts uitvoeren op uw lokale computer

Artikel
12/20/2023

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.

Wanneer u U-SQL-scripts ontwikkelt, kunt u tijd en kosten besparen door de scripts lokaal uit te voeren. Azure Data Lake Tools voor Visual Studio ondersteunt het uitvoeren van U-SQL-scripts op uw lokale computer.

Basisconcepten voor lokale uitvoeringen

In de volgende grafiek ziet u de onderdelen voor lokale uitvoering en hoe deze onderdelen worden toegewezen aan de clouduitvoering.

Onderdeel	Lokaal uitvoeren	Clouduitvoering
Storage	Hoofdmap van lokale gegevens	StandaardAccount voor Azure Data Lake Store
Compute	Lokale U-SQL-uitvoeringsengine	Azure Data Lake Analytics-service
Omgeving uitvoeren	Werkmap op lokale computer	Azure Data Lake Analytics-cluster

De volgende secties bevatten meer informatie over lokale uitvoeringsonderdelen.

Hoofdmappen voor lokale gegevens

De hoofdmap van een lokale gegevens is een lokaal archief voor het lokale rekenaccount. Elke map in het lokale bestandssysteem op uw lokale computer kan een lokale gegevenshoofdmap zijn. Dit is hetzelfde als het standaard Azure Data Lake Store-account van een Data Lake Analytics-account. Overschakelen naar een andere hoofdmap voor gegevens is hetzelfde als overschakelen naar een ander standaardopslagaccount.

De hoofdmap van de gegevens wordt als volgt gebruikt:

Metagegevens opslaan. Voorbeelden zijn databases, tabellen, tabelwaardefuncties en assembly's.
Zoek de invoer- en uitvoerpaden op die zijn gedefinieerd als relatieve paden in U-SQL-scripts. Door relatieve paden te gebruiken, kunt u uw U-SQL-scripts eenvoudiger implementeren in Azure.

Lokale U-SQL-uitvoeringsengines

Een lokale U-SQL-uitvoeringsengine is een lokaal rekenaccount voor U-SQL-taken. Gebruikers kunnen U-SQL-taken lokaal uitvoeren via Azure Data Lake Tools voor Visual Studio. Lokale uitvoeringen worden ook ondersteund via de Azure Data Lake U-SQL SDK-opdrachtregel- en programmeerinterfaces. Meer informatie over de Azure Data Lake U-SQL SDK.

Werkmappen

Wanneer u een U-SQL-script uitvoert, is een werkmapmap nodig om compilatieresultaten in de cache op te laden, logboeken uit te voeren en andere functies uit te voeren. In Azure Data Lake Tools voor Visual Studio is de werkmap van het U-SQL-project de werkmap. Deze bevindt zich onder <U-SQL project root path>/bin/debug>. De werkmap wordt opgeschoond telkens wanneer een nieuwe uitvoering wordt geactiveerd.

Lokale uitvoeringen in Microsoft Visual Studio

Azure Data Lake Tools voor Visual Studio hebben een ingebouwde engine voor lokale uitvoering. De hulpprogramma's gebruiken de engine als een lokaal rekenaccount. Als u een U-SQL-script lokaal wilt uitvoeren, selecteert u het account Local-machine of Local-project in het vervolgkeuzemenu voor marges van de editor van het script. Selecteer vervolgens Verzenden.

Een U-SQL-script verzenden naar een lokaal account

Lokale uitvoeringen met een lokaal computeraccount

Een lokale-computeraccount is een gedeeld lokaal rekenaccount met één lokale gegevenshoofdmap als het lokale opslagaccount. De hoofdmap van de gegevens bevindt zich standaard op C:\Users<username>\AppData\Local\USQLDataRoot. Het kan ook worden geconfigureerd via Extra>Data Lake-opties>en -instellingen.

Een lokale gegevenshoofdmap configureren

Een U-SQL-project is vereist voor een lokale uitvoering. De werkmap van het U-SQL-project wordt gebruikt voor de lokale U-SQL-uitvoeringswerkmap. Compilatieresultaten, uitvoeringslogboeken en andere taakuitvoeringsbestanden worden gegenereerd en opgeslagen in de werkmapmap tijdens de lokale uitvoering. Telkens wanneer u het script opnieuw uitvoert, worden alle bestanden in de werkmap opgeschoond en opnieuw gegenereerd.

Lokale uitvoeringen met een lokaal projectaccount

Een lokaal-projectaccount is een projectgeisoleerd lokaal rekenaccount voor elk project met een geïsoleerde lokale gegevenshoofdmap. Elk actief U-SQL-project dat in Solution Explorer in Visual Studio wordt geopend, heeft een bijbehorend (Local-project: <project name>) account. De accounts worden weergegeven in serververkenner in Visual Studio en in de marge van de U-SQL-scripteditor.

Het lokaal-projectaccount biedt een schone en geïsoleerde ontwikkelomgeving. Een account op een lokale computer heeft een gedeelde hoofdmap voor lokale gegevens waarin metagegevens en invoer- en uitvoergegevens voor alle lokale taken worden opgeslagen. Maar een lokaal-projectaccount maakt een tijdelijke lokale gegevenshoofdmap onder een werkmap van een U-SQL-project telkens wanneer een U-SQL-script wordt uitgevoerd. Deze tijdelijke gegevenshoofdmap wordt opgeschoond wanneer er een herbouwing of een nieuwe uitvoering plaatsvindt.

Een U-SQL-project beheert de geïsoleerde lokale uitvoeringsomgeving via een projectverwijzing en -eigenschap. U kunt de invoergegevensbronnen voor U-SQL-scripts configureren in zowel de projectomgeving als de databaseomgeving waarnaar wordt verwezen.

De invoergegevensbron voor een lokaal projectaccount beheren

Een U-SQL-project maakt een lokale hoofdmap voor gegevens en stelt gegevens in voor een lokaal-projectaccount . Een tijdelijke gegevenshoofdmap wordt opgeschoond en opnieuw gemaakt in de werkmap van het U-SQL-project telkens wanneer een herbouw en lokale uitvoering plaatsvindt. Alle gegevensbronnen die zijn geconfigureerd door het U-SQL-project, worden gekopieerd naar deze tijdelijke lokale gegevenshoofdmap voordat de lokale taak wordt uitgevoerd.

U kunt de hoofdmap van uw gegevensbronnen configureren. Klik met de rechtermuisknop op U-SQL-project>Property>Test Data Source. Wanneer u een U-SQL-script uitvoert op een lokaal-projectaccount , worden alle bestanden en submappen in de map TestGegevensbron gekopieerd naar de tijdelijke lokale gegevenshoofdmap. Bestanden onder submappen worden opgenomen. Nadat een lokale taak is uitgevoerd, kunt u uitvoerresultaten ook vinden in de tijdelijke lokale gegevenshoofdmap in de projectwerkmap. Al deze uitvoer wordt verwijderd en opgeschoond wanneer het project opnieuw wordt opgebouwd en opgeschoond.

De testgegevensbron van een project configureren

Een databaseomgeving waarnaar wordt verwezen beheren voor een lokaal projectaccount

Als een U-SQL-query gebruikmaakt van of query's uitvoert met U-SQL-databaseobjecten, moet u de databaseomgevingen lokaal voorbereiden voordat u het U-SQL-script lokaal uitvoert. Voor een lokaal projectaccount kunnen U-SQL-databaseafhankelijkheden worden beheerd door U-SQL-projectverwijzingen. U kunt verwijzingen naar U-SQL-databaseproject toevoegen aan uw U-SQL-project. Voordat u U-SQL-scripts uitvoert op een lokaal-projectaccount , worden alle databases waarnaar wordt verwezen geïmplementeerd in de hoofdmap van de tijdelijke lokale gegevens. En voor elke uitvoering wordt de tijdelijke hoofdmap van de gegevens opgeschoond als een nieuwe geïsoleerde omgeving.

Zie dit gerelateerde artikel:

Meer informatie over het beheren van U-SQL-databasedefinities en -verwijzingen in U-SQL-databaseprojecten.

Het verschil tussen lokale-machine- en lokaal-projectaccounts

Een lokale-machineaccount simuleert een Azure Data Lake Analytics-account op de lokale computers van gebruikers. Dezelfde ervaring wordt gedeeld met een Azure Data Lake Analytics-account. Een lokaal projectaccount biedt een gebruiksvriendelijke lokale ontwikkelomgeving. Deze omgeving helpt gebruikers bij het implementeren van databaseverwijzingen en het invoeren van gegevens voordat ze scripts lokaal uitvoeren. Een lokaal computeraccount biedt een gedeelde permanente omgeving die toegankelijk is via alle projecten. Een lokaal projectaccount biedt een geïsoleerde ontwikkelomgeving voor elk project. Deze wordt vernieuwd voor elke uitvoering. Een lokaal projectaccount biedt een snellere ontwikkelervaring door snel nieuwe wijzigingen toe te passen.

Meer verschillen tussen lokale machine - en lokaal-projectaccounts worden weergegeven in de volgende tabel:

Verschilhoek	Lokale machine	Lokaal project
Lokale toegang	Kan worden geopend voor alle projecten.	Alleen het bijbehorende project heeft toegang tot dit account.
Hoofdmap van lokale gegevens	Een permanente lokale map. Geconfigureerd via Extra>Data Lake-opties>en -instellingen.	Een tijdelijke map die is gemaakt voor elke lokale uitvoering in de werkmap van het U-SQL-project. De map wordt opgeschoond wanneer een herbouwing of opnieuw wordt uitgevoerd.
Invoergegevens voor een U-SQL-script	Het relatieve pad onder de hoofdmap van de permanente lokale gegevens.	Stel in via de U-SQL-projecteigenschap>TestGegevensbron. Alle bestanden en submappen worden gekopieerd naar de hoofdmap van de tijdelijke gegevens voordat een lokale uitvoering wordt uitgevoerd.
Uitvoergegevens voor een U-SQL-script	Relatief pad onder de hoofdmap van de permanente lokale gegevens.	Uitvoer naar de hoofdmap van de tijdelijke gegevens. De resultaten worden opgeschoond wanneer er opnieuw wordt gebouwd of opnieuw wordt uitgevoerd.
Database-implementatie waarnaar wordt verwezen	Databases waarnaar wordt verwezen, worden niet automatisch geïmplementeerd wanneer ze worden uitgevoerd op een lokale-computeraccount . Hetzelfde geldt voor het indienen bij een Azure Data Lake Analytics-account.	Databases waarnaar wordt verwezen, worden automatisch geïmplementeerd in het lokaal-projectaccount voordat een lokale uitvoering wordt uitgevoerd. Alle databaseomgevingen worden opgeschoond en opnieuw geïmplementeerd wanneer er opnieuw wordt gebouwd of opnieuw wordt uitgevoerd.

Een lokale uitvoering met de U-SQL SDK

U kunt U-SQL-scripts lokaal uitvoeren in Visual Studio en ook de Azure Data Lake U-SQL SDK gebruiken om U-SQL-scripts lokaal uit te voeren met opdrachtregel- en programmeerinterfaces. Via deze interfaces kunt u lokale U-SQL-uitvoeringen en -tests automatiseren.

Meer informatie over de Azure Data Lake U-SQL SDK.