Kueri Data Spasial untuk Tetangga Terdekat

Kueri umum yang digunakan dengan data spasial adalah kueri Tetangga Terdekat. Kueri Tetangga terdekat digunakan untuk menemukan objek spasial terdekat dengan objek spasial tertentu. Misalnya, penemu toko untuk situs Web sering kali harus menemukan lokasi toko terdekat dengan lokasi pelanggan.

Kueri Tetangga Terdekat dapat ditulis dalam berbagai format kueri yang valid, tetapi agar kueri Tetangga Terdekat menggunakan indeks spasial, sintaks berikut harus digunakan.

Sintaksis

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

Kueri Tetangga terdekat dan Indeks Spasial

Di SQL Server, TOP dan ORDER BY klausul digunakan untuk melakukan kueri Tetangga Terdekat pada kolom data spasial. Klausa ORDER BY berisi panggilan ke STDistance() metode untuk jenis data kolom spasial. Klausa TOP menunjukkan jumlah objek yang akan dikembalikan untuk kueri.

Persyaratan berikut harus dipenuhi untuk kueri Tetangga Terdekat untuk menggunakan indeks spasial:

1. Indeks spasial harus ada di salah satu kolom spasial dan metode tersebut harus menggunakan kolom tersebut dalam klausa STDistance() dan WHERE.

2. Klausa TOP tidak boleh berisi PERCENT pernyataan.

3. Klausa WHERE harus berisi STDistance() metode .

4. Jika ada beberapa predikat dalam klausul WHERE, maka predikat yang berisi metode STDistance() harus dihubungkan dengan predikat lain menggunakan konjungsi AND. Metode STDistance() tidak dapat berada di bagian opsional dari WHERE klausul.

5. Ekspresi pertama dalam ORDER BY klausa harus menggunakan STDistance() metode .

6. Urutan pengurutan untuk ekspresi pertama STDistance() dalam ORDER BY klausul harus ASC.

7. Semua baris yang STDistance pengembaliannya NULL harus disaring.

Peringatan

Metode yang mengambil geography atau geometry jenis data sebagai argumen akan kembali NULL jika SRID tidak sama untuk jenisnya.

Disarankan agar tessellasi indeks spasial baru digunakan untuk indeks yang digunakan dalam kueri Tetangga Terdekat. Untuk informasi selengkapnya tentang tesselulasi indeks spasial, lihat Data Spasial (SQL Server).

Contoh

Contoh kode berikut menunjukkan kueri Tetangga Terdekat yang bisa menggunakan indeks spasial. Contoh menggunakan Person.Address tabel dalam AdventureWorks2012 database.

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

Buat indeks spasial pada kolom SpatialLocation untuk melihat bagaimana kueri Tetangga Terdekat menggunakan indeks spasial. Untuk informasi selengkapnya tentang membuat indeks spasial, lihat Membuat, Memodifikasi, dan Menghilangkan Indeks Spasial.

Contoh

Contoh kode berikut menunjukkan kueri Tetangga Terdekat yang tidak dapat menggunakan indeks spasial.

USE AdventureWorks2012  
GO  
DECLARE @g geography = 'POINT(-121.626 47.8315)';  
SELECT TOP(7) SpatialLocation.ToString(), City FROM Person.Address  
ORDER BY SpatialLocation.STDistance(@g);  
  

Kueri tidak memiliki klausa WHERE yang menggunakan STDistance() dalam bentuk yang ditentukan di bagian sintaks, sehingga kueri tidak dapat menggunakan indeks spasial.

Lihat Juga

Data Spasial (SQL Server)