Microsoft Fabric-Notebookerfahrung in VS Code

  • Artikel

Die Visual Studio Code-Erweiterung für Synapse unterstützt die CRUD-Notebookumgebung (Erstellen, Lesen, Aktualisieren und Löschen) in Fabric vollständig. Die Erweiterung unterstützt auch die Synchronisierung zwischen lokalen und Remotearbeitsbereichen. wenn Sie Änderungen synchronisieren, können Sie alle Konflikte oder Unterschiede zwischen Ihrem lokalen Und Remotearbeitsbereich beheben.

Mit dieser Erweiterung können Sie Notebooks auch auf dem Remote-Fabric Spark-Compute ausführen.

Wichtig

Microsoft Fabric befindet sich derzeit in der Vorschauversion. Diese Informationen beziehen sich auf eine Vorabversion des Produkts, an der vor der Veröffentlichung noch wesentliche Änderungen vorgenommen werden können. Microsoft übernimmt keine Garantie, weder ausdrücklich noch stillschweigend, für die hier bereitgestellten Informationen.

Öffnen von Notebook mit synapse-Erweiterung

Durch Klicken auf die Schaltfläche In VS Code öffnen auf der Notebookerstellungsseite im Fabric-Portal können Sie dasselbe Notizbuch direkt mit der Synapse VS Code-Erweiterung für Fabric öffnen. Sobald die Erweiterung aktiviert wurde, sollte der Arbeitsbereich in VS Code automatisch so festgelegt werden, dass er das Notebook enthält. Wenn das Notebook noch nicht geöffnet wurde, wird er zuerst heruntergeladen und automatisch geöffnet.

Öffnen Sie das Notebook in VS Code.

Tipp

Wenn Sie die Synapse-Erweiterung für VS Code nicht installiert haben, stellen Sie sicher, dass Sie sie zuerst installieren. Weitere Informationen finden Sie unter Installieren der Synapse-Erweiterung . Sobald diese Erweiterung allgemein verfügbar ist, wird die Installation automatisiert.

Anzeigen der Liste der Notebooks

Der Knoten notebookstruktur listet die Namen aller Notizbuchelemente im aktuellen Arbeitsbereich auf. Basierend auf Ihren Änderungen in VS Code zeigt die Liste verschiedene Farben und Zeichen an, um den neuesten Zustand anzugeben, wie in der folgenden Abbildung dargestellt.

  • Standard: Weißer Text und kein Zeichen rechts neben dem Notebooknamen gibt den Standard- oder initialisierten Zustand an. Das Notebook befindet sich im Remotearbeitsbereich und wurde nicht lokal heruntergeladen.
  • Geändert: Das M-Zeichen rechts neben dem Namen und dem gelben Text gibt an, dass das Notebook lokal in VS Code heruntergeladen und bearbeitet wurde, und dass diese ausstehenden Änderungen noch nicht im Remotearbeitsbereich veröffentlicht wurden.
  • Lokal: Das L-Zeichen und der grüne Text geben an, dass das Notebook heruntergeladen wurde und der Inhalt mit dem Remotearbeitsbereich identisch ist.
  • Konflikt: Das Zeichen C und der rote Text zeigen an, dass Konflikte zwischen der lokalen Version und der Remotearbeitsbereichsversion bestehen.

Screenshot: Notebookliste

Erstellen eines Notebooks

  1. Zeigen Sie in VS Code Explorer auf die Symbolleiste des Notebooks. Die Option Notizbuch erstellen wird angezeigt.

    Screenshot der Notebookliste in VS Code, die zeigt, wo die Option Notebook erstellen ausgewählt werden soll.

  2. Wählen Sie Notizbuch erstellen aus, und geben Sie einen Namen und eine Beschreibung ein. Ein neues Notizbuch wird im Remotearbeitsbereich erstellt und im Standardzustand in ihrer Notebookliste angezeigt.

Herunterladen eines Notebooks

Bevor Sie den Notebookinhalt bearbeiten können, müssen Sie das Notebook in VS Code herunterladen.

  1. Zeigen Sie in der Notebookliste in VS Code auf den Notebooknamen. Die Option Herunterladen wird neben dem Notebooknamen angezeigt.

    Screenshot der Notizbuchliste von VS Code Explorer, die zeigt, wo die Option Notebook herunterladen ausgewählt werden soll.

  2. Wählen Sie Herunterladen aus, und speichern Sie das Notebook in Ihrem lokalen Arbeitsverzeichnis.

Öffnen eines Notebooks

  1. Zeigen Sie in VS Code Explorer auf den Namen eines heruntergeladenen Notebooks. Neben dem Notebook werden mehrere Optionen angezeigt, darunter die Option Notizbuchordner öffnen .

    Screenshot des VS Code-Explorer, der zeigt, wo Sie Notebookordner öffnen auswählen.

  2. Wählen Sie Notizbuchordner öffnen aus, und das Notizbuch wird im VS Code-Editor-Bildschirm geöffnet.

