Condividi tramite

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

  • Articolo

Questo articolo descrive le modifiche apportate alle API Query, Avvisi, Autorizzazioni e Origini dati incluse nella versione più recente dell'API SQL di Databricks. Usare questo articolo per eseguire la migrazione delle applicazioni e delle integrazioni alla nuova versione dell'API.

L'API legacy continuerà a essere supportata per sei mesi. Questo periodo di transizione consente di eseguire la migrazione prima che la versione precedente venga eliminata gradualmente.

Modifiche all'API Query

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 elenco non supporta più il filtro in base al nome o all'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 Avvisi

La nuova API Avvisi include un'esperienza più intuitiva con nomi e tipi di campo più descrittivi, risposte impaginate agli endpoint elenco 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 elenco vengono ora impaginate usando la paginazione basata su 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.

Modifiche all'API Autorizzazioni

L'API Permissions non supporta più l'ACL dell'oggetto Get e L'ACL dell'oggetto Set. Usare l'API dell'area di lavoro per gestire le autorizzazioni per queste azioni.

API Origini dati contrassegnata come legacy

L'API Origini dati è ora contrassegnata come legacy. 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.