Pisanie zapytań i eksplorowanie danych w nowym edytorze SQL

Interfejs użytkownika usługi Databricks zawiera edytor SQL, którego można używać do tworzenia zapytań, współpracy z innymi osobami, przeglądania dostępnych danych i tworzenia wizualizacji. Na tej stronie wyjaśniono, jak używać edytora SQL do pisania, uruchamiania, zarządzania i udostępniania zapytań.

W tym artykule wyjaśniono, jak używać nowego edytora SQL. Aby dowiedzieć się więcej na temat pracy ze starszym edytorem SQL, zobacz Pisanie zapytań i eksplorowanie danych w starszym edytorze SQL.

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 otwarta strona docelowa edytora SQL.

Włączanie nowego edytora SQL

Użyj przełącznika Nowy edytor SQL po prawej stronie selektorów listy rozwijanej katalogu i schematu, aby włączyć nowy edytor. Na wąskich ekranach można znaleźć przełącznik Nowy edytor SQL, po kliknięciu po prawej stronie selektorów wykazu i schematu.

Włącz nowy edytor dla dowolnego zapytania, którego jesteś właścicielem:

• Kliknij pozycję Nowy edytor SQL: WYŁĄCZONE. Zostanie otwarte menu podręczne Nowy edytor SQL.
  • Pole wyboru Zastosuj do wszystkich moich zapytań jest domyślnie zaznaczone. Zachowaj to ustawienie, aby włączyć edytor dla wszystkich własnych zapytań.
  • Aby włączyć nowy edytor tylko dla aktywnego zapytania, usuń zaznaczenie pola wyboru Zastosuj do wszystkich moich zapytań .
• Ustaw przełącznik Nowy edytor SQL na WŁ.

Nie można używać nowego edytora SQL dla wszystkich zapytań. Nie można przełączyć się do nowego edytora SQL dla zapytania, jeśli którekolwiek z następujących elementów jest prawdziwe:

• Nie jesteś właścicielem zapytania.
• Zapytanie zawiera listy rozwijane oparte na zapytaniach, które nie są obsługiwane. Zobacz Pracuj z parametrami zapytania.

Po włączeniu nowego edytora SQL zapytanie zostanie ponownie otwarte w nowym interfejsie użytkownika. Zestaw wyników jest pusty do momentu uruchomienia zapytania.

Uwaga

Wyniki zapytania są udostępniane wszystkim współpracownikom i są ograniczone do 64 000 wierszy.

Orientacja

W tej sekcji opisano kluczowe różnice w interfejsie użytkownika i wyjaśniono, jak znaleźć i używać dostępnych funkcji.

1. Dostęp do systemu plików obszaru roboczego: możesz uzyskiwać dostęp do obiektów obszaru roboczego i organizować je bezpośrednio z poziomu edytora SQL.
2. Użyj zintegrowanego Asystenta usługi Databricks: czat z asystentem, aby ułatwić pisanie, uściślinie lub interpretowanie zapytań. Uruchom kod wygenerowany przez asystenta z panelu bocznego.
3. Zwiń sekcje kodu: kliknij strzałkę zwijania po lewej stronie bloku kodu, aby selektywnie ukryć i rozwinąć sekcje kodu. Może to ułatwić pracę z dużymi plikami.
4. Otwórz paletę poleceń: paleta poleceń zawiera typowe akcje, skróty klawiaturowe, motywy niestandardowe i linki ułatwiające szybkie znajdowanie potrzebnych elementów. Po jego otwarciu użyj paska wyszukiwania, aby wyszukać określone narzędzia i skróty.
5. Komentarz do kodu: Dodaj komentarze do kodu, aby zwiększyć współpracę.
6. Przejrzyj historię wersji: Przejrzyj ostatnie zmiany w zapytaniu.

Nawiązywanie połączenia z obliczeniami

Aby uruchamiać zapytania, musisz mieć co najmniej uprawnienia CAN USE w usłudze 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. Jeśli obszar roboczy jest włączony do wybierania domyślnego magazynu SQL Warehouse, możesz dostosować domyślny magazyn. Zobacz Ustawianie domyślnego magazynu na poziomie użytkownika.

Ikona obok usługi SQL Warehouse wskazuje stan:

• Bieganie
• 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 zasobów i uzyskiwanie pomocy

Użyj okienka po lewej stronie w edytorze SQL, aby przeglądać pliki obszarów roboczych, wyświetlać obiekty danych i uzyskiwać pomoc od usługi Databricks Assitant.

