Prosedur tersimpan indeks spasial - argumen dan properti

Berlaku untuk:SQL Server

Artikel ini menjelaskan argumen dan properti untuk prosedur tersimpan indeks spasial.

Konvensi sintaks transact-SQL

Sintaks

Untuk sintaksis prosedur tersimpan indeks spasial tertentu, lihat artikel berikut ini:

Argumen

[ @tabname = ] N'tabname'

Nama tabel yang memenuhi syarat atau tidak memenuhi syarat yang indeks spasialnya telah ditentukan.

Tanda kutip diperlukan hanya jika tabel yang memenuhi syarat ditentukan. Jika nama yang sepenuhnya memenuhi syarat, termasuk nama database, disediakan, nama database harus menjadi nama database saat ini. @tabname adalah nvarchar(776), tanpa default.

[ @indexname = ] 'indexname'

Nama indeks spasial yang ditentukan. @indexname adalah sysname tanpa default.

[ @verboseoutput = ] verboseoutput

Rentang nama dan nilai properti yang akan dikembalikan.

  • 0 = properti inti
  • >0 = semua properti

@verboseoutput kecil tanpa default.

[ @query_sample = ] 'query_sample'

Sampel kueri perwakilan yang dapat digunakan untuk menguji kegunaan indeks. Ini mungkin objek representatif atau jendela kueri. query_sample adalah geometri tanpa default.

[ @xml_output = ] 'xml_output'

Parameter output yang mengembalikan tataan hasil dalam fragmen XML. xml_output adalah xml tanpa default.

Properti

Atur @verboseoutput = 0 untuk mengembalikan properti inti seperti yang ditunjukkan dalam tabel berikut, atau @verboseoutput > 0 untuk mengembalikan semua properti indeks spasial.

Base_Table_Rows

Jumlah baris dalam tabel dasar. Nilainya besar.

Bounding_Box_xmin

Properti kotak pembatas minimum X dari indeks spasial untuk jenis geometri . Nilai properti ini adalah NULL untuk jenis geografi . Nilai adalah float.

Bounding_Box_ymin

Properti kotak batas minimum Y dari indeks spasial untuk jenis geometri . Nilai properti ini adalah NULL untuk jenis geografi . Nilai adalah float.

Bounding_Box_xmax

Properti kotak batas maksimum X dari indeks spasial untuk jenis geometri . Nilai properti ini adalah NULL untuk jenis geografi . Nilai adalah float.

Bounding_Box_ymax

Properti kotak batas maksimum Y dari indeks spasial untuk jenis geometri . Nilai properti ini adalah NULL untuk jenis geografi . Nilai adalah float.

Grid_Size_Level_1

Kepadatan kisi tingkat 1 dari indeks spasial:

  • 16 untuk LOW
  • 64 untuk MEDIUM
  • 256 untuk TINGGI

Nilai adalah int.

Grid_Size_Level_2

Kepadatan kisi tingkat 2 dari indeks spasial:

  • 16 untuk LOW
  • 64 untuk MEDIUM
  • 256 untuk TINGGI

Nilai adalah int.

Grid_Size_Level_3

Kepadatan kisi tingkat 3 dari indeks spasial:

  • 16 untuk LOW
  • 64 untuk MEDIUM
  • 256 untuk TINGGI

Nilai adalah int.

Grid_Size_Level_4

Kepadatan kisi tingkat 4 dari indeks spasial:

  • 16 untuk LOW
  • 64 untuk MEDIUM
  • 256 untuk TINGGI

Nilai adalah int.

Cells_Per_Object

Jumlah sel per objek (properti indeks). Nilai adalah int.

Total_Primary_Index_Rows

Jumlah baris dalam indeks. Nilainya besar.

Total_Primary_Index_Pages

Jumlah halaman dalam indeks. Nilainya besar.

Average_Number_Of_Index_Rows_Per_Base_Row

Jumlah baris indeks/baris tabel dasar angka. Nilainya besar.

Total_Number_Of_ObjectCells_In_Level0_For_QuerySample

Menunjukkan apakah sampel kueri perwakilan berada di luar kotak pembatas indeks geometri dan ke dalam sel akar (sel tingkat 0). Ini adalah 0 (tidak dalam sel tingkat 0) atau 1. Jika berada di sel tingkat 0, indeks yang diselidiki bukan indeks yang sesuai untuk sampel kueri. Ini adalah properti inti. Nilainya besar.

