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 de POST.

  • 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 de POST.

  • 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 de permissões não oferece mais suporte a 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.