sp_help_proxy (Transact-SQL)

適用対象: SQL Server

1 つ以上のプロキシの情報を一覧表示します。

Transact-SQL 構文表記規則

構文

sp_help_proxy
    [ [ @proxy_id = ] proxy_id ]
    [ , [ @proxy_name = ] N'proxy_name' ]
    [ , [ @subsystem_name = ] N'subsystem_name' ]
    [ , [ @name = ] N'name' ]
[ ; ]

引数

[ @proxy_id = ] proxy_id

情報を一覧表示するプロキシのプロキシ ID 番号。 @proxy_id は int で、既定値は NULL です。 @proxy_idまたは@proxy_nameを指定できます。

[ @proxy_name = ] N'proxy_name'

情報を一覧表示するプロキシの名前を指定します。 @proxy_name は sysname で、既定値は NULL です。 @proxy_idまたは@proxy_nameを指定できます。

[ @subsystem_name = ] N'subsystem_name'

プロキシを一覧表示するサブシステムの名前。 @subsystem_name は sysname で、既定値は NULL です。 @subsystem_nameを指定する場合は、@nameも指定する必要があります。

次の表に、各サブシステムの値を示します。

Value	説明
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'

プロキシを一覧表示する SQL Server ログインの名前。 @name は nvarchar(256) で、既定値は NULL です。 @nameを指定する場合は、@subsystem_nameも指定する必要があります。

リターン コードの値

0 (成功) または 1 (失敗)。

結果セット

列名	データ型	説明
proxy_id	int	プロキシ ID 番号。
name	sysname	プロキシの名前。
credential_identity	sysname	プロキシに関連付けられている資格情報の Microsoft Windows ドメイン名とユーザー名。
enabled	tinyint	このプロキシが有効かどうかを指定します。 0 = 無効、 1 = 有効。
description	nvarchar(1024)	このプロキシの説明。
user_sid	varbinary(85)	このプロキシの Windows ユーザーの Windows セキュリティ ID。
credential_id	int	このプロキシに関連付けられている資格情報の識別子。
credential_identity_exists	int	credential_identityが存在するかどうかを指定します。 0 = 存在しません。 1 = 存在します。

解説

パラメーターが指定されていない場合、 sp_help_proxy はインスタンス内のすべてのプロキシの情報を一覧表示します。

ログインが特定のサブシステムに使用できるプロキシを決定するには、 @name と @subsystem_nameを指定します。 これらの引数を指定すると、 sp_help_proxy は、指定されたログインがアクセスする可能性があり、指定したサブシステムで使用できるプロキシを一覧表示します。

アクセス許可

このストアド プロシージャは、 db_owner ロールによって所有されています。 EXECUTEアクセス許可は任意のユーザーに付与できますが、SQL Server のアップグレード中にこれらのアクセス許可がオーバーライドされる可能性があります。

他のユーザーには、msdb データベース内の次SQL Server エージェント固定データベース ロールのいずれかを付与する必要があります。

• SQLAgentUserRole
• SQLAgentReaderRole
• SQLAgentOperatorRole

これらのロールの権限の詳細については、「 SQL Server エージェントの固定データベース ロール」を参照してください。

credential_identity列とuser_sid列は、sysadminのメンバーがこのストアド プロシージャを実行した場合にのみ結果セットに返されます。

例

A. すべてのプロキシの情報を一覧表示する

次の例では、インスタンス内のすべてのプロキシの情報を一覧表示します。

USE msdb;
GO

EXEC dbo.sp_help_proxy;
GO

B. 特定のプロキシの情報を一覧表示する

次の例では、 Catalog application proxyという名前のプロキシの情報を一覧表示します。

USE msdb;
GO

EXEC dbo.sp_help_proxy
    @proxy_name = N'Catalog application proxy';
GO

関連するコンテンツ

• SQL Server エージェント ストアド プロシージャ (Transact-SQL)
• sp_add_proxy (Transact-SQL)
• sp_delete_proxy (Transact-SQL)