Udostępnij za pośrednictwem


Obsługa języka T-SQL w notesach usługi Microsoft Fabric

Funkcja notesu T-SQL w usłudze Microsoft Fabric umożliwia pisanie i uruchamianie kodu T-SQL w notesie. Notesy języka T-SQL umożliwiają zarządzanie złożonymi zapytaniami i pisanie lepszej dokumentacji języka Markdown. Umożliwia również bezpośrednie wykonywanie języka T-SQL w połączonym magazynie lub punkcie końcowym analizy SQL. Dodając punkt końcowy usługi Data Warehouse lub SQL Analytics do notesu, deweloperzy języka T-SQL mogą uruchamiać zapytania bezpośrednio w połączonym punkcie końcowym. Analitycy analizy biznesowej mogą również wykonywać zapytania obejmujące wiele baz danych w celu zbierania szczegółowych informacji z wielu magazynów i punktów końcowych analizy SQL.

Większość istniejących funkcji notesu jest dostępna dla notesów języka T-SQL. Należą do nich wyniki zapytań wykresów, notesy współtworzenia, planowanie regularnych wykonań i wyzwalanie wykonywania w potokach Integracja danych.

Ważne

Ta funkcja jest dostępna w wersji zapoznawczej.

W tym artykule omówiono sposób wykonywania następujących zadań:

  • Tworzenie notesu języka T-SQL
  • Dodawanie punktu końcowego usługi Data Warehouse lub sql analytics do notesu
  • Tworzenie i uruchamianie kodu T-SQL w notesie
  • Używanie funkcji tworzenia wykresów do graficznego reprezentowania wyników zapytań
  • Zapisywanie zapytania jako widoku lub tabeli
  • Uruchamianie zapytań między magazynami
  • Pomiń wykonywanie kodu innego niż T-SQL

Tworzenie notesu języka T-SQL

Aby rozpocząć pracę z tym środowiskiem, możesz utworzyć notes języka T-SQL na następujące dwa sposoby:

  1. Utwórz notes T-SQL ze strony głównej magazynu danych: przejdź do środowiska magazynu danych i wybierz pozycję Notes.

    Zrzut ekranu przedstawiający tworzenie wpisu notesu t-sql na stronie głównej usługi DW.

  2. Utwórz notes języka T-SQL z istniejącego edytora magazynu: przejdź do istniejącego magazynu, na górnej wstążce nawigacji wybierz pozycję Nowe zapytanie SQL, a następnie pozycję Nowy notes zapytań T-SQL

Zrzut ekranu przedstawiający otwieranie notesu z edytora SQL usługi DW.

Po utworzeniu notesu język T-SQL jest ustawiony jako język domyślny. Do notesu można dodawać punkty końcowe magazynu danych lub punktów końcowych analizy SQL z bieżącego obszaru roboczego.

Dodawanie punktu końcowego usługi Data Warehouse lub sql analytics do notesu

Aby dodać punkt końcowy usługi Data Warehouse lub SQL Analytics do notesu, w edytorze notesu wybierz przycisk + Źródła danych i wybierz pozycję Magazyny. W panelu centrum danych wybierz punkt końcowy magazynu danych lub analizy SQL, z którym chcesz nawiązać połączenie.

Zrzut ekranu przedstawiający dodawanie magazynu danych lub punktu końcowego sql do notesu.

Ustawianie magazynu podstawowego

Do notesu można dodać wiele magazynów lub punktów końcowych analizy SQL, a jeden z nich jest ustawiony jako podstawowy. Magazyn podstawowy uruchamia kod T-SQL. Aby go ustawić, przejdź do eksploratora obiektów, wybierz pozycję ... obok magazynu, a następnie wybierz pozycję Ustaw jako podstawowy.

Zrzut ekranu przedstawiający ustawianie magazynu podstawowego.

W przypadku dowolnego polecenia T-SQL, które obsługuje trzyczęściowe nazewnictwo, magazyn podstawowy jest używany jako magazyn domyślny, jeśli nie określono żadnego magazynu.

Tworzenie i uruchamianie kodu T-SQL w notesie

Aby utworzyć i uruchomić kod T-SQL w notesie, dodaj nową komórkę i ustaw język T-SQL jako język komórek.

Zrzut ekranu przedstawiający sposób tworzenia komórki kodu t-sql.

Kod języka T-SQL można wygenerować automatycznie przy użyciu szablonu kodu z menu kontekstowego eksploratora obiektów. Następujące szablony są dostępne dla notesów języka T-SQL:

  • Wybierz 100 pierwszych
  • Utwórz tabelę
  • Utwórz jako wybierz
  • Porzuć
  • Upuść i utwórz

Zrzut ekranu przedstawiający szablon kodu t-sql.

