Delen via

Update naar de nieuwste versie van de Databricks SQL API

  • Artikel

In dit artikel worden wijzigingen in de API's voor query's, waarschuwingen, machtigingen en gegevensbronnen beschreven die zijn opgenomen in de nieuwste versie van de Databricks SQL-API. Gebruik dit artikel om uw toepassingen en integraties te migreren naar de nieuwe API-versie.

De verouderde API wordt nog zes maanden ondersteund. Deze overgangsperiode geeft u tijd om te migreren voordat de oudere versie wordt uitgefaseerd.

Wijzigingen in de QUERY's-API

De nieuwe query's-API bevat een gebruiksvriendelijkere ervaring met beschrijvende namen, gepagineerde antwoorden en list antwoorden automatisch gesorteerd op aanmaaktijd. In de volgende list 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 met behulp van PATCH in plaats van POST.
  • Het update-eindpunt biedt nu ondersteuning voor het overdragen van het eigendom van query's. Voorheen was dit alleen toegestaan met behulp van de API voor het overdragen van objecteigendom.
  • De list eindpuntantwoorden worden nu gepagineerd met behulp van paginering op basis van tokens.
  • Het list-eindpunt 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 restore-eindpunt 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 list eindpunten en ondersteuning voor gedeeltelijke updates. In de volgende list worden de wijzigingen in de API voor waarschuwingen 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 met behulp van PATCH in plaats van POST.
  • Het update-eindpunt biedt nu ondersteuning voor het overdragen van het eigendom van query's. Voorheen was dit alleen toegestaan met behulp van de API voor het overdragen van objecteigendom.
  • De list endpoint-antwoorden worden nu gepagineerd met behulp van token-gebaseerde paginering.
  • Het verwijdereindpunt verplaatst de waarschuwing nu naar de prullenbak in plaats van de waarschuwing permanent te verwijderen. Prullenbakwaarschuwingen worden na 30 dagen automatisch opgeschoond. 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.

Wijzigingen in de machtigingen-API

De Permissions API biedt geen ondersteuning meer voor Get object-ACL- en Set object-ACL-. Gebruik de Werkruimte-API om machtigingen voor deze acties te beheren.

Api voor gegevensbronnen die is gemarkeerd als verouderd

De API voor gegevensbronnen is nu gemarkeerd als verouderd. Op dit moment is de functionaliteit beperkt tot het ophalen van een list van SQL-magazijnen. 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.