Udostępnij za pośrednictwem


Notesy SQL (wersja testowa)

Notesy SQL w rozszerzeniu MSSQL dla programu Visual Studio Code zapewniają programowanie sql oparte na notesach przy użyciu natywnych notesów Jupyter programu Visual Studio Code. Możesz połączyć interakcyjne wykonywanie zapytań SQL z komórkami dokumentacji języka Markdown, aby tworzyć kolekcje zapytań z możliwością uruchamiania, operacje bazy danych dokumentów i udostępniać powtarzalną analizę.

Wskazówka

Notesy SQL są obecnie dostępne w wersji zapoznawczej i mogą ulec zmianie na podstawie opinii. Dołącz do społeczności w dyskusjach usługi GitHub , aby podzielić się pomysłami lub zgłaszać problemy.

Features

Notesy SQL oferują następujące możliwości:

  • Wykonywanie zapytań T-SQL w sposób interaktywny w komórkach kodu notesu z wynikami wyświetlanymi poniżej każdej komórki.

  • Aby uzyskać pełną zgodność z istniejącymi narzędziami notesu, użyj natywnego formatu notesu Jupyter programu Visual Studio Code (pliki .ipynb).

  • Wyświetl wyniki zapytania w bogatej siatce danych z sortowaniem, filtrowaniem, wybieraniem komórek, wyróżnianiem wartości null i opcjami kopiowania (w tym kopiowanie z nagłówkami).

  • Pisanie kodu SQL za pomocą funkcji IntelliSense, w tym sugestii dotyczących nazw tabel i kolumn na podstawie aktywnego połączenia z bazą danych.

  • Dodaj komórki Markdown obok komórek kodu SQL, aby dokumentować zapytania SQL, dodawać adnotacje do wyników i tworzyć narracyjne przepływy pracy.

  • Połącz każdy notebook z wystąpieniem programu SQL Server i przełącz się między bazami danych na tym samym serwerze.

  • Uruchamiaj komórki indywidualnie lub uruchamiaj wszystkie komórki sekwencyjnie.

  • GitHub Copilot umożliwia korzystanie z sugestii zapytań wbudowanych w komórki kodu oraz tworzenie notatników w oparciu o interakcję w czacie, aby generować kompletne notatniki na podstawie opisów w języku naturalnym.

  • Połącz komórki SQL z innymi jądrami języka (takimi jak Python) w tym samym notesie, instalując rozszerzenie Jupyter.

  • Eksportuj i udostępniaj notesy jako .ipynb pliki, które inne osoby mogą otwierać w programie Visual Studio Code lub dowolnym środowisku zgodnym z programem Jupyter.

Wymagania wstępne

Przed rozpoczęciem korzystania z notesów SQL upewnij się, że zostały spełnione następujące wymagania:

Tworzenie notesu SQL

Nowy notes SQL można utworzyć na kilka sposobów:

  • Otwórz paletę poleceń (Ctrl+Shift+P w systemach Windows i Linux lub Cmd+Shift+P w systemie macOS), wpisz New Notebook, a następnie wybierz polecenie.

  • Przejdź do menu Plik i wybierz pozycję Nowy plik, a następnie wybierz typ notesu Jupyter.

  • Kliknij prawym przyciskiem myszy bazę danych w Eksploratorze obiektów rozszerzenia MSSQL i wybierz pozycję Nowy notes z menu kontekstowego.

Podczas tworzenia nowego notesu wybierz jądro MSSQL , aby włączyć wykonywanie języka T-SQL w komórkach kodu.

Połącz z bazą danych

Każdy notes SQL wymaga aktywnego połączenia z bazą danych w celu uruchamiania zapytań. Po otwarciu notesu z jądrem MSSQL rozszerzenie wyświetli monit o wybranie profilu połączenia lub utworzenie nowego.

Ważna

Każdy notatnik obsługuje pojedyncze połączenie serwera na jedno jądro. Możesz nawiązać połączenie z jednym wystąpieniem programu SQL Server i przełączać się między bazami danych na tym serwerze, ale nie można nawiązać połączenia z wieloma serwerami w tym samym notesie. Aby pracować z innym serwerem, utwórz oddzielny notes lub zmień połączenie notesu.

Zapisywanie i uruchamianie komórek SQL

Komórki kodu SQL umożliwiają interaktywne pisanie i wykonywanie zapytań T-SQL w notesie.

  1. Wybierz pozycję + Kod na pasku narzędzi notesu, aby dodać nową komórkę kodu.

  2. Wprowadź zapytanie T-SQL w komórce. Komórka zapewnia takie samo środowisko edycji SQL jak standardowy edytor zapytań, w tym IntelliSense z sugestiami nazw tabel i kolumn z połączonej bazy danych.

  3. Wybierz pozycję Uruchom komórkę (przycisk odtwarzania po lewej stronie komórki), aby wykonać zapytanie.

  4. Wyniki są wyświetlane bezpośrednio pod komórką w złożonej siatce danych.

