sp_help_spatial_geometry_histogram (Transact-SQL)

Erleichtert es, Begrenzungsrahmen und Rasterparameter für einen räumlichen Index mit Schlüsseln zu versehen.

Syntax

sp_help_spatial_geometry_histogram [ @tabname =] 'tabname' 
     [ , [ @colname = ] 'columnname' ] 
     [ , [ @resolution = ] 'resolution' ]
     [ , [ @xmin = ] 'minx' ] 
     [ , [ @ymin = ] 'miny' ] 
     [ ,.[ @xmax = ] 'maxx' ]
     [ , [ @ymax = ] 'maxy' ]
     [ , [ @sample = ] 'sample' ]

Argumente

• [ @tabname =] 'tabname'
  Der qualifizierte oder nicht qualifizierte Name der Tabelle, für die der Räumlichkeitsindex angegeben wurde.

  Anführungszeichen sind nur dann erforderlich, wenn eine qualifizierte Tabelle angegeben wird. Bei Angabe eines vollqualifizierten Namens, einschließlich eines Datenbanknamens, muss es sich bei dem Datenbanknamen um den Namen der aktuellen Datenbank handeln. tabname ist vom Datentyp sysname und hat keinen Standardwert.

• [ @colname = ] 'colname'
  Dies ist der Namen der angegebenen räumlichen Spalte. colname ist vom Datentyp sysname und hat keinen Standardwert.

• [ @resolution = ] 'resolution'
  Ist die Auflösung des Begrenzungsrahmens. Werte von 10 bis 5000 sind gültig. resolution ist vom Datentyp tinyint und besitzt keinen Standardwert.

• [ @xmin = ] 'xmin'
  Dies ist die X-Minimum-Eigenschaft des Begrenzungsrahmens. xmin ist vom Datentyp float und hat keinen Standardwert.

• [ @ymin = ] 'ymin'
  Dies ist die Y-Minimum-Eigenschaft des Begrenzungsrahmens. ymin ist vom Datentyp float und hat keinen Standardwert.

• [ @xmax = ] 'xmax'
  Dies ist die X-Maximum-Eigenschaft des Begrenzungsrahmens. xmax ist vom Datentyp float und hat keinen Standardwert.

• [ @ymax = ] 'ymax'
  Dies ist die Y-Maximum-Eigenschaft des Begrenzungsrahmens. ymax ist vom Datentyp float und hat keinen Standardwert.

• [ @sample = ] 'sample'
  Ist der verwendete Prozentsatz der Tabelle. Werte zwischen 0 und 100 sind gültig. sample ist vom Datentyp float. Der Standardwert ist 100.

Eigenschaftswert/Rückgabewert

Ein Tabellenwert wird zurückgegeben. In der folgenden Tabelle wird der Spalteninhalt der Tabelle beschrieben.

Berechtigungen

Der Benutzer muss ein Mitglied der Datenbankrolle public sein. Erfordert die READ ACCESS-Berechtigung für den Server und das Objekt.

Hinweise

Auf der räumlichen SSMS-Registerkarte wird eine grafische Darstellung der Ergebnisse angezeigt. Sie können die Ergebnisse für das räumliche Fenster abfragen, um die ungefähre Anzahl von Ergebniselementen abzurufen. Objekte in der Tabelle decken möglicherweise mehrere Zellen ab, daher ist die Summe der Zellen möglicherweise größer als die Anzahl der tatsächlichen Objekte.

Eine zusätzliche Zeile mit der Anzahl der Objekte, die sich außerhalb des Begrenzungsrahmens befinden oder den Rahmen des Begrenzungsrahmens berühren, kann dem Resultset hinzugefügt werden. Die cellid dieser Zeile ist 0, und die cell dieser Zeile enthält eine LineString, die den Begrenzungsrahmen darstellt. Diese Zeile stellt den gesamten Bereich außerhalb des Begrenzungsrahmens dar.

Beispiele

Im folgenden Beispiel wird eine Beispieltabelle erstellt, und sp_help_spatial_geometry_histogram wird für die Tabelle aufgerufen.

USE AdventureWorksDW2012

GO

-- Set database compatibility for circular arc segments

ALTER DATABASE AdventureWorksDW2012

SET COMPATIBILITY_LEVEL = 110;

GO

-- Create table to execute sp_help_spatial_geometry_histogram on

CREATE TABLE TownSites

(

Location geometry NULL,

SiteName nvarchar(50) NULL

)

GO

-- Insert site data into table

DECLARE @g geometry;

SET @g = geometry::Parse('POINT(0 0)');

INSERT INTO TownSites(Location, SiteName)

SELECT @g, N'Booth Map';

SET @g = geometry::Parse('POLYGON((1 1, 1 2, 2 2, 2 1, 1 1))');

INSERT INTO TownSites(Location, SiteName)

SELECT @g, N'Town Hall';

SET @g = geometry::Parse('CURVEPOLYGON(COMPOUNDCURVE(CIRCULARSTRING(-1 0, 0 -1, 1 0),(1 0, 1 2, -1 0)))');

INSERT INTO TownSites(Location, SiteName)

SELECT @g, N'Main Park';

SET @g = geometry::Parse('CIRCULARSTRING(1 5, 2 2, 5 1)');

INSERT INTO TownSites(Location, SiteName)

SELECT @g, N'Main Road';

-- Call proc to see data within bounding box

EXEC sp_help_spatial_geometry_histogram @tabname = TownSites, @colname = Location, @resolution = 64, @xmin = -2, @ymin = -2, @xmax = 3, @ymax = 3, @sample = 100;

GO

DROP TABLE TownSites;

GO

Siehe auch

Andere Ressourcen

Gespeicherte Prozeduren für Räumlichkeitsindizes (Transact-SQL)