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

Журнал изменений

Обновления
Указано, что аргумент @collector_type_uid является необязательным.
Добавлен аргумент @parameter_formatter.
Обновлен код в разделе «Пример».

См. также

Справочник

Системные хранимые процедуры (Transact-SQL)

Другие ресурсы

Сбор данных