Outil de mise à niveau de base de données (SQL Server Compact)

L'outil de mise à niveau de base de données de SQL Server Compact 3.5 est un utilitaire d'invite de commandes qui met à niveau des bases de données SQL Server 2000 Windows CE Edition 2.0 ( SQL Server CE 2.0).

Remarque :

Le format de fichier pour SQL Server Compact 3.5 Service Pack 1 (SP1) est différent de celui des versions antérieures. Pour cette raison, les bases de données créées à l'aide de versions antérieures doivent être mises à niveau vers le nouveau format de fichier. L'ouverture d'un fichier de base de données SQL Server CE à l'aide de SQL Server Compact 3.5 SP1 échoue et une exception System.Data.SqlServerCe.SqlCeException est levée.

Fonctionnement de l'outil de mise à niveau de base de données

Lorsque l'outil de mise à niveau de base de données de SQL Server Compact (upgrade.exe) est exécuté sur un appareil de type « smart device », une nouvelle base de données SQL Server Compact est créée. La nouvelle base de données SQL Server Compact, dotée de l'extension de nom de fichier .sdf, contient toutes les données qui se trouvaient dans la base de données source. Pour utiliser Upgrade.exe, les runtimes de SQL Server Compact et SQL Server CE doivent être installés sur l'appareil mobile.

La base de données source de la version antérieure de SQL Server Compact est également conservée sur l'appareil. Avant d'exécuter l'outil de mise à niveau de base de données, vous devez vous assurer que l'appareil dispose de suffisamment de mémoire pour les deux bases de données. En outre, l'outil de mise à niveau de base de données requiert environ 300 Ko de mémoire sur l'appareil.

L'outil de mise à niveau de base de données ne met pas à niveau les informations de suivi ou d'abonnement. Seules les données de la base de données source sont mises à niveau.

Important :

Si vous utilisez la réplication ou le service RDA (Remote Data Access) pour la connectivité, vous devez d'abord synchroniser la base de données SQL Server Compact source avec la base de données SQL Server, puis mettre à niveau la base de données. La mise à niveau d'une base de données de connectivité n'est utilisée que pour conserver toute table locale qui peut exister dans la base de données. En effet, après la mise à niveau, vous devez effectuer un nouvel abonnement ou une nouvelle extraction à partir de la nouvelle base de données.

Emplacement de l'outil de mise à niveau de base de données

L'outil de mise à niveau de base de données est installé avec Visual Studio 2008 en tant que partie du fichier MSI SQL Server Compact 3.5 for Devices (SSCEDeviceRuntime-[lang].msi). L'emplacement par défaut du fichier est %ProgramFiles%\Microsoft SQL Server Compact Edition\v3.5\Devices\[plateforme]\[processeur]\upgrade.exe.

Remarque :
Le fichier MSI SQL Server Compact 3.5 SP1 for Devices n'est pas installé avec Visual Studio 2008 SP1. SQL Server Compact 3.5 SP1 for Devices est disponible uniquement à partir du Centre de téléchargement Microsoft.

Exécution de l'outil de mise à niveau de base de données

Pour exécuter l'outil de mise à niveau de base de données, les logiciels suivants doivent être installés sur l'appareil de type « smart device » :

• SQL Server CE (v. 2.0) et SQL Server Compact 3.5/3.5 SP1
• Fournisseur OLE DB SQL Server Compact (installé par défaut au cours de l'installation de SQL Server Compact)

Lorsqu'il est déployé sur l'appareil de type « smart device » où se trouve la base de données source, l'outil de mise à niveau de base de données effectue les tâches suivantes :

• Ouvre le fichier de base de données source (doté de l'extension .sdf) qui a été spécifié dans l'invite de commandes.

• Ouvre la base de données spécifiée. Si le fournisseur OLE DB de SQL Server CE 2.0 (ssce20.dll) est introuvable sur l'appareil, l'outil de mise à niveau de base de données renvoie le message «  SQL Server CE 1.1 ou une version ultérieure doit déjà être installé. ».

• Utilise le moteur de stockage de SQL Server Compact pour créer une base de données SQL Server Compact.

• Lit le schéma de la base de données source à l'aide du fournisseur OLE DB de la version antérieure de SQL Server Compact.

• Écrit le schéma dans la base de données SQL Server Compact de destination à l'aide du fournisseur OLE DB SQL Server Compact.

• Lit les données de la base de données source à l'aide du fournisseur OLE DB de la version antérieure de SQL Server Compact.

• Écrit les données dans la base de données SQL Server Compact de destination à l'aide du fournisseur OLE DB SQL Server Compact.

  Remarque :
  L'outil de mise à niveau de base de données ne parvient pas à faire la distinction entre un index créé par l'utilisateur et un index créé par l'ajout d'une contrainte telle qu'une clé primaire. Il ne met pas à niveau les index qui partagent le même nom que la contrainte, car il suppose qu'ils ont été créés par la contrainte elle-même.

Toute erreur est écrite dans un fichier journal (upgrade.log) qui est enregistré dans le même répertoire que celui de l'outil de mise à niveau de base de données (upgrade.exe) sur l'appareil.

Remarque :
Upgrade.log est supprimé et recréé avant chaque mise à niveau.

Pour plus d'informations sur la compatibilité descendante et la mise à niveau vers SQL Server Compact 3.5 SP1, consultez Mise à niveau à partir de versions antérieures (SQL Server Compact).

Pour exécuter l'outil de mise à niveau de base de données, consultez Procédure : mettre à niveau SQL Server Compact 2.0 à l'aide de l'outil de mise à niveau de base de données. Le tableau ci-dessous répertorie les paramètres de ligne de commande utilisés avec l'outil de mise à niveau de base de données.