sp_add_proxy (Transact-SQL)

適用対象: はいSQL Server (サポートされているすべてのバージョン)

指定されたエージェントプロキシを追加し SQL Server ます。

トピック リンク アイコン Transact-SQL 構文表記規則

構文

  
sp_add_proxy  
    [ @proxy_name = ] 'proxy_name' ,  
    [ @enabled = ] is_enabled ,  
    [ @description = ] 'description' ,  
    [ @credential_name = ] 'credential_name' ,  
    [ @credential_id = ] credential_id ,  
    [ @proxy_id = ] id OUTPUT   

引数

[ @proxy_name = ] 'proxy_name' 作成するプロキシの名前。 Proxy_namesysname で、既定値は NULL です。 Proxy_name が NULL または空の文字列の場合、プロキシの名前は既定で指定 user_name に設定されます。

[ @enabled = ] is_enabled プロキシが有効かどうかを指定します。 Is_enabled フラグは tinyint,、既定値は1です。 Is_enabled0 の場合、プロキシは有効ではなく、ジョブステップでは使用できません。

[ @description = ] 'description' プロキシの説明。 説明は nvarchar (512),、既定値は NULL です。 この説明はプロキシを記述する場合の参照情報として利用できますが、それ以外の目的では、SQL Server エージェントによってこの説明が使用されることはありません。 このため、この引数は省略可能です。

[ @credential_name = ] 'credential_name' プロキシの資格情報の名前。 Credential_namesysname で、既定値は NULL です。 Credential_name または credential_id のいずれかを指定する必要があります。

[ @credential_id = ] credential_id プロキシの資格情報の識別番号を指定します。 Credential_idint,、既定値は NULL です。 Credential_name または credential_id のいずれかを指定する必要があります。

[ @proxy_id = ] id OUTPUT 正常に作成された場合にプロキシに割り当てられたプロキシ id 番号。

リターン コードの値

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

結果セット

なし

解説

このストアドプロシージャは、 msdb データベースで実行する必要があります。

SQL Server エージェント プロキシは、Transact-SQL サブシステム以外のサブシステムが含まれるジョブ ステップのセキュリティを管理します。 各プロキシには対応するセキュリティ資格情報が 1 つあります。 プロキシは、任意の数のサブシステムにアクセスする可能性があります。

アクセス許可

このプロシージャを実行できるのは、 sysadmin 固定セキュリティロールのメンバーだけです。

Sysadmin 固定セキュリティロールのメンバーは、任意のプロキシを使用するジョブステップを作成できます。 ストアドプロシージャ sp_grant_login_to_proxy 使用して、 transact-sql)( し、他のログインにプロキシへのアクセスを許可します。

この例では、資格情報のプロキシを作成し CatalogApplicationCredential ます。 このコードは、資格情報が既に存在することを前提としています。 資格情報の詳細については、「 CREATE CREDENTIAL (transact-sql)」を参照してください。

USE msdb ;  
GO  
  
EXEC dbo.sp_add_proxy  
    @proxy_name = 'Catalog application proxy',  
    @enabled = 1,  
    @description = 'Maintenance tasks on catalog application.',  
    @credential_name = 'CatalogApplicationCredential' ;  
GO  

参照

CREATE CREDENTIAL (Transact-SQL)
sp_grant_login_to_proxy (Transact-sql)
sp_revoke_login_from_proxy (Transact-sql)