共用方式為

  • 發行項

sp_helpdistributor (Transact-SQL)

列出散發者、散發資料庫、工作目錄和 MicrosoftSQL Server Agent 使用者帳戶的相關資訊。這個預存程序執行於發行集資料庫或任何資料庫的發行者端。

主題連結圖示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=] 'distributor' OUTPUT
    這是散發者的名稱。散發者是 sysname，預設值是 %，它是唯一會傳回結果集的值。

  • [@distribdb=] 'distribdb' OUTPUT
    這是散發資料庫的名稱。distribdb 是 sysname，預設值是 %，它是唯一會傳回結果集的值。

  • [@directory=] 'directory' OUTPUT
    這是工作目錄。directory 是 nvarchar(255)，預設值是 %，它是唯一會傳回結果集的值。

  • [@account=] 'account' OUTPUT
    這是 Microsoft Windows 使用者帳戶。account 是 nvarchar(255)，預設值是 %，它是唯一會傳回結果集的值。

  • [@min_distretention=] min_distretentionOUTPUT
    這是最小散發保留期限 (以小時為單位)。min_distretention 是 int，預設值是 -1。

  • [@max_distretention=] max_distretentionOUTPUT
    這是最大散發保留期限 (以小時為單位)。max_distretention 是 int，預設值是 -1。

  • [@history_retention=] history_retentionOUTPUT
    這是記錄保留期限 (以小時為單位)。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，預設值是 %，它是唯一會傳回結果集的值。

結果集

資料行名稱

資料類型

描述

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 GATEWAY

傳回碼值

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

none

下列結果集資料行會傳回給在散發者端的發行集之發行集存取清單中的使用者：

  • directory

下列結果集資料行會傳回給所有使用者。

結果集資料行

輸出參數

distributor

@distributor

distribution database

@distribdb

rpc server name

@rpcsrvname

publisher type

@publisher_type