sp_help_spatial_geography_histogram (Transact-SQL)

Article
05/11/2023

S’applique à :SQL Server

Facilite le codage des paramètres de grille pour un index spatial.

Syntaxe

  
sp_help_spatial_geography_histogram [ @tabname =] 'tabname'   
     [ , [ @colname = ] 'columnname' ]   
     [ , [ @resolution = ] 'resolution' ]  
     [ , [ @sample = ] 'tablesample' ]

Arguments

[ @tabname = ] 'tabname' Nom qualifié ou non qualifié de la table pour laquelle l’index spatial a été spécifié.

Les guillemets ne sont nécessaires que si une une table qualifiée est spécifiée. Si un nom qualifié complet (incluant un nom de base de données) est fourni, le nom de base de données doit être celui de la base de données active. tabname est sysname, sans valeur par défaut.

[ @colname = ] 'columnname' Nom de la colonne spatiale spécifiée. columnname est un nom sys, sans valeur par défaut.

[ @resolution = ] 'resolution' Résolution du cadre englobant. Les valeurs possibles sont comprises entre 10 et 5000. résolution est un tinyint, sans valeur par défaut.

[ @sample = ] 'sample' Pourcentage de la table utilisée. Les valeurs valides sont comprises entre 0 et 100. tableample est un float. La valeur par défaut est 100.

Valeur de propriété/valeur de retour

Une valeur de table est retournée. La grille suivante décrit le contenu de colonne de la table.

Nom de la colonne	Type de données	Description
cellid	int	Représente l'ID unique de chaque cellule, avec un nombre initial de 1.
Cellule	Geography	Polygone rectangulaire qui représente chaque cellule. La forme de cellule est identique à la forme de cellule utilisée pour l'indexation spatiale.
row_count	bigint	Indique le nombre d'objets spatiaux qui touchent ou contiennent la cellule.

Autorisations

L’utilisateur doit être membre du rôle public . Nécessite une autorisation READ ACCESS sur le serveur et l'objet.

Remarques

L'onglet spatial SSMS affiche une représentation graphique des résultats. Vous pouvez interroger les résultats dans la fenêtre spatiale afin d'obtenir un nombre approximatif d'éléments de résultat.

Remarque

Les objets dans la table peuvent couvrir plusieurs cellules ; par conséquent, la somme de cellules de la table peut être supérieure au nombre d'objets réels.

Le cadre englobant pour le type geography est le globe entier.

Exemples

L’exemple suivant appelle sp_help_spatial_geography_histogram sur la Person.Address table dans la base de données AdventureWorks2022.

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

Voir aussi

Procédures stockées d'index spatial (Transact-SQL)