sp_syscollector_create_collector_type(Transact-SQL)

데이터 수집기에 사용할 수집기 유형을 만듭니다. 수집기 유형은 데이터를 수집하고 관리 데이터 웨어하우스에 이를 업로드하는 실제 메커니즘을 제공하는 SSIS 패키지에 대한 논리적 래퍼입니다.

Transact-SQL 구문 표기 규칙

구문

sp_syscollector_create_collector_type 
    [ [@collector_type_uid = ] 'collector_type_uid' OUTPUT ]
    , [ @name = ] 'name'
    , [ [ @parameter_schema = ] 'parameter_schema' ]
    , [ [ @parameter_formatter = ] 'parameter_formatter' ]
    , [ @collection_package_id = ] 'collection_package_id'
    , [ @upload_package_id = ] 'upload_package_id'

인수

• [ @collector\_type\_uid = ] 'collector_type_uid'
  수집기 유형의 GUID입니다. collector_type_uid는 uniqueidentifier이며 NULL인 경우 자동으로 만들어지고 OUTPUT으로 반환됩니다.

• [ @name = ] 'name'
  수집기 유형의 이름입니다. name은 sysname이며 반드시 지정해야 합니다.

• [ @parameter\_schema = ] 'parameter_schema'
  이 수집기 유형의 XML 스키마입니다. parameter_schema는 xml이며 기본값은 NULL입니다.

• [ @parameter\_formatter = ] 'parameter_formatter'
  컬렉션 집합 속성 페이지에서 맞게 XML을 변환하는 데 사용하는 템플릿입니다. parameter_formatter는 xml이며 기본값은 NULL입니다.

• [@collection_package_id = ] collection_package_id
  컬렉션 집합에 사용되는 SSIS 컬렉션 패키지를 가리키는 고유한 로컬 식별자입니다. collection_package_id는 uniqueidentifer이며 필수입니다.

• [@upload_package_id = ] upload_package_id
  컬렉션 집합에 사용되는 SSIS 업로드 패키지를 가리키는 고유한 로컬 식별자입니다. upload_package_id는 uniqueidentifier이며 필수입니다.

반환 코드 값

0(성공) 또는 1(실패)

사용 권한

이 프로시저를 실행하려면 dc_admin(EXECUTE 권한 있음) 고정 데이터베이스 역할의 멤버 자격이 필요합니다.

예

이렇게 하면 일반 T-SQL 쿼리 수집기 유형이 만들어집니다.

EXEC sp_syscollector_create_collector_type
@collector_type_uid = '302E93D1-3424-4be7-AA8E-84813ECF2419',
@name = 'Generic T-SQL Query Collector Type',
@parameter_schema = '<?xml version="1.0" encoding="utf-8"?>
  <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" targetNamespace="DataCollectorType">
    <xs:element name="TSQLQueryCollector">
      <xs:complexType>
        <xs:sequence>
          <xs:element name="Query" minOccurs="1" maxOccurs="unbounded">
            <xs:complexType>
              <xs:sequence>
                <xs:element name="Value" type="xs:string" />
                <xs:element name="OutputTable" type="xs:string" />
              </xs:sequence>
            </xs:complexType>
          </xs:element>
          <xs:element name="Databases" minOccurs="0" maxOccurs="1">
            <xs:complexType>
              <xs:sequence>
                <xs:element name="Database" minOccurs="0" maxOccurs="unbounded" type="xs:string" />
              </xs:sequence>
              <xs:attribute name="UseSystemDatabases" type="xs:boolean" use="optional" />
              <xs:attribute name="UseUserDatabases" type="xs:boolean" use="optional" />
            </xs:complexType>
          </xs:element>
        </xs:sequence>
      </xs:complexType>
    </xs:element>
  </xs:schema>',
@collection_package_id = '292B1476-0F46-4490-A9B7-6DB724DE3C0B',
@upload_package_id = '6EB73801-39CF-489C-B682-497350C939F0'
GO

참고 항목

참조

시스템 저장 프로시저(Transact-SQL)

개념

데이터 컬렉션

변경 내역

업데이트된 내용
@collector_type_uid 인수는 선택 사항임을 표시했습니다.
@parameter_formatter 인수를 추가했습니다.
"예" 섹션에서 코드를 업데이트했습니다.