sp_help_proxy (Transact-SQL)
適用対象: SQL Server
1 つ以上のプロキシの情報を一覧表示します。
構文
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
関連するコンテンツ
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示