Erstellen, Aufbauen und Abfragen von geometry-Instanzen

Der planare räumliche Datentyp geometry stellt Daten in einem euklidischen (flachen) Koordinatensystem dar. Dieser Datentyp wird in SQL Serverals CLR-Datentyp (Common Language Runtime) implementiert.

Der geometry-Typ ist vordefiniert und in jeder Datenbank verfügbar. Sie können Tabellenspalten des geometry-Typs in der gleichen Weise erstellen und geometry-Daten in der gleichen Weise verwenden wie andere CLR-Typen.

Der geometry von SQL Server unterstützte Datentyp (planar) entspricht der Open Geospatial Consortium (OGC) Simple Features for SQL Specification Version 1.1.0.

Weitere Informationen zu den OGC-Spezifikationen finden Sie in den folgenden Themen:

• OGC Specifications, Simple Feature Access Part 1 - Common Architecture

• OGC Specifications, Simple Feature Access Part 2: SQL Options (OGC-Spezifikationen, Simple Feature Access, Teil 2: SQL-Optionen)

SQL Server unterstützt eine Teilmenge des vorhandenen GML 3.1-Standards, der in folgendem Schema definiert ist: https://schemas.microsoft.com/sqlserver/profiles/gml/SpatialGML.xsd.

Erstellen oder Konstruieren einer neuen geometry-Instanz

Erstellen einer neuen geometry-Instanz aus einer vorhandenen Instanz

Der geometry-Datentyp stellt viele integrierte Methoden zur Verfügung, mit denen neue geometry-Instanzen auf der Grundlage vorhandener Instanzen erstellt werden können.

So erstellen Sie einen Puffer um eine Geometrie
STBuffer (geometry-Datentyp)

BufferWithTolerance (geometry-Datentyp)

So erstellen Sie eine vereinfachte Version einer Geometrie
Reduce (geometry-Datentyp)

So erstellen Sie die konvexe Hülle einer Geometrie
STConvexHull (geometry-Datentyp)

So erstellen Sie eine Geometrie aus der Schnittmenge zweier Geometrien
STIntersection (geometry-Datentyp)

So erstellen Sie eine Geometrie aus der Vereinigung zweier Geometrien
STUnion (geometry-Datentyp)

So erstellen Sie eine Geometrie aus den Punkten, an denen eine Geometrie eine andere nicht überlappt
STDifference (geometry-Datentyp)

So erstellen Sie eine Geometrie aus den Punkten, an denen zwei Geometrien nicht überlappen
STSymDifference (geometry-Datentyp)

So erstellen Sie eine beliebige Punktinstanz, die auf einer vorhandenen Geometrie liegt
STPointOnSurface (geometry-Datentyp)

Erstellen einer geometry-Instanz anhand einer WKT-Eingabe (Well-Known Text)

Der geometry-Datentyp bietet mehrere integrierte Methoden zur Erstellung einer Geometrie anhand der WKT-Darstellung von Open Geospatial Consortium (OGC). Der WKT-Standard ist eine Textzeichenfolge, die den Austausch von Geometriedaten in Textform ermöglicht.

So erstellen Sie eine beliebige geometry-Instanz anhand einer WKT-Eingabe
STGeomFromText (geometry-Datentyp)

Parse (geometry-Datentyp)

So erstellen Sie eine Point-geometry-Instanz anhand einer WKT-Eingabe
STPointFromText (geometry-Datentyp)

So erstellen Sie eine MultiPoint-geometry-Instanz anhand einer WKT-Eingabe
STMPointFromText (geometry-Datentyp)

So erstellen Sie eine LineString-geometry-Instanz anhand einer WKT-Eingabe
STLineFromText (geometry-Datentyp)

So erstellen Sie eine MultiLineString-geometry-Instanz anhand einer WKT-Eingabe
STMLineFromText (geometry-Datentyp)

So erstellen Sie eine Polygon-geometry-Instanz anhand einer WKT-Eingabe
STPolyFromText (geometry-Datentyp)

So erstellen Sie eine MultiPolygon-geometry-Instanz anhand einer WKT-Eingabe
STMPolyFromText (geometry-Datentyp)

So erstellen Sie eine GeometryCollection-geometry-Instanz anhand einer WKT-Eingabe
STGeomCollFromText (geometry-Datentyp)

Erstellen einer geometry-Instanz aus einer WKB-Eingabe (Well-Known Binary)

WKB ist ein vom Open Geospatial Consortium spezifiziertes Binärformat, das den Austausch von geometry-Daten zwischen einer Clientanwendung und einer SQL-Datenbank ermöglicht. Die folgenden Funktionen akzeptieren die WKB-Eingabe zum Zweck der Erstellung von Geometrien:

