sp_help_proxy (Transact-SQL)
列出一或多個 Proxy 的資訊。
語法
sp_help_proxy
[ @proxy_id = ] id,
[ @proxy_name = ] 'proxy_name' ,
[ @subsystem_name = ] 'subsystem_name' ,
[ @name = ] 'name'
引數
[ @proxy_id = ] id
要列出資訊的 Proxy 之 Proxy 識別碼。proxy_id 是 int,預設值是 NULL。您只能指定 id 或 proxy_name 其中之一。[ @proxy_name = ] 'proxy_name'
要列出資訊的 Proxy 名稱。proxy_name 是 sysname,預設值是 NULL。您只能指定 id 或 proxy_name 其中之一。[ @subsystem_name = ] 'subsystem_name'
要列出 Proxy 的子系統名稱。subsystem_name 是 sysname,預設值是 NULL。當指定 subsystem_name 時,也必須指定 name。下表列出每個子系統的值。
值
描述
ActiveScripting
ActiveX Script
CmdExec
作業系統 (CmdExec)
Snapshot
複寫快照集代理程式
LogReader
複寫記錄讀取器代理程式
Distribution
複寫散發代理程式
Merge
複寫合併代理程式
QueueReader
複寫佇列讀取器代理程式
ANALYSISQUERY
Analysis Services 命令
ANALYSISCOMMAND
Analysis Services 查詢
Dts
SSIS 封裝執行
PowerShell
PowerShell 指令碼
[ @name = ] 'name'
要列出 Proxy 的 SQL Server 登入名稱。這個名稱是 nvarchar(256),預設值是 NULL。當指定 name 時,也必須指定 subsystem_name。
傳回碼值
0 (成功) 或 1 (失敗)
結果集
資料行名稱 |
資料類型 |
描述 |
---|---|---|
proxy_id |
int |
Proxy 識別碼。 |
name |
sysname |
Proxy 的名稱。 |
credential_identity |
sysname |
Proxy 相關認證的 Microsoft Windows 網域名稱和使用者名稱。 |
enabled |
tinyint |
是否啟用這個 Proxy。{ 0 = 未啟用,1 = 已啟用 } |
description |
nvarchar(1024) |
這個 Proxy 的描述。 |
user_sid |
varbinary(85) |
這個 Proxy 的 Windows 使用者之 Windows 安全性識別碼。 |
credential_id |
int |
這個 Proxy 的相關認證識別碼。 |
credential_identity_exists |
int |
credential_identity 是否存在。{ 0 = 不存在,1 = 存在 } |
備註
當未提供任何參數時,sp_help_proxy 會列出執行個體中所有 Proxy 的資訊。
若要判斷登入在給定子系統上能夠使用哪些 Proxy,請指定 name 和 subsystem_name。當提供這些引數時,sp_help_proxy 會列出指定的登入能夠存取,且可供指定之子系統使用的 Proxy。
權限
依預設,只有系統管理員 (sysadmin) 固定伺服器角色的成員,才能夠執行這個預存程序。其他使用者必須被授與 msdb 資料庫的 SQLAgentOperatorRole 固定資料庫角色。
如需有關 SQLAgentOperatorRole 的詳細資料,請參閱<SQL Server Agent 固定資料庫角色>。
[!附註]
當系統管理員 (sysadmin) 的成員執行此預設程序時,在結果集內只傳回 credential_identity 和 user_sid 資料行。
範例
A. 列出所有 Proxy 的資訊
下列範例會列出執行個體中所有 Proxy 的資訊。
USE msdb ;
GO
EXEC dbo.sp_help_proxy ;
GO
B. 列出特定 Proxy 的資訊
下列範例會列出名稱為 Catalog application proxy 之 Proxy 的資訊。
USE msdb ;
GO
EXEC dbo.sp_help_proxy
@proxy_name = N'Catalog application proxy' ;
GO