sp_help_spatial_geometry_histogram (Transact-SQL)
Facilita o chaveamento da caixa delimitadora e dos parâmetros de grade de um índice espacial.
Sintaxe
sp_help_spatial_geometry_histogram [ @tabname =] 'tabname'
[ , [ @colname = ] 'columnname' ]
[ , [ @resolution = ] 'resolution' ]
[ , [ @xmin = ] 'minx' ]
[ , [ @ymin = ] 'miny' ]
[ ,.[ @xmax = ] 'maxx' ]
[ , [ @ymax = ] 'maxy' ]
[ , [ @sample = ] 'sample' ]
Argumentos
[ @tabname =] 'tabname'
É o nome qualificado ou não da tabela para a qual o índice espacial foi especificado.As aspas somente serão requeridas se uma tabela qualificada for especificada. Se um nome completamente qualificado, incluindo um nome de banco de dados, for fornecido, o nome do banco de dados deverá ser o nome do banco de dados atual. tabname é sysname, sem padrão.
[ @colname = ] 'colname'
É o nome da coluna especial especificada. colname é sysname, sem padrão.[ @resolution = ] 'resolution'
É a resolução da caixa delimitadora. Os valores válidos são de 10 a 5000. resolution é um tinyint, sem padrão.[ @xmin = ] 'xmin'
É a propriedade de caixa delimitadora do mínimo de X. xmin é float, sem padrão.[ @ymin = ] 'ymin'
É a propriedade de caixa delimitadora do mínimo de Y. ymin é float, sem padrão.[ @xmax = ] 'xmax'
É a propriedade de caixa delimitadora do máximo de X. xmax é float, sem padrão.[ @ymax = ] 'ymax'
É a propriedade de caixa delimitadora do máximo de Y. ymax é float, sem padrão.[ @sample = ] 'sample'
É a porcentagem da tabela usada. Os valores válidos são de 0 a 100. sample é float. O valor padrão é 100.
Valor da propriedade/Valor do retorno
Um valor de tabela é retornado. A grade a seguir descreve o conteúdo da coluna da tabela.
Nome da coluna |
Tipo de dados |
Descrição |
|---|---|---|
cellid |
int |
Representa a ID exclusiva de cada célula. A contagem é iniciada a partir de 1. |
cell |
geometry |
É um polígono retangular que representa cada célula. A forma de célula é idêntica à forma de célula usada para a indexação espacial. |
row_count |
bigint |
Indica o número de objetos espaciais que estão tocando ou contendo a célula. |
Permissões
O usuário deve ser membro da função public. Exige a permissão READ ACCESS no servidor e no objeto.
Comentários
A guia SSMS espacial mostra uma representação gráfica dos resultados. Você pode consultar os resultados em relação à janela espacial para obter um número aproximado dos itens do resultado. Os objetos da tabela podem abranger mais de uma célula, portanto, a soma de células pode ser maior que o número de objetos reais.
Uma linha adicional pode ser adicionada ao conjunto de resultados que contém o número de objetos que estão fora da caixa delimitadora ou tocando a borda da caixa delimitadora. O cellid dessa linha é 0 e a cell dessa linha contém um LineString que representa a caixa delimitadora. Essa linha representa o espaço inteiro fora da caixa delimitadora.
Exemplos
O exemplo seguinte cria uma tabela de exemplo e, em seguida, chama sp_help_spatial_geometry_histogram na tabela.
USE AdventureWorksDW2012
GO
-- Set database compatibility for circular arc segments
ALTER DATABASE AdventureWorksDW2012
SET COMPATIBILITY_LEVEL = 110;
GO
-- Create table to execute sp_help_spatial_geometry_histogram on
CREATE TABLE TownSites
(
Location geometry NULL,
SiteName nvarchar(50) NULL
)
GO
-- Insert site data into table
DECLARE @g geometry;
SET @g = geometry::Parse('POINT(0 0)');
INSERT INTO TownSites(Location, SiteName)
SELECT @g, N'Booth Map';
SET @g = geometry::Parse('POLYGON((1 1, 1 2, 2 2, 2 1, 1 1))');
INSERT INTO TownSites(Location, SiteName)
SELECT @g, N'Town Hall';
SET @g = geometry::Parse('CURVEPOLYGON(COMPOUNDCURVE(CIRCULARSTRING(-1 0, 0 -1, 1 0),(1 0, 1 2, -1 0)))');
INSERT INTO TownSites(Location, SiteName)
SELECT @g, N'Main Park';
SET @g = geometry::Parse('CIRCULARSTRING(1 5, 2 2, 5 1)');
INSERT INTO TownSites(Location, SiteName)
SELECT @g, N'Main Road';
-- Call proc to see data within bounding box
EXEC sp_help_spatial_geometry_histogram @tabname = TownSites, @colname = Location, @resolution = 64, @xmin = -2, @ymin = -2, @xmax = 3, @ymax = 3, @sample = 100;
GO
DROP TABLE TownSites;
GO