Możesz uruchomić jedną komórkę kodu T-SQL, wybierając przycisk Uruchom na pasku narzędzi komórki lub uruchamiając wszystkie komórki, wybierając przycisk Uruchom wszystko na pasku narzędzi.

Uwaga

Każda komórka kodu jest wykonywana w oddzielnej sesji, więc zmienne zdefiniowane w jednej komórce nie są dostępne w innej komórce.

W tej samej komórce kodu może zawierać wiele wierszy kodu. Użytkownik może wybrać część tego kodu i uruchomić tylko wybrane. Każde wykonanie generuje również nową sesję.

Zrzut ekranu przedstawiający sposób uruchamiania wybranej komórki kodu.

Po wykonaniu kodu rozwiń panel komunikatów, aby sprawdzić podsumowanie wykonania.

Zrzut ekranu przedstawiający podsumowanie wykonania.

Karta Tabela zawiera listę rekordów z zwróconego zestawu wyników. Jeśli wykonanie zawiera wiele zestawów wyników, możesz przełączyć się z jednego do drugiego za pomocą menu rozwijanego.

Zrzut ekranu przedstawiający sposób przełączania na karcie wyników.

Używanie funkcji tworzenia wykresów do graficznego reprezentowania wyników zapytań

Klikając pozycję Inspekcja, można zobaczyć wykresy reprezentujące jakość i rozkład danych każdej kolumny

Zrzut ekranu przedstawiający inspekcję wyniku w formularzu wykresu.

Zapisywanie zapytania jako widoku lub tabeli

Możesz użyć menu Zapisz jako tabelę , aby zapisać wyniki zapytania w tabeli za pomocą polecenia CTAS . Aby użyć tego menu, wybierz tekst zapytania z komórki kodu i wybierz polecenie Zapisz jako menu tabeli .

Zrzut ekranu przedstawiający sposób zapisywania zapytania jako tabeli.

Zrzut ekranu przedstawiający sposób zapisywania tabeli jako okna dialogowego.

Podobnie możesz utworzyć widok z wybranego tekstu zapytania przy użyciu menu Zapisz jako widok na pasku poleceń komórki.

Zrzut ekranu przedstawiający sposób tworzenia widoku.

Zrzut ekranu przedstawiający okno dialogowe zapisywania jako widoku.

Uwaga

  • Ponieważ menu Zapisz jako tabelę i Zapisz jako widok jest dostępne tylko dla zaznaczonego tekstu zapytania, należy wybrać tekst zapytania przed użyciem tych menu.

  • Widok tworzenia nie obsługuje nazewnictwa trzech części, więc widok jest zawsze tworzony w magazynie podstawowym, ustawiając magazyn jako magazyn podstawowy.

Zapytanie obejmujące magazyn między magazynami

Zapytanie między magazynami można uruchomić przy użyciu trzyczęściowego nazewnictwa. Trzyczęściowe nazewnictwo składa się z nazwy bazy danych, nazwy schematu i nazwy tabeli. Nazwa bazy danych to nazwa magazynu lub punktu końcowego analizy SQL, nazwa schematu to nazwa schematu, a nazwa tabeli jest nazwą tabeli.

Zrzut ekranu przedstawiający sposób uruchamiania zapytania między magazynami.

Pomiń wykonywanie kodu innego niż T-SQL

W tym samym notesie można utworzyć komórki kodu używające różnych języków. Na przykład komórka kodu PySpark może poprzedzać komórkę kodu T-SQL. W takim przypadku użytkownik może pominąć uruchamianie dowolnego kodu PySpark dla notesu T-SQL. To okno dialogowe jest wyświetlane po uruchomieniu wszystkich komórek kodu, klikając przycisk Uruchom wszystko na pasku narzędzi.

Zrzut ekranu przedstawiający sposób pomijania kodu innego niż TSQL.

Ograniczenia publicznej wersji zapoznawczej

  • Komórka parametrów nie jest jeszcze obsługiwana w notesie T-SQL. Parametr przekazany z potoku lub harmonogramu nie będzie mógł być używany w notesie języka T-SQL.
  • Funkcja Ostatnie uruchamianie nie jest jeszcze obsługiwana w notesie T-SQL. Aby sprawdzić historię wykonywania notesu T-SQL, należy użyć bieżącej funkcji monitorowania magazynu danych. Aby uzyskać więcej informacji, zobacz artykuł Monitorowanie magazynu danych.
  • Adres URL monitora wewnątrz wykonywania potoku nie jest jeszcze obsługiwany w notesie T-SQL.
  • Funkcja migawki nie jest jeszcze obsługiwana w notesie języka T-SQL.
  • Obsługa narzędzia Pipline w usłudze Git i wdrożeniu nie jest jeszcze obsługiwana w notesie T-SQL.

Aby uzyskać więcej informacji na temat notesów sieci Szkieletowej, zobacz następujące artykuły.