Programar la actualización automática de datos en el complemento Azure Databricks Excel

Importante

Esta característica está en versión preliminar pública.

Note

El complemento de Azure Databricks Excel no está disponible en Azure Government ni en las regiones de Azure China.

La actualización programada mantiene al día los datos importados a un libro de Excel ejecutando la importación automáticamente según una programación. Puede crear una programación para la importación de una consulta, una tabla o una tabla dinámica guardadas, elegir el almacén SQL que ejecuta cada actualización y revisar las ejecuciones recientes desde el complemento de Azure Databricks para Excel.

Prerequisites

Antes de crear una actualización programada, asegúrate de que:

Las actualizaciones programadas se ejecutan con la identidad de Azure Databricks y las credenciales de Microsoft de la persona que crea la programación. Mantén esas credenciales activas para que Azure Databricks pueda consultar los datos y actualizar el libro de trabajo.

Permisos de Microsoft

Tu archivo del complemento de Excel debe incluir el siguiente dominio en la sección AppDomains. Si instalaste el complemento de Excel antes de que se lanzara la función de actualización programada, añade el dominio a tu archivo de complemento o vuelve a descargar el archivo. Consulte Configurar el complemento de Azure Databricks para Excel.

<AppDomain>https://login.microsoftonline.com</AppDomain>

El complemento solicita los siguientes permisos de Microsoft, a los que debes dar tu consentimiento para que la actualización programada pueda acceder al libro de trabajo y actualizarlo:

  • Files.ReadWrite: Leer y actualizar tu libro de trabajo.
  • offline_access: Mantener las actualizaciones programadas en ejecución cuando no hayas iniciado sesión activamente.

Crear una programación.

Crea una actualización programada para cualquier consulta, tabla o importación de tabla dinámica guardada desde el complemento de Excel de Azure Databricks.

  1. Abre el complemento de Excel de Azure Databricks.
  2. Ve a Importaciones guardadas.
  3. Busca la importación que deseas actualizar automáticamente.
  4. Selecciona el botón del calendario situado junto a la importación.
  5. Revisa Detalles del activo para confirmar que has seleccionado la consulta, tabla o tabla dinámica correcta.
  6. En la pestaña Administrar programación, introduzca un Nombre de programación descriptivo.
  7. Elija un Tipo de programación. Consulte Intervalo y Programación:
    • Intervalo: Actualizar cada número especificado de minutos, horas, días o semanas.
    • Programación: elija una periodicidad y una hora basadas en el calendario, como cada día a una hora concreta o cada semana en un día concreto.
  8. Si ha seleccionado Programación, confirme la Zona horaria. La zona horaria inicial se basa en la configuración local de su navegador.
  9. En SQL Warehouse, selecciona el almacén en el que se ejecuta la consulta.
  10. Selecciona Crear programación.

Una vez creada la programación, el botón de calendario de la importación guardada cambia a un icono de calendario con un reloj.

Una importación guardada que muestra el icono de un calendario con reloj, que indica una actualización programada, junto con su ubicación de importación y la hora de la última actualización.

Intervalo

Utiliza Intervalo cuando la actualización deba repetirse tras un periodo regular. Introduce un número y selecciona minutos, horas, días o semanas.

Los rangos de intervalo disponibles son:

  • 1 a 120 minutos
  • 1 a 72 horas
  • De 1 a 31 días
  • 1 a 8 semanas

Para una actualización que deba ejecutarse en un día de la semana y a una hora concretos, utiliza Programación en lugar de un intervalo semanal.

La pestaña Administrar programación con el tipo de programación Intervalo seleccionado, en la que se muestran el campo Cada, el selector de SQL Warehouse y el botón Crear programación.

Programación

Utilice Programación cuando la actualización deba ejecutarse a una hora concreta del calendario. En función de la cadencia, puede seleccionar:

  • La frecuencia, como por ejemplo, minuto, hora, día, semana o mes
  • La hora del día
  • El día de la semana para las programaciones semanales
  • El día del mes para las programaciones mensuales
  • La zona horaria

Las horas se evalúan en la zona horaria seleccionada para la programación. Las marcas de tiempo del historial de ejecuciones se muestran según la configuración regional del usuario.