Przeglądanie plików obszaru roboczego

Kliknij , aby otworzyć folder użytkownika. Możesz nawigować po wszystkich plikach obszaru roboczego, do których masz dostęp z tej części interfejsu użytkownika.

Przeglądanie obiektów danych

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 Azure Databricks.

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. Możesz wpisać na pasku wyszukiwania, aby filtrować zasoby według nazwy. Kliknij Ikona filtru, aby filtrować obiekty według typu.

Kliknij nazwę obiektu w przeglądarce, aby wyświetlić więcej szczegółów dotyczących obiektu. Na przykład kliknij nazwę schematu, aby wyświetlić tabele w tym schemacie. Kliknij nazwę tabeli, aby wyświetlić kolumny w tej tabeli.

Uzyskiwanie pomocy od asystenta usługi Databricks

Kliknij , aby otworzyć okno czatu z Asystentem Databricks. Kliknij sugerowane pytanie lub wprowadź własne pytanie, aby wchodzić w interakcję z asystentem usługi Databricks.

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. Autouzupełnianie umożliwia również odwoływanie się do fragmentów zapytań.

   

2. (Opcjonalnie) Po zakończeniu edytowania kliknij przycisk Zapisz. Domyślnie zapytanie jest zapisywane w folderze głównym użytkownika. Aby zapisać zapytanie w innej lokalizacji, wybierz folder docelowy i wciśnij Przenieś.

Uwaga

Nowe zapytania są automatycznie nazywane Nowe zapytanie, a na końcu tytułu dodawana jest sygnatura czasowa utworzenia. Domyślnie nowe zapytania utworzone bez określonego kontekstu folderu są tworzone w folderze Drafts w katalogu macierzysty . Gdy nowe zapytania zostaną zapisane lub zmienione, zostaną usunięte z wersji roboczych.

Wykonywanie zapytań o źródła danych

Źródło zapytania można zidentyfikować przy użyciu w pełni kwalifikowanej nazwy tabeli w samym zapytaniu lub wybierając kombinację wykazu i schematu z selektorów listy rozwijanej wraz z nazwą tabeli w zapytaniu. W zapytaniu w pełni kwalifikowana nazwa tabeli zastępuje selektory katalogu i schematu w edytorze zapytań SQL. Jeśli nazwa tabeli lub kolumny zawiera spacje, umieszczaj te identyfikatory w apostrofach odwrotnych w zapytaniach SQL.

Uwaga

Maksymalna liczba wyników zwracanych w tabeli wynosi 64 000 wierszy lub 10 MB, w zależności od tego, co jest mniejsze.

W poniższych przykładach pokazano, jak wykonywać zapytania dotyczące różnych obiektów przypominających tabelę, które można przechowywać w wykazie.

Wykonywanie zapytań względem standardowej tabeli lub widoku

Poniższy przykład wykonuje zapytanie dotyczące tabeli z samples wykazu.

SELECT
  o_orderdate,
  o_orderkey,
  o_custkey,
  o_totalprice,
  o_shippriority
FROM
  samples.tpch.orders

Wykonywanie zapytań względem widoku metryki

Poniższy przykład wykonuje zapytanie dotyczące widoku metryki, który używa tabeli z wykazu przykładów jako jego źródła. Ocenia trzy wymienione miary i agreguje względem Order Month i Order Status. Zwraca wyniki posortowane według Order Month. Aby utworzyć podobny widok metryki w obszarze roboczym, zobacz Tworzenie widoku metryki.

Wszystkie oceny wskaźników muszą być zawinięte w funkcję MEASURE. Zobacz measure funkcja agregująca.

SELECT
 `Order Month`,
 `Order Status`,
 MEASURE(`Order Count`),
 MEASURE(`Total Revenue`),
 MEASURE(`Total Revenue per Customer`)
FROM
 orders_metric_view
GROUP BY ALL
ORDER BY 1 ASC;

Optymalizowanie zapytania za pomocą asystenta usługi Databricks

Kliknij Ikona asystenta po prawej stronie edytora w celu uzyskania wbudowanej pomocy i sugestii podczas pisania zapytań. Polecenie ukośnika /optimize powoduje, że Asystent ocenia i optymalizuje zapytania. Aby uzyskać więcej informacji, zobacz Optymalizowanie języka Python, PySpark i kodu SQL.

