Tworzenie notesów usługi Microsoft Fabric i zarządzanie nimi w programie Visual Studio Code

Rozszerzenie programu Visual Studio (VS) Code dla usługi Synapse w pełni obsługuje operacje notesu CRUD (tworzenie, odczytywanie, aktualizowanie i usuwanie) w sieci szkieletowej. Rozszerzenie obsługuje również synchronizację między lokalnymi i zdalnymi obszarami roboczymi; podczas synchronizowania zmian można rozwiązać wszelkie konflikty lub różnice między lokalnym i zdalnym obszarem roboczym.

Dzięki temu rozszerzeniu można również uruchamiać notesy na zdalnych obliczeniach platformy Apache Spark dla sieci szkieletowej.

Otwieranie notesu przy użyciu rozszerzenia synapse

Klikając przycisk Otwórz w programie VS Code na stronie tworzenia notesu w portalu sieci szkieletowej, możesz bezpośrednio otworzyć ten sam notes za pomocą rozszerzenia usługi Synapse VS Code dla sieci szkieletowej. Po aktywowaniu rozszerzenia w programie VS Code i otwarciu notesu ponownie obszar roboczy powinien automatycznie łączyć się z notesem.

Napiwek

Jeśli rozszerzenie synapse dla programu VS Code nie zostało zainstalowane, należy zainstalować je najpierw. Aby uzyskać więcej informacji, zobacz Instalowanie rozszerzenia usługi Synapse. Po publicznym wydaniu rozszerzenia instalacja zostanie zautomatyzowana.

Wyświetlanie listy notesów

Węzeł drzewa notesu zawiera listę wszystkich elementów notesu w bieżącym obszarze roboczym. Na podstawie zmian w programie VS Code na liście są wyświetlane różne kolory i znaki wskazujące najnowszy stan, jak pokazano na poniższej ilustracji.

• Ustawienie domyślne: Biały tekst i żaden znak po prawej stronie nazwy notesu wskazuje domyślny lub zainicjowany stan. Notes istnieje w zdalnym obszarze roboczym i nie pobrano go lokalnie.
• Zmodyfikowane: znak języka M po prawej stronie nazwy i żółty tekst wskazuje, że pobrano i edytowano notes lokalnie w programie VS Code i nie opublikowano jeszcze oczekujących zmian w zdalnym obszarze roboczym.
• Lokalne: znak L i zielony tekst wskazują, że notes jest pobierany, a zawartość jest taka sama jak w zdalnym obszarze roboczym.
• Konflikt: znak C i czerwony tekst wskazują, że istnieją konflikty między wersją lokalną a wersją zdalnego obszaru roboczego.

Tworzenie notesu

1. W Eksploratorze programu VS Code umieść kursor na pasku narzędzi notesu. Zostanie wyświetlona opcja Utwórz notes .

   

2. Wybierz pozycję Utwórz notes i wprowadź nazwę i opis. Nowy notes zostanie utworzony w zdalnym obszarze roboczym i zostanie wyświetlony na liście notesów w stanie domyślnym.

Pobieranie notesu

Aby można było edytować zawartość notesu, należy pobrać notes do programu VS Code.

1. Na liście notesów w programie VS Code umieść kursor na nazwie notesu. Opcja Pobierz jest wyświetlana obok nazwy notesu.

   

2. Wybierz pozycję Pobierz i zapisz notes w lokalnym katalogu roboczym.

Otwieranie notesu

1. W Eksploratorze programu VS Code umieść kursor nad nazwą pobranego notesu. Obok notesu pojawi się kilka opcji, w tym opcja Otwórz folder notesu.

   

2. Wybierz pozycję Otwórz folder notesu, a notes zostanie otwarty na ekranie Edytora programu VS Code.

Usuwanie notesu

Napiwek

Aby uniknąć awarii, zamknij folder notesu w widoku Eksploratora i zamknij notes w widoku edytora przed usunięciem notesu.

Aby usunąć notes:

1. W Eksploratorze programu VS Code umieść kursor nad nazwą notesu, który chcesz usunąć; opcje są wyświetlane po prawej stronie nazwy, w tym opcji Usuń notes .

   

2. Wybierz opcję Usuń notes. Po wyświetleniu monitu wybierz opcję usunięcia tylko kopii lokalnej lub lokalnej i zdalnej kopii obszaru roboczego.

Publikowanie lokalnych zmian w zdalnym obszarze roboczym

Aby wypchnąć zmiany lokalne do zdalnego obszaru roboczego:

1. W Eksploratorze programu VS Code umieść kursor nad nazwą notesu, który chcesz opublikować w zdalnym obszarze roboczym; opcje są wyświetlane po prawej stronie nazwy, w tym opcji Publikuj .

   

2. Wybierz Publikuj. Wersja zdalnego obszaru roboczego jest aktualizowana wraz ze zmianami lokalnego programu VS Code.

   • Jeśli aktualizacja lokalna tworzy konflikty scalania, zostanie wyświetlony monit o ich rozwiązanie przed przejściem scalania.

3. Jeśli ktoś inny ma ten sam notes otwarty w portalu sieci szkieletowej, otrzyma powiadomienie o zaakceptowaniu lub odrzuceniu lokalnych zmian programu VS Code, jak pokazano na poniższej ilustracji.

   

   • Zaakceptuj: zmiana z programu VS Code została pomyślnie zapisana w obszarze roboczym.
   • Odrzuć: zmiana z programu VS Code jest ignorowana.

Ściąganie zmian ze zdalnego obszaru roboczego

Aby zaktualizować wersję lokalną przy użyciu najnowszej wersji obszaru roboczego, należy ściągnąć wersję zdalną:

1. W Eksploratorze programu VS Code umieść kursor na nazwie notesu, który chcesz zaktualizować; opcje są wyświetlane po prawej stronie nazwy, w tym opcji Aktualizuj notes .

   

2. Wybierz opcję Aktualizuj notes. Program VS Code ściąga najnowszą wersję ze zdalnego obszaru roboczego i otwiera edytor różnic programu VS Code, aby można było porównać dwa pliki notesu. Lewy ekran znajduje się w obszarze roboczym, a po prawej stronie znajduje się wersja lokalna:

   

3. Zaktualizuj komórkę kodu/markdown po lewej stronie, aby rozwiązać problem.

4. Po usunięciu wszystkich konfliktów wybierz opcję Scal w prawym górnym rogu edytora różnic, aby potwierdzić ukończenie scalania. (Do momentu wybrania Scal, notes pozostaje w trybie konfliktów ).

   

Ważne

Po otwarciu edytora różnic raz rozszerzenie NIE będzie automatycznie odświeżać lewej strony widoku różnic, aby pobrać najnowszą aktualizację ze zdalnego obszaru roboczego.

Uruchamianie lub debugowanie notesu na zdalnych obliczeniach platformy Spark

Wybierając jądro synapse-spark-kernel dostarczane z tym rozszerzeniem, można uruchomić komórkę kodu na podstawie zdalnego obliczeń spark. Po wybraniu tego jądra w czasie wykonywania rozszerzenie przechwytuje wszystkie wywołania interfejsu API PySpark i tłumaczy je na odpowiednie wywołanie http do zdalnego obliczenia spark. W przypadku czystego kodu w języku Python jest on nadal wykonywany w środowisku lokalnym.

Powiązana zawartość

• Tworzenie definicji zadań platformy Apache Spark i zarządzanie nimi w programie Visual Studio Code
• Eksplorowanie usługi Microsoft Fabric lakehouses w programie Visual Studio Code