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

Tato stránka popisuje změny rozhraní API pro dotazy, výstrahy, oprávnění, zdroje dat a vizualizace zahrnuté v nejnovější verzi rozhraní SQL API služby Databricks. Starší verze rozhraní API je zastaralá a podpora brzy skončí. Na této stránce můžete migrovat aplikace a integrace do nové verze rozhraní API.

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 převod vlastnictví objektu.
• 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.
• Zahrnuje se nová definice 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í API pro přenos vlastnictví objektu.
• 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.

Rozhraní API pro oprávnění je zastaralé

Rozhraní API pro oprávnění je teď označené jako zastaralé. Ke správě oprávnění k objektům použijte rozhraní API pracovního prostoru . Pomocí dotazů a upozornění aktualizujte rozhraní API pro přenos vlastnictví objektu.

Zastaralé rozhraní API zdrojů dat

Rozhraní API pro zdroje dat je nyní označeno jako zastaralé. 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.

Aktualizace verzí sady SDK

Pokud přistupujete ke starší verzi rozhraní Databricks SQL API prostřednictvím sad SDK Databricks, upgradujte na nejnovější verzi sady SDK a migrujte na nová rozhraní API. Podívejte se na SDK Databricks pro dokumentaci SDK.

Migrace příkazů rozhraní příkazového řádku

Pokud ke starší verzi rozhraní SQL API Databricks přistupujete prostřednictvím rozhraní příkazového řádku Databricks, migrujte z těchto zastaralých skupin příkazů:

Deprecated	Použít místo toho
dotazy – starší verze	queries
Upozornění – starší verze	alerts
zdroje dat	Žádné nahrazení

Migrace prostředků Terraformu

Pokud ke správě prostředků SQL Databricks používáte Terraform, proveďte migraci na nové definice prostředků:

Zastaralý prostředek	Místo toho použijte	Průvodce migrací
databricks_sql_query	databricks_query	Průvodce migrací
databricks_sql_alert	databricks_alert	Průvodce migrací
databricks_sql_visualization	databricks_dashboard	Žádný průvodce migrací

Pro databricks_sql_endpoint a databricks_sql_warehouse:

Upgradujte na poskytovatele Terraformu Databricks verze 1.105.0 nebo novější. Pole data_source_id je zastaralé. Upgradem zabráníte chybám, když je rozhraní API zastaralých zdrojů dat vypnuté.