Programmez la mise à jour automatique des données dans le module complémentaire Azure Databricks Excel

L’actualisation planifiée permet de maintenir à jour les données importées dans un classeur Excel en exécutant automatiquement l’importation selon une planification définie. Vous pouvez créer une planification pour une requête enregistrée, une table ou une importation de table croisée dynamique, choisir le warehouse SQL qui exécute chaque rafraîchissement et consulter les exécutions récentes depuis le complément Azure Databricks pour Excel.

Pour savoir comment le rafraîchissement programmé se connecte à Microsoft 365 et quelles fonctionnalités de sécurité réseau s’appliquent, consultez Architecture et sécurité du complément Excel Azure Databricks.

Prerequisites

Avant de créer une actualisation planifiée, assurez-vous que :

• Le classeur est enregistré dans Microsoft OneDrive ou SharePoint.
• La requête, la table ou le tableau croisé dynamique est déjà importé et apparaît dans Importations enregistrées. Voir Importer et interroger des données à l’aide du module complémentaire Excel Azure Databricks.
• Vous avez la permission d’utiliser le SQL warehouse qui exécute l’actualisation.
• Votre compte Microsoft est connecté au complément Excel Azure Databricks. Voir Configurer le complément Azure Databricks Excel.

Les actualisations planifiées s’exécutent avec l’identité Azure Databricks et les informations d’identification Microsoft de la personne qui crée la planification. Gardez ces identifiants actifs afin qu’Azure Databricks puisse interroger les données et mettre à jour le classeur.

Autorisations Microsoft

Votre fichier de complément Excel doit inclure le domaine suivant dans la section AppDomains. Si vous avez installé le complément Excel avant la sortie de l’actualisation planifiée, ajoutez le domaine à votre fichier du complément ou téléchargez de nouveau le fichier. Voir Configurer le complément Azure Databricks Excel.

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

L’extension demande les permissions Microsoft suivantes, auxquelles vous devez consentir pour un rafraîchissement programmé afin d’accéder et de mettre à jour le classeur :

• Files.ReadWrite: Lisez et mettez à jour votre classeur.
• offline_access : maintenir les actualisations planifiées même lorsque vous n’êtes pas connecté.

Créer une planification

Créez une actualisation planifiée pour toute requête, table ou importation de tableau croisé dynamique enregistrée depuis le complément Excel Azure Databricks.

1. Ouvrez le complément Excel Azure Databricks.
2. Accédez à Importations enregistrées.
3. Trouvez l’import que vous souhaitez rafraîchir automatiquement.
4. Sélectionnez le bouton du calendrier à côté de l’importation.
5. Vérifiez les détails de la ressource pour confirmer que vous avez sélectionné la bonne requête, le bon tableau ou le bon tableau croisé dynamique.
6. Dans l’onglet Gérer le planning , saisissez un nom descriptif du planning.
7. Choisissez un type de planning. Voir Intervalle et Programme :
   • Intervalle : actualiser toutes les minutes, heures, jours ou semaines spécifiés.
   • Planification : Choisissez un rythme et une heure basés sur le calendrier, comme chaque jour à un moment précis ou chaque semaine à un jour précis.
8. Si vous avez sélectionné Planifier, confirmez le fuseau horaire. Le fuseau horaire initial est basé sur les paramètres locaux de votre navigateur.
9. Dans SQL Warehouse, sélectionnez l’entrepôt SQL qui exécute la requête.
10. Sélectionnez Créer un planning.

Après la création de la planification, le bouton du calendrier de l’importation enregistrée se transforme en une icône de calendrier avec une horloge.

Intervalle

Utilisez Interval lorsque le rafraîchissement devrait se répéter après une période régulière. Saisissez un nombre et sélectionnez minutes, heures, jours ou semaines.

Les plages d’intervalles disponibles sont :

• 1 à 120 minutes
• 1 à 72 heures
• 1 à 31 jours
• 1 à 8 semaines

Pour une mise à jour qui doit se dérouler à un jour et à une heure précis, utilisez Schedule plutôt qu’un intervalle hebdomadaire.

Planifier

Utilisez Planification lorsque l’actualisation doit s’exécuter à une date et une heure précises. Selon la cadence, vous pouvez sélectionner :

• La fréquence, telle que minute, heure, jour, semaine ou mois
• Heure de la journée
• Le jour de la semaine pour les horaires hebdomadaires
• Le jour du mois pour les horaires mensuels
• Le fuseau horaire

