Skip to content

Latest commit

 

History

History
109 lines (80 loc) · 4.17 KB

create-xml-index-selective-xml-indexes.md

File metadata and controls

109 lines (80 loc) · 4.17 KB
title description author ms.author ms.date ms.service ms.subservice ms.topic dev_langs
CREATE XML INDEX (Selective XML Indexes)
CREATE XML INDEX (Selective XML Indexes)
markingmyname
maghan
08/10/2017
sql
t-sql
reference
TSQL

CREATE XML INDEX (Selective XML Indexes)

[!INCLUDE 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.

:::image type="icon" source="../../includes/media/topic-link-icon.svg" border="false"::: 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 );

See Also

Selective XML Indexes (SXI)
Create, Alter, and Drop Secondary Selective XML Indexes