Share via


sp_help_spatial_geometry_index_xml (Transact-SQL)

S’applique à :SQL Server

Retourne les noms et les valeurs d’un ensemble spécifié de propriétés sur un index spatial geometry . 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_geometry_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 membre du rôle public . Nécessite READ ACCESS une autorisation sur le serveur et l’objet.

Notes

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

Exemples

L’exemple suivant utilise sp_help_spatial_geometry_index_xml pour examiner l’index SIndx_SpatialTable_geometry_col2 spatial défini sur la table geometry_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 base XQuery est ensuite exécutée sur le jeu de résultats, en retournant une propriété spécifique.

DECLARE @qs geometry = 'POLYGON((-90.0 -180.0, -90.0 180.0, 90.0 180.0, 90.0 -180.0, -90.0 -180.0))';
DECLARE @x XML;

EXEC sp_help_spatial_geometry_index_xml 'geometry_col',
    'SIndx_SpatialTable_geometry_col2',
    0,
    @qs,
    @x OUTPUT;

SELECT @x.value('(/Primary_Filter_Efficiency/text())[1]', 'float');

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