Partilhar via


sp_help_spatial_geography_index_xml (Transact-SQL)

Aplica-se: SQL Server

Retorna o nome e o valor de um conjunto especificado de propriedades sobre um índice espacial geography . Você pode escolher retornar um conjunto principal de propriedades ou todas as propriedades do índice.

Os resultados são retornados em um fragmento de XML que exibe o nome e valor das propriedades selecionadas.

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_help_spatial_geography_index_xml
    [ @tabname = ] N'tabname'
    , [ @indexname = ] N'indexname'
    , [ @verboseoutput = ] verboseoutput
    , [ @query_sample = ] query_sample
    , [ @xml_output = ] N'xml_output' OUTPUT
[ ; ]

Argumentos e propriedades

Consulte Procedimentos armazenados de índice espacial – argumentos e propriedades.

Permissões

O usuário deve receber uma função pública para acessar o procedimento. Requer permissão READ ACCESS no servidor e no objeto.

Comentários

As propriedades que contêm NULL valores não são incluídas no conjunto de retornos.

Exemplos

O exemplo a seguir usa sp_help_spatial_geography_index_xml para investigar o índice espacial SIndx_SpatialTable_geography_col2 definido na tabela geography_col para o exemplo de consulta fornecido em @qs. Este exemplo retorna as propriedades principais do índice especificado em um fragmento XML que exibe o nome e valor das propriedades selecionadas.

Em seguida, um XQuery é executado no conjunto de resultados, retornando uma propriedade específica.

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

Semelhante ao sp_help_spatial_geography_index, esse procedimento armazenado fornece acesso programático mais simples às propriedades de um índice espacial geography e relata o conjunto de resultados em XML.

A caixa delimitadora de uma geografia é toda a terra.