La pestaña Administrar programación con el tipo de programación Programación seleccionado, en la que se muestran los selectores de cadencia, hora y zona horaria.

Actualizar una programación existente

Cambia el nombre, la cadencia, la zona horaria o el almacén SQL de una programación que ya hayas creado.

  1. En Importaciones guardadas, selecciona el botón del calendario con reloj correspondiente a la importación.
  2. En la pestaña Administrar programación, modifica el nombre de la programación, la cadencia, la zona horaria o el almacén SQL.
  3. Selecciona Actualizar programación.

Actualizar la importación guardada subyacente también sincroniza su consulta, parámetros, filtros y límite de filas con la actualización programada. La siguiente partida utiliza la definición de importación actualizada.

Revisar el historial de ejecuciones

Consulta el resultado de las ejecuciones recientes de actualización de una importación programada, incluidos el estado de cada ejecución, su duración y los detalles de cualquier error.

  1. Abre la programación de la importación guardada.
  2. Selecciona la pestaña Historial de ejecuciones.
  3. Revisa las ejecuciones recientes. Cada entrada muestra su hora de finalización, estado y duración.
  4. Expande una ejecución para ver más detalles, incluido un mensaje de error cuando falla una actualización.

Los estados de las ejecuciones incluyen:

  • OK: La actualización se ha completado correctamente.
  • En ejecución: La actualización sigue en curso.
  • Fallido: La actualización no se ha completado. Expande la ejecución para ver los detalles disponibles del fallo.

Si la programación aún no se ha ejecutado, la pestaña muestra Todavía no hay historial de ejecución.

Eliminar una importación programada

La actualización programada no ofrece una opción independiente para pausar una programación o eliminar solo la programación.

Para detener la programación desde el complemento de Excel, elimina la importación guardada:

  1. En Importaciones guardadas, abre el menú de acciones de la importación.
  2. Seleccione Eliminar.

Eliminar la importación guardada también elimina el trabajo de actualización programado asociado y elimina la configuración de importación guardada del libro de trabajo.

Troubleshooting

Si no se ejecuta una actualización programada o el libro de trabajo no se actualiza, utiliza las siguientes secciones para identificar y resolver las causas más comunes.

Sus credenciales de Microsoft han caducado

La actualización programada requiere acceso al libro de trabajo a través de tu cuenta de Microsoft. Si el complemento muestra el siguiente mensaje, sus credenciales han caducado:

Sus credenciales de Microsoft han caducado. Inicia sesión para que las actualizaciones programadas sigan ejecutándose.

Selecciona Inicio de sesión de Microsoft y completa el proceso de inicio de sesión. Una programación puede seguir apareciendo como configurada aunque las credenciales hayan caducado, pero las ejecuciones de actualización no pueden actualizar el libro hasta que se restablezca el acceso.

Falla una actualización programada

Si una ejecución muestra un estado Fallido, realiza las siguientes comprobaciones para identificar la causa:

  1. Abra la programación y seleccione Historial de ejecuciones.
  2. Amplía la ejecución fallida y revisa su mensaje de error.
  3. Compruebe que su cuenta de Microsoft sigue conectada.
  4. Confirma que el libro sigue estando en OneDrive o SharePoint y que tu cuenta puede editarlo.
  5. Comprueba que el almacén SQL seleccionado esté disponible y que puedas ejecutar la consulta de origen.
  6. Confirma que aún tienes acceso a la tabla fuente y otros datos a los que se hace referencia.
  7. Si la importación utiliza referencias a celdas de Excel como parámetros o filtros, comprueba que la hoja de cálculo y las celdas a las que se hace referencia sigan existiendo.

El libro de trabajo no se actualiza

Si las ejecuciones indican que se han realizado correctamente, pero los datos del libro de trabajo están desactualizados, comprueba que el libro de trabajo siga estando en la ubicación esperada y sea accesible:

  1. Abre el libro de trabajo desde su ubicación en OneDrive o SharePoint.
  2. Comprueba que el libro de trabajo no se haya movido, renombrado ni sustituido desde la última actualización de la programación.
  3. Vuelve a conectar tu cuenta de Microsoft si se te solicita.
  4. Revisa el historial de ejecuciones para conocer el estado más reciente y los detalles de errores.
  • Se actualizó por última vez el