Pisanie zapytań i eksplorowanie danych w edytorze SQL

Interfejs użytkownika usługi Azure Databricks zawiera edytor SQL, którego można użyć do tworzenia zapytań, przeglądania dostępnych danych i tworzenia wizualizacji. Zapisane zapytania można również udostępniać innym członkom zespołu w obszarze roboczym. W tym artykule wyjaśniono, jak używać edytora SQL do pisania, uruchamiania zapytań i zarządzania nimi. Nowa wersja edytora SQL jest dostępna w publicznej wersji zapoznawczej. Aby dowiedzieć się, jak włączyć i pracować z nowym edytorem SQL, zobacz Współpraca ze współpracownikami przy użyciu nowego edytora SQL.

Po otwarciu edytora możesz utworzyć zapytanie SQL lub przejrzeć dostępne dane. Edytor tekstów obsługuje autouzupełnianie, autoformatowanie i różne inne skróty klawiaturowe.

Wiele zapytań można otwierać przy użyciu kart zapytań w górnej części edytora tekstów. Każda karta zapytania zawiera kontrolki uruchamiania zapytania, oznaczania zapytania jako ulubionego i nawiązywania połączenia z usługą SQL Warehouse. Możesz również zapisywać, planować lub udostępniać zapytania.

Otwieranie edytora SQL

Aby otworzyć edytor SQL w interfejsie użytkownika usługi Azure Databricks, kliknij pozycję Edytor SQL na pasku bocznym.

Edytor SQL otwiera ostatnie otwarte zapytanie. Jeśli żadne zapytanie nie istnieje lub wszystkie zapytania zostały jawnie zamknięte, zostanie otwarte nowe zapytanie. Jest on automatycznie nazwany Nowe zapytanie , a sygnatura czasowa tworzenia jest dołączana w tytule.

Nawiązywanie połączenia z obliczeniami

Aby uruchamiać zapytania, musisz mieć co najmniej uprawnienia CAN USE w uruchomionym magazynie SQL Warehouse. Aby wyświetlić dostępne opcje, możesz użyć listy rozwijanej w górnej części edytora. Aby przefiltrować listę, wprowadź tekst w polu tekstowym.

Po pierwszym utworzeniu zapytania lista dostępnych magazynów SQL jest wyświetlana alfabetycznie. Ostatnio używany magazyn SQL Jest wybierany przy następnym utworzeniu zapytania.

Ikona obok usługi SQL Warehouse wskazuje stan:

• Bieganie
• Początkowy
• Zatrzymany

Uwaga

Jeśli na liście nie ma żadnych magazynów SQL, skontaktuj się z administratorem obszaru roboczego.

Wybrany magazyn SQL Warehouse zostanie automatycznie uruchomiony ponownie po uruchomieniu zapytania. Zobacz Rozpoczynanie pracy z usługą SQL Warehouse , aby dowiedzieć się więcej o innych sposobach uruchamiania usługi SQL Warehouse.

Przeglądanie obiektów danych w edytorze SQL

Jeśli masz uprawnienie do odczytu metadanych, przeglądarka schematu w edytorze SQL wyświetla dostępne bazy danych i tabele. Możesz również przeglądać obiekty danych z Catalog Explorer.

Można nawigować po obiektach bazy danych zarządzanych przez Unity Catalog w Eksploratorze katalogu bez aktywnego obliczeń. Aby przeglądać dane w hive_metastore i innych katalogach, które nie podlegają Unity Catalog, musisz uzyskać odpowiednie uprawnienia, aby podłączyć się do zasobów obliczeniowych. Zobacz zarządzanie danymi za pomocą usługi Unity Catalog.

Uwaga

Jeśli w przeglądarce schematu lub Eksploratorze wykazu nie istnieją żadne obiekty danych, skontaktuj się z administratorem obszaru roboczego.

