Exemple Readme_Spatial

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.

SQL Server comporte des fonctions d'indexation et de requêtes performantes pour les types de données de base tels que nombres entiers, chaînes et dates. Toutefois, les fonctions d'indexation et de requêtes existantes peuvent s'avérer insuffisantes pour traiter des ensembles de données volumineux contenant des données complexes. L'exemple Spatial montre comment utiliser la technologie d'intégration du CLR (Common Language Runtime) dans SQL Server pour améliorer les fonctions de base d'indexation et de requêtes afin de prendre en charge des types de données et des requêtes plus complexes sur ces données. Bien que cet exemple soit conçu pour prendre en charge des requêtes géospatiales et célestes, les concepts auxquels il fait référence peuvent être utilisés pour des données appartenant à un grand nombre d'autres domaines.

Voici le contenu de cet exemple :

une bibliothèque de classes complète pour représenter et manipuler des informations spatiales ;
un exemple de base de données contenant des informations spatiales ;
une documentation détaillée sur les concepts sous-jacents à l'exemple et les algorithmes utilisés ;
des scripts d'installation et de test.

Répertoire d'installation : C:\Program Files\Microsoft SQL Server\100\Samples\Engine\Programmability\CLR\Spatial\

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. Elle est chargée de représenter et de manipuler des informations spatiales et d'effectuer des requêtes sur ces données.

Langages

Transact-SQL, Visual C# et Visual Basic.

Fonctionnalités

L'exemple Spatial utilise les fonctionnalités suivantes de SQL Server.

Domaine d'application	Fonctionnalités
Global	CLR, fonctions table, Transact-SQL

Configuration requise

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

SQL Server ou SQL Server Express. Vous pouvez vous procurer SQL Server Express gratuitement à partir du site Web SQL Server Express Documentation et exemples.
Exemples du Moteur de base de données SQL Server. Ces exemples accompagnent SQL Server. Vous pouvez télécharger la dernière version des exemples sur le site Web du SQL Server Developer Center.
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 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.

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 Spatial

Compilez l'exemple au moyen de Visual Studio 2005 et de la solution Visual Studio fournie, ou à l'aide de MSBuild présent dans le Kit de développement logiciel .NET Framework SDK 2.0. À une invite de commandes .NET Framework, exécutez des commandes présentant l'aspect suivant :

msbuild /nologo /verbosity:quiet /property:Configuration=Debug CS\Spatial.sln
Si vous n'avez pas installé les exemples du moteur de base de données SQL Server 2005 à l'emplacement par défaut, modifiez le chemin d'accès dans la partie CREATE ASSEMBLY du script qui se trouve dans le fichier Scripts\spHtmCsharp.sql et le chemin d'accès à la base de données dans le fichier Scripts\AttachSpatialDatabase.bat de façon à désigner l'emplacement où vous les avez installés.
Attachez la base de données Spatial en exécutant le fichier Scripts\AttachSpatialDatabase.bat dans une fenêtre d'invite de commandes.
Si vous n'êtes pas administrateur de l'instance SQL Server utilisée, vous devez demander à un administrateur de vous accorder l'autorisation CreateAssembly pour terminer l'installation.
Ouvrez le fichier scripts\spHtmCsharp.sql dans SQL Server Management Studio. Exécutez le script contenu dans le fichier ou exécutez une commande présentant l'aspect suivant dans une fenêtre d'invite de commandes :

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

Exécution de l'exemple

Pour exécuter l'exemple Spatial

Ouvrez le fichier Scripts\TestScript.sql dans Management Studio. Exécutez le script contenu dans le fichier ou exécutez une commande présentant l'aspect suivant dans une fenêtre d'invite de commandes :

sqlcmd -E -I -i Scripts\TestScript.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.

Partager via