Exemple Readme_Assembly Cleanup

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 AssemblyCleanup contient une procédure stockée .NET, écrite en Visual C# , qui nettoie les assemblys inutilisés de la base de données active en interrogeant les catalogues de métadonnées.

Son seul paramètre, visible_assemblies, est utilisé pour spécifier si les assemblys visibles inutilisés doivent être supprimés ou pas. La valeur « false » signifie par défaut que seuls les assemblys invisibles inutilisés seront supprimés ; sinon, tous les assemblys inutilisés le seront.

L'ensemble des assemblys inutilisés sont les assemblys qui n'ont pas de points d'entrée définis (routines / types et agrégats) et qui ne sont référencés directement ou indirectement par aucun assembly utilisé.

Remarque :

Lorsque vous compilez les exemples SQLCLR, le chemin d'accès de la version du compilateur Microsoft .NET Framework disponible dans SQL Server doit correspondre au premier répertoire Framework figurant dans la variable d'environnement PATH. L'emplacement du compilateur fourni avec SQL Server est lecteur:\WINNT\Microsoft.NET\Framework\v2.0.xxxxx ou lecteur:\Windows\Microsoft.NET\Framework\v2.0.xxxxx, où lecteur est le lecteur d'installation et xxxxx le numéro de version du .NET Framework fourni avec SQL Server.

Le répertoire d'installation par défaut est C:\Program Files\Microsoft SQL Server\100\Samples\Engine\Programmability\CLR\AssemblyCleanup.

Les exemples SQL Server et les exemples de bases de données doivent être téléchargés et installés avant que vous ne puissiez les afficher ou les utiliser. Pour plus d'informations, consultez Considérations relatives à l'installation d'exemples de bases de données et d'exemples de code SQL Server.

Scénario

Un développeur souhaite copier des images entre SQL Server et le système de fichiers sur le serveur.

Langages

Transact-SQL, Visual C# et Visual Basic.

Configuration requise

Avant d'exécuter cet exemple, assurez-vous que les logiciels suivants sont installés sur votre ordinateur :

• SQL Server

Génération de l'exemple

Si vous n'avez pas déjà créé le fichier de clé de nom fort ExternalSampleKey.snk, utilisez la procédure suivante pour générer ce fichier.

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

1. Ouvrez une invite de commandes Microsoft Visual Studio 2005. Cliquez sur Démarrer, pointez successivement sur Tous les programmes, sur Microsoft Visual Studio 2005 et sur Outils Visual Studio, puis cliquez sur Invite de commandes de Visual Studio 2005.

   - ou -

   Ouvrez une invite de commandes de 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.

2. À l'invite de commandes, utilisez la commande CD (changer de répertoire) pour remplacer le dossier actif dans la fenêtre de l'invite par le dossier Samples.

   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 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 <system_drive>:\Program Files\Microsoft SQL Server\100\Samples.

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

   sn -k ExternalSampleKey.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, procédez comme suit :

Génération de l'exemple

1. Compilez l'exemple à l'aide des solutions Microsoft Visual Studio fournies ou en exécutant à l'invite de commandes une commande similaire à celle-ci :

   Sn -k keypair.snk

   Csc /reference:"C:\Program Files\Microsoft SQL Server\MSSQL.10.MSSQLSERVER\MSSQL\Binn\sqlaccess.dll" /target:library /debug /out:CS\AssemblyCleanup\Bin\Debug\AssemblyCleanup.dll CS\AssemblyCleanup\*.cs

2. Assurez-vous que la base de données AdventureWorks est installée ou, si nécessaire, créez la base de données dans laquelle vous souhaitez installer les exemples.

3. Chargez le script Transact-SQL de Scripts\installCS.sql ou Scripts\installVB.sql dans Management Studio et exécutez-le. Ce fichier contient le script permettant d'installer et d'inscrire les exemples d'objets CLR dans SQL Server.

Exécution de l'exemple

Pour exécuter l'exemple, procédez comme suit :

Exécution de l'exemple

1. Chargez le script Transact-SQL de Scripts\test.sql dans Management Studio et exécutez-le. Ce script illustre les principales façons d'utiliser l'exemple.

2. Lorsque vous avez terminé l'exemple, chargez le script Transact-SQL de Scripts\cleanup.sql dans Management Studio et exécutez-le. Ce script supprime l'exemple.

Suppression de l'exemple

Pour supprimer l'exemple, procédez comme suit :

Suppression de l'exemple

1. Ouvrez le fichier scripts\cleanup.sql dans Management Studio et exécutez le script que contient le fichier. Vous pouvez également exécuter la commande suivante à l'invite de commandes :

   sqlcmd -E -I -i Scripts\cleanup.sql

Commentaires

Pour que cet exemple fonctionne correctement, le CLR pour SQL Server ou SQL Server Express doit être activé.

Les exemples sont fournis à titre éducatif uniquement. Ils ne sont pas destinés à être utilisés dans un environnement de production et n'ont pas été testés à cet usage. Microsoft ne fournit aucun support technique pour ces exemples. Les exemples d'applications et les assemblys ne doivent pas être utilisés avec votre base de données SQL Server de production ou votre serveur de rapports, ou y être connectés, sans l'autorisation de l'administrateur système.

Voir aussi

Concepts

Exemples de programmabilité CLR

Autres ressources

Large Binary Object (LOB) Handling using ADO.Net
Concepts de programmation pour l'intégration du CLR

Aide et informations

Assistance sur SQL Server 2008