Kliknij ikonę odświeżenia schematu w górnej części przeglądarki schematu, aby odświeżyć schemat. Schemat można filtrować, wpisując ciągi filtru w polu wyszukiwania.

Kliknij nazwę tabeli, aby wyświetlić kolumny dla tej tabeli.

Tworzenie zapytania

Możesz wprowadzić tekst, aby utworzyć zapytanie w edytorze SQL. Elementy można wstawić z przeglądarki schematów do odwołań do katalogów i tabel.

1. Wpisz zapytanie w edytorze SQL.

   Edytor SQL obsługuje autouzupełnianie. Podczas wpisywania autouzupełnianie sugeruje ukończenie. Na przykład, jeśli prawidłowym uzupełnieniem w miejscu kursora jest kolumna, autouzupełnianie sugeruje nazwę kolumny. Jeśli wpiszesz select * from table_name as t where t., funkcja autouzupełniania rozpoznaje, że t jest aliasem table_name i sugeruje kolumny w table_name.

   

2. (Opcjonalnie) Po zakończeniu edytowania kliknij przycisk Zapisz. Domyślnie zapytanie jest zapisywane w folderze głównym użytkownika lub możesz wybrać inną lokalizację. Następnie kliknij przycisk Zapisz.

Włączanie i wyłączanie autouzupełniania

Autouzupełnianie na żywo może uzupełniać tokeny schematu, identyfikatory składni zapytań (takie jak SELECT i JOIN) oraz tytuły fragmentów zapytań, takich jak i. Jest ona domyślnie włączona, chyba że schemat bazy danych przekracza pięć tysięcy tokenów (tabel lub kolumn).

Użyj przełącznika poniżej edytora SQL, aby wyłączyć lub włączyć automatyczne uzupełnianie na żywo.

• Aby wyłączyć autouzupełnianie na żywo, naciśnij Ctrl + Spacja lub kliknij przycisk poniżej edytora SQL.

Zapisywanie zapytań

Przycisk Zapisz w prawym górnym rogu edytora SQL zapisuje zapytanie.

Ważne

Podczas modyfikowania zapytania, ale nie klikaj jawnie przycisku Zapisz, ten stan jest zachowywany jako wersja robocza zapytania. Wersje robocze zapytań są przechowywane przez 30 dni. Po upływie 30 dni wersje robocze zapytań zostaną automatycznie usunięte. Aby zachować zmiany, musisz je jawnie zapisać.

Edytowanie wielu zapytań

Domyślnie edytor SQL używa kart, dzięki czemu można jednocześnie edytować wiele zapytań. Aby otworzyć nową kartę, kliknij przycisk +, a następnie wybierz opcję Utwórz nowe zapytanie lub Otwórz istniejące zapytanie. Kliknij Otwórz istniejące zapytanie, aby wyświetlić listę zapisanych zapytań. kliknij pozycję Moje zapytania lub Ulubione, aby przefiltrować listę zapytań. W wierszu zawierającym zapytanie, które chcesz wyświetlić, kliknij przycisk Otwórz.

Uruchamianie pojedynczego zapytania lub wielu zapytań

Aby uruchomić zapytanie lub wszystkie zapytania:

1. Wybierz usługę SQL Warehouse.

2. Wyróżnij zapytanie w edytorze SQL (jeśli wiele zapytań jest w okienku zapytania).

3. Naciśnij Ctrl/Cmd + Enter lub kliknij Uruchom (1000), aby wyświetlić wyniki jako tabelę w okienku wyników.

   

Uwaga

limit 1000 jest domyślnie wybierany dla wszystkich zapytań w celu ograniczenia powrotu zapytania do 1000 wierszy. Jeśli zapytanie zostanie zapisane przy użyciu ustawienia Limit 1000, to ustawienie dotyczy wszystkich przebiegów zapytań (w tym na pulpitach nawigacyjnych). Aby zwrócić wszystkie wiersze dla tego zapytania, możesz usunąć zaznaczenie LIMIT 1000, klikając listę rozwijaną Uruchom (1000). Jeśli chcesz określić inny limit liczby wierszy, możesz dodać klauzulę LIMIT w zapytaniu z wybraną wartością.

