CREATE SPATIAL INDEX (Transact-SQL)

• GEOMETRY_GRID
  Gibt das verwendete Mosaikschema für das Geometrieraster an. GEOMETRY_GRID kann nur für eine Spalte vom Datentyp geometry angegeben werden. Dies ist der Standardwert für diesen Datentyp; eine Angabe ist nicht erforderlich.

• GEOGRAPHY_GRID
  Gibt das Mosaikschema für das Geografieraster an. GEOGRAPHY_GRID kann nur für eine Spalte vom Datentyp geography angegeben werden. Dies ist der Standardwert für diesen Datentyp; eine Angabe ist nicht erforderlich.

• BOUNDING_BOX
  Gibt einen aus vier Werten bestehenden numerischen Tupel zurück, der die vier Koordinaten des umgebenden Felds definiert: die minimale X- und die minimale Y-Koordinate der unteren linken Ecke und die maximale X- und die maximale Y-Koordinate der oberen rechten Ecke.

  • xmin
    Gibt die X-Koordinate der unteren linken Ecke des umgebenden Felds an.

  • ymin
    Gibt die Y-Koordinate der unteren linken Ecke des umgebenden Felds an.

  • xmax
    Gibt die X-Koordinate der oberen rechten Ecke des umgebenden Felds an.

  • ymax
    Gibt die Y-Koordinate der oberen rechten Ecke des umgebenden Felds an.

  • XMIN = xmin
    Gibt den Eigenschaftsnamen und -wert für die X-Koordinate der unteren linken Ecke des umgebenden Felds an.

  • YMIN =ymin
    Gibt den Eigenschaftsnamen und -wert für die Y-Koordinate der unteren linken Ecke des umgebenden Felds an.

  • XMAX =xmax
    Gibt den Eigenschaftsnamen und -wert für die X-Koordinate der oberen rechten Ecke des umgebenden Felds an.

  • YMAX =ymax
    Gibt den Eigenschaftsnamen und -wert für die Y-Koordinate der oberen rechten Ecke des umgebenden Felds an.

  Die Koordinaten des umgebenden Felds gelten nur in einer USING GEOMETRY_GRID-Klausel.

  xmax muss größer als xmin und ymax muss größer als ymin sein. Sie können jede gültige Darstellung eines float-Werts verwenden, vorausgesetzt, dass xmax > xmin und ymax > ymin ist. Andernfalls werden die entsprechenden Fehler ausgelöst.

  Es gibt keine Standardwerte.

  Bei den Eigenschaftsnamen für umgebende Felder wird, unabhängig von der Datenbanksortierung, die Groß- und Kleinschreibung nicht beachtet.

  Eigenschaftsnamen müssen jeweils nur einmal angegeben werden. Sie können in einer beliebigen Reihenfolge angegeben werden. Beispielsweise sind die folgenden Klauseln gleichwertig:

  • BOUNDING_BOX = ( XMIN = xmin, YMIN = ymin, XMAX = xmax, YMAX = ymax )

  • BOUNDING_BOX = ( XMIN = xmin, XMAX = xmax, YMIN = ymin, YMAX = ymax )

• GRIDS
  Definiert die Dichte des Rasters auf jeder Ebene eines Mosaikschemas.

  Hinweis
  Informationen zu Mosaiken finden Sie unter Übersicht über räumliche Indizierung.

  Die GRIDS-Parameter lauten wie folgt:

  • LEVEL_1
    Gibt das Raster der obersten (höchsten) Ebene an.

  • LEVEL_2
    Gibt das Raster der zweiten Ebene an.

  • LEVEL_3
    Gibt das Raster der dritten Ebene an.

  • LEVEL_4
    Gibt das Raster der vierten Ebene an.

  • LOW
    Gibt die niedrigste mögliche Dichte für das Raster auf einer bestimmten Ebene an. LOW entspricht 16 Zellen (4 x 4-Raster).

  • MEDIUM
    Gibt die mittlere Dichte für das Raster auf einer bestimmten Ebene an. MEDIUM entspricht 64 Zellen (8 x 8-Raster).

  • HIGH
    Gibt die höchste mögliche Dichte für das Raster auf einer bestimmten Ebene an. HIGH entspricht 256 Zellen (16 x 16-Raster).

  Mithilfe von Ebenennamen können Sie die Ebenen in einer beliebigen Reihenfolge angeben oder Ebenen auslassen. Wenn Sie den Namen einer Ebene verwenden, müssen Sie auch die Namen aller anderen angegebenen Ebenen verwenden. Wenn Sie eine Ebene auslassen, wird die Dichte standardmäßig auf MEDIUM festgelegt.

  Bei Angabe einer ungültigen Dichte wird ein Fehler ausgelöst.

