Bijwerken naar de nieuwste versie van de SQL API van Databricks

Op deze pagina worden wijzigingen in de API's voor query's, waarschuwingen, machtigingen, gegevensbronnen en visualisaties beschreven die zijn opgenomen in de nieuwste versie van de SQL-API van Databricks. De verouderde API is afgeschaft en de ondersteuning wordt binnenkort beëindigd. Op deze pagina kunt u uw toepassingen en integraties migreren naar de nieuwe API-versie.

Wijzigingen in de QUERY's-API

De nieuwe query's-API bevat een gebruiksvriendelijkere ervaring met meer beschrijvende namen, gepagineerde antwoorden en lijstantwoorden die automatisch worden gesorteerd op aanmaaktijd. In de volgende lijst worden de wijzigingen in de QUERY's-API beschreven:

• Het API-pad is nu api/2.0/sql/queries, ter vervanging van het verouderde pad van /api/2.0/preview/sql/queries.
• Bevat een nieuwe querydefinitie met meer beschrijvende veldnamen en -typen.
• Het update-eindpunt ondersteunt nu gedeeltelijke updates in PATCH plaats van POST.
• Het update-eindpunt ondersteunt nu het overdragen van het eigendom van query's. Voorheen was dit alleen toegestaan met behulp van de API voor het overdragen van objecteigendom.
• De antwoorden op het lijsteindpunt worden nu gepagineerd met behulp van paginering op basis van tokens.
• Het lijsteindpunt biedt geen ondersteuning meer voor filteren op naam of aangepaste volgorde. In plaats daarvan worden alle toegankelijke query's geretourneerd en gesorteerd in oplopende volgorde op basis van de aanmaaktijd.
• Het hersteleindpunt wordt niet meer ondersteund. Prullenbakquery's kunnen nog steeds worden hersteld via de gebruikersinterface van Azure Databricks.

Zie Query's voor volledige documentatie over de bijgewerkte Query's-API.

Wijzigingen in de Waarschuwingen-API

De nieuwe Waarschuwingen-API bevat een gebruiksvriendelijkere ervaring met beschrijvende veldnamen en -typen, gepagineerde antwoorden op lijsteindpunten en ondersteuning voor gedeeltelijke updates. In de volgende lijst worden de wijzigingen in de Waarschuwingen-API beschreven:

• Het API-pad is nu api/2.0/sql/alerts, ter vervanging van het verouderde pad van /api/2.0/preview/sql/alerts.
• Bevat een nieuwe waarschuwingsdefinitie met meer beschrijvende veldnamen en typen wordt gebruikt.
• Het update-eindpunt ondersteunt nu gedeeltelijke updates in PATCH plaats van POST.
• Het update-eindpunt ondersteunt nu het overdragen van het eigendom van query's. Voorheen was dit alleen toegestaan met behulp van de API voor het overdragen van objecteigendom.
• De antwoorden op het lijsteindpunt worden nu gepagineerd met behulp van paginering op basis van tokens.
• Het verwijdereindpunt verplaatst de waarschuwing nu naar de prullenbak in plaats van de waarschuwing permanent te verwijderen. Prullenbakmeldingen worden na 30 dagen automatisch verwijderd. Verwijderde waarschuwingen kunnen binnen 30 dagen na verwijdering worden hersteld via de Gebruikersinterface van Azure Databricks.

Zie Waarschuwingen voor volledige documentatie over de bijgewerkte Waarschuwingen-API.

De API voor machtigingen is afgeschaft

De Permissions API is nu gemarkeerd als verouderd verklaard. Gebruik de Werkruimte-API om objectmachtigingen te beheren. Gebruik de query's en waarschuwingen om API's bij te werken om het eigendom van het object over te dragen.

De API voor gegevensbronnen is afgeschaft

De API voor gegevensbronnen is nu gemarkeerd als afgeschaft. Op dit moment is de functionaliteit beperkt tot het ophalen van een lijst met SQL-warehouses. Omdat de nieuwe query's-API ondersteuning biedt voor het doorgeven en retourneren van SQL-warehouse-id's in plaats van gegevensbron-id's, is een afzonderlijke API-aanroep die moet worden geconverteerd tussen gegevensbronnen en SQL-warehouses niet meer vereist.

SDK-versies upgraden

Als u toegang hebt tot de verouderde Databricks SQL-API via Databricks SDK's, voert u een upgrade uit naar de nieuwste SDK-versie en migreert u naar de nieuwe API's. Zie de Databricks SDK's voor SDK-documentatie.

CLI-opdrachten migreren

Als u toegang hebt tot de verouderde Databricks SQL-API via de Databricks CLI, migreert u vanuit deze afgeschafte opdrachtgroepen:

Deprecated	Gebruik in plaats daarvan
query's die verouderd zijn	queries
alerts-legacy	alerts
gegevensbronnen	Geen vervanging

Terraform-resources migreren

Als u Terraform gebruikt om uw Databricks SQL-resources te beheren, migreert u naar de nieuwe resourcedefinities:

Verouderde resource	Gebruik in plaats daarvan	Migratiehandleiding
databricks_sql_query	databricks_query	Migratiehandleiding
databricks_sql_alert	databricks_alert	Migratiehandleiding
databricks_sql_visualization	databricks_dashboard	Geen migratiehandleiding

Voor databricks_sql_endpoint en databricks_sql_warehouse:

Voer een upgrade uit naar databricks Terraform-provider v1.105.0 of hoger. Het data_source_id veld is afgeschaft. Voer een upgrade uit om fouten te voorkomen wanneer de API voor afgeschafte gegevensbronnen is uitgeschakeld.