Kończenie zapytania

Aby zakończyć wykonywanie zapytania, kliknij przycisk Anuluj. Administrator może zatrzymać wykonywanie zapytania uruchomionego przez innego użytkownika, wyświetlając polecenie Zakończ wykonywanie zapytania.

Opcje zapytań

Możesz użyć menu kontekstowego kebab w górnej części edytora zapytań, aby uzyskać dostęp do opcji menu klonowania, przywracania, formatowania i edytowania informacji o kwerendzie.

Przywracanie do zapisanego zapytania

Podczas edytowania zapytania zostanie wyświetlona opcja Przywróć zmiany w menu kontekstowym zapytania. Możesz kliknąć pozycję Przywróć, aby wrócić do zapisanej wersji.

Odrzucanie i przywracanie zapytań

Aby przenieść zapytanie do kosza:

• Kliknij menu kontekstowe kebab obok zapytania w edytorze SQL i wybierz pozycję Przenieś do kosza.
• Kliknij pozycję Przenieś do kosza , aby potwierdzić.

Aby odzyskać zapytanie z kosza:

1. Na liście Wszystkie zapytania kliknij pozycję .
2. Kliknij zapytanie.
3. Kliknij menu kontekstowe typu kebab w prawym górnym rogu edytora SQL i kliknij pozycję Przywróć.

Ustawianie opisu zapytania i wyświetlanie informacji o kwerendzie

Aby ustawić opis zapytania:

1. Kliknij menu kontekstowe kebab obok zapytania, a następnie kliknij pozycję Edytuj informacje o kwerendzie.

   

2. W polu tekstowym Opis wprowadź opis. Następnie kliknij przycisk Zapisz. Możesz również wyświetlić historię zapytania, w tym czas jego utworzenia i zaktualizowania w tym oknie dialogowym.

Zapytania ulubione i tagowe

Możesz użyć ulubionych i tagów, aby filtrować listy zapytań i pulpitów nawigacyjnych wyświetlanych na stronie docelowej obszaru roboczego oraz na każdej ze stron listy dla pulpitów nawigacyjnych i zapytań.

Ulubione: Aby dodać zapytanie do ulubionych, kliknij gwiazdkę po lewej stronie jego tytułu na liście zapytań. Gwiazda zmieni kolor na żółty.

Tagi: zapytania i pulpity nawigacyjne można tagować przy użyciu dowolnego znaczącego ciągu w organizacji.

Dodaj tag

Dodaj tagi w edytorze zapytań.

1. Kliknij menu kontekstowe kebab obok zapytania, a następnie kliknij pozycję Edytuj informacje o kwerendzie. Zostanie wyświetlone okno dialogowe Informacje o kwerendzie.

2. Jeśli zapytanie nie ma zastosowanych tagów, w polu tekstowym, gdzie pojawią się tagi, wyświetla się napisDodaj kilka tagów. Aby utworzyć nowy tag, wpisz go w polu . Aby wprowadzić wiele tagów, naciśnij Tab między wpisami.

   

3. Kliknij przycisk Zapisz , aby zastosować tagi i zamknąć okno dialogowe.

Usuwanie tagów

1. Kliknij menu kontekstowe kebab obok zapytania, a następnie kliknij pozycję Edytuj informacje o kwerendzie.
2. Kliknij X na dowolnym tagu, który chcesz usunąć.
3. Kliknij przycisk Zapisz , aby zamknąć okno dialogowe.

Wyświetlanie wyników zapytania

Po uruchomieniu zapytania wyniki pojawią się w okienku poniżej. Nowa tabela wyników jest ON dla nowych zapytań. W razie potrzeby kliknij listę rozwijaną, aby ją wyłączyć. Obrazy w tej sekcji używają nowej tabeli wyników.