Total_Number_Of_ObjectCells_In_Level0_In_Index

Jumlah instans sel objek terindeks yang di-tessellated di tingkat 0 (sel akar, di luar kotak pembatas untuk geometri). Ini adalah properti inti. Nilainya besar.

Untuk indeks geometri , ini terjadi jika kotak pembatas indeks lebih kecil dari domain data. Jumlah objek yang tinggi di tingkat 0 mungkin memerlukan filter sekunder jika jendela kueri berada sebagian di luar kotak pembatas dan mengurangi performa indeks (misalnya, Total_Number_Of_ObjectCells_In_Level0_For_QuerySample adalah 1). Jika jendela kueri berada di dalam kotak pembatas, jumlah objek tinggi di tingkat 0 dapat benar-benar meningkatkan performa indeks.

Instans NULL dan kosong dihitung pada tingkat 0 tetapi tidak memengaruhi performa. Tingkat 0 memiliki sel sebanyak NULL dan instans kosong di tabel dasar. Untuk indeks geografi , tingkat 0 memiliki sel sebanyak NULL dan instans kosong +1 sel, karena sampel kueri dihitung sebagai 1.

Total_Number_Of_ObjectCells_In_Level1_In_Index

Jumlah instans sel objek terindeks yang dipengaruhi dengan presisi tingkat 1. Ini adalah properti inti. Nilainya besar.

Total_Number_Of_ObjectCells_In_Level2_In_Index

Jumlah instans sel objek terindeks yang dipengaruhi dengan presisi tingkat 2. Ini adalah properti inti. Nilainya besar.

Total_Number_Of_ObjectCells_In_Level3_In_Index

Jumlah instans sel objek terindeks yang dipengaruhi dengan presisi tingkat 3. Ini adalah properti inti. Nilainya besar.

Total_Number_Of_ObjectCells_In_Level4_In_Index

Jumlah instans sel objek terindeks yang dipengaruhi dengan presisi tingkat 4. Ini adalah properti inti. Nilainya besar.

Total_Number_Of_interior_ObjectCells_In_Level1_In_Index

Jumlah sel yang sepenuhnya dicakup oleh objek pada tingkat tessel 1 dan dengan demikian merupakan interior untuk objek. (Cell_attributevalue adalah 2.) Ini adalah properti inti. Nilainya besar.

Total_Number_Of_interior_ObjectCells_In_Level2_In_Index

Jumlah sel yang sepenuhnya dicakup oleh objek pada tingkat tesselerasi 2 dan dengan demikian merupakan interior objek. (nilai Cell_attribute adalah 2.) Ini adalah properti inti. Nilainya besar.

Total_Number_Of_interior_ObjectCells_In_Level3_In_Index

Jumlah sel yang sepenuhnya dicakup oleh objek pada tingkat tessellation 3 dan dengan demikian merupakan interior untuk objek. (nilai Cell_attribute adalah 2.) Ini adalah properti inti. Nilainya besar.

Total_Number_Of_interior_ObjectCells_In_Level4_In_Index

Jumlah sel yang sepenuhnya dicakup oleh objek pada tingkat tessel 4 dan dengan demikian merupakan interior ke objek. (nilai Cell_attribute adalah 2.) Ini adalah properti inti. Nilainya besar.

Total_Number_Of_intersecting_ObjectCells_In_Level1_In_Index

Jumlah sel yang berpotongan oleh objek pada tingkat tesselerasi 1. (nilai Cell_attribute adalah 1.) Ini adalah properti inti. Nilainya besar.

Total_Number_Of_intersecting_ObjectCells_In_Level2_In_Index

Jumlah sel yang dipotong oleh objek pada tingkat tessel 2. (nilai Cell_attribute adalah 1.) Ini adalah properti inti. Nilainya besar.

Total_Number_Of_intersecting_ObjectCells_In_Level3_In_Index

Jumlah sel yang dipotong oleh objek pada tingkat tessel 3. (nilai Cell_attribute adalah 1.) Ini adalah properti inti. Nilainya besar.

Total_Number_Of_intersecting_ObjectCells_In_Level4_In_Index

Jumlah sel yang dipotong oleh objek pada tingkat tessel 4. (nilai Cell_attribute adalah 1.) Ini adalah properti inti. Nilainya besar.

