Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
En esta página se describen los cambios realizados en las API Consultas, Alertas, Permisos, Orígenes de datos y Visualizaciones incluidas en la versión más reciente de la API de SQL de Databricks. La API heredada está en desuso y el soporte técnico finalizará pronto. Use esta página para migrar las aplicaciones e integraciones a la nueva versión de API.
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
PATCHen lugar dePOST. - El endpoint 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 utilizando 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
PATCHen lugar dePOST. - El endpoint 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 extremo de lista ahora se paginan utilizando la paginación basada en tokens.
- El endpoint 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 eliminadas se pueden restaurar en un plazo de 30 días de haberse eliminado a través de la interfaz de usuario de Azure Databricks.
Para obtener documentación completa sobre la API de alertas actualizada, consulte Alertas.
API de permisos obsoleta
La API permissions ahora está marcada como en desuso. Utilice la API de Workspace para administrar los permisos de objeto. Use las consultas y las API de actualización de alertas para transferir la propiedad del objeto.
API de fuentes de datos obsoleto
La API de orígenes de datos ahora está marcada como en desuso. Actualmente, su funcionalidad se limita a obtener una lista de almacenes de SQL. Debido a que la nueva API de consultas admite pasar y devolver ID de almacenes de datos SQL en lugar de ID de orígenes de datos, ya no se requiere una llamada API independiente para convertir entre orígenes de datos y almacenes de datos SQL.
Actualización de versiones del SDK
Si accede a la API de SQL heredada de Databricks a través de los SDK de Databricks, actualice a la versión más reciente del SDK y migre a las nuevas API. Consulte la documentación del SDK de Databricks.
Migración de comandos de la CLI
Si accede a la API SQL heredada de Databricks a través de la CLI de Databricks, migre de estos grupos de comandos obsoletos:
| Deprecated | Utilice en su lugar |
|---|---|
| consultas heredadas | queries |
| alerts-legacy | alerts |
| orígenes de datos | Sin reemplazo |
Migración de recursos de Terraform
Si usa Terraform para administrar los recursos de SQL de Databricks, migre a las nuevas definiciones de recursos:
| Recurso en desuso | Usar en su lugar | Guía de migración |
|---|---|---|
| databricks_sql_query | databricks_query | Guía de migración |
| databricks_sql_alert | databricks_alert | Guía de migración |
| databricks_sql_visualization | databricks_dashboard | Sin guía de migración |
Para databricks_sql_endpoint y databricks_sql_warehouse:
Actualizar el proveedor de Terraform de Databricks a la versión v1.105.0 o posterior. El data_source_id campo está en desuso. Actualice para evitar errores cuando la API de orígenes de datos en desuso está desactivada.