So erstellen Sie einen beliebigen geometry-Instanztyp anhand einer WKB-Eingabe
STGeomFromWKB (geometry-Datentyp)

So erstellen Sie eine Point-geometry-Instanz anhand einer WKB-Eingabe
STPointFromWKB (geometry-Datentyp)

So erstellen Sie eine MultiPoint-geometry-Instanz anhand einer WKB-Eingabe
STMPointFromWKB (geometry-Datentyp)

So erstellen Sie eine LineString-geometry-Instanz anhand einer WKB-Eingabe
STLineFromWKB (geometry-Datentyp)

So erstellen Sie eine MultiLineString-geometry-Instanz anhand einer WKB-Eingabe
STMLineFromWKB (geometry-Datentyp)

So erstellen Sie eine Polygon-geometry-Instanz anhand einer WKB-Eingabe
STPolyFromWKB (geometry-Datentyp)

So erstellen Sie eine MultiPolygon-geometry-Instanz anhand einer WKB-Eingabe
STMPolyFromWKB (geometry-Datentyp)

So erstellen Sie eine GeometryCollection-geometry-Instanz anhand einer WKB-Eingabe
STGeomCollFromWKB (geometry-Datentyp)

Erstellen einer geometry-Instanz anhand einer GML-Texteingabe

Der geometry Datentyp stellt eine Methode bereit, die eine geometry instance aus GML generiert, eine XML-Darstellung geometrischer Objekte. SQL Server unterstützt eine Teilmenge von GML.

So erstellen Sie einen beliebigen geometry-Instanztyp anhand einer GML-Eingabe
GeomFromGml (geometry-Datentyp)

Zurückgeben von WKT (Well-Known Text) oder WKB (Well-Known Binary) aus einer geometry-Instanz

Anhand der folgenden Methoden können Sie entweder das WKT- oder das WKB-Format einer geometry zurückgeben:

So geben Sie eine WKT-Darstellung einer geometry-Instanz zurück
STAsText (geometry-Datentyp)

ToString (geometry-Datentyp)

So geben Sie eine WKT-Darstellung einer geometry-Instanz einschließlich Z- und M-Werten zurück
AsTextZM (geometry-Datentyp)

So geben Sie eine WKB-Darstellung einer geometry-Instanz zurück
STAsBinary (geometry-Datentyp)

So geben Sie eine GML-Darstellung einer geometry-Instanz zurück
AsGml (geometry-Datentyp)

Abfragen der Eigenschaften und Verhalten von geometry-Instanzen

Alle geometry Instanzen verfügen über eine Reihe von Eigenschaften, die über Methoden abgerufen werden können, die SQL Server bereitstellt. In den folgenden Themen werden die Eigenschaften und Verhalten von geometry-Typen und die Methoden zum Abrufen der einzelnen Eigenschaften und Verhalten beschrieben.

Gültigkeit, Instanztyp und GeometryCollection-Informationen

Sobald eine geometry-Instanz erstellt wurde, können Sie anhand der folgenden Methoden ermitteln, ob sie wohlgeformt ist, den Instanztyp zurückgeben oder, wenn es sich um eine Collection-Instanz handelt, eine spezifische geometry-Instanz zurückgeben.

So geben Sie den Instanztyp einer Geometrie zurück
STGeometryType (geometry-Datentyp)

So bestimmen Sie, ob eine Geometrie einen gegebenen Instanztyp aufweist
InstanceOf (geometry-Datentyp)

So bestimmen Sie, ob eine geometry-Instanz für ihren Instanztyp wohlgeformt ist
STIsValid (geometry-Datentyp)

So konvertieren Sie eine geometry-Instanz in eine wohlgeformte Geometrieinstanz mit einem Instanztyp
MakeValid (geometry-Datentyp)

So geben Sie die Anzahl von Geometrien in einer geometry-Auflistungsinstanz zurück
STNumGeometries (geometry-Datentyp)

So geben Sie eine bestimmte Geometrie in einer geometry-Auflistungsinstanz zurück
STGeometryN (geometry-Datentyp)STGeometryN (geometry-Datentyp)

Anzahl von Punkten

Alle nicht erlösenden geometry Instanzen bestehen aus Punkten. Diese Punkte stellen die x- und y-Koordinaten der Ebene dar, auf die die Geometrien gezeichnet werden. geometry stellt zahlreiche integrierte Methoden zum Abfragen der Punkte einer Instanz bereit.

