sp_help_spatial_geometry_histogram(Transact-SQL)
공간 인덱스의 경계 상자 및 표 매개 변수의 키 지정을 용이하게 합니다.
구문
sp_help_spatial_geometry_histogram [ @tabname =] 'tabname'
[ , [ @colname = ] 'columnname' ]
[ , [ @resolution = ] 'resolution' ]
[ , [ @xmin = ] 'minx' ]
[ , [ @ymin = ] 'miny' ]
[ ,.[ @xmax = ] 'maxx' ]
[ , [ @ymax = ] 'maxy' ]
[ , [ @sample = ] 'sample' ]
인수
[ @tabname =] 'tabname'
공간 인덱스가 지정된 테이블의 정규화된 이름 또는 정규화되지 않은 이름입니다.따옴표는 정규화된 테이블이 지정된 경우에만 필요합니다. 데이터베이스 이름을 포함한 정규화된 이름인 경우 반드시 현재 데이터베이스의 이름을 사용해야 합니다. tabname은 sysname이며 기본값은 없습니다.
[ @colname = ] 'colname'
지정된 공간 열의 이름입니다. colname은 sysname이며 기본값은 없습니다.[ @resolution = ] 'resolution'
경계 상자의 해상도입니다. 유효한 값은 10에서 5000까지입니다. resolution은 tinyint이며 기본값은 없습니다.[ @xmin = ] 'xmin'
X 최소 경계 상자 속성입니다. xmin은 float이며 기본값은 없습니다.[ @ymin = ] 'ymin'
Y 최소 경계 상자 속성입니다. ymin은 float이며 기본값은 없습니다.[ @xmax = ] 'xmax'
X 최대 경계 상자 속성입니다. xmax는 float이며 기본값은 없습니다.[ @ymax = ] 'ymax'
Y 최대 경계 상자 속성입니다. ymax는 float이며 기본값은 없습니다.[ @sample = ] 'sample'
사용된 테이블의 백분율입니다. 유효한 값은 0부터 100까지입니다. sample은 float입니다. 기본값은 100입니다.
속성 값/반환 값
테이블 값이 반환됩니다. 다음 표에서는 테이블의 열 내용에 대해 설명합니다.
열 이름 |
데이터 형식 |
설명 |
|---|---|---|
cellid |
int |
각 셀의 고유한 ID를 나타내며 1부터 셉니다. |
cell |
geometry |
각 셀을 나타내는 사각의 다각형입니다. 셀 셰이프는 공간 인덱싱에 사용된 셀 셰이프와 동일합니다. |
row_count |
bigint |
셀에 접해 있거나 셀을 포함하는 공간 개체 수를 나타냅니다. |
사용 권한
사용자는 public 역할의 멤버여야 합니다. 서버 및 개체에 대한 READ ACCESS 권한이 필요합니다.
주의
SSMS 공간 탭은 결과를 그래픽으로 나타냅니다. 공간 창에서 결과를 쿼리하여 결과 항목의 대략적인 개수를 가져올 수 있습니다. 테이블의 개체가 셀 한 개를 넘어갈 수 있으므로 셀 합계는 실제 개체의 개수보다 클 수 있습니다.
경계 상자를 벗어나거나 경계 상자 테두리에 접해 있는 개체의 수가 포함된 결과 집합에 행이 추가로 삽입될 수 있습니다. 이 행의 cellid는 0이며 이 행의 cell에는 경계 상자를 나타내는 LineString이 포함됩니다. 이 행은 경계 상자 밖의 전체 공간을 나타냅니다.
예
다음 예에서는 샘플 테이블을 만든 다음 테이블에서 sp_help_spatial_geometry_histogram을 호출합니다.
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