Readme_Spatial-Beispiel

Artikel
10/16/2009

[Dieses Thema ist eine Dokumentation zur Vorabversion und kann in zukünftigen Versionen geändert werden. Leere Themen sind als Platzhalter eingefügt. BITTE BEACHTEN SIE: Microsoft ist bestrebt, Ihnen möglichst viele Inhalte in deutscher Sprache anzubieten. Deshalb stellen wir Ihnen auch Dokumente zur Verfügung, die mit alternativen Verfahren übersetzt wurden. Der Inhalt der Dokumente dieser Vorabversion wurde zum Teil mithilfe solcher Verfahren übersetzt. Microsoft ist sich bewusst, dass ein auf diese Weise übersetztes Dokument nicht immer perfekt ist. Es kann Fehler in Bezug auf Wortwahl, Satzbau oder Grammatik enthalten. Für die Übersetzung der endgültigen Version dieses Inhalts werden herkömmliche Verfahren verwendet, sodass die Qualität der früherer Versionen entspricht.]

Dieses Beispiel funktioniert nur mit SQL Server 2005 und SQL Server 2008. In einer SQL Server-Version vor SQL Server 2005 kann das Beispiel nicht ausgeführt werden.

SQL Server stellt leistungsfähige Indizierungs- und Abfragefunktionen für einfache Datentypen, wie z. B. ganze Zahlen, Zeichenfolgen und Datumswerte, bereit. Für große Datensets mit komplexen Daten reichen die vorhandenen Indizierungs- und Abfragefunktionen u. U. jedoch nicht aus. Das Spatial-Beispiel veranschaulicht, wie Sie mithilfe der CLR-Integrationstechnologie (Common Language Runtime) in SQL Server die grundlegenden Indizierungs- und Abfragefunktionen verbessern können, um komplexere Datentypen und Abfragen auf diese Daten zu unterstützen. Obwohl das Spatial-Beispiel für die Unterstützung georäumlicher und astronomischer Abfragen konzipiert ist, können die dem Beispiel zugrunde liegenden Konzepte für viele andere Arten von Daten verwendet werden.

Dieses Beispiel enthält Folgendes:

Eine vollständige Klassenbibliothek für die Darstellung und Bearbeitung räumlicher Informationen
Eine Beispieldatenbank mit räumlichen Informationen
Detaillierte Dokumentation zu den Konzepten, die dem Beispiel und den verwendeten Algorithmen zugrunde liegen.
Installations- und Testskripts

Installationsverzeichnis: C:\Programme\Microsoft SQL Server\100\Samples\Engine\Programmability\CLR\Spatial\

SQL Server-Beispiele und -Beispieldatenbanken müssen heruntergeladen und installiert werden, bevor Sie sie anzeigen oder mit ihnen arbeiten können. Weitere Informationen finden Sie unter Überlegungen zum Installieren der SQL Server-Beispiele und -Beispieldatenbanken.

Szenario

Jane ist eine Entwicklerin für Adventure Works Cycles. Im Rahmen Ihrer Aufgaben muss sie raumbezogene Informationen darstellen, ändern und abfragen.

Sprachen

Transact-SQL, Visual C# und Visual Basic.

Features

Das Spatial-Beispiel verwendet die folgenden Features von SQL Server.

Anwendungsbereich	Features
Gesamt	CLR, Tabellenwertfunktionen, Transact-SQL

Voraussetzungen

Stellen Sie vor dem Ausführen dieses Beispiels sicher, dass die folgende Software installiert ist:

SQL Server oder SQL Server Express. Sie können SQL Server Express kostenlos von der Website mit der Dokumentation und Beispielen zu SQL Server Express abrufen.
Die Beispiele zu SQL Server Database Engine (Datenbankmodul). Diese Beispiele sind in SQL Server enthalten. Sie können die aktuelle Version der Beispiele von der SQL Server Developer-Website herunterladen.
.NET Framework SDK 2.0 oder Microsoft Visual Studio 2005. Das .NET Framework SDK ist kostenlos erhältlich. Weitere Informationen finden Sie unter Installieren der .NET Framework-Dokumentation.

Erstellen des Beispiels

Generieren Sie die Schlüsseldatei mithilfe der folgenden Anweisungen, falls Sie noch keine Schlüsseldatei mit starkem Namen erstellt haben.

