Uppdatera till den senaste Versionen av Databricks SQL API

I den här artikeln beskrivs ändringar i API:erna frågor, aviseringar, behörigheter och datakällor som ingår i den senaste versionen av Databricks SQL API. Använd den här artikeln för att migrera dina program och integreringar till den nya API-versionen.

Det äldre API:et kommer att fortsätta att stödjas i sex månader. Den här övergångsperioden ger dig tid att migrera innan den äldre versionen fasas ut.

Ändringar i fråge-API:et

Det nya API:et för frågor innehåller en mer användarvänlig upplevelse med mer beskrivande namn, sidnumrerade svar och listsvar som sorteras automatiskt efter skapandetid. I följande lista beskrivs ändringarna i FRÅGE-API:et:

• API-sökvägen är nu api/2.0/sql/queriesoch ersätter den äldre sökvägen /api/2.0/preview/sql/queriesför .
• Innehåller en ny frågedefinition med mer beskrivande fältnamn och typer.
• Uppdateringsslutpunkten stöder nu partiella uppdateringar genom att använda PATCH i stället för POST.
• Uppdateringsslutpunkten stöder nu överföring av ägarskapet för frågor. Tidigare tilläts detta endast med hjälp av API:et för ägarskap för överföringsobjekt.
• Listslutpunktssvaren är nu sidnumrerade med hjälp av tokenbaserad sidnumrering.
• Listslutpunkten stöder inte längre filtrering efter namn eller anpassad ordning. I stället returneras alla tillgängliga frågor och sorteras i stigande ordning efter deras skapandetid.
• Återställningsslutpunkten stöds inte längre. Skräpfrågor kan fortsätta att återställas via Azure Databricks-användargränssnittet.

Fullständig dokumentation om det uppdaterade fråge-API:et finns i Frågor.

Ändringar i aviserings-API:et

Det nya aviserings-API:et innehåller en mer användarvänlig upplevelse med mer beskrivande fältnamn och typer, sidnumrerade svar på listslutpunkter och stöd för partiella uppdateringar. I följande lista beskrivs ändringarna i aviserings-API:et:

• API-sökvägen är nu api/2.0/sql/alertsoch ersätter den äldre sökvägen /api/2.0/preview/sql/alertsför .
• Innehåller en ny aviseringsdefinition med mer beskrivande fältnamn och typer som används.
• Uppdateringsslutpunkten stöder nu partiella uppdateringar genom att använda PATCH istället för POST.
• Uppdateringsslutpunkten stöder nu överföring av ägarskapet för frågor. Tidigare tilläts detta endast med hjälp av API:et för ägarskap för överföringsobjekt.
• Listslutpunktssvaren är nu sidnumrerade med hjälp av tokenbaserad sidnumrering.
• Borttagningsslutpunkten flyttar nu aviseringen till papperskorgen i stället för att permanent ta bort aviseringen. Aviseringar i papperskorgen rensas automatiskt bort efter 30 dagar. Raderade varningar kan återställas inom 30 dagar efter borttagandet via användargränssnittet för Azure Databricks.

Fullständig dokumentation om det uppdaterade aviserings-API:et finns i Aviseringar.

Ändringar i behörighets-API:et

Behörighets-API :et stöder inte längre Hämta objekt-ACL och Ange objekt-ACL. Använd API:et för arbetsyta för att hantera behörigheter för dessa åtgärder.

API för datakällor som markerats som äldre

API :et för datakällor är nu markerat som äldre. För närvarande är dess funktioner begränsade till att hämta en lista över SQL-lager. Eftersom det nya API:et för frågor har stöd för att skicka in och returnera SQL-lager-ID:n i stället för datakällans ID krävs inte längre ett separat API-anrop för att konvertera mellan datakällor och SQL-lager.