• CELLS_PER_OBJECT =n
  Gibt die Anzahl von Zellen pro Objekt für das Mosaik an, die vom Mosaikprozess für ein einzelnes räumliches Objekt im Index verwendet werden können. Bei n kann es sich um jede ganze Zahl von 1 bis 8192 handeln. Standardmäßig sind 16 Zellen pro Objekt vorgegeben. Wenn bei einem bestimmten Mosaik eine ungültige Anzahl übergeben wird oder die Anzahl die maximal zulässige Anzahl von Zellen überschreitet, wird ein Fehler ausgelöst.

  Auf höchster Ebene verwendet die Indizierung die Anzahl von Zellen, die zum Bereitstellen eines vollständigen Mosaiks der höchsten Ebene erforderlich sind, wenn ein Objekt mehr Zellen abdeckt, als durch n angegeben sind. In solchen Fällen ist es möglich, dass ein Objekt mehr als die angegebene Anzahl von Zellen erhält. Die maximale Anzahl ist dann die Anzahl von Zellen, die von dem Raster der höchsten Ebene generiert wird, welche von der Dichte abhängt.

  Der CELLS_PER_OBJECT-Wert wird von der Zellen-pro-Objekt-Mosaikregel verwendet. Informationen zu den Mosaikregeln finden Sie unter Übersicht über räumliche Indizierung.

• PAD_INDEX = { ON | OFF }
  Gibt das Auffüllen von Indizes an. Die Standardeinstellung ist OFF.

  • ON
    Der Prozentsatz des mit fillfactor angegebenen freien Speicherplatzes wird für die Zwischenebenenseiten des Indexes angewendet.

  • OFF oder fillfactor ist nicht angegeben.
    Die Zwischenebenenseiten sind nahezu vollständig aufgefüllt. Allerdings ist ausreichend Speicherplatz vorhanden, um mindestens eine Zeile in der maximal für den Index möglichen Größe aufzunehmen, wenn der Schlüsselsatz auf den Zwischenseiten berücksichtigt wird.

  Die Option PAD_INDEX ist nur dann hilfreich, wenn FILLFACTOR angegeben ist, da PAD_INDEX den durch FILLFACTOR angegebenen Prozentsatz verwendet. Wenn der für FILLFACTOR angegebene Prozentsatz nicht groß genug ist, um eine Zeile aufzunehmen, setzt Database Engine (Datenbankmodul) diesen Prozentsatz intern außer Kraft, um das Minimum zuzulassen. Auf jeder Zwischenindexseite befinden sich unabhängig vom angegebenen fillfactor-Wert nie weniger als zwei Zeilen.

• FILLFACTOR =fillfactor
  Gibt einen Prozentwert an, der dem Füllfaktor entspricht. Dieser Faktor legt fest, wie weit Database Engine (Datenbankmodul) die Blattebene jeder Indexseite während der Indexerstellung oder -neuerstellung auffüllen soll. fillfactor muss ein ganzzahliger Wert zwischen 1 und 100 sein. Die Standardeinstellung ist 0. Wenn fillfactor 100 oder 0 entspricht, werden von Database Engine (Datenbankmodul) Indizes mit vollständig aufgefüllten Blattseiten erstellt.

  Hinweis
  Die Füllfaktorwerte 0 und 100 sind in jeder Hinsicht identisch.

  Die FILLFACTOR-Einstellung gilt nur, wenn der Index erstellt oder neu erstellt wird. Database Engine (Datenbankmodul) hält den angegebenen Prozentsatz des Speicherplatzes nicht dynamisch auf den Seiten frei. Zum Anzeigen der Füllfaktoreinstellung verwenden Sie die Katalogsicht sys.indexes.

  Wichtig
  Das Erstellen eines gruppierten Indexes mit einem FILLFACTOR-Wert unter 100 wirkt sich auf den Speicherplatz aus, den die Daten belegen, da Database Engine (Datenbankmodul) die Daten beim Erstellen des gruppierten Indexes neu verteilt.

  Weitere Informationen finden Sie unter Füllfaktor.

