Zdieľať cez


Podpora T-SQL v poznámkových blokoch služby Microsoft Fabric

Notebook T-SQL v službe Microsoft Fabric umožňuje písať a spúšťať kód T-SQL v poznámkovom bloku. Poznámkové bloky T-SQL môžete použiť na spravovanie zložitých dotazov a zapisovanie lepšej dokumentácie v jazyku Markdown. Umožňuje tiež priame vykonanie T-SQL na pripojenom sklade alebo koncovom bode analýzy SQL. Pridaním koncového bodu skladu údajov alebo analýzy SQL do poznámkového bloku môžu vývojári T-SQL spúšťať dotazy priamo na pripojený koncový bod. Analytici BI môžu tiež vykonávať dotazy krížovej databázy na zhromažďovanie prehľadov z viacerých skladov a koncových bodov analýzy SQL.

Väčšina existujúcich funkcií poznámkového bloku je k dispozícii pre poznámkové bloky T-SQL. Sú to napríklad vytváranie grafov výsledkov dotazov, kouutovanie poznámkových blokov, plánovanie pravidelných spustení a spúšťanie v rámci kanálov integrácie údajov.

Dôležité

Táto funkcia je vo verzii Preview.

V tomto článku sa naučíte:

  • Vytvorenie poznámkového bloku T-SQL
  • Pridanie koncového bodu skladu údajov alebo analýzy SQL do poznámkového bloku
  • Vytvorenie a spustenie kódu T-SQL v poznámkovom bloke
  • Používanie grafovacích funkcií na grafické znázornenie výsledkov dotazu
  • Uloženie dotazu ako zobrazenia alebo tabuľky
  • Spustenie dotazov krížového skladu
  • Vynechajte vykonávanie kódu, ktorý nie je T-SQL

Vytvorenie poznámkového bloku T-SQL

Ak chcete začať pracovať s týmto prostredím, môžete vytvoriť poznámkový blok T-SQL nasledujúcimi spôsobmi:

  1. V pracovnom priestore služby Fabric vytvorte poznámkový blok T-SQL: vyberte Nová položka a potom na otváranom paneli vyberte položku Poznámkový blok.

    Snímka obrazovky znázorňujúca vytvorenie nového poznámkového bloku v rámci pracovného priestoru.

  2. Vytvorenie poznámkového bloku T-SQL z existujúceho editora skladu: prejdite do existujúceho skladu a na hornom navigačnom páse s nástrojmi vyberte položky Nový dotaz SQLa potom nový poznámkový blok dotazu T-SQL.

    Snímka obrazovky s otvoreným poznámkovým blokom z editora DW SQL.

Po vytvorení poznámkového bloku je T-SQL nastavený ako predvolený jazyk. Do poznámkového bloku môžete pridať koncové body skladu údajov alebo analýzy SQL z aktuálneho pracovného priestoru.

Pridanie koncového bodu skladu údajov alebo analýzy SQL do poznámkového bloku

Ak chcete pridať koncový bod skladu údajov alebo analýzy SQL do poznámkového bloku, v editore poznámkového bloku vyberte tlačidlo + Zdroje údajov a vyberte položku Sklady. Na paneli údajového centra vyberte koncový bod sklad údajov alebo koncový bod analýzy SQL, ku ktorému sa chcete pripojiť.

Snímka obrazovky znázorňujúca pridanie skladu údajov alebo koncového bodu SQL do poznámkového bloku.

Nastavenie primárneho skladu

Do poznámkového bloku môžete pridať viacero skladov alebo koncových bodov analýzy SQL, pričom jeden z nich je nastavený ako primárny. Primárny sklad spustí kód T-SQL. Ak ho chcete nastaviť, prejdite na prieskumníka objektov, vyberte položku ... vedľa skladu a vyberte možnosť Nastaviť ako primárny.

Snímka obrazovky nastavenia primárneho skladu.

Pre akýkoľvek príkaz T-SQL, ktorý podporuje trojdielne pomenovanie, sa primárny sklad použije ako predvolený sklad, ak nie je zadaný žiadny sklad.

Vytvorenie a spustenie kódu T-SQL v poznámkovom bloke

Ak chcete vytvoriť a spustiť kód T-SQL v notebooku, pridajte novú bunku a ako jazyk buniek nastavte T-SQL .

Snímka obrazovky znázorňujúca, ako vytvoriť bunku kódu t-sql.

Môžete automaticky generovať kód T-SQL pomocou šablóny kódu z kontextovej ponuky prieskumníka objektov. Pre poznámkové bloky T-SQL sú k dispozícii nasledujúce šablóny:

  • Vyberte prvých 100
  • Vytvorenie tabuľky
  • Vytvoriť ako výber
  • Vynechať
  • Rozbaľovacia ponuka a vytvorenie

Snímka obrazovky zobrazujúca šablónu kódu t-sql.

