ALTER SEARCH PROPERTY LIST(Transact-SQL)

지정된 검색 속성 목록에 대해 지정한 검색 속성을 추가하거나 삭제합니다.

중요
CREATE SEARCH PROPERTY LIST, ALTER SEARCH PROPERTY LIST 및 DROP SEARCH PROPERTY LIST는 호환성 수준이 110인 경우에만 지원됩니다. 호환성 수준이 더 낮으면 이러한 문이 지원되지 않습니다.

구문

ALTER SEARCH PROPERTY LIST list_name
{
   ADD 'property_name'
     WITH 
      ( 
          PROPERTY_SET_GUID = 'property_set_guid'
        , PROPERTY_INT_ID = property_int_id
      [ , PROPERTY_DESCRIPTION = 'property_description' ]
      )
 | DROP 'property_name' 
}
;

인수

• list_name
  변경할 속성 목록 이름입니다. list_name은 식별자입니다.

  기존 속성 목록의 이름을 보려면 다음과 같이 sys.registered_search_property_lists 카탈로그 뷰를 사용하십시오.

  SELECT name FROM sys.registered_search_property_lists;
  

• ADD
  지정한 검색 속성을 list_name으로 지정된 속성 목록에 추가합니다. 해당 속성이 검색 속성 목록에 대해 등록됩니다. 새로 추가한 속성을 속성 검색에 사용하려면 연결된 전체 텍스트 인덱스가 다시 채워져야 합니다. 자세한 내용은 ALTER FULLTEXT INDEX(Transact-SQL)를 참조하십시오.

  [!참고]

  지정된 검색 속성을 검색 속성 목록에 추가하려면 해당 속성 집합 GUID(property_set_guid) 및 속성 정수 ID(property_int_id)를 제공해야 합니다. 자세한 내용은 이 항목의 뒷부분에 나오는 "속성 설정 GUID 및 식별자 가져오기"를 참조하십시오.

• property_name
  전체 텍스트 쿼리에서 속성을 식별하는 데 사용할 이름을 지정합니다. property_name은 속성 집합 내의 속성을 고유하게 식별해야 합니다. 속성 이름은 내부에 공백을 포함할 수 있습니다. property_name의 최대 길이는 256자입니다. 작성자나 집 주소와 같은 친숙한 단어 또는 System.Author나 System.Contact.HomeAddress와 같은 Windows 정식 속성 이름을 이 이름에 사용할 수 있습니다.

  개발자는 CONTAINS 조건자에 있는 속성을 식별하기 위해 property_name에 지정된 값을 사용해야 합니다. 따라서 속성을 추가할 때는 지정된 속성 집합 GUID(property_set_guid) 및 속성 식별자(property_int_id)로 정의된 속성을 의미 있게 나타내는 값을 지정해야 합니다. 속성 이름에 대한 자세한 내용은 이 항목의 뒷부분에 나오는 "주의"를 참조하십시오.

  현재 데이터베이스의 검색 속성 목록에 현재 존재하는 속성의 이름을 보려면 다음과 같이 sys.registered_search_properties 카탈로그 뷰를 사용하십시오.

  SELECT property_name FROM sys.registered_search_properties;
  

• PROPERTY_SET_GUID ='property_set_guid'
  속성이 속한 속성 집합의 식별자를 지정합니다. 이 식별자는 GUID(Globally Unique Identifier)입니다. 이 값을 가져오는 방법은 이 항목의 뒷부분에 나오는 "주의"를 참조하십시오.

  현재 데이터베이스의 검색 속성 목록에 있는 속성의 속성 집합 GUID를 보려면 다음과 같이 sys.registered_search_properties 카탈로그 뷰를 사용하십시오.

  SELECT property_set_guid FROM sys.registered_search_properties;
  

• PROPERTY_INT_ID =property_int_id
  속성 집합에서 속성을 식별하는 정수를 지정합니다. 이 값을 가져오는 방법은 "주의"를 참조하십시오.

  현재 데이터베이스의 검색 속성 목록에 있는 속성의 정수 식별자를 보려면 다음과 같이 sys.registered_search_properties 카탈로그 뷰를 사용하십시오.

  SELECT property_int_id FROM sys.registered_search_properties;
  

  [!참고]

  지정된 property_set_guid 및 property_int_id 조합은 검색 속성 목록에서 고유해야 합니다. 기존의 조합을 추가하려는 경우 ALTER SEARCH PROPERTY LIST 작업이 실패하고 오류가 발생합니다. 즉, 지정된 속성에 대해 이름을 한 개만 정의할 수 있습니다.

• PROPERTY_DESCRIPTION ='property_description'
  속성의 사용자 정의 설명을 지정합니다. property_description은 최대 512자의 문자열입니다. 이 옵션은 선택 사항입니다.

• DROP
  list_name으로 지정된 속성 목록에서 지정된 속성을 삭제합니다. 속성을 삭제하면 속성의 등록이 취소되므로 더 이상 검색할 수 없습니다.

주의

전체 텍스트 인덱스마다 검색 속성 목록이 하나만 있을 수 있습니다.

지정된 검색 속성에 대해 쿼리를 사용하려면 해당 속성을 전체 텍스트 인덱스의 검색 속성 목록에 추가하고 인덱스를 다시 채워야 합니다.

속성을 지정할 때는 다음 예와 같이 PROPERTY_SET_GUID, PROPERTY_INT_ID 및 PROPERTY_DESCRIPTION 절을 순서에 관계없이 괄호 안에 쉼표로 구분된 목록으로 정렬합니다.

