Aktualisieren auf die neueste Databricks-SQL-API-Version

Auf dieser Seite werden Änderungen an den APIs "Abfragen", "Warnungen", "Berechtigungen", "Datenquellen" und "Visualisierungen" beschrieben, die in der neuesten Version der SQL-API von Databricks enthalten sind. Die Legacy-API ist veraltet und der Support wird in Kürze beendet. Verwenden Sie diese Seite, um Ihre Anwendungen und Integrationen in die neue API-Version zu migrieren.

Ä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 API zum Transfer von Objekt-Besitz 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.

Die Berechtigungs-API ist veraltet.

Die Berechtigungs-API ist jetzt als veraltet gekennzeichnet. Verwenden Sie die Arbeitsbereichs-API , um Objektberechtigungen zu verwalten. Verwenden Sie die Abfragen und Warnungen zum Aktualisieren von APIs zum Übertragen des Objektbesitzes.

Datenquellen-API ist veraltet

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.

Aktualisieren von SDK-Versionen

Wenn Sie über Databricks-SDKs auf die ältere Databricks-SQL-API zugreifen, aktualisieren Sie auf die neueste SDK-Version, und migrieren Sie zu den neuen APIs. Weitere Informationen finden Sie in der Sdk-Dokumentation zu Databricks SDKs .

Migrieren von CLI-Befehlen

Wenn Sie über die Databricks-CLI auf die ältere Databricks-SQL-API zugreifen, migrieren Sie aus diesen veralteten Befehlsgruppen:

Deprecated	Stattdessen verwenden
Legacy-Abfragen	queries
Alerts-Legacy	alerts
Datenquellen	Kein Ersatz

Migrieren von Terraform-Ressourcen

Wenn Sie Terraform zum Verwalten Ihrer Databricks SQL-Ressourcen verwenden, migrieren Sie zu den neuen Ressourcendefinitionen:

Veraltete Ressource	Stattdessen verwenden	Migrationshandbuch
databricks_sql_query	databricks_query	Migrationshandbuch
databricks_sql_alert	databricks_alert	Migrationshandbuch
databricks_sql_visualization	databricks_dashboard	Kein Migrationshandbuch

Für databricks_sql_endpoint und databricks_sql_warehouse:

Upgrade auf Databricks Terraform Provider v1.105.0 oder höher. Das data_source_id Feld ist veraltet. Führen Sie ein Upgrade aus, um Fehler zu verhindern, wenn die veraltete Datenquellen-API deaktiviert ist.