Löschen eines Notebooks

Tipp

Um Fehler zu vermeiden, schließen Sie den Notizbuchordner in der ansicht Explorer, und schließen Sie das Notizbuch in der Editoransicht, bevor Sie das Notizbuch löschen.

So löschen Sie ein Notizbuch:

  1. Zeigen Sie in VS Code Explorer auf den Namen des Notizbuchs, das Sie löschen möchten. Die Optionen werden rechts neben dem Namen angezeigt, einschließlich der Option Notizbuch löschen.

    Screenshot: VS Code Explorer, der zeigt, wo die Option Notizbuch löschen angezeigt wird.

  2. Wählen Sie die Option Notizbuch löschen aus. Wenn Sie dazu aufgefordert werden, können Sie nur die lokale Kopie oder sowohl die lokalen Kopien als auch die Remotearbeitsbereichskopien löschen.

Veröffentlichen lokaler Änderungen im Remotearbeitsbereich

So übertragen Sie Ihre lokalen Änderungen an den Remotearbeitsbereich:

  1. Zeigen Sie in VS Code Explorer auf den Namen des Notebooks, das Sie im Remotearbeitsbereich veröffentlichen möchten. Die Optionen werden rechts neben dem Namen angezeigt, einschließlich der Option Veröffentlichen.

    Screenshot: VS Code Explorer, der zeigt, wo die Option Notizbuch veröffentlichen angezeigt wird.

  2. Wählen Sie Veröffentlichen aus. Die Remotearbeitsbereichsversion wird mit Ihren lokalen VS Code-Änderungen aktualisiert.

    • Wenn Ihr lokales Update Mergekonflikte erzeugt, werden Sie aufgefordert, diese zu beheben, bevor die Zusammenführung ausgeführt wird.

  3. Wenn ein anderer Benutzer dasselbe Notizbuch im Fabric-Portal geöffnet hat, wird er benachrichtigt, ihre lokalen VS Code-Änderungen zu akzeptieren oder abzulehnen, wie in der folgenden Abbildung gezeigt.

    Screenshot des Dialogfelds, in dem Portalbenutzer benachrichtigt werden, dass eine externe Bearbeitung erkannt wurde. Es enthält eine Schaltfläche Annehmen und eine Ablehnen-Schaltfläche.

    • Akzeptieren: Ihre Änderung von VS Code wurde erfolgreich im Arbeitsbereich gespeichert.
    • Ablehnen: Ihre Änderung von VS Code wird ignoriert.

Abrufen von Änderungen aus dem Remotearbeitsbereich

Um Ihre lokale Version mit der neuesten Arbeitsbereichsversion zu aktualisieren, rufen Sie die Remoteversion ab:

  1. Zeigen Sie in VS Code Explorer auf den Namen des Notizbuchs, das Sie aktualisieren möchten. Die Optionen werden rechts neben dem Namen angezeigt, einschließlich der Option Notebook aktualisieren.

    Screenshot: VS Code Explorer, in dem die Option **Notebook aktualisieren** ausgewählt werden soll.

  2. VS Code ruft die neueste Version aus dem Remotearbeitsbereich ab und öffnet den VS Code diff-Editor, um die beiden Notebookdateien zu vergleichen. Der linke Seitenbildschirm stammt aus dem Arbeitsbereich, der rechte Bildschirm aus der lokalen Version:

    Screenshot: update notebook diff

  3. Aktualisieren Sie die Code-/Markdownzelle auf der linken Seite, um das Problem zu beheben.

  4. Wenn alle Konflikte behoben sind, wählen Sie in der oberen rechten Ecke des diff-Editors die Option Merge aus, um zu bestätigen, dass die Zusammenführung abgeschlossen ist. (Bis Sie Zusammenführen auswählen, bleibt das Notebook im Konfliktmodus .

    Screenshot der oberen rechten Ecke des VS Code-diff-Editor-Bildschirms, der zeigt, wo die Option Zusammenführen ausgewählt werden soll.

Wichtig

Nachdem der diff-Editor einmal geöffnet wurde, aktualisiert die Erweiterung nicht automatisch die linke Seite der diff Ansicht, um das neueste Update aus dem Remotearbeitsbereich abzurufen.

Ausführen oder Debuggen eines Notebooks auf Spark-Remotecomputing

Wenn Sie den kernel synapse-spark-kernel auswählen, der mit dieser Erweiterung geliefert wird, können Sie die Codezelle auf dem Remote-Fabric Spark-Compute ausführen. Sobald dieser Kernel ausgewählt ist, fängt die Erweiterung während der Laufzeit alle PySpark-API-Aufrufe ab und übersetzt sie in den entsprechenden HTTP-Aufruf des Spark-Remotecomputes. Bei reinem Python-Code wird er weiterhin in der lokalen Umgebung ausgeführt.

Screenshot, der zeigt, wo ein Notebook ausgeführt werden soll.

Nächste Schritte