Eseguire l'aggiornamento alla versione più recente dell'API SQL di Databricks

Questa pagina descrive le modifiche apportate alle API Query, Avvisi, Autorizzazioni, Origini dati e Visualizzazioni incluse nella versione più recente dell'API SQL di Databricks. L'API legacy è deprecata e il supporto terminerà presto. Usare questa pagina per eseguire la migrazione delle applicazioni e delle integrazioni alla nuova versione dell'API.

Modifiche all'API Queries

La nuova API Query include un'esperienza più intuitiva con nomi più descrittivi, risposte impaginate ed elencare automaticamente le risposte ordinate in base all'ora di creazione. L'elenco seguente descrive le modifiche apportate all'API Query:

• Il percorso DELL'API è ora api/2.0/sql/queries, sostituendo il percorso legacy di /api/2.0/preview/sql/queries.
• Include una nuova definizione di query con nomi e tipi di campo più descrittivi.
• L'endpoint di aggiornamento supporta ora gli aggiornamenti parziali usando PATCH anziché POST.
• L'endpoint di aggiornamento supporta ora il trasferimento della proprietà delle query. In precedenza, ciò era consentito solo usando l'API di proprietà dell'oggetto di trasferimento.
• Le risposte dell'endpoint elenco vengono ora impaginate usando la paginazione basata su token.
• L'endpoint della lista non supporta più il filtraggio per nome o l'ordinamento personalizzato. Tutte le query accessibili vengono invece restituite e ordinate in ordine crescente in base al tempo di creazione.
• L'endpoint di ripristino non è più supportato. Le query cestinate possono continuare a essere ripristinate tramite l'interfaccia utente di Azure Databricks.

Per la documentazione completa sull'API query aggiornata, vedere Query.

Modifiche all'API degli avvisi

La nuova API degli Avvisi include un'esperienza più intuitiva, con nomi e tipi di campo più descrittivi, risposte paginated per elencare gli endpoint e supporto per gli aggiornamenti parziali. L'elenco seguente descrive le modifiche apportate all'API Avvisi:

• Il percorso DELL'API è ora api/2.0/sql/alerts, sostituendo il percorso legacy di /api/2.0/preview/sql/alerts.
• Include una nuova definizione di avviso con nomi di campo e tipi più descrittivi.
• L'endpoint di aggiornamento supporta ora gli aggiornamenti parziali usando PATCH anziché POST.
• L'endpoint di aggiornamento supporta ora il trasferimento della proprietà delle query. In precedenza, ciò era consentito solo usando l'API di proprietà dell'oggetto di trasferimento.
• Le risposte dell'endpoint di lista vengono ora impaginate utilizzando una gestione tramite token.
• L'endpoint di eliminazione sposta ora l'avviso nel cestino invece di eliminare definitivamente l'avviso. Gli avvisi cestinati verranno puliti automaticamente dopo 30 giorni. Gli avvisi cestinati possono essere ripristinati entro 30 giorni dall'eliminazione tramite l'interfaccia utente di Azure Databricks.

Per la documentazione completa sull'API avvisi aggiornata, vedere Avvisi.

API delle autorizzazioni deprecata

L'API Autorizzazioni è ora contrassegnata come deprecata. Usare l'API Area di lavoro per gestire le autorizzazioni per gli oggetti. Usare le api di aggiornamento delle query e degli avvisi per trasferire la proprietà degli oggetti.

API Origini dati deprecata

L'API Origini dati è ora contrassegnata come deprecata. Attualmente, la funzionalità è limitata all'acquisizione di un elenco di warehouse SQL. Poiché la nuova API Query supporta il passaggio e la restituzione degli ID di SQL Warehouse anziché degli ID origine dati, non è più necessaria una chiamata API separata per la conversione tra origini dati e SQL Warehouse.

Aggiornamento delle versioni dell'SDK

Se si accede all'API SQL di Databricks legacy tramite gli SDK di Databricks, eseguire l'aggiornamento alla versione più recente dell'SDK ed eseguire la migrazione alle nuove API. Vedere la documentazione sugli SDK di Databricks.

Migrazione dei comandi CLI

Se si accede all'API SQL di Databricks legacy tramite l'interfaccia della riga di comando di Databricks, eseguire la migrazione da questi gruppi di comandi deprecati:

Deprecated	Utilizzare invece
query legacy	queries
alerts-legacy	alerts
origini dati	Nessuna sostituzione

Migrazione delle risorse Terraform

Se si usa Terraform per gestire le risorse SQL di Databricks, eseguire la migrazione alle nuove definizioni di risorse:

Risorsa deprecata	Utilizzare invece	Guida alla migrazione
databricks_sql_query	databricks_query	Guida alla migrazione
databricks_sql_alert	databricks_alert	Guida alla migrazione
databricks_sql_visualization	databricks_dashboard	Nessuna guida alla migrazione

Per databricks_sql_endpoint e databricks_sql_warehouse:

Eseguire l'aggiornamento al provider Databricks Terraform v1.105.0 o versione successiva. Il data_source_id campo è deprecato. Eseguire l'aggiornamento per evitare errori quando l'API delle origini dati deprecata è disattivata.