Fichier Lisezmoi de l'exemple Backup and Restore

Article
09/18/2009

Cet exemple fonctionne uniquement avec SQL Server 2005 et SQL Server 2008. Il ne fonctionnera pas avec les versions de SQL Server antérieures à SQL Server 2005.

L'exemple Backup and Restore vous permet d'utiliser des objets AMO (Analysis Management Objects) pour vous connecter à un serveur exécutant Microsoft SQL Server Analysis Services. Il permet de créer une base de données vide, d'effectuer une sauvegarde de cette base de données, de la supprimer, de la restaurer à partir de la sauvegarde, puis de la supprimer à nouveau.

Scénario

Cet exemple vous montre comment sauvegarder et restaurer vos bases de données Analysis Services par programme.

Langages

Fonctionnalités

L'exemple Analysis Services utilise les éléments suivants.

Domaine d'application	Fonctionnalités
AMOAdventureWorks	Objets AMO

Configuration requise

Avant d'exécuter cet exemple, les logiciels suivants doivent être installés :

Le Kit de développement .NET Framework SDK 2.0 ou Microsoft Visual Studio 2005.
Vous pouvez vous procurer gratuitement le Kit de développement .NET Framework SDK. Pour plus d'informations, consultez Installation du SDK .NET Framework dans la documentation en ligne de SQL Server.
Analysis Services

Business Intelligence Development Studio

Remarque :
Business Intelligence Development Studio n'est pas pris en charge sur les ordinateurs équipés d'un système d'exploitation Itanium ; l'environnement de développement 64 bits est pris en charge par les systèmes d'exploitation x64. Vous pouvez modifier les exemples SQL Server et les exécuter sur des ordinateurs équipés de systèmes d'exploitation x86 ou x64 lorsque les bases de données utilisées dans les exemples sont déployées sur un système d'exploitation Itanium.

Business Intelligence Development Studio n'est pas pris en charge sur les ordinateurs équipés d'un système d'exploitation Itanium ; l'environnement de développement 64 bits est pris en charge par les systèmes d'exploitation x64. Vous pouvez modifier les exemples SQL Server et les exécuter sur des ordinateurs équipés de systèmes d'exploitation x86 ou x64 lorsque les bases de données utilisées dans les exemples sont déployées sur un système d'exploitation Itanium.

Base de données AdventureWorks AS.
Vous pouvez télécharger cet exemple de bases de données sur le site Web des exemples et projets de communautés Microsoft SQL Server. Pour plus d'informations sur le téléchargement et l'installation d'exemples de bases de données, consultez Installation d'exemples et d'exemples de bases de données SQL Server dans la documentation en ligne de SQL Server.

Une fois votre exemple compilé, vous devez accéder à l'un des exemples de bases de données Analysis Services pour tester votre programme. Il est recommandé d'utiliser l'exemple de base de données AdventureWorks fourni avec SQL Server.

Autorisations d'utilisateur pour la sauvegarde

Pour chaque fichier de sauvegarde, l'utilisateur qui exécute la commande de sauvegarde doit disposer de l'autorisation pour écrire dans les emplacements de sauvegarde spécifiés. Par ailleurs, l'utilisateur doit avoir l'un des rôles suivants : membre d'un rôle de serveur pour l'instance Analysis Services ou membre d'un rôle de base de données avec les autorisations de contrôle total (Administrateur) sur la base de données à sauvegarder.

Autorisations d'utilisateur pour la restauration

Pour chaque fichier de sauvegarde, l'utilisateur qui exécute la commande de restauration doit disposer de l'autorisation en lecture à partir de l'emplacement de sauvegarde spécifié. Pour restaurer une base de données Analysis Services qui n'est pas installée sur le serveur, l'utilisateur doit également être un membre du rôle serveur pour cette instance d'Analysis Services. Pour remplacer une base de données Analysis Services, l'utilisateur doit avoir l'un des rôles suivants : membre du rôle serveur pour l'instance d'Analysis Services ou membre d'un rôle de base de données avec les autorisations de contrôle total (Administrateur) sur la base de données à restaurer.