Aby uruchomić wszystkie komórki w notesie sekwencyjnie, wybierz pozycję Uruchom wszystko na pasku narzędzi notesu.

Wskazówka

Użyj klawiszy Ctrl+Enter (Windows i Linux) lub Cmd+Enter (macOS), aby uruchomić bieżącą komórkę i pozostać na niej. Użyj klawisza Shift+Enter, aby uruchomić bieżącą komórkę i przejść do następnego.

Wyniki zapytania

Wyniki zapytań w notatnikach SQL zapewniają takie samo bogate doświadczenie z siatką danych, jakie występuje w standardowym edytorze zapytań.

  • Sortowanie: wybierz nagłówek kolumny, aby posortować wyniki rosnąco lub malejąco.
  • Filtrowanie: użyj ikony filtru w nagłówkach kolumn, aby filtrować dane wynikowe.
  • Zaznaczenie komórki: zaznacz poszczególne komórki lub zakresy komórek w siatce wyników.
  • Wyróżnianie wartości null: NULL wartości są wizualnie wyróżnione w siatce wyników w celu łatwej identyfikacji.
  • Opcje kopiowania: kliknij prawym przyciskiem myszy zaznaczone komórki, aby uzyskać dostęp do pozycji Kopiuj, Kopiuj z nagłówkami i Wybierz wszystkie opcje.

Dodaj komórki markdown

Komórki języka Markdown umożliwiają dodawanie sformatowanego tekstu, nagłówków, list i linków obok komórek kodu SQL. Służy do dokumentowania zapytań, wyjaśniania logiki biznesowej lub dodawania notatek dotyczących oczekiwanych wyników.

  1. Wybierz pozycję + Markdown na pasku narzędzi notesu, aby dodać nową komórkę tekstową.

  2. Wpisz zawartość języka Markdown. Podgląd jest wyświetlany podczas wpisywania.

  3. Zaznacz poza komórką, aby renderować tekst Markdown.

Ponownie wybierz komórkę, aby powrócić do trybu edycji.

Korzystanie z wielu jąder

Rozszerzenie MSSQL udostępnia gotowe jądro SQL. Notesy można rozszerzyć o więcej jąder do języków, instalując rozszerzenie Jupyter, które zawiera obsługę dla Pythona i innych jąder. Zapytania SQL dotyczące danych można łączyć z komórkami do przetwarzania danych i wizualizacji w języku Python w tym samym notesie.

Integracja z usługą GitHub Copilot

Narzędzie GitHub Copilot współpracuje z notesami SQL, aby ułatwić pisanie zapytań i generowanie notesów. Po zainstalowaniu rozszerzenia GitHub Copilot uzyskasz następujące informacje:

  • Sugestie wbudowane: podczas wpisywania w komórkach kodu SQL narzędzie GitHub Copilot sugeruje uzupełnianie zapytań na podstawie kontekstu bazy danych i otaczających komórek języka Markdown.

  • Tworzenie notesów opartych na czacie: użyj funkcji GitHub Copilot Chat, aby wygenerować kompletne notesy ze zmieniającymi się komórkami Markdown i SQL. Opisz analizę, którą chcesz wykonać, a narzędzie GitHub Copilot tworzy pełną strukturę notesu.

Możesz na przykład otworzyć aplikację GitHub Copilot Chat i użyć monitu, takiego jak:

I have a SQL Notebook open connected to AdventureWorks. Create cells for a sales
analysis: list all tables, find top 10 customers by revenue, show revenue by product
category, and demonstrate a safe data modification using BEGIN TRAN / ROLLBACK.

Narzędzie GitHub Copilot generuje komórki dokumentacji języka Markdown i komórki kodu T-SQL, które można uruchamiać pojedynczo lub wszystkie jednocześnie przy użyciu polecenia Uruchom wszystko.

Przełączanie baz danych

Aby przełączyć się do innej bazy danych w ramach tego samego połączenia serwera:

  1. Wybierz nazwę bazy danych wyświetlaną w obszarze stanu połączenia notatnika.

  2. Wybierz inną bazę danych z listy rozwijanej.

Wszystkie kolejne wykonania komórek używają nowo wybranej bazy danych.

Uwaga / Notatka

Aby przełączyć się na inny serwer, musisz zmienić profil połączenia notatnika. Rozważ utworzenie oddzielnego notesu dla każdego serwera, z którym musisz pracować.

Ograniczenia

Pojedyncze połączenie serwera na notatnik: obecnie każdy notatnik łączy się z jednym wystąpieniem programu SQL Server. Można przełączać bazy danych na tym serwerze, ale nie można nawiązać połączenia z drugim serwerem w tym samym notesie.

Opinie i wsparcie

Jeśli masz pomysły, opinie lub chcesz zaangażować się w społeczność, dołącz do dyskusji na stronie https://aka.ms/vscode-mssql-discussions. Aby zgłosić usterkę, odwiedź stronę https://aka.ms/vscode-mssql-bug. Aby zażądać nowej funkcji, przejdź do strony https://aka.ms/vscode-mssql-feature-request.