So geben Sie die Anzahl von Punkten zurück, aus denen eine Instanz besteht
STNumPoints (geometry-Datentyp)

So geben Sie einen bestimmten Punkt einer Instanz zurück
STPointN

So geben Sie einen beliebigen Punkt zurück, der auf einer Instanz liegt
STPointOnSurface

So geben Sie den Ausgangspunkt einer Instanz zurück
STStartPoint

So geben Sie den Endpunkt einer Instanz zurück
STEndpoint

So geben Sie die X-Koordinate einer Point-Instanz zurück
STX (geometry-Datentyp)

So geben Sie die Y-Koordinate einer Point-Instanz zurück
STY

So geben Sie den geometrischen Mittelpunkt einer Polygon-, CurvePolygon- oder MultiPolygon-Instanz zurück
STCentroid

Dimension

Eine nicht leere geometry-Instanz kann null-, ein- oder zweidimensional sein. Nulldimensionale Objekte (geometries), z. B. Point und MultiPoint, verfügen weder über eine Länge noch über eine Fläche. Eindimensionale Objekte (z. B. LineString, CircularString, CompoundCurve und MultiLineString) weisen eine Länge auf. Zweidimensionale Instanzen (z. B. Polygon, CurvePolygon und MultiPolygon) weisen eine Fläche und eine Länge auf. Für leere Instanzen wird als Dimension -1 ausgegeben, und für eine GeometryCollection-Auflistung wird eine Fläche ausgegeben, die vom Typ der darin enthaltenen Elemente abhängt.

So geben Sie die Dimension einer Instanz zurück
STDimension

So geben Sie die Länge einer Instanz zurück
STLength

So geben Sie die Fläche einer Instanz zurück
STArea

Empty

Eine leeregeometry instance hat keine Punkte. Die Länge von leeren LineString, CircularString- , CompoundCurve- und MultiLineString -Instanzen ist 0. Die Fläche von leeren Polygon-, CurvePolygon- und MultiPolygon-Instanzen ist 0 (null).

So bestimmen Sie, ob eine Instanz leer ist
STIsEmpty.

Einfach

Damit eine geometry der instance einfach ist, muss sie die folgenden beiden Anforderungen erfüllen:

• Keine Abbildung der Instanz darf sich selbst außer an den Endpunkten schneiden.

• Keine zwei Abbildungen einer Instanz dürfen sich an einem Punkt schneiden, der nicht auf den Umrisslinien dieser beiden Abbildungen liegt.

So bestimmen Sie, ob eine Instanz einfach ist
STIsSimple.

Begrenzung, Innenbereich und Außenbereich

Das Innere eines geometry instance ist der Raum, der vom instance eingenommen wird, und das Äußere ist der Raum, den er nicht belegt.

DieBegrenzung wird vom OGC wie folgt definiert:

• Point- und MultiPoint-Instanzen haben keine Begrenzung.

• Die Begrenzung von LineString- und MultiLineString-Instanzen werden durch die Anfangs- und Endpunkte gebildet, wobei die Punkte entfernt werden, die eine gerade Anzahl von Malen vorkommen.

DECLARE @g geometry;  
SET @g = geometry::Parse('MULTILINESTRING((0 1, 0 0, 1 0, 0 1), (1 1, 1 0))');  
SELECT @g.STBoundary().ToString();  

Die Begrenzung einer Polygon- oder MultiPolygon-Instanz besteht aus der Menge ihrer Ringe.

DECLARE @g geometry;  
SET @g = geometry::Parse('POLYGON((0 0, 3 0, 3 3, 0 3, 0 0), (1 1, 1 2, 2 2, 2 1, 1 1))');  
SELECT @g.STBoundary().ToString();  

So geben Sie die Begrenzung einer Instanz zurück
STBoundary

Umschlag

Der Umschlag eines geometry instance, auch als Begrenzungsrahmen bezeichnet, ist das achsenorientierte Rechteck, das von den minimalen und maximalen (X,Y)-Koordinaten des instance gebildet wird.

So geben Sie den Umschlag einer Instanz zurück
STEnvelope

Abschluss

Ein geschlossenergeometry instance ist eine Abbildung, deren Start- und Endpunkte identisch sind. Alle Polygon-Instanzen gelten als geschlossen. Alle Point-Instanzen gelten als nicht geschlossen.

Ein Ring ist eine einfache, geschlossene LineString-Instanz.

So bestimmen Sie, ob eine Instanz abgeschlossen ist
STIsClosed

So bestimmen Sie, ob eine Instanz ein Ring ist
STIsRing