• SORT_IN_TEMPDB = { ON | OFF }
  Gibt an, ob temporäre Sortierergebnisse in tempdb gespeichert werden sollen. Der Standardwert ist OFF.

  • ON
    Die Zwischenergebnisse von Sortierungen, mit denen der Index erstellt wird, werden in tempdb gespeichert. Diese Option verringert u. U. den Zeitaufwand, der mit der Erstellung eines Indexes verbunden ist, wenn sich tempdb auf einem anderen Datenträgersatz befindet als die Benutzerdatenbank. Allerdings wird mehr Speicherplatz während der Erstellung des Indexes benötigt.

  • OFF
    Die Zwischenergebnisse von Sortierungen werden in derselben Datenbank wie der Index gespeichert.

  Zusätzlich zu dem Speicherplatz, der in der Benutzerdatenbank zum Erstellen des Indexes erforderlich ist, muss tempdb ungefähr die gleiche Menge an zusätzlichem Speicherplatz aufweisen, um die Zwischenergebnisse des Sortierens zu speichern. Weitere Informationen finden Sie unter tempdb und Indexerstellung.

• IGNORE_DUP_KEY =OFF
  Hat keine Auswirkungen auf räumliche Indizes, da der Indextyp nie eindeutig ist. Legen Sie diese Option nicht auf ON fest, oder es wird ein Fehler ausgelöst.

• STATISTICS_NORECOMPUTE = { ON | OFF}
  Gibt an, ob Verteilungsstatistiken neu berechnet werden. Der Standardwert ist OFF.

  • ON
    Veraltete Indexstatistiken werden nicht automatisch neu berechnet.

  • OFF
    Die automatischen Aktualisierungen der Statistiken sind aktiviert.

  Um das automatische Aktualisieren von Statistiken wiederherzustellen, müssen Sie STATISTICS_NORECOMPUTE auf OFF festlegen oder die UPDATE STATISTICS-Anweisung ohne die NORECOMPUTE-Klausel ausführen.

  Wichtig
  Wenn Sie die automatische Neuberechnung von Verteilungsstatistiken deaktivieren, wählt der Abfrageoptimierer möglicherweise nicht die optimalen Ausführungspläne für Abfragen, an denen die Tabelle beteiligt ist.

• DROP_EXISTING = { ON | OFF }
  Gibt an, dass der benannte, bereits vorhandene räumliche Index gelöscht und neu erstellt wird. Der Standardwert ist OFF.

  • ON
    Der vorhandene Index wird gelöscht und neu erstellt. Der angegebene Indexname muss mit dem eines derzeit vorhandenen Indexes übereinstimmen. Die Indexdefinition kann jedoch geändert werden. Sie können beispielsweise andere Spalten, eine andere Sortierreihenfolge, ein anderes Partitionsschema oder andere Indexoptionen angeben.

  • OFF
    Es wird ein Fehler angezeigt, wenn der angegebene Indexname bereits vorhanden ist.

  Der Indextyp kann nicht mithilfe von DROP_EXISTING geändert werden.

• ONLINE =OFF
  Gibt an, dass zugrunde liegende Tabellen oder zugehörige Indizes für Abfragen und Datenänderungen während des Indexvorgangs nicht zur Verfügung stehen. In dieser Version von SQL Server werden Onlineindexerstellungen für räumliche Indizes nicht unterstützt. Wenn diese Option für einen räumlichen Index auf ON festgelegt ist, wird ein Fehler ausgelöst. Lassen Sie die ONLINE-Option weg, oder legen Sie ONLINE auf OFF fest.

  Ein Offlineindexvorgang, der einen räumlichen Index erstellt, neu erstellt oder löscht, aktiviert eine Schemaänderungssperre (Sch-M) für die Tabelle. Dadurch wird verhindert, dass Benutzer für die Dauer des Vorgangs auf die zugrunde liegende Tabelle zugreifen können.

  Hinweis
  Onlineindexvorgänge sind nur in den SQL Server Enterprise-, Developer- und Evaluation-Editionen verfügbar.

• ALLOW_ROW_LOCKS = { ON | OFF }
  Gibt an, ob Zeilensperren zulässig sind. Die Standardeinstellung ist ON.

  • ON
    Zeilensperren sind beim Zugriff auf den Index zulässig. Die Database Engine (Datenbankmodul) bestimmt, wann Zeilensperren verwendet werden.

  • OFF
    Zeilensperren werden nicht verwendet.