Edytowanie wielu kart zapytań

Domyślnie edytor SQL używa kart, dzięki czemu można otwierać i edytować wiele zapytań jednocześnie. Aby otworzyć nową kartę, kliknij przycisk +, a następnie wybierz opcję Utwórz nowe zapytanie lub Otwórz istniejące zapytanie. Kliknij pozycję Otwórz istniejące zapytanie , aby wyświetlić listę zapytań. Karta For you oferuje wyselekcjonowaną listę sugestii na podstawie twojego korzystania. Użyj karty Wszystkie , aby znaleźć dowolne zapytanie, do którego masz dostęp.

Uruchomienie pojedynczego zapytania lub zapytań wieloinstrukcyjnych

Zapytania z wieloma instrukcjami można pisać na jednej karcie edytora. Aby użyć wielu instrukcji zapytania na jednej karcie, zakończ każdą instrukcję średnikami (;).

Aby uruchomić pojedyncze zapytanie:

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

Domyślnie wybrano opcję Uruchom wszystkie instrukcje i Limit 1000 .

• Aby uruchomić tylko aktywną instrukcję, usuń zaznaczenie opcji Uruchom wszystkie instrukcje.
• Jeśli zapytanie zostanie zapisane przy użyciu ustawienia Limit 1000 , to ustawienie dotyczy wszystkich przebiegów zapytań. Aby zwrócić wszystkie wiersze (do 64 000 wierszy lub 10 MB, w zależności od tego, co jest mniejsze), wyczyść poleLIMIT 1000 z menu rozwijanego Uruchom (1000). Aby określić inny limit liczby wierszy, dodaj klauzulę LIMIT w zapytaniu.

Kończenie zapytania

Aby zakończyć zapytanie podczas jego działania, kliknij przycisk Anuluj. Administrator może zatrzymać uruchomione zapytanie uruchomione przez innego użytkownika, wyświetlając polecenie Zakończ wykonywanie zapytania.

Udostępnianie zapytania

Nowy edytor SQL obsługuje uprawnienia w dwóch częściach:

Wykonywanie interakcyjne: zapytania w nowym edytorze SQL zawsze są uruchamiane przy użyciu poświadczeń Uruchom jako przeglądarkę . Wyniki zapytania są dostępne dla każdego, kto ma dostęp do zapytania. Użytkownicy z uprawnieniami CAN EDIT lub wyższymi mogą modyfikować wersję roboczą udostępnionego zapytania. Ponadto niezapisane edycje są widoczne dla każdej osoby z uprawnieniami CAN VIEW lub wyższymi. Aby uruchamiać zapytania, użytkownicy muszą mieć co najmniej uprawnienie CAN USE w skojarzonym magazynie.

Ustawienia poświadczeń: Ustawienia uprawnień dla starszych alertów, przepływów pracy i starszych pulpitów nawigacyjnych są takie same jak w przypadku starszego edytora SQL. W zależności od preferencji te zasoby mogą być uruchamiane przy użyciu poświadczeń właściciela lub osoby przeglądającego.

Zobacz Konfigurowanie uprawnień zapytania, aby dowiedzieć się więcej o ustawieniach poświadczeń Uruchom jako właściciel i Uruchom jako przeglądarki . Zobacz Listy ACL zapytań, aby dowiedzieć się, jak zarządzać dostępem do obiektu zapytania.

Współpraca nad zapytaniami w czasie rzeczywistym

Po udostępnieniu zapytania możesz współtworzyć lub debugować zapytania na żywo za pośrednictwem wspólnego edytowania. Edytory mogą również komentować poszczególne wiersze kodu, aby zadawać pytania lub dodawać sugestie.

kontrola źródła zapytania

Pliki zapytań SQL usługi Databricks (rozszerzenie: .dbquery.ipynb) są obsługiwane w folderach git usługi Databricks. Możesz użyć folderu Git, aby kontrolować pliki zapytań i udostępniać je w innych obszarach roboczych folderom Git, które uzyskują dostęp do tego samego repozytorium Git. Jeśli zdecydujesz się zrezygnować z nowego edytora SQL po zatwierdzeniu lub sklonowaniu zapytania w folderze Git usługi Databricks, usuń i sklonuj ponownie ten folder Git, aby uniknąć nieoczekiwanych zachowań.

Zapisywanie zapytania

