适用于:SQL Server
Azure SQL 数据库
Azure SQL 托管实例
Microsoft Fabric 中的 SQL 分析终结点
Microsoft Fabric 中的仓库
Microsoft Fabric 中的 SQL 数据库
与空间数据一起使用的常见查询是最近的邻居查询。 最近的邻居查询用于查找与特定空间对象最近的空间对象。 例如,网站的门店查找器通常必须找到离客户位置最近的门店位置。
最近邻查询可以采用各种有效的查询格式编写,但要使最近邻查询使用空间索引,必须使用以下语法。
Syntax
SELECT TOP ( number )
[ WITH TIES ]
[ * | expression ]
[, ...]
FROM spatial_table_reference, ...
[ WITH
(
[ INDEX ( index_ref ) ]
[ , SPATIAL_WINDOW_MAX_CELLS = <value>]
[ ,... ]
)
]
WHERE
column_ref.STDistance ( @spatial_ object )
{
[ IS NOT NULL ] | [ < const ] | [ > const ]
| [ <= const ] | [ >= const ] | [ <> const ] ]
}
[ AND { other_predicate } ]
}
ORDER BY column_ref.STDistance ( @spatial_ object ) [ ,...n ]
[ ; ]
最近的邻居查询和空间索引
在 SQL Server 中,TOP 和 ORDER BY 子句用于对空间数据列执行最近邻查询。 对于空间列数据类型,ORDER BY 子句包含对 STDistance() 方法的调用。
TOP 子句指示针对该查询要返回的对象数。
若要使用空间索引,最近邻查询必须满足以下要求:
空间索引必须存在于其中一个空间列上,并且
STDistance()方法必须在WHERE和ORDER BY子句中使用该空间列。TOP子句不能包含PERCENT语句。WHERE子句必须包含STDistance()方法。如果
WHERE子句中有多个谓词,则必须使用AND连词将包含STDistance()方法的谓词连接到其他谓词。STDistance()方法不能位于WHERE子句的可选部分中。ORDER BY子句中的第一个表达式必须使用STDistance()方法。ORDER BY子句中第一个STDistance()表达式的排序顺序必须是ASC。必须筛选掉
STDistance返回NULL的所有行。
Warning
将 geography 或 geometry 数据类型用作参数的方法,如果这些类型的 SRID 不相同,则返回 NULL。
建议将新的空间索引分割用于在最近的邻域查询中使用的索引。 有关空间索引镶嵌的详细信息,请参阅 空间数据。
示例 1
下面的代码示例演示了可以使用空间索引的最近邻查询。 本示例使用 AdventureWorks2025 示例数据库中的 Person.Address 表。
Note
在 Azure SQL 数据库 和 Microsoft Fabric 中的 SQL 数据库中,该USE语句不可用。 相反,直接连接到目标数据库,运行剩余的代码样本。
USE AdventureWorks2022
GO
DECLARE @g geography = 'POINT(-121.626 47.8315)';
SELECT TOP(7) SpatialLocation.ToString(), City FROM Person.Address
WHERE SpatialLocation.STDistance(@g) IS NOT NULL
ORDER BY SpatialLocation.STDistance(@g);
在 SpatialLocation 列上创建空间索引,以查看最近的邻居查询如何使用空间索引。 有关创建空间索引的详细信息,请参阅 Create, Modify, and Drop Spatial Indexes。
示例 2
下面的代码示例演示了无法使用空间索引的最接近的邻居查询。
Note
在 Azure SQL 数据库 和 Microsoft Fabric 中的 SQL 数据库中,该USE语句不可用。 相反,直接连接到目标数据库,运行剩余的代码样本。
USE AdventureWorks2022
GO
DECLARE @g geography = 'POINT(-121.626 47.8315)';
SELECT TOP(7) SpatialLocation.ToString(), City FROM Person.Address
ORDER BY SpatialLocation.STDistance(@g);
该查询缺少使用 STDistance() 且形式如语法部分所指定的 WHERE 子句,因此它无法使用空间索引。