sp_helparticle (Transact-SQL)
Отображает сведения о статье. Эта хранимая процедура выполняется на издателе в базе данных публикации. Для издателей Oracle данная хранимая процедура выполняется распространителем для любой базы данных.
.gif "Значок ссылки на раздел")
Синтаксис
sp_helparticle [ @publication = ] 'publication'
[ , [ @article = ] 'article' ]
[ , [ @returnfilter = ] returnfilter ]
[ , [ @publisher = ] 'publisher' ]
[ , [ @found = ] found OUTPUT ]
Аргументы
[ @publication= ] 'publication'
Имя публикации. Аргумент publication имеет тип sysname и не имеет значения по умолчанию.[ @article = ] 'article'
Имя статьи в публикации. Аргумент article имеет тип sysname и значение по умолчанию %. Если аргумент article не указан, то возвращаются данные по всем статьям публикации.[ @returnfilter=] returnfilter
Указывает, должно ли возвращаться предложение фильтра. Аргумент returnfilter имеет тип bit и значение по умолчанию 1, при котором предложение фильтра возвращается.[ @publisher= ] 'publisher'
Задает издателя, отличного от MicrosoftSQL Server. Аргумент publisher имеет тип sysname и значение по умолчанию NULL..gif "Примечание")
ПримечаниеПри запросе сведений о статье, опубликованной издателем SQL Server, аргумент publisher не задается.
[ @found= ] found OUTPUT
Только для внутреннего использования.
Результирующие наборы
Имя столбца |
Тип данных |
Описание |
|---|---|---|
article id |
int |
Идентификатор статьи. |
article name |
sysname |
Имя статьи. |
base object |
nvarchar(257) |
Имя базовой таблицы, заданной в статье или в хранимой процедуре. |
destination object |
sysname |
Имя целевой таблицы (таблицы подписки). |
synchronization object |
nvarchar(257) |
Имя представления, определяющего опубликованную статью. |
type |
smallint |
Тип статьи: 1 = статья на основе журнала. 3 = статья на основе журнала с ручным фильтром. 5 = статья на основе журнала с ручным просмотром. 7 = статья на основе журнала с ручным фильтром и ручным просмотром. 8 = выполнение хранимой процедуры. 24 = выполнение сериализуемой хранимой процедуры. 32 = хранимая процедура (только схема). 64 = представление (только схема). 128 = функция (только схема). |
status |
tinyint |
Может являться результатом операции & (Bitwise AND) над одним или более свойством статьи: 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 |
Размер диапазона идентификаторов для издателя в случае, если параметр identityrangemanagementoption статьи имеет значение auto или параметр auto_identity_range имеет значение true. |
identity_range |
bigint |
Размер диапазона идентификаторов для подписчика в случае, если параметр identityrangemanagementoption статьи имеет значение auto или параметр auto_identity_range имеет значение true. |
threshold |
bigint |
Процентное значение, показывающее момент, когда агент распространителя выделяет новый диапазон идентификаторов. |
identityrangemanagementoption |
int |
Указывает способ управления диапазоном идентификаторов для статьи. |
fire_triggers_on_snapshot |
bit |
Используется в случае, когда реплицированные пользовательские триггеры срабатывают при применении исходного моментального снимка: 1 = триггеры выполняются. 0 = триггеры не выполняются. |
Значения кодов возврата
0 (успешное завершение) или 1 (неуспешное завершение)
Замечания
Функция sp_helparticle используется при репликации моментальных снимков и транзакций.
Разрешения
Процедура sp_helparticle может быть вызвана только членами предопределенной роли сервера sysadmin или предопределенной роли базы данных db_owner, а также лицами, внесенными в список доступа к публикации.
Пример
DECLARE @publication AS sysname;
SET @publication = N'AdvWorksProductTran';
USE [AdventureWorks]
EXEC sp_helparticle
@publication = @publication;
GO