ALTER INDEX(选择性 XML 索引)
适用于:SQL Server
Azure SQL 数据库 Azure SQL 托管实例
修改现有的选择性 XML 索引。 ALTER INDEX 语句更改以下一项或多项:
已建立索引的路径的列表(FOR 子句)。
命名空间的列表(WITH XMLNAMESPACES 子句)。
索引选项(WITH 子句)。
您不能更改辅助选择性 XML 索引。 有关详细信息,请参阅创建、更改和删除辅助选择性 XML 索引。
语法
ALTER INDEX index_name
ON <table_object>
[WITH XMLNAMESPACES ( <xmlnamespace_list> )]
FOR ( <promoted_node_path_action_list> )
[WITH ( <index_options> )]
<table_object> ::=
{ database_name.schema_name.table_name | schema_name.table_name | table_name }
<promoted_node_path_action_list> ::=
<promoted_node_path_action_item> [, <promoted_node_path_action_list>]
<promoted_node_path_action_item>::=
<add_node_path_item_action> | <remove_node_path_item_action>
<add_node_path_item_action> ::=
ADD <path_name> = <promoted_node_path_item>
<promoted_node_path_item>::=
<xquery_node_path_item> | <sql_values_node_path_item>
<remove_node_path_item_action> ::= REMOVE <path_name>
<path_name_or_typed_node_path>::=
<path_name> | <typed_node_path>
<typed_node_path> ::=
<node_path> [[AS XQUERY <xsd_type_ext>] | [AS SQL <sql_type>]]
<xquery_node_path_item> ::=
<node_path> [AS XQUERY <xsd_type_or_node_hint>] [SINGLETON]
<xsd_type_or_node_hint> ::=
[<xsd_type>] [MAXLENGTH(x)] | 'node()'
<sql_values_node_path_item> ::=
<node_path> AS SQL <sql_type> [SINGLETON]
<node_path> ::=
character_string_literal
<xsd_type_ext> ::=
character_string_literal
<sql_type> ::=
identifier
<path_name> ::=
identifier
<xmlnamespace_list> ::=
<xmlnamespace_item> [, <xmlnamespace_list>]
<xmlnamespace_item> ::=
<xmlnamespace_uri> AS <xmlnamespace_prefix>
<xml_namespace_uri> ::= character_string_literal
<xml_namespace_prefix> ::= identifier
<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
)
参数
index_name
要更改的现有索引的名称。
<table_object>
包含要建立索引的 XML 列的表。 使用以下格式之一:
database_name.schema_name.table_name
database_name..table_name
schema_name.table_name
table_name
[WITH XMLNAMESPACES (<xmlnamespace_list>)]
要建立索引的路径使用的命名空间的列表。 有关 WITH XMLNAMESPACES 子句的语法的信息,请参阅 WITH XMLNAMESPACES (Transact-SQL)。
FOR (<promoted_node_path_action_list>)
要添加或删除的已建立索引的路径的列表。
使用 ADD 语句添加路径。 添加路径时,您使用的语法与使用 CREATE SELECTIVE XML INDEX 语句创建路径所用的语法相同。 有关可以在 CREATE 或 ALTER 语句中指定的路径的信息,请参阅为选择性 XML 索引指定路径和优化提示。
使用 REMOVE 语句删除路径。 删除路径时,请提供创建路径时的路径名。
[WITH (<index_options>)]
使用不包含 FOR 子句的 ALTER INDEX 时只能指定 <index_options>。 在您使用 ALTER INDEX 添加或删除索引中的路径时,索引选项将不是有效的参数。 有关索引选项的信息,请参阅 CREATE XML INDEX(选择性 XML 索引)。
注意
若要查看 SQL Server 2014 (12.x) 及更早版本的 Transact-SQL 语法,请参阅早期版本文档。
注解
重要
在您运行 ALTER INDEX 语句时,始终重新生成选择性 XML 索引。 请务必考虑此过程对服务器资源的影响。
安全性
权限
若要运行 ALTER INDEX,需要对表或视图拥有 ALTER 权限。
示例
下面的示例说明 ALTER INDEX 语句。 此语句将路径 '/a/b/m'
添加到索引的 XQuery 部分,并且从在 CREATE SELECTIVE XML INDEX (Transact-SQL) 主题的示例中创建的索引的 SQL 部分删除路径 '/a/b/e'
。 要删除的路径由在创建时提供给它的名称标识。
ALTER INDEX sxi_index
ON Tbl
FOR
(
ADD pathm = '/a/b/m' as XQUERY 'node()' ,
REMOVE pathabe
);
下面的示例说明指定索引选项的 ALTER INDEX 语句。 允许索引选项,因为该语句未使用 FOR 子句来添加或删除路径。
ALTER INDEX sxi_index
ON Tbl
PAD_INDEX = ON;