Remarque :
Après la restauration d'une base de données existante, l'utilisateur qui a restauré la base de données peut perdre l'accès à la base de données restaurée. Cette perte d'accès peut se produire si, au moment de la sauvegarde, l'utilisateur n'était pas un membre du rôle serveur ou n'était pas un membre du rôle de base de données avec les autorisations de contrôle total (Administrateur).

Après la restauration d'une base de données existante, l'utilisateur qui a restauré la base de données peut perdre l'accès à la base de données restaurée. Cette perte d'accès peut se produire si, au moment de la sauvegarde, l'utilisateur n'était pas un membre du rôle serveur ou n'était pas un membre du rôle de base de données avec les autorisations de contrôle total (Administrateur).

Génération de l'exemple

Si vous n'avez pas encore créé un fichier de clé de nom fort, utilisez la procédure suivante pour générer ce fichier.

Pour générer un fichier de clé de nom fort

Ouvrez une invite de commandes Microsoft Visual Studio 2005. Cliquez sur Démarrer, pointez sur Tous les programmes et sur Kit de développement Microsoft .NET Framework SDK 2.0, puis cliquez sur Invite de commandes du Kit de développement SDK.

-- ou --

Ouvrez une invite de commandes Microsoft .NET Framework. Cliquez sur Démarrer, pointez sur Tous les programmes et sur Kit de développement Microsoft .NET Framework SDK 2.0, puis cliquez sur Invite de commandes du Kit de développement SDK.

Utilisez la commande CD (changer de répertoire) pour remplacer le dossier actif dans la fenêtre de l'invite de commandes par le dossier dans lequel les exemples sont installés.

Remarque :
Pour déterminer le dossier dans lequel se trouvent les exemples, cliquez sur Démarrer, pointez successivement sur Tous les programmes, sur Microsoft SQL Server 2005 et sur Documentation et didacticiels puis cliquez sur le répertoire Samples. Si l'emplacement d'installation par défaut a été utilisé, les exemples se trouvent dans <lecteur_système>:\Program Files\Microsoft SQL Server\100\Samples.

Pour déterminer le dossier dans lequel se trouvent les exemples, cliquez sur Démarrer, pointez successivement sur Tous les programmes, sur Microsoft SQL Server 2005 et sur Documentation et didacticiels puis cliquez sur le répertoire Samples. Si l'emplacement d'installation par défaut a été utilisé, les exemples se trouvent dans <lecteur_système>:\Program Files\Microsoft SQL Server\100\Samples.

À l'invite de commandes, exécutez la commande suivante pour générer le fichier de clé :

sn -k SampleKey.snk

Important :
Pour plus d'informations sur la paire de clés avec nom fort, consultez « Security Briefs: Strong Names and Security in the .NET Framework » (en anglais) dans le Centre de Développement du .NET sur MSDN.

Pour générer l'exemple Backup and Restore

Générez l'exemple à l'aide de Visual Studio 2005 et de la solution Visual Studio fournie.

- ou -
Générez l'exemple à l'aide de Microsoft MSBuild, fourni dans le Kit de développement .NET Framework SDK 2.0, et exécutez une commande similaire à celle-ci à l'invite de commandes :

msbuild /nologo /verbosity:quiet /property:Configuration=Debug CS/BackupAndRestore.sln

Vous pouvez utiliser d'autres options de génération Microsoft MSBuild, en fonction de vos besoins.

Exécution de l'exemple

Pour exécuter l'exemple Backup and Restore

Dans Visual Studio 2005, appuyez sur la touche F5.

- ou -
Dans Visual Studio 2005, cliquez sur Démarrer dans le menu Déboguer.

- ou -
À l'invite de commandes, exécutez une commande similaire à celle-ci :

CS\BackupAndRestore\bin\Debug\BackupAndRestore.exe

Le chemin d'accès peut varier en fonction des options qui ont été utilisées pour compiler l'exemple et le dossier de démarrage à l'invite de commandes.

Après l'exécution de l'exemple, le fichier de sauvegarde de la base de données temporaire créée par l'exemple se trouve dans <system_drive>:\backup_file_generated_by_amo_sample_code.abf.

Voir aussi