Aktualisieren auf die neueste Databricks-SQL-API-Version

  • Artikel

In diesem Artikel werden Änderungen an den APIs für Abfragen, Warnungen, Berechtigungen und Datenquellen in der neuesten Version der Databricks-SQL-API beschrieben. Dieser Artikel soll Ihnen helfen, Ihre Anwendungen und Integrationen zur neuen API-Version zu migrieren.

Die Legacy-API wird noch weitere sechs Monate unterstützt. Dieser Übergangszeitraum gibt Ihnen Zeit für die Migration, bevor die ältere Version eingestellt wird.

Änderungen an der Abfrage-API

Die neue Abfrage-API enthält eine benutzerfreundlichere Oberfläche mit aussagekräftigeren Namen, seitenweisen Antworten und Antworten in Listenform, die automatisch nach ihrer Erstellungszeit sortiert werden. In der folgenden Liste werden die Änderungen an der Abfrage-API beschrieben:

  • Der API-Pfad lautet jetzt api/2.0/sql/queries und ersetzt den älteren Pfad /api/2.0/preview/sql/queries.
  • Sie enthält eine neue Abfragedefinition mit aussagekräftigeren Feldnamen und -typen.
  • Der Updateendpunkt unterstützt jetzt partielle Updates mit PATCH anstelle von POST.
  • Der Updateendpunkt unterstützt jetzt die Übertragung des Besitzes von Abfragen. Bisher war dies nur mit der [Objektbesitzübertragungs-API](/API/workspace/dbsqlpermissions/transfer ownership) zulässig.
  • Die Antworten am Listenendpunkt werden jetzt mithilfe der tokenbasierten Paginierung auf Seiten aufgeteilt.
  • Der Listenendpunkt unterstützt keine Filterung nach Name und keine benutzerdefinierter Sortierung mehr. Stattdessen werden alle barrierefreien Abfragen nach ihrer Erstellungszeit in aufsteigender Reihenfolge zurückgegeben und sortiert.
  • Der Wiederherstellungsendpunkt wird nicht mehr unterstützt. Gelöschte Abfragen können weiterhin über die Azure Databricks-Benutzeroberfläche wiederhergestellt werden.

Die vollständige Dokumentation zur aktualisierten Abfrage-API finden Sie unter Abfragen.

Änderungen an der Warnungs-API

Die neue Warnungs-API bietet eine benutzerfreundlichere Oberfläche mit aussagekräftigeren Feldnamen und -typen, seitenweise Antworten an Listenendpunkten und Unterstützung für partielle Updates. In der folgenden Liste werden die Änderungen an der Warnungs-API beschrieben:

  • Der API-Pfad lautet jetzt api/2.0/sql/alerts und ersetzt den älteren Pfad /api/2.0/preview/sql/alerts.
  • Sie enthält eine neue Warnungsdefinition mit aussagekräftigeren Feldnamen und -typen.
  • Der Updateendpunkt unterstützt jetzt partielle Updates mit PATCH anstelle von POST.
  • Der Updateendpunkt unterstützt jetzt die Übertragung des Besitzes von Abfragen. Bisher war dies nur mit der API zum Transfer von Objekt-Besitz zulässig.
  • Die Antworten am Listenendpunkt werden jetzt mithilfe der tokenbasierten Paginierung auf Seiten aufgeteilt.
  • Der Löschendpunkt verschiebt eine Warnung jetzt in den Papierkorb, anstatt sie dauerhaft zu löschen. Gelöschte Benachrichtigungen werden nach 30 Tagen automatisch bereinigt. Gelöschte Warnungen können innerhalb von 30 Tagen über die Benutzeroberfläche von Azure Databricks wiederhergestellt werden.

Die vollständige Dokumentation zur aktualisierten Warnungs-API finden Sie unter Warnungen.

Änderungen an der Berechtigungs-API

Die Berechtigungs-API unterstützt Get object ACL und Set object ACL nicht mehr. Verwenden Sie die Arbeitsbereichs-API, um Berechtigungen für diese Aktionen zu verwalten.

Datenquellen-API als veraltet gekennzeichnet

Die Datenquellen-API ist jetzt als veraltet gekennzeichnet. Derzeit ist die Funktionalität auf das Abrufen einer Liste von SQL-Warehouses beschränkt. Da die neue Abfrage-API das Übergeben und Zurückgeben von SQL-Warehouse-IDs anstelle von Datenquellen-IDs unterstützt, ist kein separater API-Aufruf zum Konvertieren zwischen Datenquellen und SQL-Warehouses mehr erforderlich.