sp_helparticle (Transact-SQL)
Область применения: SQL Server (все поддерживаемые версии)
Управляемый экземпляр SQL Azure
Отображает сведения о статье. Эта хранимая процедура выполняется на издателе в базе данных публикации. Для издателей Oracle данная хранимая процедура выполняется распространителем для любой базы данных.
Синтаксические обозначения в Transact-SQL
Синтаксис
sp_helparticle [ @publication = ] 'publication'
[ , [ @article = ] 'article' ]
[ , [ @returnfilter = ] returnfilter ]
[ , [ @publisher = ] 'publisher' ]
[ , [ @found = ] found OUTPUT ]
Аргументы
[ @publication = ] 'publication'
Имя публикации. publication — sysname без значения по умолчанию.
[ @article = ] 'article'
Имя статьи в публикации. article — sysname с значением по умолчанию %. Если статья не указана, возвращается информация обо всех статьях для указанной публикации.
[ @returnfilter = ] returnfilter
Указывает, следует ли возвращать предложение фильтра. функция returnfilterимеет значение по умолчанию 1, которое возвращает предложение фильтра.
[ @publisher = ] 'publisher'
Указывает издатель, отличный от Microsoft SQL Server. Publisher — sysname с значением 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)