Tipos espaciais - geometria (Transact-SQL)

Aplica-se a:SQL ServerBase de Dados SQL do AzureAzure SQL Managed InstanceBase de dados SQL no Microsoft Fabric

O tipo de dados espaciais planares, geometry, é implementado como um tipo de dados CLR (Common Language Runtime) no SQL Server. Este tipo representa dados em um sistema de coordenadas euclidiano (plano).

O SQL Server dá suporte a um conjunto de métodos para o tipo de dados espaciais de geometria . Esses métodos incluem métodos em geometria que são definidos pelo padrão Open Geospatial Consortium (OGC) e um conjunto de extensões da Microsoft para esse padrão.

A tolerância a erros para os métodos de geometria pode ser tão grande quanto 1.0e-7 * extensões. As extensões referem-se à distância máxima aproximada entre pontos do objeto de geometria .

Registar o tipo de geometria

O tipo de geometria é predefinido e está disponível em cada base de dados. Você pode criar colunas de tabela de geometria de tipo e operar em dados de geometria da mesma maneira que usaria outros tipos de CLR. O tipo pode ser usado em colunas computadas persistentes e não persistentes.

Conversion

A conversão de geometria para binário, varbinário, char, varchar, nchar e nvarchar deve ser explícito. Utilizar CAST ou CONVERT.

A conversão de binário, varbinário, char, varchar, nchar e nvarchar para geometria pode ser implícita ou explícita.

A conversão entre geometria e todos os outros tipos de dados não é permitida. Isto inclui a conversão entre geometria e geografia. Para mover dados entre estes dois tipos, utilize-se os métodos Well-Known Binary (WKB) ou Well-Known Text (WKT), por exemplo STAsBinary() com STGeomFromWKB().

A conversão de um tipo de corda para geometria usa as mesmas regras que geometry::Parse(). A cadeia tem de ser Well-Known Texto. O SRID do resultado é 0.

A conversão entre geometria e binário ou varbinário utiliza o formato SQL Server de serialização nativa da geometria, não Well-Known Binário. Um valor binário Well-Known causa um erro. Para converter para ou a partir de Well-Known binário, use STAsBinary() e STGeomFromWKB().

Se a cadeia alvo ou o tipo binário for demasiado curto para o valor geométrico , ocorre um erro. O valor não é truncado.

Remarks

Na base de dados SQL no Microsoft Fabric, os tipos de dados geográficos e geométricos são suportados, mas não podem ser espelhados para o Fabric OneLake.

Examples

A. Mostrar como adicionar e consultar dados de geometria

Os dois exemplos a seguir mostram como adicionar e consultar dados de geometria. O primeiro exemplo cria uma tabela com uma coluna de identidade e uma geometry coluna, GeomCol1. Uma terceira coluna processa a geometry coluna em sua representação Open Geospatial Consortium (OGC) Well-Known Text (WKT) e usa o STAsText() método. Duas linhas são então inseridas: uma linha contém uma LineString instância de geometry, e uma linha contém uma Polygon instância.

IF OBJECT_ID('dbo.SpatialTable', 'U') IS NOT NULL
    DROP TABLE dbo.SpatialTable;
GO

CREATE TABLE SpatialTable
(
    id INT IDENTITY (1, 1),
    GeomCol1 geometry,
    GeomCol2 AS GeomCol1.STAsText()
);
GO

INSERT INTO SpatialTable
(
    GeomCol1
)
VALUES (geometry::STGeomFromText('LINESTRING (100 100, 20 180, 180 180)', 0));

INSERT INTO SpatialTable
(
    GeomCol1
)
VALUES (geometry::STGeomFromText('POLYGON ((0 0, 150 0, 150 150, 0 150, 0 0))', 0));
GO

B. Devolva a interseção de duas instâncias de geometria

O segundo exemplo usa o STIntersection() método para retornar os pontos onde as duas instâncias inseridas geometry anteriormente se cruzam.

DECLARE @geom1 AS geometry;
DECLARE @geom2 AS geometry;
DECLARE @result AS geometry;

SELECT @geom1 = GeomCol1
FROM SpatialTable
WHERE id = 1;

SELECT @geom2 = GeomCol1
FROM SpatialTable
WHERE id = 2;

SELECT @result = @geom1.STIntersection(@geom2);

SELECT @result.STAsText();

C. Usar geometria numa coluna calculada

O exemplo a seguir cria uma tabela com uma coluna computada persistente usando um tipo de geometria .

IF OBJECT_ID('dbo.SpatialTable', 'U') IS NOT NULL
    DROP TABLE dbo.SpatialTable;
GO

CREATE TABLE SpatialTable
(
    locationId INT IDENTITY (1, 1),
    location geometry,
    deliveryArea AS location.STBuffer(10) PERSISTED
);

Conteúdo relacionado

• Dados Espaciais