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 Queries inclui uma experiência mais amigável para o utilizador, com nomes mais descritivos, respostas paginadas e respostas de lista ordenadas automaticamente por tempo de criação. A lista seguinte descreve as alterações à API Queries:

• 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 endpoint de atualização agora suporta atualizações parciais usando PATCH em vez de POST.
• O endpoint de atualização agora suporta a transferência da propriedade das consultas. Anteriormente, isso só era permitido usando a API de propriedade do objeto de transferência.
• As respostas dos endpoints da lista são agora paginadas usando um sistema de paginação baseado em tokens.
• O endpoint da lista já não suporta filtragem por nome ou ordenação personalizada. Em vez disso, todas as consultas acessíveis são retornadas e classificadas em ordem crescente por seu tempo de criação.
• O endpoint de restauro já não é 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 para o utilizador, com nomes e tipos de campos mais descritivos, respostas paginadas aos endpoints das listas e suporte para atualizações parciais. A lista seguinte descreve as alterações à 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 endpoint de atualização agora suporta atualizações parciais usando PATCH em vez de POST.
• O endpoint de atualização agora suporta a transferência da propriedade das consultas. Anteriormente, isso só era permitido usando a API de propriedade do objeto de transferência.
• As respostas dos endpoints da lista são agora paginadas usando um sistema de paginação baseado em tokens.
• 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.

API de permissões marcadas como legado

A API de Permissões está agora marcada como legado. Use a API do Workspace para gerir permissões de objetos. Use as APIs de atualização de consultas e alertas para transferir a propriedade dos objetos.

API de fontes de dados marcada como herdada

A API de Fontes de Dados agora está marcada como legada. Atualmente, a sua funcionalidade limita-se 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.