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 filtrować list, wprowadź tekst w polu tekstowym.

Przy pierwszym utworzeniu zapytania, lista dostępnych magazynów SQL jest wyświetlana alfabetycznie według liczby list. 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 w listnie 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 schema w edytorze SQL wyświetla dostępne bazy danych i tables. Możesz również przeglądać obiekty danych z Catalog Explorer.

Można nawigować obiektami bazy danych zarządzanymi przez Unity Catalogw eksploratorze Catalog bez aktywnych obliczeń. Aby eksplorować dane w hive_metastore i innych catalogs, które nie są zarządzane przez Unity Catalog, musisz połączyć się z systemem obliczeniowym z odpowiednimi uprawnieniami. Zobacz zarządzanie danymi przy użyciu Unity Catalog.

Uwaga

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

Kliknij w górnej części przeglądarki schema, aby refreshschema. schema można filtrować, wpisując ciągi filtru w polu wyszukiwania.

Kliknij nazwę table, aby wyświetlić columns dla tego table.

Tworzenie zapytania

Możesz wprowadzić tekst, aby utworzyć zapytanie w edytorze SQL. Możesz insert elementy z przeglądarki schema, aby odwoływać się do catalogs i tables.

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łowe uzupełnianie w lokalizacji kursora to nazwa column, autouzupełnianie sugeruje nazwę column. Jeśli wpiszesz select * from table_name as t where t., autouzupełnianie rozpoznaje, że t jest aliasem table_name i sugeruje columns wewnątrz table_name.

   

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

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

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

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 pozycję +, a następnie selectUtwó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 filtrować listę zapytań list. 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. Select magazyn SQL.

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 table w okienku wyników.

   

Uwaga

Limit 1000 jest domyślnie wybierana dla wszystkich zapytań do limit zwracanie 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 dla liczby wierszy, możesz dodać klauzulę LIMIT w swoim zapytaniu, aby wpisać wybraną przez siebie wartość.

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 selectPrzenieś do kosza.
• Kliknij pozycję Przenieś do kosza , aby potwierdzić.

Aby restore zapytanie z kosza:

1. W listWszystkie zapytania kliknij .
2. Kliknij zapytanie.
3. Kliknij menu kontekstowe kebab w prawym górnym rogu edytora SQL i kliknij Restore.

Set opis zapytania i wyświetlanie informacji o kwerendzie

Aby set 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 w Zapytaniach list. 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 pojawi sięDodaj tagi, a tagi będą widoczne w where. 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.

tagi Remove

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 remove.
3. Kliknij przycisk Zapisz , aby zamknąć okno dialogowe.

Wyświetlanie wyników zapytania

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

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 parameters

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

Wizualizacja: Wizualizacje mogą pomóc w zbadaniu wyniku set. Aby uzyskać pełną list dostępnych typów wizualizacji, zobacz Typy wizualizacji.

filtru: filtry umożliwiają limit wyniku set po uruchomieniu 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: Parameters umożliwia limit wyniku set przez podstawianie values do zapytania w czasie wykonywania. Zobacz Pracuj z zapytaniem parameters, aby dowiedzieć się, jak zastosować parameters.

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.

Rozmiar pobierania końcowego pliku może być nieco większy lub mniejszy niż 1 GB, ponieważ 1 GB limit jest stosowane na wcześniejszym etapie niż końcowe pobieranie pliku.

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 na rosnącą lub malejącą values. Możesz również użyć filtru, aby wyszukać wiersze wyników, które zawierają określoną wartość.

Możesz użyć kart w okienku wyników, aby dodać wizualizacje, filtry i parameters.

Filtrowanie list zapisanych zapytań w zapytaniach window

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

Automatyzowanie aktualizacji

Możesz użyć przycisku harmonogramu , aby 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 (właściciel credentials): to ustawienie oznacza, że osoby przeglądające mogą wyświetlać te same wyniki zapytania co właściciel zapytania. Dotyczy to zaplanowanych lub ręcznych przebiegów zapytań.
• Uruchom jako przeglądający (osoby przeglądające credentials): 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.