Jednu bunku kódu T-SQL môžete spustiť výberom tlačidla Spustiť na paneli s nástrojmi bunky alebo spustením všetkých buniek výberom tlačidla Spustiť všetko na paneli s nástrojmi.

Poznámka

Každá bunka kódu sa vykoná v samostatnej relácii, takže premenné definované v jednej bunke nie sú k dispozícii v inej bunke.

V tej istej bunke kódu môže obsahovať viacero riadkov kódu. Používateľ môže vybrať časť tohto kódu a spustiť iba tie vybraté. Každá spustenie tiež vygeneruje novú reláciu.

Snímka obrazovky zobrazujúca spustenie vybratej bunky kódu.

Po spustení kódu rozbaľte panel správ a skontrolujte súhrn spustenia.

Snímka obrazovky zobrazujúca súhrn vykonávania.

Na karte Tabuľka sa nachádzajú záznamy z vrátenej množiny výsledkov. Ak vykonanie obsahuje viacero množín výsledkov, môžete prepnúť z jednej na druhú prostredníctvom rozbaľovacej ponuky.

Snímka obrazovky znázorňujúca, ako prepnúť na karte s  výsledkom.

Používanie grafovacích funkcií na grafické znázornenie výsledkov dotazu

Kliknutím na položku Skontrolovať môžete zobraziť grafy, ktoré predstavujú kvalitu a distribúciu údajov jednotlivých stĺpcov.

Snímka obrazovky znázorňujúca kontrolu výsledku vo formulári grafu.

Uloženie dotazu ako zobrazenia alebo tabuľky

Pomocou ponuky Uložiť ako tabuľku môžete uložiť výsledky dotazu do tabuľky pomocou príkazu CTAS. Ak chcete použiť túto ponuku, vyberte text dotazu v bunke kódu a potom vyberte ponuku Uložiť ako tabuľku .

Snímka obrazovky znázorňujúca, ako uložiť dotaz ako tabuľku.

Snímka obrazovky s postupom uloženia tabuľky ako dialógového okna.

Podobne môžete vytvoriť zobrazenie z vybratého textu dotazu pomocou ponuky Uložiť ako zobrazenie na paneli príkazov bunky.

Snímka obrazovky zobrazujúca spôsob vytvorenia zobrazenia.

Snímka obrazovky zobrazujúca uloženie ako dialógové okno zobrazenia.

Poznámka

  • Keďže ponuka Uložiť ako tabuľku a Uložiť ako zobrazenie sú k dispozícii len pre vybratý text dotazu, pred použitím týchto ponúk musíte vybrať text dotazu.

  • Funkcia Vytvoriť zobrazenie nepodporuje trojdielne pomenovanie, takže zobrazenie sa vždy vytvorí v primárnom sklade nastavením skladu ako primárneho skladu.

Dotaz krížového skladu

Dotaz krížového skladu môžete spustiť pomocou trojdielne pomenovania. Trojdielne pomenovanie sa skladá z názvu databázy, názvu schémy a názvu tabuľky. Názov databázy je názov koncového bodu skladu alebo analýzy SQL, názov schémy je názov schémy a názov tabuľky je názov tabuľky.

Snímka obrazovky zobrazujúca spôsob spustenia dotazu krížového skladu.

Vynechajte vykonávanie kódu, ktorý nie je T-SQL

V tom istom poznámkovom bloku je možné vytvoriť bunky s kódom, ktoré používajú rôzne jazyky. Bunka kódu v PySparku môže byť napríklad pred bunkou kódu T-SQL. V takom prípade si používateľ môže vybrať vynechať spustenie ľubovoľného kódu PySpark pre poznámkový blok T-SQL. Toto dialógové okno sa zobrazí po spustení všetkých buniek kódu kliknutím na tlačidlo Spustiť všetko na paneli s nástrojmi.

Snímka obrazovky znázorňujúca, ako vynechať kód iných ako TSQL.

Obmedzenia verejnej ukážky

  • Bunka parametra zatiaľ nie je podporovaná v poznámkovom bloku T-SQL. Parameter odoslaný z kanála alebo plánovača sa nebude môcť použiť v poznámkovom bloku T-SQL.
  • Funkcia Nedávne spustenie zatiaľ nie je podporovaná v poznámkovom bloku T-SQL. Na kontrolu histórie spúšťania poznámkového bloku T-SQL je potrebné použiť funkciu na monitorovanie aktuálneho skladu údajov. Ďalšie podrobnosti nájdete v článku Monitorovanie skladu údajov.
  • URL adresa monitora v rámci spustenia kanála zatiaľ nie je podporovaná v poznámkovom bloku T-SQL.
  • Funkcia snímok zatiaľ nie je podporovaná v poznámkovom bloku T-SQL.
  • Podpora kanálov Git a nasadenia zatiaľ nie je podporovaná v poznámkovom bloke T-SQL.

Ďalšie informácie o poznámkových blokoch služby Fabric nájdete v nasledujúcich článkoch.