Share via


sp_help_spatial_geography_histogram (Transact-SQL)

Gilt für:SQL Server

Ermöglicht es, Rasterparameter für einen räumlichen Index mit Schlüsseln zu versehen.

Syntax

sp_help_spatial_geography_histogram
    [ @tabname = ] N'tabname'
    , [ @colname = ] N'colname'
    , [ @resolution = ] resolution
    [ , [ @sample = ] sample ]
[ ; ]

Argumente

[ @tabname = ] N'tabname'

Der qualifizierte oder nicht qualifizierte Name der Tabelle, für die der räumliche Index angegeben wurde. @tabname ist "sysname" ohne Standard.

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.

[ @colname = ] N'colname'

Der Name der angegebenen räumlichen Spalte. @colname ist "sysname" ohne Standard.

[ @resolution = ] Auflösung

Die Auflösung des umgebenden Felds. Werte zwischen 10 und 5000 sind gültig. @resolution ist "int" ohne Standard.

[ @sample = ] Beispiel

Der Prozentsatz der verwendeten Tabelle. Gültige Werte liegen zwischen 0 und 100. @sample ist float, mit einem Standardwert von 100.

Rückgabewerte

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

Spaltenname Datentyp BESCHREIBUNG
cellid int Stellt die eindeutige ID jeder Zelle mit einer Anfangsanzahl von 1 dar.
cell geography Ein rechteckiges Polygon, das jede Zelle darstellt. Die Zellenform ist mit der für die räumliche Indizierung verwendeten Zellenform identisch.
row_count bigint Gibt die Anzahl räumlicher Objekte an, die die Zelle berühren oder enthalten.

Berechtigungen

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

Hinweise

Die räumliche Registerkarte SQL Server Management Studio (SSMS) zeigt eine grafische Darstellung der Ergebnisse. Sie können die Ergebnisse für das räumliche Fenster abfragen, um die ungefähre Anzahl von Ergebniselementen abzurufen.

Hinweis

Objekte in der Tabelle können mehr als eine Zelle abdecken, sodass die Summe der Zellen in der Tabelle größer als die Anzahl der tatsächlichen Objekte sein kann.

Das Begrenzungsfeld für den Geografietyp ist der gesamte Globus.

Beispiele

Im folgenden Beispiel wird die Tabelle in der Person.Address AdventureWorks2022-Datenbank aufgerufensp_help_spatial_geography_histogram.

EXEC sp_help_spatial_geography_histogram
    @tabname = Person.Address,
    @colname = SpatialLocation,
    @resolution = 64,
    @sample = 30;