Uppdatera till den senaste Versionen av Databricks SQL API

På den här sidan beskrivs ändringar i API:erna frågor, aviseringar, behörigheter, datakällor och visualiseringar som ingår i den senaste versionen av Databricks SQL API. Det äldre API:et är inaktuellt och supporten upphör snart. Använd den här sidan om du vill migrera dina program och integreringar till den nya API-versionen.

Ä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 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.
• 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.

Behörighets-API:et är inaktuellt

Behörighets-API:et har nu markerats som inaktuellt. Använd API:et för arbetsyta för att hantera objektbehörigheter. Använd api:erna för uppdatering av frågor och aviseringar för att överföra objektägarskap.

API för datakällor inaktuellt

API:et för datakällor har nu markerats som inaktuellt. 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.

Uppgradera SDK-versioner

Om du kommer åt det äldre Databricks SQL-API:et via Databricks SDK:er uppgraderar du till den senaste SDK-versionen och migrerar till de nya API:erna. Se Databricks SDK-dokumentation för information om SDK.

Migrera CLI-kommandon

Om du har åtkomst till det äldre Databricks SQL-API:et via Databricks CLI migrerar du från dessa inaktuella kommandogrupper:

Deprecated	Använd i stället
äldre frågor	queries
alerts-legacy	alerts
datakällor	Ingen ersättning

Migrera Terraform-resurser

Om du använder Terraform för att hantera dina Databricks SQL-resurser migrerar du till de nya resursdefinitionerna:

Inaktuell resurs	Använd i stället	Migreringsguide
databricks_sql_query	databricks_query	Migreringsguide
databricks_sql_alert	databricks_alert	Migreringsguide
databricks_sql_visualization	databricks_dashboard	Ingen migreringsguide

För databricks_sql_endpoint och databricks_sql_warehouse:

Uppgradera till Databricks Terraform-providern v1.105.0 eller senare. Fältet data_source_id är inaktuellt. Uppgradera för att förhindra fel när api:et för inaktuella datakällor är inaktiverat.