Frissítés a Databricks SQL API legújabb verziójára

Ez a lap a Databricks SQL API legújabb verziójában található lekérdezések, riasztások, engedélyek, adatforrások és vizualizációk API-k módosításait ismerteti. Az örökölt API elavult, és a támogatás hamarosan megszűnik. Ezen a lapon migrálhatja az alkalmazásokat és az integrációkat az új API-verzióba.

A Lekérdezések API módosítása

Az új Lekérdezések API felhasználóbarátabb felületet biztosít leíróbb nevek, lapszámozott válaszok és listaválaszok automatikus rendezésével a létrehozási idő szerint. Az alábbi lista a Lekérdezések API módosításait ismerteti:

• Az API elérési útja most már api/2.0/sql/queries, felváltva a régi elérési utat /api/2.0/preview/sql/queries.
• Tartalmaz egy új lekérdezésdefiníciót, amely leíróbb mezőneveket és -típusokat tartalmaz.
• A frissítési végpont mostantól támogatja a részleges frissítéseket úgy, hogy a PATCH-t használja a POST helyett.
• A frissítési végpont mostantól támogatja a lekérdezések tulajdonjogának átadását. Korábban ez csak az átviteli objektum tulajdonjogi API-jának használatával engedélyezett.
• A listavégpont-válaszok mostantól tokenalapú lapozással vannak lapszámozottak.
• A listavégpont már nem támogatja a név vagy egyéni rendezés szerinti szűrést. Ehelyett a rendszer az összes akadálymentes lekérdezést növekvő sorrendben adja vissza és rendezi a létrehozási idő szerint.
• A visszaállítási végpont már nem támogatott. A törölt lekérdezések továbbra is visszaállíthatók az Azure Databricks felhasználói felületén keresztül.

A frissített Lekérdezések API teljes dokumentációját a Lekérdezések című témakörben találja.

A Riasztások API módosítása

Az új Riasztások API felhasználóbarátabb felületet biztosít, amely leíróbb mezőneveket és -típusokat, többoldalas válaszokat tartalmaz a végpontok listázására, és támogatja a részleges frissítéseket. Az alábbi lista a Riasztások API módosításait ismerteti:

• Az API elérési útja most már api/2.0/sql/alerts, felváltva a régi elérési utat /api/2.0/preview/sql/alerts.
• Tartalmaz egy új riasztásdefiníciót, amely leíróbb mezőneveket és típusokat használ.
• A frissítési végpont mostantól támogatja a részleges frissítéseket úgy, hogy a PATCH-t használja a POST helyett.
• A frissítési végpont mostantól támogatja a lekérdezések tulajdonjogának átadását. Korábban ez csak az átviteli objektum tulajdonjogi API-jának használatával engedélyezett.
• A listavégpont-válaszok mostantól tokenalapú lapozással vannak lapszámozottak.
• A törlési végpont a riasztás végleges törlése helyett a kukába helyezi át a riasztást. A lomtárba került riasztások 30 nap elteltével automatikusan törlődnek. A törölt riasztások a törlést követő 30 napon belül visszaállíthatók az Azure Databricks felhasználói felületén keresztül.

A frissített Riasztások API teljes dokumentációját a Riasztások című témakörben találja.

Az Engedélyek API elavult

Az Engedélyek API elavultként van megjelölve. A Workspace API használatával kezelheti az objektumengedélyeket. A lekérdezések és riasztások frissítési API-kkal ruházhatja át az objektum tulajdonjogát.

Az adatforrások API elavulttá vált

Az Adatforrások API elavultként van megjelölve. A funkció jelenleg az SQL-raktárak listájának lekérésére korlátozódik. Mivel az új Lekérdezések API támogatja az SQL Warehouse-azonosítók átadását és visszaadását adatforrásazonosítók helyett, már nincs szükség külön API-hívásra az adatforrások és az SQL-raktárak közötti konvertáláshoz.

SDK-verziók frissítése

Ha a Databricks SDK-kkal éri el az örökölt Databricks SQL API-t, frissítsen a legújabb SDK-verzióra, és migráljon az új API-kba. A Databricks SDK-ket lásd az SDK dokumentációért.

Parancssori felületi parancsok migrálása

Ha az örökölt Databricks SQL API-t a Databricks parancssori felületén keresztül éri el, migrálhatja ezeket az elavult parancscsoportokat:

Deprecated	Használjon helyette
lekérdezések –örökölt	queries
régi riasztások	alerts
adatforrások	Nincs csere

Terraform-erőforrások migrálása

Ha a Terraform használatával kezeli a Databricks SQL-erőforrásokat, migráljon az új erőforrás-definíciókra:

Elavult erőforrás	Használjon helyette	Migrálási útmutató
databricks_sql_query	databricks_query	Migrálási útmutató
databricks_sql_alert	databricks_alert	Migrálási útmutató
databricks_sql_visualization	databricks_dashboard	Nincs migrálási útmutató

Databricks_sql_endpoint és databricks_sql_warehouse esetén:

Frissítsen a Databricks Terraform-szolgáltató 1.105.0-s vagy újabb verziójára. A data_source_id mező elavult. Frissítsen a hibák megelőzésére, amennyiben a már nem támogatott adatforrások API ki van kapcsolva.