Compartir a través de

Actualizar a la versión más reciente de la API de SQL de Databricks

  • Artículo

En este artículo se describen los cambios en las API de consultas, alertas, permisos y orígenes de datos incluidas en la última versión de la API de SQL de Databricks. Use este artículo para ayudarle a migrar las aplicaciones e integraciones a la nueva versión de API.

La API heredada seguirá siendo compatible durante seis meses. Este período de transición le da tiempo para migrar antes de que se elimine la versión anterior.

Cambios en la API de consultas

La nueva API de consultas incluye una experiencia más fácil de usar con nombres más descriptivos, respuestas paginadas y respuestas de lista ordenadas automáticamente por tiempo de creación. En la lista siguiente se describen los cambios realizados en la API de consultas:

  • La ruta de acceso de API ahora está api/2.0/sql/queries, reemplazando la ruta de acceso heredada de /api/2.0/preview/sql/queries.
  • Incluye una nueva definición de consulta con tipos y nombres de campo más descriptivos.
  • El punto de conexión de actualización ahora admite actualizaciones parciales mediante PATCH en lugar de POST.
  • El punto de conexión de actualización ahora admite la transferencia de la propiedad de las consultas. Anteriormente, esto solo se permitía mediante la [API de propiedad del objeto de transferencia](/API/workspace/dbsqlpermissions/transfer ownership).
  • Las respuestas del punto de conexión de lista ahora se paginan mediante la paginación basada en tokens.
  • El punto de conexión de lista ya no admite el filtrado por nombre o por ordenación personalizada. En su lugar, todas las consultas accesibles se devuelven y ordenan en orden ascendente por su hora de creación.
  • Ya no se admite el punto de conexión de restauración. Las consultas en la papelera pueden seguir restaurándose a través de la interfaz de usuario de Azure Databricks.

Para obtener documentación completa sobre la API de consultas actualizada, consulte Consultas.

Cambios en la API de alertas

La nueva API de alertas incluye una experiencia más fácil de usar con tipos y nombres de campo más descriptivos, respuestas paginadas a puntos de conexión de lista y compatibilidad con actualizaciones parciales. La siguiente lista describe los cambios en la API de alertas:

  • La ruta de acceso de API ahora está api/2.0/sql/alerts, reemplazando la ruta de acceso heredada de /api/2.0/preview/sql/alerts.
  • Incluye una nueva definición de alerta con nombres de campo y tipos más descriptivos.
  • El punto de conexión de actualización ahora admite actualizaciones parciales mediante PATCH en lugar de POST.
  • El punto de conexión de actualización ahora admite la transferencia de la propiedad de las consultas. Anteriormente, esto solo se permitía mediante la API de propiedad de objeto de transferencia.
  • Las respuestas del punto de conexión de lista ahora se paginan mediante la paginación basada en tokens.
  • El punto de conexión de eliminación ahora mueve la alerta a la papelera en lugar de eliminarla de forma permanente. Las alertas en la papelera se limpiarán automáticamente después de 30 días. Las alertas papeleras se pueden restaurar en un plazo de 30 días a partir de la eliminación a través de la interfaz de usuario de Azure Databricks.

Para obtener documentación completa sobre la API de alertas actualizada, consulte Alertas.

Cambios en la API de permisos

La API de permisos ya no admite Obtener ACL de objeto y Establecer ACL de objeto. Utilice la API de áreas de trabajo para administrar los permisos de estas acciones.

API de orígenes de datos marcada como heredada

La API de orígenes de datos ahora está marcada como heredada. Actualmente, su funcionalidad se limita a obtener una lista de almacenes de SQL. Debido a que la nueva API de consultas admite el paso y la devolución de ID de almacén de SQL en lugar de ID de orígenes de datos, ya no se requiere una llamada API independiente para convertir entre fuentes de datos y almacenes de SQL.