Skip to content

sp-help-spatial-geography-index-xml-transact-sql.md

Latest commit

 

History

History
84 lines (62 loc) · 3.32 KB

sp-help-spatial-geography-index-xml-transact-sql.md

File metadata and controls

84 lines (62 loc) · 3.32 KB
title sp_help_spatial_geography_index_xml (Transact-SQL)
description Returns the name and value for a specified set of properties about a geography spatial index.
author markingmyname
ms.author maghan
ms.reviewer randolphwest
ms.date 06/23/2025
ms.service sql
ms.subservice system-objects
ms.topic reference
f1_keywords
sp_help_spatial_geography_index_xml_TSQL
sp_help_spatial_geography_index_xml
helpviewer_keywords
sp_help_spatial_geography_index_xml procedure
dev_langs
TSQL

sp_help_spatial_geography_index_xml (Transact-SQL)

[!INCLUDE SQL Server]

Returns the name and value for a specified set of properties about a geography spatial index. You can choose to return a core set of properties or all properties of the index.

Results are returned in an XML fragment that displays the name and value of the properties selected.

:::image type="icon" source="../../includes/media/topic-link-icon.svg" border="false"::: Transact-SQL syntax conventions

Syntax

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 and properties

See Spatial index stored procedures - arguments and properties.

Permissions

User must be assigned a public role to access the procedure. Requires READ ACCESS permission on the server and the object.

Remarks

Properties containing NULL values aren't included in the return set.

Examples

The following example uses sp_help_spatial_geography_index_xml to investigate the spatial index SIndx_SpatialTable_geography_col2 defined on table geography_col for the given query sample in @qs. This example returns the core properties of the specified index in an XML fragment that displays the name and value of the properties selected.

An XQuery is then run on the result set, returning a specific property.

DECLARE @qs AS GEOGRAPHY = 'POLYGON((-90.0 -180, -90 180.0, 90 180.0, 90 -180, -90 -180.0))';
DECLARE @x AS XML;

EXECUTE 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');

Similar to sp_help_spatial_geography_index, this stored procedure provides simpler programmatic access to the properties of a geography spatial index and reports the result set in XML.

The bounding box of a geography is the whole earth.

Related content