Wykonywanie zapytań dotyczących zawartości w nowym edytorze SQL jest stale automatycznie zapisywane. Przycisk Zapisz określa, czy zawartość zapytania roboczego powinna być stosowana do powiązanych zasobów, takich jak starsze pulpity nawigacyjne, przepływy pracy lub starsze alerty. Jeśli zapytanie jest udostępniane poświadczeniu Uruchom jako właściciel , tylko właściciel zapytania może użyć przycisku Zapisz , aby propagować zmiany. Jeśli poświadczenie ma wartość Uruchom jako przeglądający, każdy użytkownik z co najmniej CAN MANAGE uprawnienia może zapisać zapytanie.

Wyświetlanie wyników zapytania

Dane wyjściowe z każdej instrukcji można porównać z wieloma instrukcjami wyników. Po uruchomieniu wielu instrukcji SQL w jednym oknie edycji możesz użyć interfejsu użytkownika w panelu Dane wyjściowe w dolnej części ekranu, aby przewijać różne zestawy 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

Kliknij , aby dodać wizualizację. Wizualizacje mogą ułatwić eksplorowanie zestawu wyników. Zobacz Typy wizualizacji notesu i edytora SQL , aby uzyskać pełną listę dostępnych typów wizualizacji.

Kliknij na karcie wizualizacji, aby wyświetlić dodatkowe opcje.

• Kliknij przycisk Pobierz , aby pobrać dane reprezentowane w wizualizacji jako plik CSV, TSV lub Excel.
• Kliknij przycisk Usuń , aby usunąć wizualizację.
• Kliknij pozycję Duplikuj , aby sklonować kartę wyników.
• Kliknij Zmień nazwę, aby zmienić tytuł wizualizacji.

1. Kliknij przycisk Edytuj, aby edytować wizualizację.

2. Kliknij pozycję Dodaj do pulpitu nawigacyjnego, aby skopiować zapytanie i wizualizację do nowego pulpitu nawigacyjnego AI/BI.

3. Wybierz pozycję Utwórz nowy pulpit nawigacyjny lub Dodaj do istniejącego pulpitu nawigacyjnego.

   • Utwórz nowy pulpit nawigacyjny: Tworzy nowy pulpit nawigacyjny zawierający wszystkie wizualizacje skojarzone z zapytaniem. Zostanie wyświetlony monit o wybranie nazwy nowego pulpitu nawigacyjnego. Nowy pulpit nawigacyjny jest zapisywany w folderze głównym.
   • Dodaj do istniejącego pulpitu nawigacyjnego: Dodaje zapytanie i skojarzone wizualizacje do istniejącego pulpitu nawigacyjnego. Użyj menu rozwijanego, aby wybrać pulpit nawigacyjny, do którego powinien zostać dodany zestaw danych i wizualizacja.

Pobieranie wyników

Wyniki można pobrać jako plik CSV lub excel. Pliki CSV do pobrania obsługują maksymalnie 5 GB danych. Kliknij w obrębie karty wyników, aby wyświetlić opcje pobierania. Ostateczny rozmiar pobierania pliku może być nieco większy lub mniejszy niż 5 GB, ponieważ limit 5 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.

Filtry

Filtry umożliwiają ograniczenie zestawu wyników po uruchomieniu zapytania. Filtry można stosować do selektywnego pokazywania różnych podzestawów danych. Użyj Asystenta, aby ułatwić dodawanie filtru dla wyników.

Aby dodać filtr:

1. Kliknij Ikona filtru.
2. Wprowadź tekst opisujący rodzaj filtru, który chcesz zastosować. Filtr o nazwie jest stosowany do zestawu wyników.

Aby edytować filtr:

1. Kliknij nazwę filtru.
2. Użyj menu rozwijanych i pól tekstowych, aby dostosować ustawienia filtru.
3. (Opcjonalnie) Wybierz Wielkość liter ma znaczenie, aby filtr uwzględniał wielkość liter.
4. (Opcjonalnie) Kliknij pozycję Dodaj warunek OR , aby dodać dodatkowy filtr.

Dodawanie parametrów

Parametry umożliwiają ograniczenie zestawu wyników poprzez podstawienie wartości do zapytania podczas wykonywania. Aby dowiedzieć się, jak stosować parametry, zobacz Pracę z parametrami zapytania.

Zmiany składni parametrów

