Consultar datos espaciales para el vecino más próximo

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

Una consulta frecuente utilizada con datos espaciales es la de vecino más cercano. Las consultas de vecino más cercano se emplean para encontrar los objetos espaciales más cercanos a un objeto espacial concreto. Por ejemplo, un buscador de tiendas de un sitio web debe encontrar a menudo las ubicaciones de las tiendas más cercanas a la ubicación de un cliente.

Se puede escribir una consulta de vecino más cercano en distintos formatos de consulta válidos, pero para que dicha consulta use un índice espacial se debe emplear la siguiente sintaxis.

Sintaxis

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 ]  
[ ; ]  
  

Consulta de vecino más cercano e índices espaciales

En SQL Server, las cláusulas TOP y ORDER BY se usan para realizar una consulta de vecino más próximo en columnas de datos espaciales. La cláusula ORDER BY contiene una llamada al método STDistance() para el tipo de datos de columna espacial. La cláusula TOP indica el número de objetos que se va a devolver para la consulta.

Se deben cumplir los siguientes requisitos para que una consulta de vecino más cercano utilice un índice espacial:

1. Debe haber un índice espacial en una de las columnas espaciales y el método STDistance() debe usar esa columna en las cláusulas WHERE y ORDER BY .

2. La cláusula TOP no puede contener una instrucción PERCENT .

3. La cláusula WHERE debe contener un método STDistance() .

4. Si hay varios predicados en la cláusula WHERE , el predicado que contiene el método STDistance() debe estar conectado por una conjunción AND a los demás predicados. El método STDistance() no puede estar en una parte opcional de la cláusula WHERE .

5. La primera expresión de la cláusula ORDER BY debe usar el método STDistance() .

6. El criterio de ordenación para la primera expresión STDistance() de la cláusula ORDER BY debe ser ASC.

7. Todas las filas para las que STDistance devuelve NULL se deben filtrar.

Se recomienda utilizar las nuevas teselaciones de índice espacial para los índices empleados en las consultas de vecino más cercano. Para obtener más información sobre las teselaciones de índice espacial, vea Datos espaciales (SQL Server).

Ejemplo 1

En el ejemplo de código siguiente se muestra una consulta de vecino más cercano que puede utilizar un índice espacial. El ejemplo utiliza la tabla Person.Address de la base de datos de ejemplo AdventureWorks2022.

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

Cree un índice espacial en la columna SpatialLocation para ver cómo una consulta de vecino más cercano utiliza un índice espacial. Para obtener más información sobre cómo crear índices espaciales, vea Create, Modify, and Drop Spatial Indexes.

Ejemplo 2

En el ejemplo de código siguiente se muestra una consulta de vecino más cercano que no puede utilizar un índice espacial.

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

A la consulta le falta una cláusula WHERE que usa STDistance() en un formato especificado en la sección de sintaxis, por lo que la consulta no puede usar un índice espacial.

Consulte también

Datos espaciales (SQL Server)