sp_help_spatial_geography_index_xml (Transact-SQL)

  • Article

S’applique à :SQL Server

Retourne le nom et la valeur d’un ensemble de propriétés spécifié concernant un index spatial geography . Vous pouvez choisir de retourner un jeu principal de propriétés ou toutes les propriétés de l'index.

Les résultats sont retournés dans un fragment XML qui affiche le nom et la valeur des propriétés sélectionnées.

Conventions de la syntaxe Transact-SQL

Syntaxe

  
sp_help_spatial_geography_index_xml [ @tabname =] 'tabname'   
     [ , [ @indexname = ] 'indexname' ]   
     [ , [ @verboseoutput = ] 'verboseoutput' ]   
     [ , [ @query_sample = ] 'query_sample' ]   
     [ ,.[ @xml_output = ] 'xml_output' ]

Arguments

Consultez Arguments et propriétés des procédures stockées d’index spatial.

Propriétés

Consultez Arguments et propriétés des procédures stockées d’index spatial.

Autorisations

L'utilisateur doit être assigné un rôle PUBLIC pour accéder à la procédure. Nécessite une autorisation READ ACCESS sur le serveur et l'objet.

Remarques

Les propriétés qui contiennent des valeurs NULL ne sont pas incluses dans le jeu de retour.

Exemple

L’exemple suivant utilise sp_help_spatial_geography_index_xml pour examiner l’index spatial SIndx_SpatialTable_geography_col2 défini sur le geography_col de table pour l’exemple de requête donné dans @qs. Cet exemple retourne les propriétés principales de l'index spécifié dans un fragment XML qui affiche le nom et la valeur des propriétés sélectionnées.

Une requête XQuery est ensuite exécutée sur le jeu de résultats, renvoyant une propriété spécifique.

declare @qs geography  
        ='POLYGON((-90.0 -180, -90 180.0, 90 180.0, 90 -180, -90 -180.0))';  
declare @x xml;  
exec sp_help_spatial_geography_index_xml 'geography_col', 'SIndx_SpatialTable_geography_col2', 0, @qs, @x output;  
select @x.value('(/Primary_Filter_Efficiency/text())[1]', 'float');

Comme pour sp_help_spatial_geography_index, cette procédure stockée offre un accès par programme plus simple aux propriétés d’un index spatial geography et signale le jeu de résultats en XML.

Le cadre englobant d’une géographie est la terre entière.

Spécifications

Voir aussi

Procédures stockées d'index spatial
sp_help_spatial_geography_index
Vue d’ensemble des index spatiaux
Données spatiales (SQL Server)
Concepts de base de XQuery
Informations de référence sur le langage XQuery