U-SQL-scripts uitvoeren op uw lokale computer

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.

De volgende secties bevatten meer informatie over lokale uitvoeringsonderdelen.

Hoofdmappen voor lokale gegevens

Een lokale gegevenshoofdmap 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 gegevenshoofdmap is net zoals overschakelen naar een ander standaardarchiefaccount.

De hoofdmap van de gegevens wordt als volgt gebruikt:

• Sla metagegevens op. 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, is het eenvoudiger om uw U-SQL-scripts in Azure te implementeren.

Lokale U-SQL-uitvoeringsengines

Een lokale U-SQL-run-engine 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 opdrachtregel- en programmeerinterfaces van Azure Data Lake U-SQL SDK. Meer informatie over de Azure Data Lake U-SQL SDK.

Werkmappen

Wanneer u een U-SQL-script uitvoert, is een werkmapmap nodig voor het opslaan van compilatieresultaten, het uitvoeren van logboeken en het uitvoeren van andere functies. In Azure Data Lake Tools voor Visual Studio is de werkmap de werkmap van het U-SQL-project. Het bevindt zich onder <U-SQL project root path>/bin/debug>. De werkmap wordt leeggemaakt telkens wanneer een nieuwe taak 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 laten de engine zien als een lokale rekenomgeving. Als u een U-SQL-script lokaal wilt uitvoeren, selecteert u het Local-machine of Local-project account in het vervolgkeuzemenu in de marges van de editor van het script. Selecteer vervolgens Verzenden.

Lokale uitvoeringen met een lokaal computeraccount

Een lokaal computeraccount is een gedeeld lokaal rekenaccount met één lokale gegevenshoofdmap als het lokale archiefaccount. De hoofdmap van de gegevens bevindt zich standaard in C:\Users<username>\AppData\Local\USQLDataRoot. Het kan ook worden geconfigureerd via Tools>Data Lake>Opties en Instellingen.

Een U-SQL-project is vereist voor een lokale uitvoering. De werkmap van het U-SQL-project wordt gebruikt voor de U-SQL-werkmap die lokaal wordt uitgevoerd. Compilatieresultaten, uitvoeringslogboeken en andere taakuitvoeringsbestanden worden gegenereerd en opgeslagen onder 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 lokaal rekenaccount dat is geïsoleerd voor elk project met een geïsoleerde lokale gegevenshoofdmap. Elk actief U-SQL-project dat wordt geopend in Solution Explorer in Visual Studio heeft een bijbehorend (Local-project: <project name>) account. De accounts worden weergegeven in Server Explorer in Visual Studio en de marge van de U-SQL-scripteditor.

Het Local-project-account biedt een schone en geïsoleerde ontwikkelomgeving. Een lokale-computeraccount heeft een gedeelde lokale gegevenshoofdmap waarin metagegevens en invoer- en uitvoergegevens voor alle lokale taken worden opgeslagen. Maar een lokaal projectaccount maakt een tijdelijke lokale gegevenshoofdmap onder een U-SQL-projectwerkmap telkens wanneer een U-SQL-script wordt uitgevoerd. Deze tijdelijke gegevenshoofddirectory wordt opgeschoond wanneer een herbouw of opnieuw uitvoeren gebeurt.

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 het project als de databaseomgevingen waarnaar wordt verwezen.

De invoergegevensbron voor een lokaal projectaccount beheren

Een U-SQL-project maakt een lokale gegevenshoofdmap en stelt gegevens in voor een lokaal projectaccount . Een tijdelijke hoofdmap voor gegevens wordt opgeschoond en opnieuw gemaakt onder de werkmap van het U-SQL-project telkens wanneer een herbouwing 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-projecteigenschap>>testgegevensbron. Wanneer u een U-SQL-script uitvoert op een lokaal projectaccount , worden alle bestanden en submappen in de map Testgegevensbron gekopieerd naar de tijdelijke map met lokale gegevens. Bestanden die zich onder submappen bevinden, zijn opgenomen. Nadat een lokale taak is uitgevoerd, kunnen uitvoerresultaten ook worden gevonden onder de tijdelijke lokale gegevenshoofdmap in de werkmap van het project. Al deze uitvoer wordt verwijderd en opgeschoond wanneer het project opnieuw wordt opgebouwd en opgeschoond.

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 U-SQL-databaseprojectverwijzingen 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 tijdelijke lokale gegevenshoofdmap. En voor elke uitvoering wordt de tijdelijke gegevenshoofddirectory opgeschoond voor een frisse, afgezonderde omgeving.

Raadpleeg dit gerelateerde artikel:

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

Het verschil tussen Local-machine-accounts en Local-project-accounts

Een lokale-machineaccount simuleert een Azure Data Lake Analytics-account op de lokale machines van gebruikers. Het deelt dezelfde ervaring met een Azure Data Lake Analytics-account. Een lokaal projectaccount biedt een gebruiksvriendelijke lokale ontwikkelomgeving. Met deze omgeving kunnen gebruikers databaseverwijzingen en invoergegevens implementeren 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. Het wordt vernieuwd voor elke uitvoering. Een lokaal projectaccount biedt een snellere ontwikkelervaring door snel nieuwe wijzigingen toe te passen.

In de volgende tabel worden meer verschillen tussen machine-lokaal en project-lokaal accounts weergegeven.

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.

Volgende stappen

• Een CI/CD-pijplijn instellen voor Azure Data Lake Analytics.
• Uw Azure Data Lake Analytics-code testen.