--- locale: "fr" updated_at: "2026-11-12T14:14:55.618Z" canonical: "https://www.isdecisions.com/fr/userlock/docs/guides/base-de-donnees/migrate-userlock-database" --- # Migrer la base de données UserLock Changer de fournisseur, choisir les données à copier, suivre et vérifier la migration. ## Migrations de base de données prises en charge Vous changez la base de données de production depuis la console, dans **Paramètres serveur**** ▸ ****Base de données**. L’assistant de base de données copie les données UserLock de la base actuelle vers SQLite, SQL Server ou MySQL, quel que soit le fournisseur actuel. Vous pouvez par exemple passer de SQLite à SQL Server quand un essai passe en production, ou d’une instance SQL Server à une autre. La base de données stocke les événements UserLock, comme les ouvertures de session et les changements de statut. Les stratégies d’accès, les statuts utilisateur et les paramètres serveur sont stockés par le service UserLock : la migration ne les modifie pas. UserLock continue d’enregistrer les événements dans la base actuelle pendant la copie. À la fin de la copie, il copie aussi les événements enregistrés entre-temps, puis bascule sur la nouvelle base. Aucun événement n’est perdu. Pour déplacer une base SQL Server avec les outils SQL Server, voir [Déplacer les fichiers de la base UserLock vers un autre SQL Server](/userlock/docs/guides/base-de-donnees/migrer-vers-autre-base-donnees-sql-server). Pour les prérequis de la base de données, voir [Architecture de la base de données](/userlock/docs/reference/concepts-fondamentaux/architecture-base-de-donnees). ## Migrer de Microsoft Access vers SQLite Depuis UserLock 13.1, SQLite remplace Microsoft Access comme base de données par défaut. Une base de production Access existante continue de fonctionner, mais vous ne pouvez plus sélectionner Access pour une nouvelle base de production. Quand la base de production utilise Access, la page **Base de données** affiche le message **Recommandé : migrer votre base de données vers SQLite**. Comme Access, SQLite stocke ses données dans un fichier, mais sans limite de taille de 2 Go. SQLite convient aux essais et aux petits déploiements. Pour la production ou de gros volumes de données, migrez plutôt vers SQL Server. ![Propriété serveur - Base de données - Message de migration vers SQLite](https://a.storyblok.com/f/122374/1370x535/e8b8453053/migrer-votre-base-de-donnees-vers-sqlite.png) Pour migrer d’Access vers SQLite : 1. Dans **Paramètres serveur**** ▸ ****Base de données**, sous **Base de données de production**, cliquez sur **Migrer vers SQLite**. L’assistant s’ouvre à l’étape **Migration**, avec SQLite et le fichier de base par défaut déjà sélectionnés : `C:\ProgramData\ISDecisions\UserLock\Database\UserLock.db`. Pour utiliser un autre emplacement, cliquez sur **Retour**. 2. Choisissez les données à migrer, puis cliquez sur **Continuer**. Voir [3. Choisir les données à migrer](#3-choisir-les-donnes-migrer). 3. Vérifiez le récapitulatif, puis cliquez sur **Confirmer et appliquer**. Voir [4. Confirmer et appliquer les modifications](#4-confirmer-et-appliquer-les-modifications). Continuez ensuite à l’étape [5. Suivre ou annuler la migration](#5-suivre-ou-annuler-la-migration). ## 1. Sélectionner le fournisseur de base de données 1. Dans la console, allez dans **Paramètres serveur**** ▸ ****Base de données**. 2. Sous **Base de données de production**, cliquez sur **Changer la base de données de production**. L’assistant s’ouvre à l’étape **Fournisseur**, avec le fournisseur actuel sélectionné. 3. Sélectionnez le fournisseur, puis cliquez sur **Continuer**. SQLite convient aux essais et aux petits déploiements. SQL Server est le choix recommandé pour la production. Sélectionnez MySQL si votre organisation l’utilise déjà, ou **Chaîne de connexion personnalisée** pour une configuration avancée. Aucune modification n’est appliquée avant que vous cliquiez sur **Confirmer et appliquer**, à la dernière étape. Si vous fermez l’assistant ou rechargez la page avant cette étape, les paramètres saisis sont perdus. ## 2. Sélectionner la base de données cible 1. À l’étape **Base de données**, saisissez les informations de connexion du fournisseur sélectionné. Voir le tableau ci-dessous. 2. Pour SQL Server et MySQL, sélectionnez une base existante dans le champ **Base de données**, ou saisissez un nouveau nom. Une base existante est signalée par le badge **Existant**. Si aucune base ne porte ce nom, UserLock la crée après l’étape de confirmation. Pour la créer, le compte utilisé pour la connexion doit avoir le droit de créer des bases de données sur le serveur. 3. Cliquez sur **Continuer**. UserLock teste la connexion. | Fournisseur | Informations de connexion | | --- | --- | | **SQLite** | Saisissez le chemin du fichier de base de données, ou cliquez sur **Parcourir**. Pour créer une nouvelle base, saisissez le chemin d’un fichier qui n’existe pas encore. | | **SQL Server** avec **Authentification Windows** | Saisissez le **Serveur** (nom d’hôte ou adresse IP). UserLock se connecte avec le compte défini dans [Paramètres serveur ▸ Service](/userlock/docs/reference/parametres-serveur/service), et non avec votre compte administrateur. Cochez **Faire confiance aux certificats auto-signés du serveur** si le serveur utilise un certificat auto-signé, ce qui est le cas de la plupart des instances SQL Server auto-hébergées. | | **SQL Server** avec **Authentification SQL Server** | Saisissez le **Serveur** (nom d’hôte ou adresse IP), puis le **Nom d'utilisateur**** **et le **Mot de passe** d’un compte SQL Server. | | **MySQL** | Saisissez le **Nom d'hôte**, le **Port** (3306 par défaut), le **Nom d'utilisateur**** **et le **Mot de passe**. | | **Chaîne de connexion personnalisée** | Sélectionnez le pilote dans la liste, puis saisissez la chaîne de connexion complète. Elle doit inclure le nom de la base et les paramètres d’authentification. | Si vous avez conservé le fournisseur actuel, l’assistant préremplit ses informations de connexion : pour passer à une autre instance SQL Server, modifiez uniquement le champ **Serveur**. ## 3. Choisir les données à migrer À l’étape **Migration**, sélectionnez une option, puis cliquez sur **Continuer**. | Option | Données copiées | Quand l’utiliser | | --- | --- | --- | | **Ne pas migrer les données** | Aucune. UserLock utilise la base sélectionnée telle quelle : vide si elle est nouvelle, avec ses données existantes sinon. | Vous n’avez pas besoin de l’historique des événements, ou la base sélectionnée le contient déjà. | | **Migrer toutes les données** | Tous les événements de la base actuelle | Vous avez besoin de tout l’historique pour les rapports et les audits. | | **Migrer à partir des X derniers jours** | Uniquement les événements des X derniers jours. Saisissez le nombre de jours : l’assistant affiche la date de début correspondante. | La cible a une limite de taille, comme la limite de 10 Go de SQL Server Express, ou les événements plus anciens ne sont plus utiles. | > **⚠️ Important** > > Si la base sélectionnée existe déjà (badge **Existant**), **Migrer toutes les données** et **Migrer à partir des X derniers jours** effacent ses tables UserLock dès le début de la migration. Annuler la migration ne les restaure pas. Pour conserver les données d’une base existante, sélectionnez **Ne pas migrer les données**, ou cliquez sur **Retour** et sélectionnez une nouvelle base. La durée de la migration dépend du volume de données et du réseau entre le serveur UserLock et les serveurs de base de données. Migrer uniquement les X derniers jours la réduit. Les événements non copiés restent dans la base actuelle. Vous pouvez la conserver comme archive et l’ouvrir dans les rapports en tant que base archivée. Voir [Générer des rapports à partir d’une base archivée](/userlock/docs/guides/base-de-donnees/generate-reports-from-an-archived-database). ## 4. Confirmer et appliquer les modifications À l’étape **Confirmation**, vérifiez le fournisseur, la base de données et l’option de migration des données. Pour une nouvelle base, un badge à côté de son nom indique que UserLock va la créer. Sans ce badge, la base existe déjà : si vous migrez des données, ses tables UserLock sont effacées. Voir [3. Choisir les données à migrer](#3-choisir-les-donnes-migrer). Cliquez sur **Confirmer et appliquer**. L’assistant se ferme et la migration démarre. ## 5. Suivre ou annuler la migration Pendant la migration, la page **Base de données** affiche **Migration des données vers la nouvelle base de données...**, avec la base actuelle, la nouvelle base et le nombre d’enregistrements déjà migrés. ![Propriété serveur - Base de données - Migration en cours entre Microsoft Access et SQLite](https://a.storyblok.com/f/122374/1498x738/5fb8b46605/migration-base-de-donnees-en-cours.png) La migration s’exécute sur le serveur UserLock. Vous pouvez fermer la console : quand vous y revenez, la page affiche toujours la migration en cours. Les paramètres de base de données sont verrouillés pour tous les administrateurs jusqu’à la fin de la migration. La page se déverrouille ensuite automatiquement. Pour arrêter la migration, cliquez sur **Annuler la migration**, sous la carte de migration (faites défiler la page si besoin). - La base de production reste la base actuelle. - L’annulation peut prendre du temps : UserLock termine l’étape de copie en cours avant de s’arrêter. - La nouvelle base n’est pas supprimée. Elle contient les enregistrements copiés avant l’annulation, elle est donc incomplète. Supprimez-la manuellement, ou sélectionnez-la à nouveau comme cible d’une nouvelle migration. ## 6. Vérifier la migration et mettre à jour les paramètres associés 1. Dans **Paramètres serveur**** ▸ ****Base de données**, sous **Base de données de production**, vérifiez le **Fournisseur**, le nombre d’**Enregistrements** et la **Plage de données**. 2. Ouvrez un rapport et vérifiez qu’il affiche les sessions récentes. 3. Si un **Accès en lecture seule** est configuré, mettez-le à jour pour qu’il utilise la nouvelle base de production. Voir [Paramètres serveur ▸ Base de données](/userlock/docs/reference/parametres-serveur/base-de-donnees). 4. Configurez les permissions et les sauvegardes de la nouvelle base. Voir [Sauvegarder les configurations et données](/userlock/docs/guides/installation/sauvegarder-configurations-donnees). 5. Conservez l’ancienne base jusqu’à avoir vérifié la nouvelle, puis archivez-la. UserLock ne la modifie pas et ne la supprime pas. La base de données de sauvegarde de UserLock, configurée dans **Paramètres serveur**** ▸ ****Base de données**, est indépendante de la base de production : la migration ne la modifie pas. ## Résoudre les erreurs de migration de base de données | Symptôme | Solution | | --- | --- | | *« La connexion à la base de données n'a pas pu être établie. »* après un clic sur **Continuer** | Cliquez sur **Consultez les détails** pour afficher l’erreur renvoyée par le serveur de base de données. | | L’erreur mentionne un certificat (SQL Server) | Avec **Authentification Windows**, cochez **Faire confiance aux certificats auto-signés du serveur** à l’étape **Base de données**. | | L’erreur mentionne des droits d’accès | Donnez au compte utilisé pour la connexion le droit de créer des bases de données, pour une nouvelle base, ou de lire, écrire et créer des tables, pour une base existante. Avec **Authentification Windows**, ce compte est celui défini dans [Paramètres serveur ▸ Service](/userlock/docs/reference/parametres-serveur/service). | | La carte de migration affiche une erreur | La base de production reste la base actuelle, et la nouvelle base, incomplète, reste en place. Lisez l’erreur, cliquez sur **Ignorer les modifications** pour revenir à la page **Base de données**, puis relancez la migration. | | La migration échoue car la base cible est pleine | Relancez avec **Migrer à partir des X derniers jours**, ou utilisez une cible sans cette limite de taille, par exemple SQL Server au lieu de SQL Server Express. | | Les paramètres de base de données ne peuvent pas être modifiés | Une migration est en cours : la page affiche **Migration des données vers la nouvelle base de données...**. Attendez la fin de la migration, ou cliquez sur **Annuler la migration**. |