Les horaires sont évalués dans le fuseau horaire sélectionné. Les horodatages de l’historique de la série sont affichés en utilisant la localisation du spectateur.

Mettre à jour un planning existant

Changez le nom, la cadence, le fuseau horaire ou l’entrepôt SQL d’un planning que vous avez déjà créé.

1. Depuis les importations sauvegardées, sélectionnez le bouton calendrier avec horloge pour l’importation.
2. Dans l’onglet Gérer le planning , changez le nom du planning, la cadence, le fuseau horaire ou l’entrepôt SQL.
3. Sélectionnez Modifier le planning.

La mise à jour de l’importation sauvegardée sous-jacente synchronise également sa requête, ses paramètres, ses filtres et sa limite de lignes avec le rafraîchissement programmé. La prochaine exécution utilise la définition d’importation mise à jour.

Examiner l’historique des exécutions

Vérifiez le résultat des récentes actualisations pour une importation programmée, y compris le statut, la durée et les détails de défaillance de chaque exécution.

1. Ouvre le planning de l’importation sauvegardée.
2. Cliquez sur l’onglet Historique des exécutions.
3. Consultez les dernières exécutions. Chaque entrée indique son temps d’achèvement, son statut et sa durée.
4. Développez une exécution pour voir plus de détails, y compris un message d’erreur en cas d’échec du rafraîchissement.

Les statuts des runs incluent :

• OK : le rafraîchissement s’est terminé avec succès.
• En cours : le rafraîchissement est toujours en cours.
• Échec : le rafraîchissement n’a pas abouti. Élargissez la série pour voir les détails disponibles sur les défaillances.

Si le planning n’a pas encore été exécuté, l’onglet affiche Aucun historique des exécutions pour le moment.

Supprimer une importation programmée

Le rafraîchissement programmé ne propose pas d’option séparée pour mettre un planning en pause ou supprimer uniquement le planning.

Pour arrêter la planification depuis le module complémentaire Excel, supprimez l’importation enregistrée :

1. Dans Importations sauvegardées, ouvre le menu d’actions pour l’importation.
2. Sélectionnez Supprimer.

Supprimer l’importation enregistrée supprime également le travail de rafraîchissement programmé associé et supprime la configuration d’importation sauvegardée du classeur.

Troubleshooting

Si un rafraîchissement programmé ne s’exécute pas ou si le classeur ne se met pas à jour, utilisez les sections suivantes pour identifier et résoudre les causes les plus courantes.

Vos identifiants Microsoft ont expiré

Le rafraîchissement programmé nécessite l’accès au classeur via votre compte compte Microsoft. Si le complément affiche le message suivant, vos identifiants ont expiré :

Vos informations d’identification Microsoft ont expiré. Connectez-vous pour maintenir les rafraîchissements programmés en cours.

Sélectionnez connexion Microsoft et terminez le flux de connexion. Une planification peut toujours apparaître comme configurée même si les identifiants ont expiré, mais les actualisations ne peuvent pas mettre à jour le classeur tant que l’accès n’est pas rétabli.

Un rafraîchissement programmé échoue

Si une exécution montre un statut Échec, effectuez les vérifications suivantes pour en identifier la cause :

1. Ouvrez le calendrier et sélectionnez Historique des exécutions.
2. Développez l’exécution ayant échoué et vérifiez son message d’erreur.
3. Confirmez que votre compte Microsoft est toujours connecté.
4. Confirmez que le classeur existe toujours dans OneDrive ou SharePoint et que votre compte peut le modifier.
5. Confirmez que l’entrepôt SQL sélectionné est disponible et que vous pouvez lancer la requête source.
6. Confirmez que vous avez toujours accès à la table source et aux autres données référencées.
7. Si l’importation utilise des références de cellules Excel pour les paramètres ou filtres, confirmez que la feuille de calcul référencée et les cellules existent toujours.

Le cahier d’exercices n’est pas mis à jour

Si les exécutions se terminent avec succès mais que les données du classeur ne sont pas à jour, confirmez que le classeur se trouve toujours à l’emplacement attendu et qu’il est accessible :

1. Ouvrez le classeur depuis son emplacement OneDrive ou SharePoint.
2. Confirmez que le classeur n’a pas été déplacé, renommé ou remplacé depuis la dernière mise à jour du planning.
3. Reconnectez votre compte Microsoft si vous y êtes invité.
4. Consultez l’historique des exécutions pour connaître les derniers statuts et détails sur les erreurs.