Share via


sp_help_spatial_geography_index_xml (Transact-SQL)

S’applique à :SQL Server

Retourne le nom et la valeur d’un ensemble spécifié de propriétés sur 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 = ] N'tabname'
    , [ @indexname = ] N'indexname'
    , [ @verboseoutput = ] verboseoutput
    , [ @query_sample = ] query_sample
    , [ @xml_output = ] N'xml_output' OUTPUT
[ ; ]

Arguments et propriétés

Consultez les procédures stockées d’index spatial : arguments et propriétés.

Autorisations

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

Notes

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

Exemples

L’exemple suivant utilise sp_help_spatial_geography_index_xml pour examiner l’index spatial SIndx_SpatialTable_geography_col2 défini sur la table geography_col 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, en retournant 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 fournit un accès programmatique plus simple aux propriétés d’un index spatial geography et signale le jeu de résultats en XML.

La zone englobante d’une zone géographique est la terre entière.