CREATE XML INDEX (Selective XML Indexes)

Artikel
09/03/2024

Applies to: SQL Server Azure SQL Database Azure SQL Managed Instance

Creates a new secondary selective XML index on a single path that is already indexed by an existing selective XML index. You can also create primary selective XML indexes. For information, see Create, Alter, and Drop Selective XML Indexes.

Transact-SQL syntax conventions

Syntax

CREATE XML INDEX index_name  
    ON <table_object> ( xml_column_name )  
    USING XML INDEX sxi_index_name  
    FOR ( <xquery_or_sql_values_path> )  
    [WITH ( <index_options> )]  
  
<table_object> ::=   
{ database_name.schema_name.table_name | schema_name.table_name | table_name }  
  
<xquery_or_sql_values_path>::=   
<path_name>   
  
<path_name> ::=   
character string literal  
  
<xmlnamespace_list> ::=   
<xmlnamespace_item> [, <xmlnamespace_list>]  
  
<xmlnamespace_item> ::=   
xmlnamespace_uri AS xmlnamespace_prefix  
  
<index_options> ::=   
(    
  | PAD_INDEX  = { ON | OFF }  
  | FILLFACTOR = fillfactor  
  | SORT_IN_TEMPDB = { ON | OFF }  
  | IGNORE_DUP_KEY = OFF  
  | DROP_EXISTING = { ON | OFF }  
  | ONLINE = OFF  
  | ALLOW_ROW_LOCKS = { ON | OFF }  
  | ALLOW_PAGE_LOCKS = { ON | OFF }  
  | MAXDOP = max_degree_of_parallelism  
)

Arguments

index_name
Is the name of the new index to create. Index names must be unique within a table, but do not have to be unique within a database. Index names must follow the rules of identifiers.

ON <table_object> Is the table that contains the XML column to index. You can use the following formats:

database_name.schema_name.table_name
database_name..table_name
schema_name.table_name

xml_column_name
Is the name of the XML column that contains the path to index.

USING XML INDEX sxi_index_name
Is the name of the existing selective XML index.

FOR ( <xquery_or_sql_values_path> ) Is the name of the indexed path on which to create the secondary selective XML index. The path to index is the assigned name from the CREATE SELECTIVE XML INDEX statement. For more information, see CREATE SELECTIVE XML INDEX (Transact-SQL).

WITH <index_options> For information about the index options, see CREATE XML INDEX.

Remarks

There can be multiple secondary selective XML indexes on every XML column in the base table.

Limitations and Restrictions

A selective XML index on an XML column must exist before secondary selective XML indexes can be created on the column.

Security

Permissions

Requires ALTER permission on the table or view. User must be a member of the sysadmin fixed server role or the db_ddladmin and db_owner fixed database roles.

Examples

The following example creates a secondary selective XML index on the path pathabc. The path to index is the assigned name from the CREATE SELECTIVE XML INDEX (Transact-SQL).

CREATE XML INDEX filt_sxi_index_c  
ON Tbl(xmlcol)  
USING XML INDEX sxi_index  
FOR ( pathabc );

Dela via