查询最近邻的空间数据

适用于:SQL ServerAzure 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 子句指示针对该查询要返回的对象数。

若要使用空间索引,最近邻查询必须满足以下要求:

  1. 空间索引必须存在于其中一个空间列上,并且 STDistance() 方法必须在 WHERE 和 ORDER BY 子句中使用该空间列。

  2. TOP 子句不能包含 PERCENT 语句。

  3. WHERE 子句必须包含 STDistance() 方法。

  4. 如果 WHERE 子句中有多个谓词,则必须使用 AND 连词将包含 STDistance() 方法的谓词连接到其他谓词。 STDistance() 方法不能位于 WHERE 子句的可选部分中。

  5. ORDER BY 子句中的第一个表达式必须使用 STDistance() 方法。

  6. ORDER BY 子句中第一个 STDistance() 表达式的排序顺序必须是 ASC。

  7. 必须筛选掉 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 子句,因此它无法使用空间索引。