So geben Sie den äußeren Ring einer Polygoninstanz zurück
STExteriorRing

So geben Sie die Anzahl der inneren Ringen in einer Polygoninstanz zurück
STNumInteriorRing

So geben Sie einen gegebenen inneren Ring einer Polygoninstanz zurück
STInteriorRingN

SRID (Spatial Reference ID)

Der SRID (Spatial Reference ID) ist ein Bezeichner, der das Koordinatensystem angibt, in dem die geometry-Instanz dargestellt wird. Zwei Instanzen mit unterschiedlichen SRIDs können nicht verglichen werden.

So können Sie die SRID einer Instanz festlegen oder zurückgeben
STSrid

Diese Eigenschaft kann geändert werden.

Bestimmen der Beziehungen zwischen geometry-Instanzen

Der geometry-Datentyp stellt viele integrierte Methoden zur Verfügung, mit denen die Beziehungen zwischen zwei geometry-Instanzen bestimmt werden können.

So bestimmen Sie, ob zwei Instanzen die gleiche Punktmenge umfassen
STEquals

So bestimmen Sie, ob zwei Instanzen disjunkt sind
STDisjoint

So bestimmen Sie, ob sich zwei Instanzen überschneiden
STIntersects

So bestimmen Sie, ob sich zwei Instanzen berühren
STTouches

So bestimmen Sie, ob sich zwei Instanzen überlappen
STOverlaps

So bestimmen Sie, ob sich zwei Instanzen überkreuzen
STCrosses

So bestimmen Sie, ob eine Instanz sich innerhalb einer anderen befindet
STWithin

So bestimmen Sie, ob eine Instanz eine andere enthält
STContains

So bestimmen Sie, ob eine Instanz eine andere überlappt
STOverlaps

So bestimmen Sie, ob zwei Instanzen räumlich verbunden sind
STRelate

So bestimmen Sie die kürzeste Entfernung zwischen Punkten in zwei Geometrien
STDistance

geometry-Instanzen haben standardmäßig die SRID 0 (null)

Die STANDARD-SRID für geometry Instanzen in SQL Server ist 0. Bei räumlichen geometry-Daten ist zur Ausführung von Berechnungen des SRID der Räumlichkeitsinstanz nicht erforderlich. Daher können sich Instanzen in einer undefinierten ebenen Fläche befinden. Um den nicht definierten planaren Raum in den Berechnungen von geometry Datentypmethoden anzugeben, verwendet die SQL Server Datenbank-Engine SRID 0.

Beispiele

Die folgenden zwei Beispiele zeigen, wie Geometriedaten hinzugefügt und abgefragt werden.

• Im ersten Beispiel wird eine Tabelle mit einer Identitätsspalte und der geometry -Spalte GeomCol1erstellt. Eine dritte Spalte rendert die geometry -Spalte als Darstellung im Open Geospatial Consortium (OGC) WKT-Format und verwendet die STAsText() -Methode. Dann werden zwei Zeilen eingefügt: Eine Zeile enthält eine LineString -Instanz des Typs geometryund die andere eine Polygon -Instanz.

  IF OBJECT_ID ( 'dbo.SpatialTable', 'U' ) IS NOT NULL   
      DROP TABLE dbo.SpatialTable;  
  GO  
  
  CREATE TABLE SpatialTable   
      ( id int IDENTITY (1,1),  
      GeomCol1 geometry,   
      GeomCol2 AS GeomCol1.STAsText() );  
  GO  
  
  INSERT INTO SpatialTable (GeomCol1)  
  VALUES (geometry::STGeomFromText('LINESTRING (100 100, 20 180, 180 180)', 0));  
  
  INSERT INTO SpatialTable (GeomCol1)  
  VALUES (geometry::STGeomFromText('POLYGON ((0 0, 150 0, 150 150, 0 150, 0 0))', 0));  
  GO  
  

• Im zweiten Beispiel werden mithilfe der STIntersection() -Methode die Punkte zurückgegeben, an denen die beiden zuvor eingegebenen geometry -Instanzen sich schneiden.

  DECLARE @geom1 geometry;  
  DECLARE @geom2 geometry;  
  DECLARE @result geometry;  
  
  SELECT @geom1 = GeomCol1 FROM SpatialTable WHERE id = 1;  
  SELECT @geom2 = GeomCol1 FROM SpatialTable WHERE id = 2;  
  SELECT @result = @geom1.STIntersection(@geom2);  
  SELECT @result.STAsText();  
  

Weitere Informationen

Räumliche Daten (SQL Server)