• ALLOW_PAGE_LOCKS = { ON | OFF }
  Gibt an, ob Seitensperren zulässig sind. Die Standardeinstellung ist ON.

  • ON
    Seitensperren sind beim Zugriff auf den Index zulässig. Die Database Engine (Datenbankmodul) bestimmt, wann Seitensperren verwendet werden.

  • OFF
    Seitensperren werden nicht verwendet.

• MAXDOP =max_degree_of_parallelism
  Setzt die Konfigurationsoption max degree of parallelism für die Dauer des Indexvorgangs außer Kraft. Sie können mit MAXDOP die Anzahl der Prozessoren begrenzen, die bei der Ausführung paralleler Pläne verwendet werden. Der Höchstwert ist 64 Prozessoren.

  Wichtig
  Obwohl die MAXDOP-Option syntaktisch unterstützt wird, verwendet CREATE SPATIAL INDEX derzeit immer nur einen einzelnen Prozessor.

  Mögliche Werte für max_degree_of_parallelism sind:

  • 1
    Unterdrückt das Generieren paralleler Pläne.

  • >1
    Beschränkt die maximale Anzahl der Prozessoren, die bei einem parallelen Indexvorgang verwendet werden, je nach aktueller Systemauslastung auf die angegebene Zahl oder einen niedrigeren Wert.

  • 0 (Standardwert)
    Verwendet die tatsächliche Anzahl oder, je nach aktueller Systemauslastung, eine geringere Anzahl von Prozessoren

  Weitere Informationen finden Sie unter Konfigurieren von Parallelindexvorgänge.

  Hinweis
  Parallele Indexvorgänge sind nur in den Editionen SQL Server Enterprise, Developer und Evaluation verfügbar.

Unter bestimmten Bedingungen unterstützen räumliche Indizes eine Reihe von mengenorientierten Geometriemethoden. Weitere Informationen finden Sie unter Von räumlichen Indizes unterstützte geometry-Methoden.

Standardmäßig wird beim Erstellen eines räumlichen Indexes für eine partitionierte Tabelle der Index in Übereinstimmung mit dem Partitionsschema der Tabelle partitioniert. So kann sichergestellt werden, dass Indexdaten und die zugehörige Zeile in der gleichen Partition gespeichert werden.

In diesem Fall müssen Sie, um das Partitionsschema der Basistabelle zu ändern, den räumlichen Index löschen, bevor Sie die Basistabelle neu partitionieren können. Diese Einschränkung kann umgangen werden, indem Sie beim Erstellen eines räumlichen Indexes die "ON filegroup"-Option angeben. Weitere Informationen finden Sie nachfolgend unter "Räumliche Indizes und Dateigruppen".

Standardmäßig werden räumliche Indizes in die gleichen Dateigruppen wie die Tabelle partitioniert, für die der Index angegeben wird. Dies kann durch Angabe der Dateigruppe außer Kraft gesetzt werden:

[ ON { filegroup_name | "default" } ]

Wenn Sie eine Dateigruppe für einen räumlichen Index angeben, wird der Index unabhängig vom Partitionierungsschema der Tabelle in dieser Dateigruppe platziert.

Die folgenden Katalogsichten sind für räumliche Indizes spezifisch:

• sys.spatial_indexes
  Stellt die wichtigsten Indexinformationen der räumlichen Indizes dar.

• sys.spatial_index_tessellations
  Stellt die Informationen zum Mosaikschema und zu den Parametern jedes räumlichen Indexes dar.

Weitere Informationen zur Metadatenstruktur von räumlichen Indizes finden Sie unter Interne Tabellen.

Weitere Informationen zum Erstellen von Indizes finden Sie in den Hinweisen unter CREATE INDEX (Transact-SQL).

Im folgenden Beispiel wird eine Tabelle namens SpatialTable erstellt, die eine Spalte vom Typ geometry aufweist, nämlich geometry_col. Dann wird ein räumlicher Index, SIndx_SpatialTable_geometry_col1, für geometry_col erstellt. Im Beispiel wird das Standardmosaikschema verwendet und das umgebende Feld angegeben.

CREATE TABLE SpatialTable(id int primary key, geometry_col geometry);
CREATE SPATIAL INDEX SIndx_SpatialTable_geometry_col1 
   ON SpatialTable(geometry_col)
   WITH ( BOUNDING_BOX = ( 0, 0, 500, 200 ) );

