sp_help_agent_profile (Transact-SQL)
指定されたエージェントのプロファイルを表示します。このストアド プロシージャは、ディストリビュータ側で任意のデータベースについて実行されます。
構文
sp_help_agent_profile [ [ @agent_type = ] agent_type ]
[ , [ @profile_id = ] profile_id ]
引数
[ @agent_type=] agent_type
エージェントのタイプを指定します。agent_type のデータ型は int で、既定値は 0 です。次のいずれかの値をとります。値 説明 1
スナップショット エージェント
2
ログ リーダー エージェント
3
ディストリビューション エージェント
4
マージ エージェント
9
キュー リーダー エージェント
- [ @profile_id=] profile_id
表示対象のプロファイルの ID を指定します。profile_id のデータ型は int で、既定値は -1 です。-1 は、MSagent_profiles テーブル内のすべてのプロファイルを返すことを示します。
結果セット
列名 | データ型 | 説明 |
---|---|---|
profile_id |
int |
プロファイルの ID です。 |
profile_name |
sysname |
エージェント タイプに一意です。 |
agent_type |
int |
1 = スナップショット エージェント 2 = ログ リーダー エージェント 3 = ディストリビューション エージェント 4 = マージ エージェント 9 = キュー リーダー エージェント |
Type |
int |
0 = システム 1 = カスタム |
description |
varchar(3000) |
プロファイルの説明です。 |
def_profile |
bit |
このプロファイルがこのエージェント タイプの既定値かどうかを示します。 |
解説
sp_help_agent_profile は、すべての種類のレプリケーションで使用します。
権限
sp_help_agent_profile を実行できるのは、固定サーバー ロール sysadmin または固定データベース ロール replmonitor のメンバだけです。
戻り値
成功した場合は 0 を、失敗した場合は 1 をそれぞれ返します。
参照
関連項目
sp_add_agent_profile (Transact-SQL)
sp_drop_agent_profile (Transact-SQL)
sp_help_agent_parameter (Transact-SQL)
その他の技術情報
レプリケーション エージェント プロファイルを扱う方法 (レプリケーション Transact-SQL プログラミング)