Total_Number_Of_Border_ObjectCells_In_Level0_For_QuerySample

Menunjukkan apakah sampel kueri berada di sel akar 0 di luar kotak pembatas, tetapi menyentuhnya. Ini adalah properti inti. Nilainya besar.

Catatan

Informasi ini hanya berguna dalam menentukan apakah ada objek yang mungkin terlewatkan oleh kotak pembatas.

Total_Number_Of_Border_ObjectCells_In_Level0_In_Index

Jumlah objek di tingkat 0 yang menyentuh kotak pembatas. (nilai Cell_attribute adalah 0.) Nilainya besar.

Total_Number_Of_Border_ObjectCells_In_Level1_In_Index

Jumlah sel objek yang menyentuh batas sel kisi di tingkat tessel 1. (nilai Cell_attribute adalah 0.) Ini adalah properti inti. Nilainya besar.

Total_Number_Of_Border_ObjectCells_In_Level2_In_Index

Jumlah sel objek yang menyentuh batas sel kisi di tingkat tessel 2. (nilai Cell_attribute adalah 0.) Ini adalah properti inti. Nilainya besar.

Total_Number_Of_Border_ObjectCells_In_Level3_In_Index

Jumlah sel objek yang menyentuh batas sel kisi di tingkat tessel 3. (nilai Cell_attribute adalah 0.) Ini adalah properti inti. Nilainya besar.

Total_Number_Of_Border_ObjectCells_In_Level4_In_Index

Jumlah sel objek yang menyentuh batas sel kisi di tingkat tessel 4. (nilai Cell_attribute adalah 0.) Ini adalah properti inti. Nilainya besar.

Interior_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage

Persentase area total (total sel daun) kisi yang berisi sel daun yang dicakup oleh objek.

Misalnya, objek dipengaruhi menjadi 10 sel pada empat tingkat kisi berbeda yang mencakup area yang setara dengan total 100 sel daun. Misalkan ada tiga sel interior yang sepenuhnya tertutup oleh objek. Area yang dicakup oleh tiga sel interior setara dengan 42 sel daun. Dengan demikian, persentase area tercakup adalah 42 persen. Ini adalah ukuran yang baik tentang seberapa baik objek dalam indeks dihancurkan.

Nilai adalah float.

Intersecting_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage

Sama seperti Interior_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage, kecuali bahwa ini adalah sel yang tercakup sebagian. Nilai adalah float.

Border_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage

Sama seperti Interior_To_Total_Cells_Normalized_To_Leaf_Grid_Percentage kecuali bahwa ini adalah sel batas. Nilai adalah float.

Average_Cells_Per_Object_Normalized_To_Leaf_Grid

Sel rata-rata per objek dinormalisasi ke kisi daun. Ini memberi kita indikasi ukuran spasial objek, atau seberapa besar objek. Nilai adalah float.

Average_Objects_PerLeaf_GridCell

Jarangnya indeks. Jumlah rata-rata objek per sel daun. Nilai adalah float.

Number_Of_SRIDs_Found

Jumlah SRID unik dalam indeks dan kolom. Nilai adalah int.

Karena kolom dapat berisi lebih dari satu SRID dan objek SRID yang berbeda tidak pernah bersinggungan, jumlah SRID menunjukkan selektivitas indeks.

Width_Of_Cell_In_Level1

Properti lebar sel dalam kisi pengindeksan. Unit pengukuran disediakan oleh indeks dan tergantung pada SRID data terindeks. Nilai adalah float.

Width_Of_Cell_In_Level2

Properti lebar sel dalam kisi pengindeksan. Unit pengukuran disediakan oleh indeks dan tergantung pada SRID data terindeks. Nilai adalah float.

Width_Of_Cell_In_Level3

Properti lebar sel dalam kisi pengindeksan. Unit pengukuran disediakan oleh indeks dan tergantung pada SRID data terindeks. Nilai adalah float.

Width_Of_Cell_In_Level4

Properti lebar sel dalam kisi pengindeksan. Unit pengukuran disediakan oleh indeks dan bergantung pada SRID data terindeks. Nilai adalah float.

Height_Of_Cell_In_Level1

Properti tinggi sel dalam kisi pengindeksan. Unit pengukuran disediakan oleh indeks dan tergantung pada SRID data terindeks. Nilai adalah float.

