sp_db_selective_xml_index(Transact-SQL)

  • 아티클

적용 대상:SQL Server

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

참고 항목

SQL Server 2014(12.x)부터 선택적 XML 인덱스 기능을 사용하지 않도록 설정할 수 없습니다. 이 기능은 이후 버전의 SQL Server에서 제거됩니다. 새 개발 작업에서는 이 기능을 사용하지 않도록 하고, 현재 이 기능을 사용하는 애플리케이션은 수정하세요. SQL Server 2012(11.x)에서 이 저장 프로시저를 사용하여 선택적 XML 인덱스 기능을 사용하지 않도록 설정하려면 ALTER DATABASE SET 옵션(Transact-SQL) 명령을 사용하여 데이터베이스를 SIMPLE 복구 모델에 배치해야 합니다.

Transact-SQL 구문 표기 규칙

구문

  
      sys.sp_db_selective_xml_index[[ @dbname = ] 'dbname'],   
[[ @selective_xml_index = ] 'selective_xml_index']

인수

[ @ dbname = ] 'dbname' 선택적 XML 인덱스 사용 또는 사용 안 함을 설정할 데이터베이스의 이름입니다. dbname이 NULL이면 현재 데이터베이스가 가정됩니다. @dbname sysname입니다.

[ @selective_xml_index = ] 'selective_xml_index' 인덱스를 사용하거나 사용하지 않도록 설정할지 여부를 결정합니다. 허용되는 값: 'on', 'off', 'true', 'false'. 'on', 'true', 'off' 또는 'false'를 제외한 다른 값이 전달되면 오류가 발생합니다. @selective_xml_index varchar(6)입니다.

반환 코드 값

특정 데이터베이스에서 선택적 XML 인덱스가 사용하도록 설정된 경우 1 이고, 사용하지 않도록 설정된 경우 0 입니다.

예제

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

다음은 현재 데이터베이스에서 선택적 XML 인덱스를 사용하도록 설정하는 예제입니다.

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

다음 예제에서는 데이터베이스에서 선택적 XML 인덱스를 AdventureWorks2022 사용하도록 설정합니다.

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

B. 선택적 XML 인덱스 기능 해제

다음 예에서는 현재 데이터베이스에서 선택적 XML 인덱스를 해제합니다.

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

다음 예제에서는 데이터베이스에서 AdventureWorks2022 선택적 XML 인덱스를 사용하지 않도록 설정합니다.

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

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

다음 예제에서는 선택적 XML 인덱스를 사용할 수 있는지 검색합니다. 선택적 XML 인덱스가 사용되는 경우 1을 반환합니다.

EXECUTE sys.sp_db_selective_xml_index;  
GO

참고 항목

SXI(선택적 XML 인덱스)