Partilhar via


CREATE XML INDEX (Índices XML seletivos)

Aplica-se a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceBase de dados SQL no Microsoft Fabric

Cria um novo índice XML seletivo secundário em um único caminho que já está indexado por um índice XML seletivo existente. Você também pode criar índices XML seletivos primários. Para obter informações, consulte Criar, alterar e descartar índices XML seletivos.

Transact-SQL convenções de sintaxe

Sintaxe

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  
)  

Argumentos

index_name
É o nome do novo índice a ser criado. Os nomes de índice devem ser exclusivos dentro de uma tabela, mas não precisam ser exclusivos dentro de um banco de dados. Os nomes dos índices devem seguir as regras dos identificadores.

ON <table_object> É a tabela que contém a coluna XML a ser indexada. Você pode usar os seguintes formatos:

  • database_name.schema_name.table_name

  • database_name..table_name

  • schema_name.table_name

xml_column_name
É o nome da coluna XML que contém o caminho para o índice.

USANDO O XML INDEX sxi_index_name
É o nome do índice XML seletivo existente.

FOR (<xquery_or_sql_values_path>) É o nome do caminho indexado no qual criar o índice XML seletivo secundário. O caminho para o índice é o nome atribuído da instrução CREATE SELECTIVE XML INDEX. Para obter mais informações, consulte CREATE SELECTIVE XML INDEX (Transact-SQL).

COM <index_options> Para obter informações sobre as opções de índice, consulte CREATE XML INDEX.

Observações

Pode haver vários índices XML seletivos secundários em cada coluna XML na tabela base.

Limitações e Restrições

Um índice XML seletivo em uma coluna XML deve existir antes que índices XML seletivos secundários possam ser criados na coluna.

Segurança

Permissões

Requer permissão ALTER na tabela ou exibição. O usuário deve ser membro da função de servidor fixa sysadmin ou das funções de banco de dados db_ddladmin e db_owner fixas.

Exemplos

O exemplo a seguir cria um índice XML seletivo secundário no caminho pathabc. O caminho para o índice é o nome atribuído a partir de CREATE SELECTIVE XML INDEX (Transact-SQL).

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

Ver também

Índices XML seletivos (SXI)
Criar, alterar e descartar índices XML seletivos secundários