So generieren Sie eine Schlüsseldatei mit starkem Namen

Öffnen Sie eine Microsoft Visual Studio 2005-Eingabeaufforderung. Klicken Sie auf Start, zeigen Sie auf Alle Programme und danach auf Microsoft .NET Framework SDK 2.0, und klicken Sie dann auf SDK-Eingabeaufforderung.

– oder –

Öffnen Sie eine Microsoft .NET Framework-Eingabeaufforderung. Klicken Sie auf Start, zeigen Sie auf Alle Programme und dann auf Microsoft .NET Framework SDK 2.0, und klicken Sie anschließend auf SDK-Eingabeaufforderung.
Wechseln Sie an der Eingabeaufforderung mit dem Befehl CD (Verzeichnis wechseln) vom aktuellen Verzeichnis im Eingabeaufforderungsfenster zu dem Ordner, in dem die Beispiele installiert werden.

Hinweis

Klicken Sie auf Start, zeigen Sie auf Alle Programme, Microsoft SQL Server und auf Dokumentation und Lernprogramme, und klicken Sie dann auf Beispielordner, um den Ordner zu ermitteln, in dem sich die Beispiele befinden. Wenn das Standardverzeichnis verwendet wurde, befinden sich die Beispiele im Verzeichnis <system_drive>:\Programme\Microsoft SQL Server\100\Samples.
Führen Sie an der Eingabeaufforderung den folgenden Befehl zum Generieren der Schlüsseldatei aus:

sn -k SampleKey.snk

Wichtig

Weitere Informationen zum Schlüsselpaar mit starkem Namen finden Sie unter "Security Briefs: Starke Namen und Sicherheit im .NET Framework" unter .NET-Entwicklung von MSDN.

So erstellen Sie das Spatial-Beispiel

Kompilieren Sie das Beispiel mithilfe von Visual Studio 2005 und der bereitgestellten Visual Studio-Projektmappe oder mithilfe von MSBuild, das im .NET Framework SDK 2.0 enthalten ist. Führen Sie an einer .NET Framework-Eingabeaufforderung Befehle aus, die dem folgenden ähnlich sind:

msbuild /nologo /verbosity:quiet /property:Configuration=Debug CS\Spatial.sln
Wenn Sie die Beispiele für SQL Server Database Engine (Datenbankmodul) nicht im Standardverzeichnis installiert haben, ändern Sie den Pfad im CREATE ASSEMBLY-Abschnitt des Skripts in Scripts\spHtmCsharp.sql und den Pfad zur Datenbank in der Datei Scripts\AttachSpatialDatabase.bat, um auf den Speicherort zu verweisen, in dem die Beispiele installiert wurden.
Fügen Sie die Spatial-Datenbank an, indem Sie die Datei Scripts\AttachSpatialDatabase.bat in einem Eingabeaufforderungsfenster ausführen.
Falls Sie kein Administrator für die verwendete SQL Server-Instanz sind, muss Ihnen ein Administrator die CreateAssembly-Berechtigung erteilen, damit Sie die Installation ausführen können.
Öffnen Sie die Datei scripts\spHtmCsharp.sql in SQL Server Management Studio. Führen Sie das in der Datei enthaltene Skript aus, oder führen Sie in einem Eingabeaufforderungsfenster einen ähnlichen Befehl wie den folgenden aus:

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

Ausführen des Beispiels

So führen Sie das Spatial-Beispiel aus

Öffnen Sie die Datei Scripts\TestScript.sql in Management Studio. Führen Sie das in der Datei enthaltene Skript aus, oder führen Sie in einem Eingabeaufforderungsfenster einen ähnlichen Befehl wie den folgenden aus:

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

Kommentar

CLR für SQL Server oder SQL Server Express muss aktiviert sein, damit dieses Beispiel ordnungsgemäß ausgeführt werden kann.

Die Beispiele dienen nur zu Lernzwecken. Sie sind nicht für den Einsatz in einer Produktionsumgebung gedacht und wurden auch nicht in einer Produktionsumgebung getestet. Microsoft leistet keinen technischen Support für diese Beispiele. Beispielanwendungen und Assemblys sollten nicht ohne die Zustimmung des Systemadministrators mit der SQL Server-Datenbank oder dem Berichtsserver verbunden sein oder verwendet werden.

Freigeben über