Im folgenden Beispiel wird ein zweiter räumlicher Index, SIndx_SpatialTable_geometry_col2, für geometry_col in der Tabelle SpatialTable erstellt. Im Beispiel wird GEOMETRY_GRID als Mosaikschema angegeben. Im Beispiel werden auch das umgebende Feld, unterschiedliche Dichten auf verschiedenen Ebenen und 64 Zellen pro Objekt angegeben. Zudem wird der Indexabstand auf ON festgelegt.

CREATE SPATIAL INDEX SIndx_SpatialTable_geometry_col2
   ON SpatialTable(geometry_col)
   USING GEOMETRY_GRID
   WITH (
    BOUNDING_BOX = ( xmin=0, ymin=0, xmax=500, ymax=200 ),
    GRIDS = (LOW, LOW, MEDIUM, HIGH),
    CELLS_PER_OBJECT = 64,
    PAD_INDEX  = ON );

Im folgenden Beispiel wird ein dritter räumlicher Index, SIndx_SpatialTable_geometry_col3, für geometry_col in der Tabelle SpatialTable erstellt. Im Beispiel wird das Standardmosaikschema verwendet. Im Beispiel wird das umgebende Feld angegeben, und es werden unterschiedliche Zelldichten auf der dritten und vierten Ebene, aber die vorgegebene Anzahl von Zellen pro Objekt verwendet.

CREATE SPATIAL INDEX SIndx_SpatialTable_geometry_col3
   ON SpatialTable(geometry_col)
   WITH (
    BOUNDING_BOX = ( 0, 0, 500, 200 ),
    GRIDS = ( LEVEL_4 = HIGH, LEVEL_3 = MEDIUM ) );

Im folgenden Beispiel wird der räumliche Index neu erstellt, der im vorherigen Beispiel erstellt wurde, nämlich SIndx_SpatialTable_geography_col3. Zu diesem Zweck wird eine neue Dichte für LEVEL_3 mit DROP_EXISTING = ON angegeben.

CREATE SPATIAL INDEX SIndx_SpatialTable_geography_col3
   ON SpatialTable(geography_col)
   WITH ( BOUNDING_BOX = ( 0, 0, 500, 200 ),
        GRIDS = ( LEVEL_3 = LOW ),
        DROP_EXISTING = ON );

Im folgenden Beispiel wird eine Tabelle namens SpatialTable2 erstellt, die eine Spalte vom Typ geography aufweist, nämlich geography_col. Dann wird ein räumlicher Index, SIndx_SpatialTable_geography_col1, für geography_col erstellt. Im Beispiel werden die Standardparameterwerte des Mosaikschemas GEOGRAPHY_GRID verwendet.

CREATE TABLE SpatialTable2(id int primary key, object GEOGRAPHY);
CREATE SPATIAL INDEX SIndx_SpatialTable_geography_col1 
   ON SpatialTable2(object);

Hinweis
Für Geografierasterindizes kann kein umgebendes Feld angegeben werden.

Im folgenden Beispiel wird ein zweiter räumlicher Index, SIndx_SpatialTable_geography_col2, für geography_col in der Tabelle SpatialTable2 erstellt. Im Beispiel wird GEOGRAPHY_GRID als Mosaikschema angegeben. Im Beispiel werden auch unterschiedliche Rasterdichten auf verschiedenen Ebenen und 64 Zellen pro Objekt angegeben. Zudem wird der Indexabstand auf ON festgelegt.

CREATE SPATIAL INDEX SIndx_SpatialTable_geography_col2
   ON SpatialTable2(object)
   USING GEOGRAPHY_GRID
   WITH (
    GRIDS = (MEDIUM, LOW, MEDIUM, HIGH ),
    CELLS_PER_OBJECT = 64,
    PAD_INDEX  = ON );

Im folgenden Beispiel wird dann ein dritter räumlicher Index, SIndx_SpatialTable_geography_col3, für geography_col in der Tabelle SpatialTable2 erstellt. Im Beispiel werden das Standardmosaikschema GEOGRAPHY_GRID und der Standardwert für CELLS_PER_OBJECT (16) verwendet.

CREATE SPATIAL INDEX SIndx_SpatialTable_geography_col3
   ON SpatialTable2(object)
   WITH ( GRIDS = ( LEVEL_3 = HIGH, LEVEL_2 = HIGH ) );