> For the complete documentation index, see [llms.txt](https://docs.workflowgen.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.workflowgen.com/upgrade-fr/10.6.0/mise-a-jour-workflowgen/migration-dune-base-de-donnees-sql-server-workflowgen-v8-ou-v9-vers-v10.md).

# Migration d’une base de données SQL Server WorkflowGen v8 ou v9 vers v10

## Quand utiliser cette procédure

Utilisez cette procédure pour mettre à jour une base de données WorkflowGen existante de version 8 ou 9 supportée vers la version 10 à l’aide de l’outil de migration assistée SQL Server.

Le script `migrate-v8-v9-to-v10.ps1` du pack WorkflowGen cible sélectionne les migrations manquantes, les applique dans l’ordre et valide le schéma obtenu. Il n’est pas nécessaire d’avoir accès à Git, de disposer des fichiers SQL individuels des versions 8 ou 9, ni d’installer séparément la version 9 pour l’exécuter.

## Compatibilité des versions sources et exigences de migration

### Versions sources supportées et validation

Le manifeste fourni répertorie les versions sources validées **8.0.0 à 8.6.0** et **9.0.0 à 9.7.0**. Utilisez la version de l’application WorkflowGen installée, y compris son numéro de correctif; le schéma de la base de données ne permet pas à lui seul d’identifier toutes les versions correctives. L’outil de migration vérifie que le schéma correspond à la version déclarée. N’indiquez pas une autre version pour contourner un refus.

Une version ultérieure de v8 ou v9 n’est pas rejetée uniquement parce qu’elle dépasse les plages indiquées. L’outil de migration affiche un avertissement et demande un consentement explicite pour l’évaluer par rapport au dernier profil de schéma connu de la même version majeure. Il vérifie ensuite le schéma source et les inscriptions des applications, ainsi que la compatibilité des colonnes, des contraintes et des déclencheurs, avant de créer un journal de migration ou de modifier les données. Tout échec d’une vérification interrompt la migration; une confirmation ne permet pas de contourner cet échec. Les autres versions majeures ne sont pas admissibles à cette procédure.

Pour une exécution sans intervention, le paramètre `-AllowUnvalidatedSourceVersion` fournit ce consentement. Utilisez-le pour l’aperçu et l’exécution de la migration (ainsi que pour la reprise, au besoin), en indiquant la version **réellement** installée. Le paramètre `-Confirm:$false` seul ne constitue pas un consentement pour une version source non validée. L’aperçu indique `SourceValidation` et `SchemaProfileVersion` afin de distinguer une version validée d’une version ultérieure évaluée par rapport à un profil connu. Conservez la même version source et le même pack lors de la reprise.

### Vérifications de compatibilité et précautions

Ces vérifications établissent la compatibilité avec les exigences de migration définies dans le pack, mais ne garantissent pas le support de toutes les modifications futures possibles de l’application ou des données. Testez d’abord la procédure sur une sauvegarde restaurée. Les personnalisations de schéma non reconnues peuvent nécessiter un pack mis à jour ou une investigation; ne supprimez pas les contraintes pour forcer leur acceptation.

#### Version cible et portée de la migration

Le pack actuel et la version cible de la migration sont **10.5.0**. La dernière mise à jour du schéma SQL reste la version **10.4.0** : la version 10.5.0 n’introduit aucune mise à jour supplémentaire de la base de données. Un pack ultérieur peut définir une version cible ou une plage de versions sources différente. Utilisez toujours les fichiers du pack correspondant et vérifiez la version cible indiquée dans l’aperçu.

Cet outil ne met pas à jour les fichiers de l’application, la configuration, les formulaires ou les services; ne déplace pas la base de données vers un autre serveur; n’installe pas les composants SQL Server; et n’indexe pas les demandes existantes. Les nouvelles installations utilisent les scripts de création. Les installations existantes de la version 10 utilisent plutôt les scripts habituels de mise à jour incrémentielle de la version 10.

### Avant de commencer

{% hint style="warning" %}

#### **Important : Le composant Recherche en texte intégral de SQL Server est requis**

Avant d’exécuter la migration, vérifiez que le composant Recherche en texte intégral de SQL Server est installé et activé sur le serveur cible. La migration ne peut pas se poursuivre sans ce composant et le script PowerShell s’arrêtera avec une erreur s’il n’est pas disponible.
{% endhint %}

* Testez la procédure sur une sauvegarde restaurée contenant des données et des personnalisations représentatives avant de mettre à jour l’environnement de production.
* Utilisez SQL Server 2016 ou une version ultérieure avec le composant Recherche en texte intégral installé. Si vous devez migrer vers une version plus récente du moteur, effectuez d’abord cette migration. Le support natif des vecteurs n’est pas nécessaire au fonctionnement de la recherche en texte intégral.
* Utilisez Windows PowerShell 5.1 ou PowerShell 7 sous Windows, avec un accès à la base de données cible. Les exemples utilisent l’authentification intégrée de Windows.
* Pour l’aperçu, l’utilisateur de la base de données doit disposer des autorisations nécessaires pour consulter les métadonnées et lire les tables examinées lors de la validation, y compris les inscriptions des applications. Son schéma par défaut doit être `dbo`. L’exécution de la migration nécessite l’appartenance au rôle `db_owner`; la base de données cible doit être une base de données utilisateur accessible en écriture.
* Conservez les fichiers suivants provenant du **même pack** ensemble, sans les modifier :

  ```
  migrate-v8-v9-to-v10.ps1
  legacy-migration-manifest.json
  migrations/
    legacy-migration-bundle.json
    validate-migration-schema.sql
    validate-newer-source.sql
  ```

## Procédure de migration

#### **Étape 1 : Prévisualiser la migration**

Ouvrez PowerShell dans le dossier `Databases\MsSQLServer` du pack. Remplacez le serveur, la base de données et la version source de cet exemple par vos propres valeurs :

```powershell
$connectionString = 'Server=SQL_SERVER;Database=WFGEN;Integrated Security=True'
$sourceVersion = '9.7.0'
$plan = .\migrate-v8-v9-to-v10.ps1 -ConnectionString $connectionString -SourceVersion $sourceVersion
$plan | Select-Object Status, Server, Database, SourceVersion, SchemaProfileVersion, SourceValidation, TargetVersion
$plan.Steps | Format-Table Id, File, Status
```

Sans le paramètre `-Apply`, l’outil de migration se connecte et vérifie les prérequis, mais n’apporte aucune modification persistante à la base de données. Une nouvelle migration retourne `Status = Planned`. Vérifiez le serveur, la base de données, la version source, la version cible et les étapes sélectionnées avant de poursuivre. Toute erreur lors de la prévisualisation doit être résolue avant d’exécuter la migration.

Vous pouvez également consulter l’aide intégrée de PowerShell :

```powershell
Get-Help .\migrate-v8-v9-to-v10.ps1 -Full
```

#### **Étape 2 : Sauvegarder et appliquer la migration**

Planifiez une fenêtre de maintenance. Arrêtez les pools d’applications et les services WorkflowGen sur tous les nœuds d’application qui utilisent cette base de données, ainsi que tout autre processus qui y effectue des écritures. Effectuez des sauvegardes correspondantes de la base de données et de l’application, puis vérifiez votre procédure de restauration avant de poursuivre. Maintenez les services arrêtés jusqu’à ce que les mises à jour de la base de données et de l’application soient terminées.

En utilisant la même connexion et la même version source, appliquez la migration :

```powershell
$result = .\migrate-v8-v9-to-v10.ps1 -ConnectionString $connectionString -SourceVersion $sourceVersion -Apply
$result | Select-Object Status, Server, Database, SourceVersion, TargetVersion
$result.Steps | Format-Table Id, File, Status
```

Une exécution réussie retourne `Status = Completed` après la validation de la version cible. Ne réexécutez pas manuellement les fichiers SQL inclus dans l’ensemble de scripts par la suite. Une nouvelle exécution avec le même pack et la version source d’origine valide la version cible déjà mise à jour et retourne `AlreadyCompleted`.

L’outil de migration conserve les données des processus clients et les inscriptions personnalisées supportées. Les mises à jour historiques peuvent modifier intentionnellement les descriptions des applications intégrées, les noms de classes ainsi que les indicateurs définis par défaut ou obligatoires. Vérifiez les personnalisations lors des essais de migration; un schéma incompatible ou partiellement mis à jour peut être rejeté.

#### **Étape 3 : Terminer la mise à jour de l’application et effectuer les vérifications**

Déployez les fichiers de l’application v10 correspondants, puis mettez à jour la configuration et les personnalisations conformément à votre procédure de mise à jour de l’application. Ne redémarrez les pools d’applications et les services qu’une fois ces opérations terminées.

Vérifiez l’authentification, les demandes existantes, l’exécution des processus et les fonctions de recherche utilisées par vos utilisateurs. Activez l’indexation des segments pour les données dans lesquelles vous souhaitez effectuer des recherches et appliquez ces paramètres aux demandes existantes, au besoin. Attendez que le service du moteur et l’indexation en texte intégral aient terminé leurs opérations avant de vérifier les résultats de recherche.

Sur une base de données sans support natif des vecteurs, la recherche en texte intégral ne nécessite aucune clé API pour les modèles d’incorporation. Sur une base de données avec support natif des vecteurs, la recherche sémantique nécessite également un fournisseur de modèles d’incorporation configuré. Si le moteur de base de données a été mis à jour, mais qu’une colonne de compatibilité existante demeure, suivez les [instructions distinctes d’activation de la recherche vectorielle](https://docs.workflowgen.com/upgrade-fr/10.6.0/procedures-facultatives.md#activer-le-stockage-vectoriel-apres-la-mise-a-jour-du-moteur-de-base-de-donnees).

## En cas d’échec ou d’interruption de l’exécution

Laissez l’application arrêtée. Notez l’étape et l’erreur signalées, conservez le pack d’origine et résolvez la cause du problème avec votre administrateur de base de données ou le support. La migration complète ne constitue **pas une transaction unique** : les étapes précédentes exécutées avec succès restent validées. Les fichiers de migration ordinaires et les enregistrements correspondants du journal de migration sont transactionnels; les opérations de recherche en texte intégral disposent de vérifications de récupération distinctes.

Lorsqu’un journal de migration interrompue existe, reprenez la migration en utilisant **exactement le même pack et la version source d’origine** :

```powershell
.\migrate-v8-v9-to-v10.ps1 -ConnectionString $connectionString -SourceVersion $sourceVersion -Apply -Resume
```

Si l’échec s’est produit avant la création d’un journal de migration, corrigez le problème, puis exécutez de nouveau la prévisualisation et la migration avec `-Apply`, sans `-Resume`. Les empreintes de hachage du pack empêchent la reprise avec des fichiers SQL ou du code modifiés. Ne modifiez jamais le journal de migration ni l’ensemble de scripts pour ignorer une étape ayant échoué.

<table data-header-hidden><thead><tr><th valign="top">Refus ou erreur</th><th valign="top">Action à effectuer</th></tr></thead><tbody><tr><td valign="top">Version source non supportée ou incompatibilité du schéma</td><td valign="top">Vérifiez la version installée, le pack et le schéma restauré; ne devinez pas la version.</td></tr><tr><td valign="top">Recherche en texte intégral non disponible</td><td valign="top">Installez ou activez le composant serveur requis avant de réessayer.</td></tr><tr><td valign="top">Autorisations ou schéma par défaut</td><td valign="top">Demandez à l’administrateur d’accorder les autorisations requises et de définir <code>dbo</code> comme schéma par défaut.</td></tr><tr><td valign="top">Inscriptions d’applications ou de paramètres en double</td><td valign="top">Examinez les enregistrements conflictuels avec l’administrateur; ne supprimez pas les données clients sans vérification.</td></tr><tr><td valign="top">Conflit de paramètres d’application ou incompatibilité avec la version source attendue</td><td valign="top">Vérifiez la version déclarée et comparez l’inscription de l’application concernée à l’inscription standard de cette version. Résolvez les conflits liés aux personnalisations intentionnelles avec le support avant de relancer la prévisualisation.</td></tr><tr><td valign="top">Une autre migration est en cours</td><td valign="top">Attendez la fin de la migration en cours et examinez son résultat avant de réessayer.</td></tr><tr><td valign="top">Incompatibilité du pack ou du journal de migration</td><td valign="top">Récupérez le pack d’origine et la version source d’origine; ne modifiez ni les sommes de contrôle ni les enregistrements du journal.</td></tr><tr><td valign="top">Délai d’exécution de la commande dépassé</td><td valign="top">Examinez la charge du serveur ou les blocages; utilisez <code>-CommandTimeout</code> (en secondes) si un délai d’exécution plus long est nécessaire.</td></tr></tbody></table>

Il n’existe aucune procédure de retour automatique à une version antérieure. Pour abandonner une mise à jour partiellement effectuée, restaurez les sauvegardes correspondantes de la base de données et de l’application avant de redémarrer la version précédente de l’application.

## Conflits de paramètres des applications intégrées

WorkflowGen fournit et contrôle les paramètres des applications intégrées telles que OPENAICHAT. Une inscription modifiée peut occuper un numéro requis par un paramètre standard sans contenir le nom attendu de ce paramètre. L’outil de migration rejette cette situation lors des vérifications préalables de la source, avant de créer un journal de migration ou d’appliquer les mises à jour SQL. La prévisualisation et l’exécution avec `-Apply` effectuent toutes deux cette vérification.

Ce refus concerne une version source modifiée et ne signifie pas qu’une correction est nécessaire pour les installations normales. Ne supprimez pas les paramètres et ne modifiez pas leur numérotation sans vérification. Comparez l’inscription de l’application concernée à celle de la version officielle correspondante, vérifiez les associations dépendantes avec le support et testez toute correction convenue sur une copie restaurée avant de réessayer.

L’exécution manuelle des scripts SQL individuels contourne les vérifications préalables de l’outil de migration. Dans ce cas, un conflit de numéros peut provoquer une erreur de clé primaire après la validation des lots précédents. Arrêtez la procédure et évaluez l’état partiellement mis à jour. Ni la réexécution du fichier entier ni l’utilisation du paramètre `-Resume` de l’outil de migration sans son journal ne permettent de corriger cet état.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.workflowgen.com/upgrade-fr/10.6.0/mise-a-jour-workflowgen/migration-dune-base-de-donnees-sql-server-workflowgen-v8-ou-v9-vers-v10.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
