空間類型 - 幾何(Transact-SQL)

適用於:SQL ServerAzure SQL DatabaseAzure SQL 受控執行個體Microsoft Fabric 中的 SQL 資料庫

平面空間資料類型 geometry 在 SQL Server 中是實作為通用語言執行平台 (CLR) 資料類型。 此類型代表以 Euclidean (平面) 座標系統表示的資料。

SQL Server 支援一組 geometry 空間資料類型方法。 這些方法包括「開放地理空間協會」(OGC) 標準及該標準的一組 Microsoft 延伸模組所定義的 geometry 相關方法。

geometry 方法的誤差容許範圍可以大到 1.0e-7 *。 範圍是指 幾何 物件點之間的近似最大距離。

註冊幾何類型

geometry 類型已預先定義,而且可在每一個資料庫中使用。 您可以建立 geometry 類型的資料表資料行,並使用與其他 CLR 類型相同的方式來操作 geometry 資料。 此型別可用於持久化與非持久化計算欄位。

Conversion

從 幾何 轉換為二 元、 變數、 char、 varchar、 nchar 和 nvarchar 必須明確。 使用 CAST 或 CONVERT。

從 二元、 變數、 char、 varchar、 nchar 和 nvarchar 轉換成幾 何 ,可以是隱含的,也可以是顯式的。

不允許在 幾何 體和其他資料型態之間轉換。 這包括幾 何 與 地理之間的轉換。 若要在這兩種類型間移動資料,請使用 Well-Known 二進位(WKB)或 Well-Known 文字(WKT)方法,例如STAsBinary()將 。STGeomFromWKB()

從字串類型轉換為 幾何 體時,使用與 geometry::Parse()相同的規則。 字串必須是 Well-Known Text。 結果的 SRID 為 0。

幾何與二進位或變數進制之間的轉換使用SQL Server原生序列化格式,而非 Well-Known 二進位。 Well-Known 二進位值會造成錯誤。 若要轉換成或從二進位轉換 Well-Known,請使用 STAsBinary() 和 STGeomFromWKB()。

如果目標字串或二進位型別對幾 何 值來說太短,就會發生錯誤。 價值沒有被截斷。

Remarks

在 Microsoft Fabric 的 SQL 資料庫中,支援地理與幾何資料型別,但無法鏡像至 Fabric OneLake。

Examples

A. 展示如何新增與查詢幾何資料

下列兩個範例示範如何加入及查詢幾何資料。 第一個範例會建立具有識別資料行及 geometry 資料行 GeomCol1 的資料表。 第三個資料行會將 geometry 資料行轉譯成它的開放地理空間協會 (Open Geospatial Consortium,OGC) 已知的文字 (Well-Known Text,WKT) 表示法,並使用 STAsText() 方法。 然後會插入兩個資料列:一個資料列包含 LineString 的 geometry執行個體,另一個資料列包含 Polygon 執行個體。

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. 回傳兩個幾何實例的交集

第二個範例使用 STIntersection() 方法傳回之前插入之兩個 geometry 執行個體相交的點。

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. 在計算出的欄位中使用幾何形狀

下列範例會使用 geometry 類型來建立含有保存之計算資料行的資料表。

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