Psaní dotazů a zkoumání dat v novém editoru SQL

Uživatelské rozhraní Databricks obsahuje editor SQL, který můžete použít k vytváření dotazů, spolupráci s kolegy, procházení dostupných dat a vytváření vizualizací. Tato stránka vysvětluje, jak pomocí editoru SQL psát, spouštět, spravovat a sdílet dotazy.

Tento článek vysvětluje, jak používat nový editor SQL. Další informace o práci se starší verzí editoru SQL najdete v tématu Psaní dotazů a zkoumání dat ve starším editoru SQL.

Otevření editoru SQL

Pokud chcete otevřít editor SQL v uživatelském rozhraní Azure Databricks, klikněte na editor SQL na bočním panelu.

Editor SQL se otevře s posledním otevřeným dotazem. Pokud neexistuje žádný dotaz nebo všechny vaše dotazy byly explicitně zavřeny, otevře se cílová stránka editoru SQL.

Zapnutí nového editoru SQL

K zapnutí nového editoru použijte přepínač Nový editor SQL napravo od selektorů katalogu a schématu. Na úzkých displejích najdete přepínač Nový editor SQL kliknutím na Vpravo od katalogu a selektorů schématu.

Povolte nový editor pro libovolný dotaz, který vlastníte:

• Klikněte na Nový editor SQL: VYPNUTO. Otevře se místní nabídka Nového editoru SQL.
  • Ve výchozím nastavení je zaškrtnuté políčko Použít u všech dotazů . Pokud chcete povolit editor pro všechny dotazy, které vlastníte, ponechte toto nastavení.
  • Pokud chcete povolit nový editor jenom pro aktivní dotaz, zrušte zaškrtnutí políčka Použít u všech mých dotazů .
• Přepněte přepínač Nový editor SQL na ZAPNUTO.

Nový editor SQL nelze použít pro všechny dotazy. Pokud platí některá z následujících hodnot, nemůžete přepnout do nového editoru SQL pro dotaz:

• Dotaz nevlastníte.
• Dotaz obsahuje rozevírací seznamy založené na dotazech, které nejsou podporované. Viz Práce s parametry dotazu.

Když zapnete nový editor SQL, dotaz se znovu otevře v novém uživatelském rozhraní. Sada výsledků je prázdná, dokud dotaz nespustíte.

Poznámka:

Výsledky dotazů se sdílejí se všemi spolupracovníky a jsou omezené na 64 000 řádků.

Orientace

Tato část popisuje klíčové rozdíly v uživatelském rozhraní a vysvětluje, jak najít a používat dostupné funkce.

1. Přístup k systému souborů pracovního prostoru: K objektům pracovního prostoru můžete přistupovat a uspořádat je přímo z editoru SQL.
2. Použijte integrovaného pomocníka Databricks: Chatujte s asistentem, který vám pomůže psát, upřesňovat nebo pochopit dotazy. Spusťte kód vygenerovaný asistentem na bočním panelu.
3. Sbalení oddílů kódu: Kliknutím na šipku sbalení vlevo od bloku kódu selektivně skryjete a rozbalíte oddíly kódu. To může usnadnit práci s velkými soubory.
4. Otevřete paletu příkazů: Paleta příkazů obsahuje běžné akce, klávesové zkratky, vlastní motivy a odkazy, které vám pomůžou rychle najít, co potřebujete. Po otevření vyhledejte pomocí panelu hledání konkrétní nástroje a klávesové zkratky.
5. Komentář k kódu: Přidání komentářů do kódu za účelem vylepšení spolupráce
6. Zkontrolovat historii verzí: Zkontrolujte nedávné změny dotazu.

Připojení k výpočetním prostředkům

Ke spouštění dotazů musíte mít k SQL Warehouse alespoň oprávnění CAN USE. K zobrazení dostupných možností můžete použít rozevírací seznam v horní části editoru. Pokud chcete seznam filtrovat, zadejte do textového pole text.

Při prvním vytvoření dotazu se seznam dostupných skladů SQL zobrazí abecedně. Při příštím vytvoření dotazu se vybere naposledy použitý SQL Warehouse. Pokud je váš pracovní prostor povolený pro výběr výchozího SQL Warehouse, můžete výchozí sklad přizpůsobit. Viz Nastavení výchozího skladu na úrovni uživatele.

Ikona vedle SQL Warehouse označuje stav:

• Tekoucí
• Zastavený