ALTER SEARCH PROPERTY LIST CVitaProperties
ADD 'System.Author' 
WITH ( 
      PROPERTY_DESCRIPTION = 'Author or authors of a given document.',
      PROPERTY_SET_GUID   = 'F29F85E0-4FF9-1068-AB91-08002B27B3D9', 
      PROPERTY_INT_ID = 4 
      );

[!참고]

이 예에서는 속성 이름 System.Author를 사용합니다. 이 이름은 Windows Vista에 도입된 정식 속성 이름(Windows 정식 이름)의 개념과 비슷합니다.

속성 값 가져오기

해당 속성 집합 GUID 및 속성 정수 ID를 사용하여 전체 텍스트 검색이 검색 속성을 전체 텍스트 인덱스에 매핑합니다. Microsoft에서 정의한 속성의 이러한 항목을 가져오는 방법은 검색 속성의 속성 집합 GUID 및 속성 정수 ID찾기를 참조하십시오. ISV(Independent Software Vendor)에서 정의한 속성에 대한 자세한 내용은 해당 공급업체의 설명서를 참조하십시오.

추가한 속성을 검색 가능하도록 설정

검색 속성 목록에 검색 속성을 추가하면 속성이 등록됩니다. 새로 추가한 속성을 CONTAINS 쿼리에서 즉시 지정할 수 있습니다. 그러나 연결된 전체 텍스트 인덱스를 다시 채워야 새로 추가한 속성의 속성 범위 전체 텍스트 쿼리가 문서를 반환합니다. 예를 들어 대상 테이블(table_name)과 연결된 전체 텍스트 인덱스를 다시 채워야 새로 추가한 속성 new_search_property의 다음 속성 범위 쿼리가 문서를 반환합니다.

SELECT column_name FROM table_name WHERE CONTAINS( PROPERTY( column_name, 'new_search_property' ), 'contains_search_condition');
GO 

전체 채우기를 시작하려면 다음 ALTER FULLTEXT INDEX(Transact-SQL) 문을 사용하십시오.

USE database_name;
GO
ALTER FULLTEXT INDEX ON table_name START FULL POPULATION;
GO

[!참고]

검색 속성 목록에 남아 있는 속성만 전체 텍스트 쿼리에 사용할 수 있으므로 속성 목록에서 속성이 삭제된 후에는 다시 채울 필요가 없습니다.

관련 참조

속성 목록을 만들려면

• CREATE SEARCH PROPERTY LIST(Transact-SQL)

속성 목록을 삭제하려면

• DROP SEARCH PROPERTY LIST(Transact-SQL)

속성 목록을 전체 텍스트 인덱스에 추가하거나 제거하려면

• ALTER FULLTEXT INDEX(Transact-SQL)

전체 텍스트 인덱스에서 채우기를 실행하려면

• ALTER FULLTEXT INDEX(Transact-SQL)

사용 권한

속성 목록에 대한 CONTROL 권한이 필요합니다.

예

1.속성 추가

다음 예에서는 Title, Author 및 Tags와 같은 여러 속성을 DocumentPropertyList라는 속성 목록에 추가합니다.

[!참고]

DocumentPropertyList 속성 목록을 만드는 예는 CREATE SEARCH PROPERTY LIST(Transact-SQL)를 참조하십시오.

ALTER SEARCH PROPERTY LIST DocumentPropertyList
   ADD 'Title' 
   WITH ( PROPERTY_SET_GUID = 'F29F85E0-4FF9-1068-AB91-08002B27B3D9', PROPERTY_INT_ID = 2, 
      PROPERTY_DESCRIPTION = 'System.Title - Title of the item.' );

ALTER SEARCH PROPERTY LIST DocumentPropertyList 
    ADD 'Author'
   WITH ( PROPERTY_SET_GUID = 'F29F85E0-4FF9-1068-AB91-08002B27B3D9', PROPERTY_INT_ID = 4, 
      PROPERTY_DESCRIPTION = 'System.Author - Author or authors of the item.' );

ALTER SEARCH PROPERTY LIST DocumentPropertyList 
    ADD 'Tags'
   WITH ( PROPERTY_SET_GUID = 'F29F85E0-4FF9-1068-AB91-08002B27B3D9', PROPERTY_INT_ID = 5, 
      PROPERTY_DESCRIPTION = 'System.Keywords - Set of keywords (also known as tags) assigned to the item.' );

[!참고]

제공된 검색 속성 목록을 속성 범위 쿼리에 사용하려면 먼저 이 목록을 전체 텍스트 인덱스와 연결해야 합니다. 이렇게 하려면 ALTER FULLTEXT INDEX 문을 사용하고 SET SEARCH PROPERTY LIST 절을 지정하십시오.

2.속성 삭제

다음 예에서는 DocumentPropertyList 속성 목록에서 Comments 속성을 삭제합니다.

ALTER SEARCH PROPERTY LIST DocumentPropertyList
DROP 'Comments' ;

참고 항목

참조

CREATE SEARCH PROPERTY LIST(Transact-SQL)

DROP SEARCH PROPERTY LIST(Transact-SQL)

sys.registered_search_properties(Transact-SQL)

sys.registered_search_property_lists(Transact-SQL)

sys.dm_fts_index_keywords_by_property(Transact-SQL)

개념

검색 속성 목록을 사용하여 문서 속성 검색

검색 속성의 속성 집합 GUID 및 속성 정수 ID찾기