Aktualizace na nejnovější verzi rozhraní SQL API služby Databricks

Tento článek popisuje změny rozhraní API pro dotazy, výstrahy, oprávnění a zdroje dat, která jsou součástí nejnovější verze rozhraní SQL API služby Databricks. Tento článek vám pomůže s migrací aplikací a integrací do nové verze rozhraní API.

Starší rozhraní API bude nadále podporováno po dobu šesti měsíců. Toto přechodné období vám poskytne čas k migraci před ukončením starší verze.

Změny rozhraní API pro dotazy

Nové rozhraní API pro dotazy zahrnuje uživatelsky přívětivější prostředí s popisnějšími názvy, stránkovanými odpověďmi a automaticky seřazenými odpověďmi podle času vytvoření seznamu. Následující seznam popisuje změny rozhraní API pro dotazy:

• Cesta rozhraní API je nyní api/2.0/sql/queriesnahrazena starší cestou /api/2.0/preview/sql/queries.
• Obsahuje novou definici dotazu s popisnějšími názvy a typy polí.
• Koncový bod aktualizace teď podporuje částečné aktualizace pomocí PATCH místo POST.
• Koncový bod aktualizace teď podporuje přenos vlastnictví dotazů. Dříve to bylo povoleno pouze pomocí rozhraní API pro vlastnictví objektu pro přenos.
• Odpovědi na koncové body seznamu se teď stránkují pomocí stránkování založeného na tokenech.
• Koncový bod seznamu už nepodporuje filtrování podle názvu nebo vlastního řazení. Místo toho se všechny přístupné dotazy vrátí a seřadí vzestupně podle času vytváření.
• Koncový bod obnovení se už nepodporuje. Dotazy v koši je možné i nadále obnovovat prostřednictvím uživatelského rozhraní Azure Databricks.

Kompletní dokumentaci k aktualizovanému rozhraní API pro dotazy najdete v tématu Dotazy.

Změny rozhraní API pro upozornění

Nové rozhraní API pro upozornění zahrnuje uživatelsky přívětivější prostředí s popisnějšími názvy a typy polí, stránkovanými odpověďmi na koncové body seznamu a podporou částečných aktualizací. Následující seznam popisuje změny rozhraní API upozornění:

• Cesta rozhraní API je nyní api/2.0/sql/alertsnahrazena starší cestou /api/2.0/preview/sql/alerts.
• Obsahuje novou definici výstrahy s popisnějšími názvy polí a typy.
• Koncový bod aktualizace teď podporuje částečné aktualizace pomocí PATCH místo POST.
• Koncový bod aktualizace teď podporuje přenos vlastnictví dotazů. Dříve to bylo povoleno pouze pomocí rozhraní API pro vlastnictví objektu pro přenos.
• Odpovědi na koncové body seznamu se teď stránkují pomocí stránkování založeného na tokenech.
• Koncový bod odstranění teď přesune upozornění do koše místo trvalého odstranění výstrahy. Upozornění v koši se automaticky vyčistí po 30 dnech. Odstraněná upozornění je možné obnovit do 30 dnů od odstranění prostřednictvím uživatelského rozhraní Azure Databricks.

Kompletní dokumentaci k aktualizovanému rozhraní API upozornění najdete v tématu Výstrahy.

Změny rozhraní API pro oprávnění

Rozhraní API Oprávnění už nepodporuje Získat ACL objektu a Nastavit ACL objektu. Ke správě oprávnění pro tyto akce použijte rozhraní API pracovního prostoru.

Rozhraní API zdrojů dat označené jako starší verze

Rozhraní API zdrojů dat je teď označené jako starší verze. V současné době je jeho funkce omezená na získání seznamu skladů SQL. Vzhledem k tomu, že nové rozhraní API pro dotazy podporuje předávání a vracení ID SQL Warehouse místo ID zdrojů dat, už se nevyžaduje samostatné volání rozhraní API pro převod mezi zdroji dat a sklady SQL.