STRelate (geometry 資料類型)
適用於:Microsoft Fabric 中的 SQL Server
Azure SQL 資料庫
Azure SQL 受控執行個體
SQL 資料庫
如果 geometry 執行個體與另一個 geometry 執行個體有關 (關聯性是由 Dimensionally Extended 9 Intersection Model (DE-9IM) 模式矩陣值所定義),便傳回 1;否則會傳回 0。
語法
.STRelate ( other_geometry, intersection_pattern_matrix )
引數
other_geometry
這是要與叫用 STRelate()
所在之執行個體相比較的另一個 geometry 執行個體。
intersection_pattern_matrix
這是兩個 geometry 執行個體之間 DE-9IM 模式矩陣裝置的 nchar(9) 類型編碼可接受值字串。
備註
如果 geometry 執行個體的空間參考識別碼 (SRID) 不相符,這個方法一律會傳回 Null。 如果矩陣的格式不正確,這個方法將會擲回 ArgumentException。
傳回型別
SQL Server 傳回類型:bit
CLR 傳回類型:SqlBoolean
範例
下列範例會使用 STRelate()
,利用明確的 DE-9IM 模式測試兩個 geometry 執行個體是否在空間上不相鄰。
DECLARE @g geometry;
DECLARE @h geometry;
SET @g = geometry::STGeomFromText('LINESTRING(0 2, 2 0, 4 2)', 0);
SET @h = geometry::STGeomFromText('POINT(5 5)', 0);
SELECT @g.STRelate(@h, 'FF*FF****');