Możesz korzystać z wyników zapytania i eksplorować je przy użyciu okienka wyników. Okienko wyników zawiera następujące funkcje do eksplorowania wyników:

Wizualizacje, filtry i parametry

Kliknij przycisk , aby dodać wizualizację, filtr lub parametr. Pojawią się następujące opcje:

Wizualizacja: wizualizacje mogą ułatwić eksplorowanie zestawu wyników. Aby uzyskać pełną listę dostępnych typów wizualizacji, zobacz Typy wizualizacji.

Filtr: filtry umożliwiają ograniczenie zestawu wyników po wykonaniu zapytania. Filtry można stosować do selektywnego pokazywania różnych podzestawów danych. Zobacz Filtry zapytań , aby dowiedzieć się, jak używać filtrów.

Parametr: Parametry umożliwiają ograniczenie zestawu wyników przez podstawianie wartości do zapytania w czasie jego wykonywania. Aby dowiedzieć się, jak stosować parametry, zobacz Pracę z parametrami zapytania.

Edytowanie, pobieranie lub dodawanie do pulpitu nawigacyjnego

Ważne

• Usługa Databricks zaleca korzystanie z pulpitów nawigacyjnych AI/BI (dawniej pulpitów nawigacyjnych usługi Lakeview). Starsze wersje pulpitów nawigacyjnych, nazywane wcześniej pulpitami nawigacyjnymi SQL usługi Databricks, są teraz nazywane starszymi pulpitami nawigacyjnymi. Usługa Databricks nie zaleca tworzenia nowych starszych pulpitów nawigacyjnych.

Harmonogram zakończenia wsparcia technicznego:

• 7 kwietnia 2025 r.: zakończy się oficjalna obsługa starszych wersji pulpitów nawigacyjnych. Zostaną rozwiązane tylko krytyczne problemy z zabezpieczeniami i awarie usługi.

• 3 listopada 2025 r.: Usługa Databricks rozpocznie archiwizowanie starszych pulpitów nawigacyjnych, do których nie uzyskiwano dostępu w ciągu ostatnich sześciu miesięcy. Zarchiwizowane pulpity nawigacyjne nie będą już dostępne, a proces archiwizacji będzie występować w sposób ciągły. Dostęp do aktywnie używanych pulpitów nawigacyjnych pozostanie niezmieniony.

  Databricks będzie współpracować z klientami w celu opracowania planów migracji dla aktywnych przestarzałych pulpitów nawigacyjnych po 3 listopada 2025 r.

• Konwertowanie starszych pulpitów nawigacyjnych przy użyciu narzędzia do migracji lub interfejsu API REST. Aby uzyskać instrukcje dotyczące korzystania z wbudowanego narzędzia do migracji, zobacz Klonowanie starszego pulpitu nawigacyjnego do pulpitu nawigacyjnego AI/BI. Zobacz Samouczki dotyczące pulpitów nawigacyjnych , aby zapoznać się z samouczkami dotyczącymi tworzenia pulpitów nawigacyjnych i zarządzania nimi przy użyciu interfejsu API REST.

Kliknij kartę wyników, aby wyświetlić więcej opcji.

1. Kliknij przycisk Edytuj , aby dostosować wyniki wyświetlane w wizualizacji.
2. Kliknij przycisk Usuń, aby usunąć kartę wyników.
3. Kliknij pozycję Duplikuj , aby sklonować kartę wyników.
4. Kliknij pozycję Dodaj do pulpitu nawigacyjnego , aby skopiować zapytanie i wizualizację do nowego pulpitu nawigacyjnego.
   • Ta akcja powoduje utworzenie nowego pulpitu nawigacyjnego zawierającego wszystkie wizualizacje skojarzone z zapytaniem. Zobacz Pulpity nawigacyjne, aby dowiedzieć się, jak edytować pulpit nawigacyjny.
   • Zostanie wyświetlony monit o wybranie nazwy nowego pulpitu nawigacyjnego. Nowy pulpit nawigacyjny jest zapisywany w folderze głównym.
   • Nie można dodać wyników do istniejącego pulpitu nawigacyjnego.
