다음을 통해 공유


sp_db_selective_xml_index(Transact-SQL)

적용 대상: SQL Server

SQL Server 데이터베이스에서 선택적 SXI(XML 인덱스) 기능을 사용하거나 사용하지 않도록 설정합니다. 매개 변수 없이 호출되는 경우 저장 프로시저는 특정 데이터베이스에서 SXI를 사용하도록 설정하면 반환 1 됩니다.

참고 항목

SQL Server 2014(12.x) 이상 버전에서는 SXI 기능을 사용하지 않도록 설정할 수 없습니다. SQL Server의 이후 버전에서는 이 기능이 제거됩니다. 새 개발 작업에서는 이 기능을 사용하지 않도록 하고, 현재 이 기능을 사용하는 애플리케이션은 수정하세요.

Transact-SQL 구문 표기 규칙

구문

sp_db_selective_xml_index
    [ [ @dbname = ] N'dbname' ]
    [ , [ @selective_xml_index = ] 'selective_xml_index' ]
[ ; ]

인수

[ @dbname = ] N'dbname'

선택적 XML 인덱스 사용하거나 사용하지 않도록 설정할 데이터베이스의 이름입니다. @dbname sysname이며 기본값은 .입니다NULL.

@dbname NULL경우 현재 데이터베이스가 가정됩니다.

[ @selective_xml_index = ] 'selective_xml_index'

인덱스를 사용하거나 사용하지 않도록 설정할지 여부를 결정합니다. @selective_xml_index 기본값NULL인 varchar(6)이며 다음 OFFTRUEFALSEON중 하나일 수 있습니다. 다른 값이 있으면 오류가 발생합니다.

반환 코드 값

1 SXI가 특정 데이터베이스 0 에서 사용하도록 설정되어 있으면 사용하지 않도록 설정합니다.

예제

A. 선택적 XML 인덱스 기능 사용

다음 예제에서는 현재 데이터베이스에서 SXI를 사용하도록 설정합니다.

EXEC sys.sp_db_selective_xml_index
    @dbname = NULL
  , @selective_xml_index = N'on';
GO

다음 예제에서는 데이터베이스에서 SXI를 AdventureWorks2022 사용하도록 설정합니다.

EXECUTE sys.sp_db_selective_xml_index
    @dbname = N'AdventureWorks2022'
  , @selective_xml_index = N'true';
GO

B. 선택적 XML 인덱스 기능 사용 안 함

다음은 현재 데이터베이스에서 SXI를 사용하지 않도록 설정하는 예제입니다.

EXECUTE sys.sp_db_selective_xml_index
    @dbname = NULL
  , @selective_xml_index = N'off';
GO

다음 예제에서는 데이터베이스에서 SXI를 AdventureWorks2022 사용하지 않도록 설정합니다.

EXECUTE sys.sp_db_selective_xml_index
    @dbname = N'AdventureWorks2022'
  , @selective_xml_index = N'false';
GO

C. 선택적 XML 인덱스가 사용되는지 검색

다음 예제에서는 SXI를 사용할 수 있는지 검색하고 SXI가 활성화되었는지를 반환 1 합니다.

EXECUTE sys.sp_db_selective_xml_index;
GO