Height_Of_Cell_In_Level2

Properti tinggi sel dalam kisi pengindeksan. Unit pengukuran disediakan oleh indeks dan tergantung pada SRID data terindeks. Nilai adalah float.

Height_Of_Cell_In_Level3

Properti tinggi sel dalam kisi pengindeksan. Unit pengukuran disediakan oleh indeks dan tergantung pada SRID data terindeks. Nilai adalah float.

Height_Of_Cell_In_Level4

Properti tinggi sel dalam kisi pengindeksan. Unit pengukuran disediakan oleh indeks dan tergantung pada SRID data terindeks. Nilai adalah float.

Area_Of_Cell_In_Level1

Properti area sel dalam kisi pengindeksan. Unit pengukuran disediakan oleh indeks dan tergantung pada SRID data terindeks. Nilai adalah float.

Area_Of_Cell_In_Level2

Properti area sel dalam kisi pengindeksan. Unit pengukuran disediakan oleh indeks dan tergantung pada SRID data terindeks. Nilai adalah float.

Area_Of_Cell_In_Level3

Properti area sel dalam kisi pengindeksan. Unit pengukuran disediakan oleh indeks dan tergantung pada SRID data terindeks. Nilai adalah float.

Area_Of_Cell_In_Level4

Properti area sel dalam kisi pengindeksan. Unit pengukuran disediakan oleh indeks dan tergantung pada SRID data terindeks. Nilai adalah float.

CellArea_To_BoundingBoxArea_Percentage_In_Level1

Persentase cakupan kotak pembatas dengan sel tingkat 1. Nilai adalah float.

CellArea_To_BoundingBoxArea_Percentage_In_Level2

Persentase cakupan kotak pembatas dengan sel tingkat 2. Nilai adalah float.

CellArea_To_BoundingBoxArea_Percentage_In_Level3

Persentase cakupan kotak pembatas dengan sel tingkat 3. Nilai adalah float.

CellArea_To_BoundingBoxArea_Percentage_In_Level4

Persentase cakupan kotak pembatas dengan sel tingkat 4. Nilai adalah float.

Number_Of_Rows_Selected_By_Primary_Filter

Jumlah baris yang dipilih oleh filter utama. Ini adalah properti inti. Nilainya besar.

Number_Of_Rows_Selected_By_Internal_Filter

Jumlah baris yang dipilih oleh filter internal. Filter sekunder tidak dipanggil untuk baris ini. Ini adalah properti inti. Nilainya besar.

Angka yang dikembalikan hanya berlaku untuk STintersects.

Number_Of_Times_Secondary_Filter_Is_Called

Berapa kali filter sekunder dipanggil. Ini adalah properti inti. Nilainya besar.

Percentage_Of_Rows_NotSelected_By_Primary_Filter

Jika ada baris N dalam tabel dasar, dan P dipilih oleh filter utama, ini mengembalikan (N-P)/N sebagai persentase. Ini adalah properti inti. Nilai adalah float.

Percentage_Of_Primary_Filter_Rows_Selected_By_internal_Filter

Jika baris P dipilih oleh filter utama dan baris S dipilih oleh filter internal, ini mengembalikan S/P sebagai persentase. Semakin tinggi persentasenya, semakin baik indeks dalam menghindari filter sekunder yang lebih mahal performanya. Ini adalah properti inti. Nilai adalah float.

Number_Of_Rows_Output

Jumlah output baris menurut kueri. Ini adalah properti inti. Nilainya besar.

Internal_Filter_Efficiency

Jika O adalah jumlah output baris, ini mengembalikan S/O sebagai persentase. Ini adalah properti inti. Nilai adalah float.

Primary_Filter_Efficiency

Jika baris P dipilih oleh filter utama dan O adalah jumlah output baris, ini mengembalikanO/P sebagai persentase. Semakin tinggi efisiensi filter utama, semakin sedikit positif palsu yang harus diproses oleh filter sekunder. Ini adalah properti inti. Nilai adalah float.

Izin

Pengguna harus menjadi anggota peran publik . Memerlukan izin READ ACCESS pada server dan objek. Ini berlaku untuk semua prosedur tersimpan indeks spasial.

Keterangan

Properti yang berisi nilai NULL tidak disertakan dalam kumpulan pengembalian.

Contoh

Misalnya, lihat artikel berikut ini: