Jaký je koncový bod pro SQL analytiku v rámci lakehousu?

Koncový bod analýzy SQL poskytuje povrch pro dotazy T-SQL určený jen pro čtení nad tabulkami Delta ve vašem datovém jezeře (lakehouse). Každý lakehouse automaticky zřídí koncový bod analýzy SQL při vytváření – není potřeba nic dalšího nastavit. Koncový bod analýzy SQL běží na stejném modulu jako Fabric Data Warehouse, takže můžete získat dotazy SQL s vysokým výkonem a nízkou latencí bez správy infrastruktury.

Koncový bod analýzy SQL není pro lakehouse jedinečný. Ostatní položky Fabric – včetně skladů, zrcadlených databází, SQL databází a Azure Cosmos DB – také automaticky zřizují koncový bod analýzy SQL. Zkušenosti a omezení jsou ve všech stejná.

Snímek obrazovky koncového bodu analýzy SQL pro lakehouse zobrazující editor dotazů a seznam tabulek.

Co můžete dělat

Koncový bod analýzy SQL funguje v režimu jen pro čtení v tabulkách Delta – prostřednictvím tabulek Delta není možné vkládat, aktualizovat ani odstraňovat data. Chcete-li upravit data, přepněte na lakehouse a použijte Apache Spark.

V rámci této hranice jen pro čtení můžete:

  • Dotazování na tabulky Delta pomocí T-SQL – Spusťte příkazy SELECT pro libovolnou tabulku Delta ve vašem datovém jezeře, včetně tabulek přístupných prostřednictvím zkratek pro externí Azure Data Lake Storage nebo Amazon S3.
  • Vytvářejte zobrazení, funkce a uložené procedury – zapouzdřujte obchodní logiku a opakovaně použitelné vzory dotazů v objektech T-SQL, které se uchovávají v koncovém bodu analýzy SQL.
  • Použití zabezpečení na úrovni řádků a objektů – Pomocí podrobných oprávnění SQL můžete určit, kteří uživatelé uvidí, které tabulky, sloupce nebo řádky.
  • Vytváření sestav Power BI – sémantické modely Power BI se můžou připojit ke koncovému bodu analýzy SQL prostřednictvím jeho koncového bodu TDS (Tabular Data Stream), takže můžete vytvářet sestavy přes data lakehouse.
  • Dotazování napříč pracovními prostory – Pomocí zástupců OneLake můžete odkazovat na tabulky Delta v jiných jezerech nebo skladech a pak je spojit do jednoho dotazu. Další scénáře použití napříč pracovními prostory najdete v tématu Případy použití koncového bodu Sql Analytics pro Lakehouse.

Poznámka:

Externí tabulky Delta vytvořené pomocí kódu Sparku nejsou viditelné pro koncový bod analýzy SQL. K zobrazení externích tabulek delta použijte klávesové zkratky v části Tabulky. Podívejte se na Vytvoření zástupce a zjistěte jak na to.

Přístup k koncovému bodu SQL Analytics

Koncový bod analýzy SQL můžete otevřít dvěma způsoby:

  • V pracovním prostoru – V seznamu položek pracovního prostoru najděte položku koncového bodu SQL Analytics (sdílí název s vaším lakehousem) a vyberte ji.
  • Z Průzkumníka Lakehouse – v pravé horní části přepněte pomocí rozevíracího seznamu na zobrazení SQL analytického koncového bodu.

V obou případech se otevře query editor, kde můžete psát a spouštět dotazy T-SQL na tabulky Delta.

Zabezpečení

Pravidla zabezpečení SQL nastavená na koncový bod SQL Analytics platí jenom v případech, kdy se k datům přistupuje prostřednictvím koncového bodu. Nepoužijí se, pokud ke stejným datům přistupujete přes Spark nebo jiné nástroje.

Zabezpečení dat:

  • Nastavte na koncovém bodu analýzy SQL SQL podrobná oprávnění pro řízení přístupu k specifickým tabulkám, sloupcům nebo řádkům.
  • Nastavte role a oprávnění workspace (pracovního prostoru) pro kontrolování, kdo může přistupovat k lakehouse a jeho datům po jiných cestách.

Další informace o modelu zabezpečení najdete v tématu Zabezpečení OneLake pro koncové body analýzy SQL.

Synchronizace metadat

Když ve svém lakehouse vytvoříte nebo aktualizujete tabulku Delta, koncový bod analýzy SQL automaticky zjistí změnu a aktualizuje její metadata SQL – definice tabulek, typy sloupců a statistiky. Neexistuje žádný krok importu a nevyžaduje se žádná ruční synchronizace. Máte několik možností ručního zahájení aktualizace metadat koncového bodu analýzy SQL.

Další informace najdete v tématu Synchronizace metadat koncových bodů služby SQL Analytics.

Opětovné zřízení

Pokud se SQL analytics endpoint nepodaří při vytváření lakehouse, můžete to zkusit znovu přímo z domovské stránky lakehouse, aniž byste jezerní dům znovu vytvořili.

Snímek obrazovky znázorňující možnost opakování zřizování koncových bodů analýzy SQL v jezeře

Poznámka:

Opětovné zřízení může stále selhat, stejně jako počáteční zřizování. Pokud opakované pokusy selžou, obraťte se na podporu.

Omezení

SQL analytický endpoint sdílí svůj engine se skladem ve Fabric a mají stejná omezení.

Následující omezení platí pro automatické generování schématu a zjišťování metadat koncového bodu analýzy SQL.

  • Data by měla být ve formátu Delta Parquet, aby byla automaticky zjištěna v koncovém bodu analýzy SQL. Delta Lake je open-source úložný rámec , který umožňuje budovat architekturu jezerních domů.

  • Mapování sloupců Delta podle názvu je podporované, ale mapování sloupců Delta podle ID se nepodporuje. Další informace viz Funkce Delta Lake a zkušenosti prostředí Fabric.

  • Tabulky Delta vytvořené mimo /tables složku nejsou v koncovém bodu analýzy SQL dostupné.

    Pokud v SQL analytics endpointu nevidíte tabulku lakehouse, zkontrolujte její polohu. V koncovém bodu SQL Analytics jsou k dispozici pouze tabulky odkazované na data ve /tables složce. Tabulky, které odkazují na data ve složce /files v úložišti, nejsou v koncovém bodu SQL Analytics zpřístupněny. Jako alternativní řešení přesuňte data do /tables složky.

  • Některé sloupce, které existují v tabulkách Spark Delta, nemusí být dostupné v tabulkách v koncovém bodu analýzy SQL. Pro každou tabulku Delta v Lakehouse koncový bod analýzy SQL automaticky vygeneruje tabulku s datovými typy T-SQL. Modul koncových bodů SQL Analytics je založený na modulu Fabric Data Warehouse a sdílí datové typy. Úplný seznam podporovaných datových typů najdete v tématu Datové typy v datovém skladu Fabric.

  • Pokud do koncového bodu analýzy SQL přidáte omezení cizího klíče, nebudete moct provádět žádné další změny schématu (například přidání nových sloupců). Pokud nevidíte sloupce Delta Lake s typy, které by měly být podporovány v koncovém bodu analýzy SQL, zkontrolujte, jestli neexistuje omezení cizího klíče, které by mohlo bránit aktualizacím v tabulce.

  • Informace a doporučení týkající se výkonu koncového bodu sql Analytics najdete v tématu Aspekty výkonu koncových bodů analýzy SQL.

  • Skalární UDF jsou podporovány, pokud je lze integrovat. Další informace naleznete v tématu VYTVOŘENÍ FUNKCE a Vkládání skalárních UDF.

  • Datový typ varchar(max) je podporován pouze v SQL analytických endpointech zrcadlených položek a Fabric databází, nikoli v lakehouse. Tabulky vytvořené po 10. listopadu 2025 se automaticky mapují pomocí varchar(max). Tabulky vytvořené před 10. listopadem 2025 je potřeba znovu vytvořit, aby přijaly nový datový typ, nebo se během další změny schématu automaticky upgradují na varchar(max ).

Zkrácení dat na 8 KB stále platí v tabulkách v SQL analytickém endpointu jezerního domu, včetně zkratek k zrcadlenému prvku.

Vzhledem k tomu, že všechny tabulky nepodporují spojení varchar(max) v těchto sloupcích, nemusí fungovat podle očekávání, pokud jedna z tabulek stále obsahuje zkrácení dat. Například pokud CTAS uděláte tabulku nově vytvořeného zrcadleného předmětu do tabulky lakehouse pomocí Sparku a pak je spojíte pomocí sloupce varchar(max), výsledky dotazu budou jiné než u datového typu varchar(8000). Pokud chcete pokračovat v předchozím chování, můžete sloupec přetypovat na varchar(8000) v dotazu.

Pomocí následujícího dotazu T-SQL můžete ověřit, jestli tabulka obsahuje libovolný sloupec varchar(max) z metadat schématu. Hodnota max_length-1 představuje varchar(max):

SELECT o.name, c.name, type_name(user_type_id) AS [type], max_length
FROM sys.columns AS c
INNER JOIN sys.objects AS o
ON c.object_id = o.object_id
WHERE max_length = -1 
AND type_name(user_type_id) IN ('varchar', 'varbinary');
  • Schémata s názvy, které jsou v konfliktu se schématy systému (například sys nebo information_schema) a objekty zabezpečení databáze (například db_owner, db_datareader) se v koncovém bodu analýzy SQL nepodporují. Tabulky v těchto schématech se nesynchronizují s koncovým bodem analýzy SQL.

  • Pracovní prostor podporuje až 150 položek skladiště a koncových bodů analytiky SQL dohromady. Vytváření dalších položek nad rámec tohoto limitu se nepodporuje. Před vytvořením nové položky odstraňte existující položku.