Zapytania napisane w starszym edytorze SQL, które używają podwójnych nawiasów klamrowych ({{}}) do oznaczania parametrów, muszą zostać zmodyfikowane w celu uruchomienia w nowym edytorze SQL. Nowy edytor SQL używa tej samej składni parametrów co inne narzędzia usługi Databricks, takie jak pulpity nawigacyjne sztucznej inteligencji/analizy biznesowej, sztuczna inteligencja/usługa BI Genie i notesy.

Parametry w nowym edytorze SQL są definiowane przy użyciu nazwanej składni parametrów. Nazwane parametry to parametry w zapytaniu, które są poprzedzone dwukropkiem, na przykład :parameter_name.

Zobacz Nazwane znaczniki parametrów dla dokumentacji referenece SQL. Zobacz Przykłady składni nazwanych parametrów, aby zapoznać się z przykładami konwertowania składni parametrów z klasycznego edytora SQL na nazwane znaczniki parametrów.

Obsługiwane typy filtrów

W poniższej tabeli przedstawiono typy filtrów obsługiwane w nowym edytorze SQL. Druga kolumna wskazuje, czy filtr działa również w starszym edytorze SQL.

Typ filtru	Obsługiwane w starszym edytorze
Jest równe	Tak
Nie jest równe	Nie.
Jest jednym z	Tak
Nie jest jednym z	Nie.
Zawiera	Tak
Nie zawiera	Nie.
Rozpoczyna się od	Tak
Nie zaczyna się od	Nie.
Kończy się na	Nie.
Nie kończy się na	Nie.
Ma wartość null	Nie.
Nie jest null	Nie.
Większe niż	Nie.
Większe niż lub równe	Nie.
Mniejsze niż	Nie.
Mniej lub równe	Nie.
Między	Tak
Przed	Nie.
Po	Nie.
Czy to prawda	Tak
To jest fałsz	Tak
logiczne warunki OR	Nie.

Używanie skrótów klawiaturowych

Nowy edytor SQL zawiera wiele wbudowanych skrótów klawiaturowych, które ułatwiają szybkie działanie. W poniższej tabeli przedstawiono często używane skróty klawiaturowe.

Funkcja	Skrót dla systemu macOS	Skrót systemu Windows
Uruchamianie zapytania	Cmd + Enter	Ctrl + Enter
Uruchamianie pojedynczej wyróżnionej instrukcji	Cmd + Shift + Enter	Ctrl + Shift + Enter
Autouzupełnianie	Ctrl + Space	Ctrl + Space
Zwiększ rozmiar czcionki	Option + + (plus klucz)	Alt + + (plus klucz)
Zmniejsz rozmiar czcionki	Option + - (klucz minus)	Alt + - (klucz minus)
Formatowanie kodu SQL	Cmd + Shift + F	Ctrl + Shift + F
Wyświetl wszystkie skróty	Esc następnie H	Esc następnie H

Wyłącz nowy edytor SQL

Aby wyłączyć nowy edytor SQL:

• Kliknij pozycję Nowy edytor SQL: WŁĄCZONE. Zostanie otwarte menu podręczne Nowy edytor SQL.
• Ustaw przełącznik Nowy edytor SQL na WYŁ.
• W oknie dialogowym potwierdzenia wybierz wyłączenie nowego edytora tylko dla aktywnego zapytania lub dla wszystkich kwalifikujących się zapytań.
  • Opcja Wyłącz dla wszystkich kwalifikujących się zapytań nie jest zaznaczona. Zachowaj to ustawienie, jeśli chcesz wyłączyć nowy edytor tylko dla aktywnego zapytania.
  • Aby wyłączyć nowy edytor SQL dla wszystkich zapytań, zaznacz pole wyboru Wyłącz dla wszystkich kwalifikujących się zapytań.

Aby zapobiec automatycznemu otwieraniu zapytań w nowym edytorze SQL:

1. W obszarze roboczym usługi Databricks kliknij swoją nazwę użytkownika na górnym pasku i wybierz pozycję Ustawienia.
2. W okienku po lewej stronie w obszarze Użytkownik kliknij kartę Deweloper .
3. Wyłącz pozycję Utwórz i otwórz wszystkie kwalifikujące się zapytania w nowym edytorze SQL.

Administratorzy obszaru roboczego mogą wyłączyć tę funkcję na poziomie obszaru roboczego, odwiedzając portal w wersji zapoznawczej i wyszukując edytor SQL. Zobacz Zarządzanie wersjami zapoznawczami usługi Azure Databricks.