Exemple Readme_Hello World
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 Hello World montre les opérations de base à effectuer pour créer, déployer et tester une procédure stockée simple et basée sur l'intégration du CLR (Common Language Runtime). Cet exemple montre également comment retourner, par le biais d'un paramètre de sortie et d'un enregistrement, des données qui sont générées dynamiquement par la procédure stockée et retournées au client.
Répertoire d'installation : C:\Program Files\Microsoft SQL Server\100\Samples\Engine\Programmability\CLR\HelloWorld\
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
Jane travaille au service Développement de la société Adventure Works Cycles. Il souhaite apprendre à utiliser les procédures stockées d'intégration du CLR.
Langages
Transact-SQL, Visual C# et Visual Basic.
Fonctionnalités
L'exemple Hello World utilise les fonctionnalités suivantes de SQL Server.
Domaine d'application | Fonctionnalités |
---|---|
Général |
CLR, métadonnées |
Configuration requise
Avant d'exécuter cet exemple, vérifiez que le logiciel suivant est installé :
- (Microsoft, SQL Server ou SQL Server Express). Vous pouvez vous procurer gratuitement SQL Server Express à partir du site Web SQL Server Express Documentation and Samples (en anglais).
- Base de données AdventureWorks qui est disponible sur le site Web du Centre pour les développeurs Microsoft SQL Server.
- Exemples Moteur de base de données SQL Server qui sont disponibles sur le site Web du Centre pour les développeurs Microsoft SQL Server.
- Kit de développement logiciel .NET Framework 2.0 (SDK) ou Microsoft Visual Studio 2005. Vous pouvez vous procurer gratuitement le Kit de développement logiciel .NET Framework (SDK). Consultez Installation de la documentation .NET Framework..
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. À 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 Hello World
Compilez l'exemple au moyen de Visual Studio 2005 et de la solution Visual Studio fournie, ou à l'aide de Microsoft MSBuild disponible dans le Kit de développement logiciel .NET Framework SDK 2.0. À une invite de commandes, exécutez une commande présentant l'aspect suivant :
msbuild /nologo /verbosity:quiet /property:Configuration=Debug CS\HelloWorld.sln
Assurez-vous que la base de données AdventureWorks est installée.
Si vous n'avez pas installé les exemples pour le moteur SQL Server à l'emplacement par défaut, modifiez le chemin d'accès dans la partie CREATE ASSEMBLY des scripts qui se trouvent dans les fichiers Scripts\InstallCS.sql et Scripts\InstallVB.sql de façon à désigner l'emplacement où vous avez installé ces exemples.
Si vous n'êtes pas un administrateur de l'instance de SQL Server que vous utilisez, demandez à un administrateur de vous accorder l'autorisation CreateAssembly pour effectuer l'installation.
Ouvrez le fichier scripts\installCS.sql ou scripts\installVB.sql, selon que vous avez compilé le projet Visual C# ou le projet Visual Basic, dans Microsoft SQL Server Management Studio. Exécutez le script contenu dans le fichier ou exécutez une commande semblable à la suivante dans une fenêtre d'invite de commandes :
sqlcmd -E -I -i Scripts\InstallCS.sql
Exécution de l'exemple
Pour exécuter l'exemple Hello World
Ouvrez le fichier scripts\test.sql dans Management Studio. Exécutez le script contenu dans le fichier ou bien la commande suivante dans une fenêtre d'invite de commandes :
sqlcmd -E -I -i Scripts\test.sql
Suppression de l'exemple
Pour supprimer l'exemple Hello World
Ouvrez le fichier scripts\cleanup.sql dans Management Studio. Exécutez le script contenu dans le fichier ou bien la commande suivante dans une fenêtre d'invite de commandes :
sqlcmd -E -I -i Scripts\cleanup.sql
Commentaires
Pour que cet exemple fonctionne correctement, le CLR pour SQL Server 2008 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
Autres ressources
CREATE ASSEMBLY (Transact-SQL)
DROP ASSEMBLY (Transact-SQL)
CREATE PROCEDURE (Transact-SQL)
DROP PROCEDURE (Transact-SQL)