CREATE SEARCH PROPERTY LIST(Transact-SQL)CREATE SEARCH PROPERTY LIST (Transact-SQL)

이 항목은 다음에 적용됩니다.예SQL Server(2012부터 시작)예Azure SQL Database아니요Azure SQL Data Warehouse 아니요병렬 데이터 웨어하우스 THIS TOPIC APPLIES TO:yesSQL Server (starting with 2012)yesAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

새로운 검색 속성 목록을 만듭니다.Creates a new search property list. 검색 속성 목록은 전체 텍스트 인덱스에 포함할 하나 이상의 검색 속성을 지정하는 데 사용됩니다.A search property list is used to specify one or more search properties that you want to include in a full-text index.

항목 링크 아이콘 Transact-SQL 구문 규칙Topic link icon Transact-SQL Syntax Conventions

구문Syntax

CREATE SEARCH PROPERTY LIST new_list_name  
   [ FROM [ database_name. ] source_list_name ]  
   [ AUTHORIZATION owner_name ]  
;  

인수Arguments

new_list_namenew_list_name
새 검색 속성 목록 이름입니다.Is the name of the new search property list. new_list_name 은 최대 128 자의 식별자입니다.new_list_name is an identifier with a maximum of 128 characters. new_list_name 현재 데이터베이스의 모든 속성 목록에서 고유 해야 하며 식별자에 대 한 규칙을 따라야 합니다.new_list_name must be unique among all property lists in the current database, and conform to the rules for identifiers. new_list_name 전체 텍스트 인덱스를 만들 때 사용 됩니다.new_list_name will be used when the full-text index is created.

database_namedatabase_name
속성 목록에 지정 된 있는 데이터베이스의 이름인 source_list_name 있는 합니다.Is the name of the database where the property list specified by source_list_name is located. 지정 하지 않으면 database_name 현재 데이터베이스에 대 한 기본값입니다.If not specified, database_name defaults to the current database.

a s e _ 기존 데이터베이스의 이름을 지정 해야 합니다.database_name must specify the name of an existing database. 현재 연결에 대 한 로그인에 지정 된 데이터베이스의 기존 사용자 ID와 연결 되어 있어야 database_name합니다.The login for the current connection must be associated with an existing user ID in the database specified by database_name. 필요한 있어야 권한을 데이터베이스에 있습니다.You must also have the required permissions on the database.

source_list_namesource_list_name
새 속성 목록에서 기존 속성 목록을 복사 하 여 만들어지도록 지정 database_name합니다.Specifies that the new property list is created by copying an existing property list from database_name. 경우 source_list_name CREATE SEARCH PROPERTY LIST 실패 오류가 발생 하 여 존재 하지 않습니다.If source_list_name does not exist, CREATE SEARCH PROPERTY LIST fails with an error. 검색 속성 source_list_name 상속 new_list_name합니다.The search properties in source_list_name are inherited by new_list_name.

권한 부여 owner_nameAUTHORIZATION owner_name
속성 목록을 소유할 사용자 또는 역할 이름을 지정합니다.Specifies the name of a user or role to own of the property list. owner_name 는 현재 사용자가 멤버, 또는 현재 사용자 대 한 IMPERSONATE 권한이 있어야 하는 역할의 이름 이어야 합니다. owner_name합니다.owner_name must either be the name of a role of which the current user is a member, or the current user must have IMPERSONATE permission on owner_name. 값을 지정하지 않으면 현재 사용자에게 소유권이 부여됩니다.If not specified, ownership is given to the current user.

참고

사용 하 여 소유자를 변경할 수는 ALTER AUTHORIZATION Transact-SQLTransact-SQL 문.The owner can be changed by using the ALTER AUTHORIZATION Transact-SQLTransact-SQL statement.

주의Remarks

참고

속성에 대 한 정보는 일반적으로 참조 검색 속성 목록으로 문서 속성 검색합니다.For information about property lists in general, see Search Document Properties with Search Property Lists.

기본적으로 새 검색 속성 목록은 비어 있으므로 검색 속성 목록을 변경하여 하나 이상의 검색 속성을 수동으로 추가해야 합니다.By default, a new search property list is empty and you must alter it to manually to add one or more search properties. 또는 기존 검색 속성 목록을 복사할 수 있습니다.Alternatively, you can copy an existing search property list. 이 경우 새 목록이 해당 원본의 검색 속성을 상속하지만 새 목록을 변경하여 검색 속성을 추가하거나 제거할 수 있습니다.In this case, the new list inherits the search properties of its source, but you can alter the new list to add or remove search properties. 다음 번 전체 채우기를 수행할 당시의 검색 속성 목록의 속성이 전체 텍스트 인덱스에 포함됩니다.Any properties in the search property list at the time of the next full population are included in the full-text index.

다음 조건에서는 CREATE SEARCH PROPERTY LIST 문이 실패합니다.A CREATE SEARCH PROPERTY LIST statement fails under any of the following conditions:

사용 권한 Permissions

