sp_helparticle (Transact-SQL)

Область применения: yesSQL Server (все поддерживаемые версии) YesУправляемый экземпляр SQL Azure

Отображает сведения о статье. Эта хранимая процедура выполняется на издателе в базе данных публикации. Для издателей Oracle данная хранимая процедура выполняется распространителем для любой базы данных.

Topic link iconСинтаксические обозначения в Transact-SQL

Синтаксис

  
sp_helparticle [ @publication = ] 'publication'   
    [ , [ @article = ] 'article' ]  
    [ , [ @returnfilter = ] returnfilter ]  
    [ , [ @publisher = ] 'publisher' ]  
    [ , [ @found = ] found OUTPUT ]  

Аргументы

[ @publication = ] 'publication' Имя публикации. publicationsysname без значения по умолчанию.

[ @article = ] 'article' Имя статьи в публикации. articlesysname с значением по умолчанию %. Если статья не указана, возвращается информация обо всех статьях для указанной публикации.

[ @returnfilter = ] returnfilter Указывает, следует ли возвращать предложение фильтра. функция returnfilterимеет значение по умолчанию 1, которое возвращает предложение фильтра.

[ @publisher = ] 'publisher' Указывает издатель, отличный от Microsoft SQL Server. Publishersysname с значением NULL по умолчанию.

Примечание

При запросе сведений о статье, опубликованной издателем SQL Server, не следует указывать издателя.

[ @found = ] found OUTPUT Только внутреннее использование.

Результирующие наборы

Имя столбца Тип данных Описание
идентификатор статьи int Идентификатор статьи.
article name sysname Имя статьи.
base object nvarchar(257) Имя базовой таблицы, заданной в статье или в хранимой процедуре.
Объект destination sysname Имя целевой таблицы (таблицы подписки).
synchronization object nvarchar(257) Имя представления, определяющего опубликованную статью.
type smallint Тип статьи:

1 = на основе журналов.

3 = на основе журналов с помощью ручного фильтра.

5 = на основе журналов с ручным представлением.

7 = на основе журналов с ручным фильтром и ручным представлением.

8 = выполнение хранимой процедуры.

24 = выполнение сериализуемой хранимой процедуры.

32 = хранимая процедура (только схема).

64 = просмотр (только схема).

96 = агрегатная функция (только схема).

128 = Функция (только схема).

257 = индексированные представления на основе журнала.

259 = индексированные представления на основе журналов с ручным фильтром.

261 = индексированные представления на основе журналов с ручным представлением.

263 = индексированные представления на основе журналов с ручным фильтром и ручным представлением.

320 = индексированное представление (только схема).

status tinyint Может быть результатом & (побитового И) одного или нескольких или следующих свойств статьи:

0x00 = идентифицировано только для информационных целей. Не поддерживается. Совместимость с будущими версиями не гарантируется.

0x01 = статья активна.

0x08 = Включить имя столбца в инструкции insert.

0x16 = использовать параметризованные инструкции.

0x32 = использовать параметризованные инструкции и включать имя столбца в инструкции insert.
filter nvarchar(257) Хранимая процедура, используемая для горизонтальной фильтрации таблиц. Данная хранимая процедура должна быть создана с помощью предложения FOR REPLICATION.
description nvarchar(255) Описание статьи.
insert_command nvarchar(255) Тип команды репликации, используемый при репликационной вставке в статьи таблицы. Дополнительные сведения см. в статье Указание способа распространения изменений для статей транзакций.
update_command nvarchar(255) Тип команды репликации, используемый при репликационном обновлении статей таблицы. Дополнительные сведения см. в статье Указание способа распространения изменений для статей транзакций.
delete_command nvarchar(255) Тип команды репликации, используемый при репликационном удалении в статьях таблицы. Дополнительные сведения см. в статье Указание способа распространения изменений для статей транзакций.
creation script path nvarchar(255) Путь и имя скрипта схемы статьи, используемого для создания целевых таблиц.
vertical partition bit Указывает, включено ли вертикальное секционирование для статьи; где значение 1 означает, что вертикальное секционирование включено.
pre_creation_cmd tinyint Команда, выполняемая перед инструкциями DROP TABLE, DELETE TABLE и TRUNCATE.
filter_clause ntext Предложение WHERE задает горизонтальную фильтрацию.
schema_option binary(8) Битовая карта параметра создания схемы для заданной статьи. Полный список значений schema_option см. в разделе sp_addarticle (Transact-SQL).
dest_owner sysname Имя владельца целевого объекта.
source_owner sysname Владелец исходного объекта.
unqua_source_object sysname Имя исходного объекта без учета имени его владельца.
sync_object_owner sysname Владелец представления, определяющего опубликованную статью. .
unqualified_sync_object sysname Имя представления, определяющего опубликованную статью, без учета имени владельца.
filter_owner sysname Владелец фильтра.
unqua_filter sysname Имя фильтра без учета имени его владельца.
auto_identity_range int Флаг, показывающий включение автоматической обработки диапазонов идентификаторов для публикации при ее создании. 1 означает, что включен диапазон автоматических удостоверений; 0 означает, что он отключен.
publisher_identity_range int Размер диапазона идентификаторов на издателе, если в статье задано значение auto или auto_identity_range задано значение true, если в статье задано значение identityrangemanagementoption.
identity_range bigint Размер диапазона идентификаторов на подписчике, если в статье задано значение auto или auto_identity_range задано значение true, если для статьи задано значение identityrangemanagementoption.
threshold bigint Процентное значение, показывающее момент, когда агент распространителя выделяет новый диапазон идентификаторов.
identityrangemanagementoption int Указывает способ управления диапазоном идентификаторов для статьи.
fire_triggers_on_snapshot bit Используется в случае, когда реплицированные пользовательские триггеры срабатывают при применении исходного моментального снимка:

1 = выполняются триггеры пользователя.

0 = триггеры пользователя не выполняются.

Значения кода возврата

0 (успешно) или 1 (сбой)

Remarks

sp_helparticle используется в репликации моментальных снимков и репликации транзакций.

Разрешения

Только члены предопределенных ролей сервера sysadmin , db_owner предопределенных ролей базы данных или список доступа к публикации для текущей публикации могут выполняться sp_helparticle.

Пример

DECLARE @publication AS sysname;
SET @publication = N'AdvWorksProductTran';

USE [AdventureWorks2012]
EXEC sp_helparticle
  @publication = @publication;
GO

См. также:

View and Modify Article Properties (Просмотр и изменение свойств статьи)
sp_addarticle (Transact-SQL)
sp_articlecolumn (Transact-SQL)
sp_changearticle (Transact-SQL)
sp_droparticle (Transact-SQL)
Хранимые процедуры репликации (Transact-SQL)