Megosztás a következőn keresztül:


T-SQL-támogatás a Microsoft Fabric-jegyzetfüzetekben

A Microsoft Fabric T-SQL-jegyzetfüzet funkciója lehetővé teszi T-SQL-kód írását és futtatását egy jegyzetfüzeten belül. T-SQL-jegyzetfüzetekkel összetett lekérdezéseket kezelhet, és jobb Markdown-dokumentációt írhat. Emellett lehetővé teszi a T-SQL közvetlen végrehajtását a csatlakoztatott raktárban vagy az SQL Analytics-végponton. Ha hozzáad egy adattárház- vagy SQL Analytics-végpontot egy jegyzetfüzethez, a T-SQL-fejlesztők közvetlenül a csatlakoztatott végponton futtathatnak lekérdezéseket. A BI-elemzők adatbázisközi lekérdezéseket is végrehajthatnak, hogy több raktárból és SQL Analytics-végpontból származó megállapításokat gyűjtsenek.

A meglévő jegyzetfüzetfunkciók többsége elérhető a T-SQL-jegyzetfüzetekhez. Ilyenek például a lekérdezési eredmények diagramozása, a jegyzetfüzetek társszerzőségével, a rendszeres végrehajtások ütemezésével és a végrehajtás adatintegráció folyamatokon belüli aktiválásával.

Fontos

Ez a funkció előzetes verzióban érhető el.

Ebben a cikkben az alábbiakkal ismerkedhet meg:

  • T-SQL-jegyzetfüzet létrehozása
  • Adattárház- vagy SQL Analytics-végpont hozzáadása jegyzetfüzethez
  • T-SQL-kód létrehozása és futtatása jegyzetfüzetben
  • A diagramkészítési funkciókkal grafikusan ábrázolhatja a lekérdezési eredményeket
  • A lekérdezés mentése nézetként vagy táblázatként
  • Raktárközi lekérdezések futtatása
  • A nem T-SQL-kód végrehajtásának kihagyása

T-SQL-jegyzetfüzet létrehozása

Ennek a felületnek az első lépéseihez létrehozhat egy T-SQL-jegyzetfüzetet a következő módokon:

  1. T-SQL-jegyzetfüzet létrehozása a Háló munkaterületről: válassza Új elemlehetőséget, majd a megnyíló panelen válassza Jegyzetfüzet lehetőséget.

    Új jegyzetfüzet munkaterületen belüli létrehozásáról készült képernyőkép.

  2. T-SQL-jegyzetfüzet létrehozása meglévő raktárszerkesztőből: lépjen egy meglévő raktárra, és a felső navigációs menüszalagon válassza Új SQL-lekérdezés, majd Új T-SQL lekérdezési jegyzetfüzet.

    Képernyőkép a DW SQL-szerkesztőből megnyitott jegyzetfüzetről.

A jegyzetfüzet létrehozása után a T-SQL lesz az alapértelmezett nyelv. Az aktuális munkaterületen lévő adattárház- vagy SQL Analytics-végpontokat hozzáadhatja a jegyzetfüzethez.

Adattárház- vagy SQL Analytics-végpont hozzáadása jegyzetfüzethez

Ha adattárház- vagy SQL Analytics-végpontot szeretne hozzáadni egy jegyzetfüzethez, a jegyzetfüzet-szerkesztőben válassza a + Adatforrások gombot, és válassza a Raktárak lehetőséget. Az adatközpont paneljén válassza ki azt az adattárházat vagy SQL Analytics-végpontot, amelyhez csatlakozni szeretne.

Képernyőkép az adattárház vagy sql-végpont jegyzetfüzetbe való hozzáadásáról.

Elsődleges raktár beállítása

Több raktárat vagy SQL Analytics-végpontot is hozzáadhat a jegyzetfüzethez, és ezek közül az egyik elsődlegesként van beállítva. Az elsődleges raktár futtatja a T-SQL-kódot. A beállításhoz lépjen az objektumkezelőre, válassza a ... lehetőséget a raktár mellett, és válassza a Beállítás elsődlegesként lehetőséget.

Képernyőkép az elsődleges raktár beállításáról.

A háromrészes elnevezést támogató T-SQL-parancsok esetében a rendszer az elsődleges raktárt használja alapértelmezett raktárként, ha nincs megadva raktár.

T-SQL-kód létrehozása és futtatása jegyzetfüzetben

T-SQL-kód jegyzetfüzetben való létrehozásához és futtatásához adjon hozzá egy új cellát, és állítsa be a T-SQL-t cellanyelvként.

T-SQL-kódcellák létrehozását bemutató képernyőkép.

A T-SQL-kódot automatikusan létrehozhatja az objektumkezelő helyi menüjében található kódsablon használatával. A T-SQL-jegyzetfüzetekhez a következő sablonok érhetők el:

  • Az első 100 kiválasztása
  • Tábla létrehozása
  • Létrehozás kijelölésként
  • Eltávolítás
  • Drop and create

