Delen via

Bijwerken naar de nieuwste versie van de SQL API van Databricks

  • 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 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 [objecteigendom-API overdragen](/API/workspace/dbsqlpermissions/transfer ownership).
  • 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. 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 Machtigingen-API biedt geen ondersteuning meer voor object-ACL ophalen en object-ACL instellen. 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 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.