현재 데이터베이스에서 CREATE FULLTEXT CATALOG 권한이 필요하고 원본 속성 목록을 복사하는 데이터베이스에 대한 REFERENCES 권한이 필요합니다.Requires CREATE FULLTEXT CATALOG permissions in the current database and REFERENCES permissions on any database from which you copy a source property list.

참고

목록을 전체 텍스트 인덱스와 연결하려면 REFERENCES 권한이 필요합니다.REFERENCES permission is required to associate the list with a full-text index. 속성을 추가 및 제거하거나 목록을 삭제하려면 CONTROL 권한이 필요합니다.CONTROL permission is required to add and remove properties or drop the list. 속성 목록 소유자는 목록에 대한 REFERENCES 또는 CONTROL 권한을 부여할 수 있습니다.The property list owner can grant REFERENCES or CONTROL permissions on the list. CONTROL 권한을 가진 사용자는 다른 사용자에게 REFERENCES 권한을 부여할 수도 있습니다.Users with CONTROL permission can also grant REFERENCES permission to other users.

Examples

1.A. 빈 속성 목록을 만들고 인덱스와 연결Creating an empty property list and associating it with an index

다음 예에서는 DocumentPropertyList라는 새 검색 속성 목록을 만듭니다.The following example creates a new search property list named DocumentPropertyList. 이 예제에서는 다음 사용 하 여는 ALTER FULLTEXT INDEX 문을의 전체 텍스트 인덱스와 새 속성 목록 연결에 Production.Document 테이블에 AdventureWorks 채우기를 시작 하지 않고 데이터베이스입니다.The example then uses an ALTER FULLTEXT INDEX statement to associate the new property list with the full-text index of the Production.Document table in the AdventureWorks database, without starting a population.

참고

이 검색 속성 목록에 몇 가지 미리 정의 된, 잘 알려진 검색 속성을 추가 하는 예제를 참조 하세요. ALTER SEARCH PROPERTY list( Transact SQL ) .For an example that adds several predefined, well-known search properties to this search property list, see ALTER SEARCH PROPERTY LIST (Transact-SQL). 목록에 검색 속성을 추가한 후에는 데이터베이스 관리자가 다른 ALTER FULLTEXT INDEX 문을 START FULL POPULATION 절과 함께 사용해야 합니다.After adding search properties to the list, the database administrator would need to use another ALTER FULLTEXT INDEX statement with the START FULL POPULATION clause.

CREATE SEARCH PROPERTY LIST DocumentPropertyList;  
GO  
USE AdventureWorks2012;  
ALTER FULLTEXT INDEX ON Production.Document   
   SET SEARCH PROPERTY LIST DocumentPropertyList  
   WITH NO POPULATION;   
GO   

2.B. 기존 속성 목록을 사용하여 속성 목록 만들기Creating a property list from an existing one

다음 예에서는 예 1에서 만든 목록 JobCandidateProperties로 새 검색 속성 목록 DocumentPropertyList를 만듭니다. 기존 목록은 AdventureWorks2012 데이터베이스에서 전체 텍스트 인덱스와 연결되어 있습니다.The following example creates a new the search property list, JobCandidateProperties, from the list created by Example A, DocumentPropertyList, which is associated with a full-text index in the AdventureWorks2012 database. 그런 다음 이 예에서는 ALTER FULLTEXT INDEX 문을 사용하여 새 속성 목록을 HumanResources.JobCandidate 데이터베이스에 있는 AdventureWorks2012 테이블의 전체 텍스트 인덱스와 연결합니다.The example then uses an ALTER FULLTEXT INDEX statement to associate the new property list with the full-text index of the HumanResources.JobCandidate table in the AdventureWorks2012 database. 이 ALTER FULLTEXT INDEX 문이 전체 채우기를 시작합니다. 전체 채우기는 SET SEARCH PROPERTY LIST 절의 기본 동작입니다.This ALTER FULLTEXT INDEX statement starts a full population, which is the default behavior of the SET SEARCH PROPERTY LIST clause.

CREATE SEARCH PROPERTY LIST JobCandidateProperties 
FROM AdventureWorks2012.DocumentPropertyList;  
GO  
ALTER FULLTEXT INDEX ON HumanResources.JobCandidate   
   SET SEARCH PROPERTY LIST JobCandidateProperties;  
GO  

관련 항목:See Also

ALTER SEARCH PROPERTY list( Transact SQL ) ALTER SEARCH PROPERTY LIST (Transact-SQL)
DROP SEARCH PROPERTY list( Transact SQL ) DROP SEARCH PROPERTY LIST (Transact-SQL)
sys.registered_search_properties( Transact SQL ) sys.registered_search_properties (Transact-SQL)
sys.registered_search_property_lists( Transact SQL ) sys.registered_search_property_lists (Transact-SQL)
sys.dm_fts_index_keywords_by_property( Transact SQL ) sys.dm_fts_index_keywords_by_property (Transact-SQL)
검색 속성 목록을 사용하여 문서 속성 검색 Search Document Properties with Search Property Lists
검색 속성의 속성 집합 GUID 및 속성 정수 ID찾기Find Property Set GUIDs and Property Integer IDs for Search Properties