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 |
Значения кода возврата
0
(успешно) или 1
(сбой).
Замечания
sp_helpdistributor
используется во всех типах репликации.
Если при выполнении 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 |