Poznámka:

Pokud v seznamu nejsou žádné sklady SQL, obraťte se na správce pracovního prostoru.

Vybraný SQL Warehouse se automaticky restartuje při spuštění dotazu. Další způsoby, jak spustit SQL Warehouse, najdete v tématu Spuštění SQL Warehouse .

Procházení assetů a získání nápovědy

Pomocí levého podokna v editoru SQL můžete procházet soubory pracovního prostoru, zobrazovat datové objekty a získat pomoc od Databricks Assitant.

Procházení souborů pracovního prostoru

Klikněte na a otevřete složku uživatele pracovního prostoru. Můžete procházet všechny soubory pracovního prostoru, ke kterým máte přístup z této části uživatelského rozhraní.

Procházení datových objektů

Pokud máte oprávnění ke čtení metadat, prohlížeč schématu v editoru SQL zobrazuje dostupné databáze a tabulky. Datové objekty můžete procházet také z průzkumníka katalogu .

Databázové objekty řízené katalogem Unity můžete procházet v Průzkumníku katalogu bez aktivního výpočetního výkonu. Pokud chcete prozkoumat data v hive_metastore a dalších katalogech, které nejsou spravovány katalogem Unity, musíte se připojit k výpočetním prostředkům s příslušnými oprávněními. Viz zásady správného řízení dat pomocí Azure Databricks.

Poznámka:

Pokud v prohlížeči schématu nebo v Průzkumníku katalogu neexistují žádné datové objekty, obraťte se na správce pracovního prostoru.

Kliknutím na blízko horní části prohlížeče schématu aktualizujte schéma. Pokud chcete filtrovat prostředky podle názvu, můžete na panelu hledání zadat. Klikněte na Ikona filtru pro filtrování objektů podle typu.

Kliknutím na název objektu v prohlížeči zobrazíte další podrobnosti o objektu. Například kliknutím na název schématu zobrazíte tabulky v tomto schématu. Kliknutím na název tabulky zobrazíte sloupce v této tabulce.

Získání nápovědy od Databricks Assistantu

Klikněte na Ikona Assistant otevře okno chatu pomocí Assistenta Databricks. Klikněte na navrženou otázku nebo zadejte vlastní otázku, abyste mohli pracovat s Databricks Assistantem.

Vytvoření dotazu

Zadáním textu můžete vytvořit dotaz v editoru SQL. Prvky můžete vložit z prohlížeče schématu a odkazovat na katalogy a tabulky.

1. Zadejte dotaz do editoru SQL.

   Editor SQL podporuje automatické dokončování. Při psaní navrhuje automatické dokončování dokončení. Pokud je například platným dokončením v umístění kurzoru sloupec, automatické dokončování navrhne název sloupce. Pokud zadáte select * from table_name as t where t., automatické dokončování rozpozná, že t je alias pro table_name a navrhne sloupce uvnitř table_name. K odkazování na fragmenty dotazů můžete použít také automatické dokončování.

   

2. (Volitelné) Po dokončení úprav klikněte na Uložit. Ve výchozím nastavení se dotaz uloží do domovské složky uživatele. Pokud chcete dotaz uložit do jiného umístění, vyberte cílovou složku a klikněte na Přesunout.

Poznámka:

Nové dotazy se automaticky nazývají Nový dotaz s časovým razítkem vytvoření, které je v názvu připojené. Ve výchozím nastavení se nové dotazy vytvořené bez konkrétního kontextu složky vytvoří ve složce Koncepty ve vašem domovském adresáři. Když se nové dotazy uloží nebo přejmenují, odeberou se z Konceptů.

Dotazování zdrojů dat

