sp_help_spatial_geography_histogram (Transact-SQL)

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 de type sysname et n'a pas de valeur par défaut.

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

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

  • [ @sample = ] 'sample'
    Pourcentage de la table utilisée. Les valeurs possibles sont comprises entre 0 et 100. tablesample est de type 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.

cell

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.

Notes

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 rectangle englobant pour le type de geography est le globe entier.

Exemples

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

USE AdventureWorks2012

GO

ALTER DATABASE AdventureWorks2012

SET COMPATIBILITY_LEVEL = 110;

GO

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

GO

Voir aussi

Autres ressources

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