5. Kliknij pozycję Dodaj do starszego pulpitu nawigacyjnego , aby dodać kartę wyników do nowego lub istniejącego starszego pulpitu nawigacyjnego.
6. Kliknij dowolną z opcji pobierania, aby pobrać wyniki. Aby uzyskać szczegółowe informacje i limity, zobacz następujący opis.

Wyniki pobierania: wyniki można pobrać jako plik CSV, TSV lub Excel.

Możesz pobrać do około 1 GB danych wyników z usługi Databricks SQL w formacie CSV i TSV oraz maksymalnie 100 000 wierszy do pliku programu Excel.

Ostateczny rozmiar pobierania pliku może być nieco większy lub mniejszy niż 1 GB, ponieważ limit 1 GB jest stosowany do wcześniejszego kroku niż pobieranie pliku końcowego.

Uwaga

Jeśli nie możesz pobrać zapytania, administrator obszaru roboczego wyłączył pobieranie dla obszaru roboczego.

Poprzednie wykonania

Poprzednie uruchomienia zapytania można wyświetlić, w tym pełną składnię zapytania. Poprzednie wykonania są otwierane w trybie tylko do odczytu i zawierają przyciski klonowania do nowego zapytania lub wznawiania edycji. Ta karta nie zawiera zaplanowanych przebiegów.

Eksplorowanie wyników

Zwrócone wyniki zapytania są wyświetlane poniżej zapytania. Karta Nieprzetworzone wyniki jest wypełniana zwracanymi wierszami. Za pomocą wbudowanych filtrów można zmienić kolejność wyników, rosnąco lub malejąco. Możesz również użyć filtru, aby wyszukać wiersze wyników, które zawierają określoną wartość.

Karty w okienku wyników umożliwiają dodawanie wizualizacji, filtrów i parametrów.

Filtrowanie listy zapisanych zapytań w oknie zapytania

W oknie zapytania można filtrować listę wszystkich zapytań według listy utworzonych zapytań (Moje zapytania), według ulubionych i według tagów.

Automatyzowanie aktualizacji

Możesz użyć przycisku Harmonogram, aby ustawić automatyczne cykle uruchamiania zapytań. Aktualizacje automatyczne mogą ułatwić aktualizowanie pulpitów nawigacyjnych i raportów przy użyciu najbardziej aktualnych danych. Zapytania schedueled mogą również włączać alerty SQL usługi Databricks, specjalny typ zaplanowanego zadania, które wysyła powiadomienia, gdy wartość osiągnie określony próg.

Zobacz Planowanie zapytania.

Zobacz Co to są alerty SQL usługi Databricks?.

Udostępnianie zapytań

Przycisk Udostępnij umożliwia udostępnianie zapytania innym użytkownikom w obszarze roboczym. Podczas udostępniania wybierz między następującymi opcjami:

• Uruchom jako właściciel (poświadczenia właściciela): To ustawienie oznacza, że osoby przeglądające mogą uzyskiwać dostęp do tych samych wyników zapytania co właściciel zapytania. Dotyczy to zaplanowanych lub ręcznych przebiegów zapytań.
• Uruchom jako osoba przeglądająca (poświadczenia osoby przeglądającej): to ustawienie ogranicza wyniki do przypisanych uprawnień osoby przeglądającej.

Zobacz Konfigurowanie uprawnień zapytania.

Następny krok

Zobacz Uzyskiwanie dostępu do zapisanych zapytań i zarządzanie nimi, aby dowiedzieć się, jak pracować z zapytaniami za pomocą interfejsu użytkownika usługi Azure Databricks.