Atualize para a versão mais recente Databricks SQL API
Este artigo descreve as alterações em Queries, alerta, Permissions e fonte de dados APIs incluídas na versão mais recente do site Databricks SQL API. Use este artigo para ajudá-lo a migrar seus aplicativos e integrações para a nova versão do API.
A API herdada continuará a ser suportada por seis meses. Esse período de transição dá ao senhor tempo para migrar antes que a versão mais antiga seja eliminada.
Alterações na API de consultas
A nova API de consultas inclui uma experiência mais fácil de usar, com nomes mais descritivos, respostas paginadas e listas de respostas classificadas automaticamente por hora de criação. A lista a seguir descreve as alterações na API de consultas:
O caminho da API agora é
api/2.0/sql/queries
, substituindo o caminho legado de/api/2.0/preview/sql/queries
.Inclui uma nova definição de consulta com nomes e tipos de campos mais descritivos.
A atualização endpoint agora é compatível com atualizações parciais, usando
PATCH
em vez dePOST
.A atualização endpoint agora suporta a transferência de propriedade de consultas. Anteriormente, isso só era permitido usando a API de propriedade de objeto de transferência.
As respostas da lista endpoint agora são paginadas usando a paginação baseada em tokens.
A lista endpoint não suporta mais a filtragem por nome ou ordenação personalizada. Em vez disso, todas as consultas acessíveis são retornadas e classificadas em ordem crescente pelo tempo de criação.
A restauração endpoint não é mais suportada. As consultas descartadas podem continuar a ser restauradas por meio da interface do usuário do Databricks.
Para obter a documentação completa sobre a API de consultas atualizada, consulte Consultas.
Alterações no alerta API
O novo alerta API inclui uma experiência mais amigável com nomes e tipos de campos mais descritivos, respostas paginadas para o endpoint da lista e suporte para atualizações parciais. A lista a seguir descreve as alterações no alerta API:
O caminho da API agora é
api/2.0/sql/alerts
, substituindo o caminho legado de/api/2.0/preview/sql/alerts
.Inclui uma nova definição de alerta com nomes e tipos de campos mais descritivos.
A atualização endpoint agora é compatível com atualizações parciais, usando
PATCH
em vez dePOST
.A atualização endpoint agora suporta a transferência de propriedade de consultas. Anteriormente, isso só era permitido usando a API de propriedade de objeto de transferência.
As respostas da lista endpoint agora são paginadas usando a paginação baseada em tokens.
A exclusão endpoint agora move o alerta para a lixeira em vez de excluí-lo permanentemente. Os alertas descartados serão limpos automaticamente após 30 dias. Os alertas descartados podem ser restaurados em até 30 dias após a exclusão por meio da UI Databricks.
Para obter a documentação completa sobre o alerta atualizado API, consulte alerta.
Alterações na API de permissões
A API Permissions não é mais compatível com Get object ACL e Set object ACL. Use a API do Workspace para gerenciar as permissões para essas ações.
fonte de dados API marcado como legado
A fonte de dados API agora está marcada como legado. Atualmente, sua funcionalidade se limita a obter uma lista do armazém SQL. Como o novo Queries API suporta a passagem e o retorno de IDs SQL warehouse em vez de IDs de fontes de dados, não é mais necessária uma chamada API separada para converter entre fonte de dados e depósito SQL.