sp_help_proxy (Transact-SQL)
適用於:SQL Server
列出一或多個 Proxy 的資訊。
語法
sp_help_proxy
[ [ @proxy_id = ] proxy_id ]
[ , [ @proxy_name = ] N'proxy_name' ]
[ , [ @subsystem_name = ] N'subsystem_name' ]
[ , [ @name = ] N'name' ]
[ ; ]
引數
[ @proxy_id = ] proxy_id
要列出資訊的 Proxy 識別碼。 @proxy_id為 int,預設值為 NULL
。 您可以指定@proxy_id或@proxy_name。
[ @proxy_name = ] N'proxy_name'
要列出資訊的 Proxy 名稱。 @proxy_name為 sysname,預設值為 NULL
。 您可以指定@proxy_id或@proxy_name。
[ @subsystem_name = ] N'subsystem_name'
要列出 Proxy 的子系統名稱。 @subsystem_name為 sysname,預設值為 NULL
。 指定@subsystem_name時,也必須指定@name。
下表列出每個子系統的值。
值 | Description |
---|---|
ActiveScripting |
ActiveX 腳本 |
CmdExec |
作業系統 (CmdExec ) |
Snapshot |
Replication Snapshot Agent |
LogReader |
複寫記錄讀取器代理程式 |
Distribution |
Replication Distribution Agent |
Merge |
Replication Merge Agent |
QueueReader |
複寫佇列讀取器代理程式 |
ANALYSISQUERY |
Analysis Services 命令 |
ANALYSISCOMMAND |
Analysis Services 查詢 |
Dts |
SSIS 封裝執行 |
PowerShell |
PowerShell 指令碼 |
[ @name = ] N'name'
要列出 Proxy 的 SQL Server 登入名稱。 @name為 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,以及可能用於指定子系統的 Proxy。
權限
您可以授與此 EXECUTE
程序的許可權,但這些許可權可能會在 SQL Server 升級期間覆寫。
其他用戶必須在資料庫中獲得下列其中一個 SQL Server Agent 固定資料庫角色 msdb
:
- SQLAgentUserRole
- SQLAgentReaderRole
- SQLAgentOperatorRole
如需這些角色權限的詳細資訊,請參閱 SQL Server Agent 固定資料庫角色。
credential_identity
只有在 sysadmin 的成員執行這個預存程式時,才會在結果集中傳回 和 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