sp_helpdistributor (Transact-SQL)

  • Статья

Применимо к:SQL Server Управляемый экземпляр SQL Azure

Выводит сведения о распространителю, базе данных распространителя, рабочей папке и агент SQL Server учетной записи пользователя. Эта хранимая процедура выполняется на издателе для базы данных публикации или любой базы данных.

Соглашения о синтаксисе Transact-SQL

Синтаксис

sp_helpdistributor [ [ @distributor = ] 'distributor' OUTPUT ]
    [ , [ @distribdb = ] 'distribdb' OUTPUT ]
    [ , [ @directory = ] 'directory' OUTPUT ]
    [ , [ @account = ] 'account' OUTPUT ]
    [ , [ @min_distretention = ] min_distretention OUTPUT ]
    [ , [ @max_distretention = ] max_distretention OUTPUT ]
    [ , [ @history_retention = ] history_retention OUTPUT ]
    [ , [ @history_cleanupagent = ] 'history_cleanupagent' OUTPUT ]
    [ , [ @distrib_cleanupagent = ] 'distrib_cleanupagent' OUTPUT ]
    [ , [ @publisher = ] 'publisher' ]
    [ , [ @local = ] 'local' ]
    [ , [ @rpcsrvname = ] 'rpcsrvname' OUTPUT ]
    [ , [ @publisher_type = ] 'publisher_type' OUTPUT ]
[ ; ]

Аргументы

[ @distributor = ] 'распространитель' OUTPUT

Имя распространителя. @distributor — sysname, значение по умолчанию %— единственное значение, возвращающее результирующий набор.

[ @distribdb = ] 'distribdb' OUTPUT

Имя базы данных распространителя. @distribdb — sysname, значение по умолчанию %— единственное значение, возвращающее результирующий набор.

[ @directory = ] 'directory' OUTPUT

Рабочий каталог. @directory — nvarchar(255) с значением по умолчанию%, которое является единственным значением, возвращающим результирующий набор.

[ @account = ] 'account' OUTPUT

Учетная запись пользователя Microsoft Windows. @account — nvarchar(255) с значением по умолчанию%, которое является единственным значением, возвращающим результирующий набор.

[ @min_distretention = ] min_distretention OUTPUT

Минимальный период хранения распределения в часах. @min_distretention имеет значение int с значением по умолчанию-1.

[ @max_distretention = ] max_distretention ВЫХОДНЫЕ ДАННЫЕ

Максимальный период хранения распределения в часах. @max_distretention имеет значение int с значением по умолчанию-1.

[ @history_retention = ] history_retention OUTPUT

Период хранения журнала в часах. @history_retention имеет значение int с значением по умолчанию-1.

[ @history_cleanupagent = ] "history_cleanupagent" OUTPUT

Имя агента очистки журнала. @history_cleanupagent является nvarchar(100), значением по умолчанию %является единственное значение, возвращающее результирующий набор.

[ @distrib_cleanupagent = ] "distrib_cleanupagent" OUTPUT

Имя агента очистки дистрибутива. @distrib_cleanupagent является nvarchar(100), значением по умолчанию %является единственное значение, возвращающее результирующий набор.

[ @publisher = ] 'publisher'

Имя издателя. @publisher — sysname с значением по умолчаниюNULL.

[ @local = ] 'local'

Следует ли SQL Server получать значения локального сервера. @local — nvarchar(5) с значением по умолчаниюNULL.

[ @rpcsrvname = ] 'rpcsrvname' OUTPUT

Имя сервера, который выдает удаленные вызовы процедур. @rpcsrvname — sysname, значение по умолчанию %— единственное значение, возвращающее результирующий набор.

[ = ] @publisher_type "publisher_type" OUTPUT

Тип издателя издателя. @publisher_type имеет имя sysname с значением по умолчанию%, которое является единственным значением, возвращающим результирующий набор.

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

Имя столбца Тип данных Description
distributor sysname Имя распространителя.
distribution database sysname Имя базы данных распространителя.
directory nvarchar(255) Имя рабочего каталога.
account nvarchar(255) Имя учетной записи пользователя Windows.
min distrib retention int Минимальный срок хранения распространения.
max distrib retention int Максимальный срок хранения распространения.
history retention int Срок хранения журнала.
history cleanup agent nvarchar(100) Имя агента очистки журнала.
distribution cleanup agent nvarchar(100) Имя агента очистки распространителя.
rpc server name sysname Имя удаленного или локального распространителя.
rpc login name sysname Имя входа, используемое при удаленных вызовах процедур удаленного распространителя.
publisher type sysname Тип издателя; возможны следующие варианты:

-MSSQLSERVER
-ORACLE
— ШЛЮЗ ORACLE

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

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

Замечания

sp_helpdistributorиспользуется во всех типах реплика tion.

Если при выполнении sp_helpdistributorзадано одно или несколько выходных параметров, все выходные параметры, заданные null, присваиваются значениям при выходе, и результирующий набор не возвращается. Если выходных параметров нет, результирующий набор возвращается.

Разрешения

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

Столбец результирующего набора Выходной параметр
account @account
min distrib retention @min_distretention
max distrib retention @max_distretention
history retention @history_retention
history cleanup agent @history_cleanupagent
distribution cleanup agent @distrib_cleanupagent
rpc login name ничего

Пользователям из списка доступа публикации распространителя возвращается следующий столбец результирующего набора:

  • организации

Следующие столбцы результирующего набора возвращаются всем пользователям:

Столбец результирующего набора Выходной параметр
distributor @distributor
distribution database @distribdb
rpc server name @rpcsrvname
publisher type @publisher_type

См. также