Zdroj dotazu můžete identifikovat pomocí plně kvalifikovaného názvu tabulky v samotném dotazu nebo výběrem kombinace katalogu a schématu z rozevíracích selektorů spolu s názvem tabulky v dotazu. Plně kvalifikovaný název tabulky v dotazu přepíše selektory katalogu a schématu v editoru SQL. Pokud název tabulky nebo sloupce obsahuje mezery, uzavřete tyto identifikátory do znaků ` (obrácené uvozovky) ve vašich SQL dotazech.

Poznámka:

Maximální počet výsledků vrácených v tabulce je 64 000 řádků nebo 10 MB podle toho, co je menší.

Následující příklady ukazují, jak dotazovat různé objekty podobné tabulce, které můžete uložit do katalogu.

Dotaz na standardní tabulku nebo zobrazení

Následující příklad dotazuje tabulku z samples katalogu.

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

Dotazovat zobrazení metriky

Následující příklad dotazuje zobrazení metrik, které jako zdroj používá tabulku z katalogu ukázek. Vyhodnocuje tři uvedené míry a agregace nad Order Month a Order Status. Vrátí výsledky seřazené podle Order Month. Pokud chcete vytvořit podobné zobrazení metrik v pracovním prostoru, přečtěte si téma Vytvoření zobrazení metriky.

Všechna vyhodnocení metriky musí být obalena funkcí MEASURE. Viz measure agregační funkce.

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;

Optimalizace dotazu pomocí nástroje Databricks Assistant

Klikněte na na pravé straně editoru, která poskytuje kontextovou nápovědu a návrhy při psaní dotazů. Příkaz /optimize slash vyzve asistenta k vyhodnocení a optimalizaci dotazů. Další informace najdete v tématu Optimalizace kódu Python, PySpark a SQL.

Úprava několika karet dotazu

Editor SQL ve výchozím nastavení používá karty, abyste mohli otevírat a upravovat více dotazů současně. Pokud chcete otevřít novou kartu, klikněte na +a pak vyberte Vytvořit nový dotaz nebo Otevřít existující dotaz. Kliknutím na Otevřít existující dotaz zobrazíte seznam dotazů. Karta Pro vás nabízí pečlivě vybraný seznam doporučení na základě vašeho využití. Pomocí karty Vše vyhledejte libovolný dotaz, ke kterému máte přístup.

Spusťte jeden dotaz nebo vícero dotazů

Dotazy s více příkazy můžete psát do jednoho panelu editoru. Chcete-li použít více příkazů dotazu v jednom panelu, ukončete každý příkaz středníkem (;).

Spusťte jeden dotaz:

1. Vyberte SQL Warehouse.
2. Zvýrazněte dotaz v editoru SQL (pokud je v podokně dotazu více dotazů).
3. Stiskněte Ctrl/Cmd + Enter nebo kliknutím na Spustit (1000) zobrazte výsledky jako tabulku v podokně výsledků.

Poznámka:

Ve výchozím nastavení jsou vybrány příkazy Spustit všechny příkazy a Limit 1000 .

• Pokud chcete spustit pouze aktivní příkaz, zrušte výběr příkazu Spustit všechny příkazy.
• Pokud je dotaz uložen s nastavením Limit 1000 , platí toto nastavení pro všechna spuštění dotazu. Pokud chcete vrátit všechny řádky (až 64 000 řádků nebo 10 MB, podle toho, co je menší), vymažte LIMIT z rozevírací nabídky Spustit (1000) hodnotu 1000 . Pokud chcete zadat jiný limit počtu řádků, přidejte LIMIT do dotazu klauzuli.

Ukončení dotazu

Chcete-li ukončit dotaz během běhu, klikněte na tlačítko Storno. Správce může zastavit spuštěný dotaz, který spustil jiný uživatel, zobrazením spuštěného dotazu Ukončit.

Sdílení dotazu

Nový editor SQL zpracovává oprávnění ve dvou částech:

Interaktivní spouštění: Dotazy v novém editoru SQL se vždy spouštějí pomocí Spustit jako prohlížeče přihlašovacích údajů. Výsledky dotazů jsou přístupné všem uživatelům, kteří mají k dotazu přístup. Uživatelé s oprávněními CAN EDIT nebo vyšší můžou koncept sdíleného dotazu upravovat. Neuložené úpravy jsou navíc viditelné pro všechny uživatele s oprávněními CAN VIEW nebo vyšší. Aby mohli uživatelé spouštět dotazy, musí mít k přidruženému skladu alespoň oprávnění CAN USE.

Nastavení přihlašovacích údajů: Nastavení oprávnění pro starší verze výstrah, pracovních postupů a starších řídicích panelů jsou stejná jako u staršího editoru SQL. V závislosti na vašich preferencích je možné tyto prostředky spustit pomocí přihlašovacích údajů vlastníka nebo prohlížeče.

Informace o nastavení přihlašovacích údajů prohlížeče Spustit jako a Spustit jako najdete v tématu Konfigurace oprávnění k dotazům. Informace o správě přístupu k objektu dotazu najdete v seznamech ACL dotazů.

Spolupráce na dotazech v reálném čase

Po sdílení dotazu můžete spoluvytvářením nebo laděním dotazů živě provádět úpravy pro spolupráci. Editory můžou také komentovat jednotlivé řádky kódu a klást otázky nebo přidávat návrhy.

Řízení zdrojového kódu dotaz

Soubory dotazů SQL Databricks (přípona: .dbquery.ipynb) se podporují ve složkách Databricks v Gitu. Pomocí složky Gitu můžete řídit soubory dotazů a sdílet je v jiných pracovních prostorech se složkami Gitu, které přistupují ke stejnému úložišti Git. Pokud se rozhodnete odhlásit z nového editoru SQL po potvrzení nebo klonování dotazu ve složce Git Databricks, odstraňte tuto složku Gitu a znovu ji odstraňte, abyste se vyhnuli neočekávanému chování.

Uložení dotazu

Obsah dotazů v novém editoru SQL se průběžně automaticky vyloží. Tlačítko Uložit určuje, zda se má obsah konceptu dotazu použít na související prostředky, jako jsou starší verze řídicích panelů, pracovní postupy nebo starší verze upozornění. Pokud je dotaz sdílený s přihlašovacími údaji vlastníka Spustit jako, může změny rozšířit pouze vlastník dotazu pomocí tlačítka Uložit. Pokud je přihlašovací údaje nastavené na Spustit jako prohlížeč, může dotaz uložit libovolný uživatel s alespoň CAN MANAGE oprávněním.

Zobrazení výsledků dotazu

Výstup z každého příkazu můžete porovnat s více příkazy výsledku. Když spustíte více příkazů SQL z jednoho okna pro úpravy, můžete pomocí uživatelského rozhraní na panelu Výstup v dolní části obrazovky procházet různé sady výsledků.

Výsledky dotazu můžete procházet a zkoumat pomocí podokna výsledků. Podokno výsledků obsahuje následující funkce pro zkoumání výsledků.

Vizualizace

Kliknutím na přidáte vizualizaci. Vizualizace vám můžou pomoct prozkoumat sadu výsledků. Úplný seznam dostupných typů vizualizací najdete v tématu Typy vizualizací poznámkového bloku a editoru SQL .

Kliknutím na na kartě vizualizace zobrazíte další možnosti.

• Kliknutím na Tlačítko Stáhnout stáhnete data znázorněná ve vizualizaci jako csv, TSV nebo excelový soubor.
• Kliknutím na odebrat vizualizaci odstraníte.
• Kliknutím na Duplikovat naklonujete kartu výsledků.
• Kliknutím na Přejmenovat vizualizaci znovu pojmenujete.

1. Kliknutím na Upravit můžete vizualizaci upravit.

2. Kliknutím na Přidat na řídicí panel zkopírujete dotaz a vizualizaci do nového řídicího panelu AI/BI.

3. Vyberte Vytvořit nový řídicí panel nebo Přidat do existujícího řídicího panelu.

   • Vytvořit nový řídicí panel: Vytvoří nový řídicí panel, který obsahuje všechny vizualizace přidružené k dotazu. Zobrazí se výzva k výběru názvu nového řídicího panelu. Nový řídicí panel se uloží do domovské složky.
   • Přidat do existujícího řídicího panelu: Přidá dotaz a přidružené vizualizace do existujícího řídicího panelu. V rozevírací nabídce vyberte řídicí panel, do kterého se má datová sada a vizualizace přidat.

Stažení výsledků

Výsledky si můžete stáhnout jako soubor CSV nebo Excel. Soubory CSV ke stažení podporují až 5 GB dat. Klikněte na symbol na kartě výsledků, abyste zobrazili možnosti stahování. Konečná velikost stahování souborů může být o něco větší nebo menší než 5 GB, protože limit 5 GB se použije u předchozího kroku, než je konečný soubor ke stažení.

Poznámka:

Pokud nemůžete stáhnout dotaz, správce pracovního prostoru zakázal stahování pro váš pracovní prostor.

Filtry

Filtry umožňují omezit sadu výsledků po spuštění dotazu. Filtry můžete použít k selektivnímu zobrazení různých podmnožina dat. Pomocí Pomocníka můžete přidat filtr výsledků.

Přidání filtru:

1. Klikněte na Ikona filtru.
2. Zadejte text, který popisuje typ filtru, který chcete použít. Na sadu výsledků se použije pojmenovaný filtr.

Úprava filtru:

1. Klikněte na název filtru.
2. Pomocí rozevíracích nabídek a textových polí upravte nastavení filtru.
3. (Volitelné) Vyberte Rozlišování velikosti písmen pro nastavení filtru jako citlivý na velikost písmen.
4. (Volitelné) Chcete-li přidat další filtr, klikněte na přidat podmínku OR .

Přidání parametrů

Parametry umožňují omezit sadu výsledků nahrazením hodnot do dotazu za běhu. Informace o použití parametrů najdete v tématu Práce s parametry dotazu.

Změny syntaxe parametrů

Dotazy napsané ve starším editoru SQL, které používají dvojité složené závorky ({{}}) k označení parametrů, musí být upraveny tak, aby se spouštěly v novém editoru SQL. Nový editor SQL používá stejnou syntaxi parametrů jako jiné nástroje Databricks, jako jsou řídicí panely AI/BI, AI/BI Genie a poznámkové bloky.

Parametry v novém editoru SQL se definují pomocí pojmenované syntaxe parametrů. Pojmenované parametry jsou parametry v dotazu s předponou dvojtečky, například :parameter_name.

Viz pojmenované značky parametrů pro dokumentaci k sql referenece. Příklady převodu syntaxe parametrů z klasického editoru SQL na pojmenované značky parametrů najdete v příkladech syntaxe pojmenovaných parametrů.

Podporované typy filtrů

Následující tabulka uvádí typy filtrů podporované v novém editoru SQL. Druhý sloupec označuje, jestli filtr funguje také ve starším editoru SQL.

Typ filtru	Podporováno ve starší verzi editoru
Rovná se	Ano
Nerovná se	Ne
Je jedním z	Ano
Není jedním z	Ne
Obsahuje	Ano
Neobsahuje	Ne
Začíná na	Ano
Nezačíná na	Ne
končí na	Ne
Nekončí na	Ne
Je null	Ne
Není nulový.	Ne
Je větší než	Ne
Větší nebo rovno	Ne
Menší než	Ne
Menší nebo rovno	Ne
Mezi	Ano
Před	Ne
Po	Ne
Je true	Ano
Je false	Ano
PODMÍNKY OR	Ne

Použití klávesových zkratek

Nový editor SQL obsahuje řadu předdefinovaných klávesových zkratek, které vám pomůžou rychle pracovat. Následující tabulka uvádí běžně používané klávesové zkratky.

Funkce	zástupce macOS	Zástupce systému Windows
Spusť dotaz	Cmd + Enter	Ctrl + Enter
Spuštění jednoho zvýrazněného příkazu	Cmd + Shift + Enter	Ctrl + Shift + Enter
Automatické dokončování	Ctrl + Space	Ctrl + Space
Zvětšení velikosti písma	Option + + (klíč plus)	Alt + + (klíč plus)
Zmenšení velikosti písma	Option + - (mínus na klávesnici)	Alt + - (mínus na klávesnici)
Formátování kódu SQL	Cmd + Shift + F	Ctrl + Shift + F
Zobrazit všechny klávesové zkratky	Esc poté H	Esc poté H

Zakázání nového editoru SQL

Zakázání nového editoru SQL:

• Klikněte na Nový editor SQL: ZAPNUTO. Otevře se místní nabídka Nového editoru SQL.
• Nastavte přepínač Nový editor SQL na VYPNUTO.
• V potvrzovacím dialogovém okně zvolte, že chcete zakázat nový editor jenom pro aktivní dotaz nebo pro všechny oprávněné dotazy.
  • Možnost Zakázat pro všechny oprávněné dotazy není vybraná. Toto nastavení ponechte, pokud chcete zakázat nový editor pouze pro aktivní dotaz.
  • Pokud chcete zakázat nový editor SQL pro všechny vaše dotazy, zaškrtněte políčko Zakázat pro všechny oprávněné dotazy.

Pokud chcete zabránit automatickému otevírání dotazů v novém editoru SQL:

1. V pracovním prostoru Databricks klikněte na své uživatelské jméno v horním panelu a vyberte Nastavení.
2. V levém podokně v části Uživatel klikněte na kartu Vývojář .
3. Vypněte možnost Vytvořit a otevřít všechny oprávněné dotazy v novém editoru SQL.

Správci pracovních prostorů můžou tuto funkci vypnout na úrovni pracovního prostoru tak, že navštíví portál Preview a vyhledá editor SQL. Podívejte se na Správa náhledů Azure Databricks.