Képernyőkép a t-sql kódsablonról.

Egy T-SQL-kódcella futtatásához válassza a Cella eszköztár Futtatás gombját, vagy futtassa az összes cellát az eszköztár Összes futtatása gombjának kiválasztásával.

Feljegyzés

Az egyes kódcellák végrehajtása külön munkamenetben történik, így az egyik cellában definiált változók nem érhetők el egy másik cellában.

Ugyanazon a kódcellán belül több sornyi kódot is tartalmazhat. A felhasználó kiválaszthatja a kód egy részét, és csak a kijelölteket futtathatja. Minden végrehajtás új munkamenetet is létrehoz.

Képernyőkép a kijelölt kódcella futtatásáról.

A kód végrehajtása után bontsa ki az üzenetpanelt a végrehajtási összegzés ellenőrzéséhez.

A végrehajtás összegzését bemutató képernyőkép.

A Tábla lap felsorolja a visszaadott eredményhalmaz rekordjait. Ha a végrehajtás több eredménykészletet tartalmaz, a legördülő menüben válthat egyikről a másikra.

Képernyőkép az eredmény lapon való váltásról.

A diagramkészítési funkciókkal grafikusan ábrázolhatja a lekérdezési eredményeket

A Vizsgálat gombra kattintva megtekintheti az egyes oszlopok adatminőségét és eloszlását ábrázoló diagramokat

Képernyőkép az eredmény diagraműrlapon történő vizsgálatról.

A lekérdezés mentése nézetként vagy táblázatként

A Mentés táblázatként menüvel mentheti a lekérdezés eredményeit a táblába a CTAS paranccsal. A menü használatához jelölje ki a lekérdezés szövegét a kódcellából, és válassza a Mentés táblázatként menüt.

Képernyőkép a lekérdezés táblázatként való mentéséről.

Képernyőkép a táblázat párbeszédpanelként való mentéséről.

Hasonlóképpen létrehozhat nézetet a kijelölt lekérdezési szövegből a Cella parancssáv Mentés nézetként menüjével.

Nézet létrehozását bemutató képernyőkép.

Képernyőkép a Mentés nézetként párbeszédpanelről.

Feljegyzés

  • Mivel a Mentés táblázatként és a Mentés nézetként menü csak a kijelölt lekérdezésszöveghez érhető el, a menük használata előtt ki kell választania a lekérdezés szövegét.

  • A Nézet létrehozása nem támogatja a háromrészes elnevezést, ezért a nézet mindig az elsődleges raktárban jön létre úgy, hogy a raktárt elsődleges raktárként állítja be.

Raktárközi lekérdezés

A raktárközi lekérdezést háromrészes elnevezéssel futtathatja. A háromrészes elnevezés az adatbázis nevét, a sémanevet és a táblanevet tartalmazza. Az adatbázis neve a raktár vagy az SQL Analytics-végpont neve, a séma neve a séma neve, a tábla neve pedig a tábla neve.

Képernyőkép a raktárközi lekérdezések futtatásáról.

A nem T-SQL-kód végrehajtásának kihagyása

Ugyanabban a jegyzetfüzetben különböző nyelveket használó kódcellák hozhatók létre. Egy PySpark-kódcella például megelőzhet egy T-SQL-kódcellát. Ilyen esetben a felhasználó kihagyhatja a T-SQL-jegyzetfüzethez tartozó PySpark-kód futtatását. Ez a párbeszédpanel akkor jelenik meg, ha az összes kódcellát az eszköztár Összes futtatása gombjára kattintva futtatja.

Képernyőkép a nem TSQL-kód kihagyásáról.

A nyilvános előzetes verzió korlátozásai

  • A paramétercella még nem támogatott a T-SQL-jegyzetfüzetben. A folyamatból vagy ütemezőből átadott paraméter nem használható a T-SQL-jegyzetfüzetben.
  • A Legutóbbi futtatás funkció még nem támogatott a T-SQL-jegyzetfüzetben. A T-SQL-jegyzetfüzet végrehajtási előzményeinek ellenőrzéséhez az aktuális adattárház-figyelési funkciót kell használnia. További részletekért lásd az Adattárház monitorozása című cikket.
  • A folyamat végrehajtásán belüli figyelő URL-címe még nem támogatott a T-SQL-jegyzetfüzetben.
  • A pillanatkép funkció még nem támogatott a T-SQL-jegyzetfüzetben.
  • A Git és az Üzembehelyezési folyamat támogatása még nem támogatott a T-SQL-jegyzetfüzetben.

A Fabric-jegyzetfüzetekkel kapcsolatos további információkért tekintse meg az alábbi cikkeket.