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 última versão da API de SQL do Databricks. Use este artigo para ajudar você na migração de seus aplicativos e integrações para a nova versão da API.

A API herdada continuará com suporte por seis meses. Esse período de transição oferece tempo para migrar antes que a versão mais antiga seja eliminada gradualmente.

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 classificadas automaticamente pelo 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 de /api/2.0/preview/sql/queries.
• Inclui uma nova definição de consulta com tipos e nomes de campo mais descritivos.
• O endpoint de atualização agora dá suporte a atualizações parciais usando PATCH em vez de POST.
• Agora, o ponto de extremidade de atualização dá suporte à transferência da propriedade de consultas. Anteriormente, isso só era permitido usando a API transferir propriedade de objeto.
• Agora, as respostas do ponto de extremidade da lista são paginadas usando a paginação baseada em token.
• O endpoint de lista não suporta mais filtragem por nome ou ordenação personalizada. Em vez disso, todas as consultas acessíveis são retornadas e classificadas em ordem crescente de acordo com a hora de criação.
• Não há mais suporte para o ponto de extremidade de restauração. As consultas descartadas podem continuar a ser restauradas pela 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 campo mais descritivos, suporte para atualizações parciais e respostas paginadas para endpoints de listas. 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 de /api/2.0/preview/sql/alerts.
• Inclui uma nova definição de alerta com tipos e nomes de campo mais descritivos usados.
• O endpoint de atualização agora suporta atualizações parciais usando PATCH em vez de POST.
• Agora, o ponto de extremidade de atualização dá suporte à transferência da propriedade de consultas. Anteriormente, isso só era permitido usando a API transferir propriedade de objeto.
• Agora, as respostas do ponto de extremidade da lista são paginadas usando a paginação baseada em token.
• Agora, o ponto de extremidade de exclusão 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 dentro de 30 dias da 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 dá mais suporte à ACL do objeto Get e à ACL do objeto Set. Use a API do workspace para gerenciar permissões para essas ações.

API das Fontes de Dados marcada como herdada

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