Atualize para a versão mais recente da API SQL do Databricks

Este artigo descreve as alterações nas APIs de consultas, alertas, permissões e fontes de dados incluídas na versão mais recente da API SQL do Databricks. Use este artigo para ajudá-lo a migrar seus aplicativos e integrações para a nova versão da API.

A API herdada continuará a ser suportada por seis meses. Este período de transição dá-lhe tempo para migrar antes de a versão mais antiga ser eliminada.

Alterações na API de consultas

A nova API de Consultas inclui uma experiência mais amigável com nomes mais descritivos, respostas paginadas e respostas de lista ordenadas automaticamente por tempo 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 herdado do /api/2.0/preview/sql/queries.
• Inclui uma nova definição de consulta com nomes e tipos de campo mais descritivos.
• O ponto de extremidade de atualização agora oferece suporte a atualizações parciais usando PATCH em vez de POST.
• O ponto de extremidade de atualização agora suporta a transferência de propriedade de consultas. Anteriormente, isso só era permitido usando a API de propriedade do objeto de transferência.
• As respostas do ponto de extremidade da lista agora são paginadas usando paginação baseada em token.
• O ponto de extremidade de lista não suporta mais filtragem por nome ou ordem personalizada. Em vez disso, todas as consultas acessíveis são retornadas e classificadas em ordem crescente por seu tempo de criação.
• O ponto de extremidade de restauração não é mais suportado. As consultas perdidas podem continuar a ser restauradas por meio da interface do usuário do Azure Databricks.

Para obter a documentação completa sobre a API de consultas atualizada, consulte Consultas.

Alterações na API de Alertas

A nova API de Alertas inclui uma experiência mais amigável com nomes e tipos de campos mais descritivos, respostas paginadas a pontos de extremidade de lista e suporte para atualizações parciais. A lista a seguir descreve as alterações na API de alertas:

• O caminho da API agora api/2.0/sql/alertsé , substituindo o caminho herdado do /api/2.0/preview/sql/alerts.
• Inclui uma nova definição de alerta com nomes e tipos de campo mais descritivos é usado.
• O ponto de extremidade de atualização agora oferece suporte a atualizações parciais usando PATCH em vez de POST.
• O ponto de extremidade de atualização agora suporta a transferência de propriedade de consultas. Anteriormente, isso só era permitido usando a API de propriedade do objeto de transferência.
• As respostas do ponto de extremidade da lista agora são paginadas usando paginação baseada em token.
• O ponto de extremidade de exclusão agora move o alerta para a lixeira em vez de excluí-lo permanentemente. Os alertas eliminados serão automaticamente limpos após 30 dias. Os alertas transferidos podem ser restaurados dentro de 30 dias após a exclusão por meio da interface do usuário do Azure Databricks.

Para obter a documentação completa sobre a API de alertas atualizada, consulte Alertas.

Alterações na API de permissões

A API de permissões não suporta mais a ACL do objeto Get e a ACL do objeto set. Use a API de espaço de trabalho para gerenciar permissões para essas ações.

API de fontes de dados marcada como herdada

A API de Fontes de Dados agora está marcada como legada. Atualmente, sua funcionalidade é limitada a obter uma lista de armazéns SQL. Como a nova API de Consultas oferece suporte à passagem e ao retorno de IDs do SQL warehouse em vez de IDs de fonte de dados, uma chamada de API separada para converter entre fontes de dados e SQL warehouses não é mais necessária.