STRelate (тип данных geometry)

  • Статья

Применяется к:SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure Управляемый экземпляр SQL Azure sql analytics в хранилище Microsoft Fabricв Microsoft Fabric

Возвращает значение 1, если экземпляр geometry связан с другим экземпляром geometry, где связь определяется значением шаблона матрицы DE-9IM; в противном случае возвращается 0.

Синтаксис

  
.STRelate ( other_geometry, intersection_pattern_matrix )

Примечание.

Сведения о синтаксисе Transact-SQL для SQL Server 2014 (12.x) и более ранних версиях см . в документации по предыдущим версиям.

Аргументы

other_geometry
Другой экземпляр geometry для сравнения с экземпляром, для которого вызван метод STRelate().

intersection_pattern_matrix
Строка типа nchar(9) кодирует приемлемые значения для устройства шаблона матрицы DE-9IM между двумя экземплярами geometry.

Замечания

Этот метод всегда возвращает значение NULL, если у экземпляров geometry не совпадают идентификаторы пространственных ссылок (SRID). Этот метод вызывает исключение ArgumentException, если формат матрицы неправильный.

Типы возвращаемых данных

Тип возвращаемого значения SQL Server: bit

Тип возвращаемых данных CLR: SqlBoolean

Примеры

В приведенном ниже примере используется STRelate(), чтобы проверить отсутствие пространственного перекрытия двух экземпляров geometry с использованием явного шаблона DE-9IM.

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

См. также

Методы OGC в экземплярах Geometry