Freigeben über


Ausführen von U-SQL und lokales Debuggen in Visual Studio Code

Wichtig

Azure Data Lake Analytics wurde am 29. Februar 2024 eingestellt. In dieser Ankündigung erhalten Sie weitere Informationen.

Bei Datenanalysen kann Ihre Organisation Azure Synapse Analytics oder Microsoft Fabricverwenden.

In diesem Artikel wird beschrieben, wie U-SQL-Aufträge auf einem lokalen Entwicklungscomputer ausgeführt werden, um frühe Codierungsphasen zu beschleunigen oder Code lokal in Visual Studio Code zu debuggen. Anweisungen zum Azure Data Lake-Tool für Visual Studio Code finden Sie unter Verwenden von Azure Data Lake Tools für Visual Studio Code.

Nur Windows-Installationen der Azure Data Lake Tools für Visual Studio unterstützen die Aktion, um U-SQL lokal auszuführen und U-SQL lokal zu debuggen. Installationen auf macOS- und Linux-basierten Betriebssystemen unterstützen dieses Feature nicht.

Einrichten der lokalen U-SQL-Ausführungsumgebung

  1. Wählen Sie STRG+UMSCHALT+P aus, um die Befehlspalette zu öffnen, und geben Sie dann ADL ein: Laden Sie das lokale Run-Paket herunter, um die Pakete herunterzuladen.

    Herunterladen der ADL LocalRun-Abhängigkeitspakete

  2. Suchen Sie die Abhängigkeitspakete aus dem Pfad, der im Ausgabebereich angezeigt wird, und installieren Sie dann BuildTools und Win10SDK 10240. Hier ist ein Beispielpfad:
    C:\Users\xxx\AppData\Roaming\LocalRunDependency

    Finden Sie die Abhängigkeitspakete

    2.1 Um BuildTools zu installieren, wählen Sie visualcppbuildtools_full.exe im Ordner "LocalRunDependency" aus, und folgen Sie dann den Anweisungen des Assistenten.

    Installieren von BuildTools

    2.2 Um Win10SDK 10240 zu installieren, wählen Sie sdksetup.exe im Ordner "LocalRunDependency/Win10SDK_10.0.10240_2" aus, und folgen Sie dann den Anweisungen des Assistenten.

    Installieren von Win10SDK 10240

  3. Richten Sie die Umgebungsvariable ein. Legen Sie die umgebungsvariable SCOPE_CPP_SDK auf Folgendes fest:
    C:\Users\XXX\AppData\Roaming\LocalRunDependency\CppSDK_3rdparty

Starten Des lokalen Ausführungsdiensts und Übermitteln des U-SQL-Auftrags an ein lokales Konto

Verwenden Sie zum ersten Mal ADL: Laden Sie das lokale Run-Paket herunter, um lokale Ausführungspakete herunterzuladen, wenn Sie keine lokale U-SQL-Ausführungsumgebung eingerichtet haben.

  1. Wählen Sie STRG+UMSCHALT+P aus, um die Befehlspalette zu öffnen, und geben Sie dann ADL ein: Starten Des lokalen Ausführungsdiensts.

  2. Wählen Sie "Akzeptieren" aus, um die Microsoft-Software-Lizenzbedingungen zum ersten Mal zu akzeptieren.

    Akzeptieren der Microsoft-Software-Lizenzbedingungen

  3. Die cmd-Konsole wird geöffnet. Zum ersten Mal müssen Sie "3" eingeben und dann den lokalen Ordnerpfad für die Dateneingabe und -ausgabe suchen. Wenn Sie den Pfad nicht mit Rückschrägstrichen definieren können, versuchen Sie es mit Schrägstrichen. Für andere Optionen können Sie die Standardwerte verwenden.

    Data Lake Tools for Visual Studio Code local run cmd

  4. Wählen Sie STRG+UMSCHALT+P aus, um die Befehlspalette zu öffnen, geben Sie "ADL: Auftrag übermitteln" ein, und wählen Sie dann "Lokal" aus, um den Auftrag an Ihr lokales Konto zu übermitteln.

    Data Lake Tools for Visual Studio Code select local

  5. Nachdem Sie den Auftrag übermittelt haben, können Sie die Übermittlungsdetails anzeigen. Um die Übermittlungsdetails anzuzeigen, wählen Sie jobUrl im Ausgabefenster aus. Sie können den Auftragsübermittlungsstatus auch über die cmd-Konsole anzeigen. Geben Sie 7 in der cmd-Konsole ein, wenn Sie weitere Auftragsdetails wissen möchten.

    Data Lake Tools für Visual Studio Code lokale Ausführung Ausgabe Data Lake Tools für Visual Studio Code lokale Ausführung Befehlsstatus

Starten eines lokalen Debugvorgangs für den U-SQL-Auftrag

Für den ersten Benutzer:

  1. Verwenden Sie ADL: Laden Sie das lokale Run-Paket herunter, um lokale Ausführungspakete herunterzuladen, wenn Sie keine lokale U-SQL-Ausführungsumgebung eingerichtet haben.
  2. Installieren Sie .NET Core SDK 2.0 wie im Meldungsfeld vorgeschlagen, falls nicht installiert.   Erinnerungsfunktion zur Installation von Dotnet
  3. Installieren Sie C# für Visual Studio Code wie im Meldungsfeld vorgeschlagen, wenn sie nicht installiert ist. Wählen Sie "Installieren" aus, um fortzufahren, und starten Sie dann VS Code neu.

Erinnerung zur Installation von C#

Führen Sie die folgenden Schritte aus, um das lokale Debuggen auszuführen:

  1. Wählen Sie STRG+UMSCHALT+P aus, um die Befehlspalette zu öffnen, und geben Sie dann ADL ein: Starten Des lokalen Ausführungsdiensts. Die cmd-Konsole wird geöffnet. Stellen Sie sicher, dass dataRoot festgelegt ist.

  2. Legen Sie einen Haltepunkt in Ihrem C#-Code-Behind fest.

  3. Zurück zum Skript-Editor, klicken Sie mit der rechten Maustaste, und wählen Sie ADL: Lokales Debuggen aus.

    Data Lake Tools für das lokale Debugergebnis von Visual Studio Code

Nächste Schritte