sysmail_help_account_sp (Transact-SQL)
データベース メール アカウントに関する、パスワード以外の情報を一覧表示します。
.gif "トピック リンク アイコン")
構文
sysmail_help_account_sp [ [ @account_id = ] account_id | [ @account_name = ] 'account_name' ]
引数
[ @account_id = ] account_id
情報を一覧表示するアカウントのアカウント ID を指定します。account_id のデータ型は int で、既定値は NULL です。[ @account_name = ] 'account_name'
情報を一覧表示するアカウントの名前を指定します。account_name のデータ型は sysname で、既定値は NULL です。
リターン コード値
0 (成功) または 1 (失敗)
結果セット
次の列を含む結果セットを返します。
列名 |
データ型 |
説明 |
account_id |
int |
アカウントの ID。 |
name |
sysname |
アカウントの名前。 |
description |
nvarchar(256) |
アカウントの説明。 |
email_address |
nvarchar(128) |
メッセージ送信元の電子メール アドレス。 |
display_name |
nvarchar(128) |
アカウントの表示名。 |
replyto_address |
nvarchar(128) |
このアカウントからのメッセージに対する返信アドレス。 |
servertype |
sysname |
アカウントで使用されている電子メール サーバーの種類。 |
servername |
sysname |
アカウントで使用されている電子メール サーバーの名前。 |
port |
int |
電子メール サーバーで使用されているポート番号。 |
username |
nvarchar(128) |
電子メール サーバーで認証が使用されている場合に、電子メール サーバーへのサインインに使用するユーザー名。username が NULL の場合、データベース メールではこのアカウントに対して認証が使用されません。 |
use_default_credentials |
bit |
SQL Server データベース エンジンの資格情報を使用してメールを SMTP サーバーに送信するかどうかを指定します。use_default_credentials のデータ型は bit で、既定値は 0 です。このパラメーターが 1 の場合、データベース メールでは、SQL Server データベース エンジン サービスの資格情報が使用されます。このパラメーターが 0 の場合、データベース メールでは、SMTP サーバーでの認証に @username および @password が使用されます。@username および @password が NULL の場合、データベース メールでは、匿名認証が使用されます。このパラメーターを指定する前に、SMTP 管理者に問い合わせてください。 |
enable_ssl |
bit |
データベース メールで SSL (Secure Sockets Layer) を使用して通信を暗号化するかどうかを指定します。SMTP サーバーで SSL が必要な場合はこのオプションを使用します。enable_ssl のデータ型は bit で、既定値はありません。1 の場合、データベース メールでは SSL を使用して通信を暗号化することを示します。0 の場合、データベース メールでは SSL 暗号化を使用せずにメールを送信することを示します。 |
説明
account_id または account_name を指定しない場合、sysmail_help_account では、Microsoft SQL Server インスタンスのすべてのデータベース メール アカウントに関する情報が一覧表示されます。
ストアド プロシージャ sysmail_help_account_sp は msdb データベースにあり、dbo スキーマが所有しています。現在のデータベースが msdb でない場合、このプロシージャを実行するときには名前に 3 つの要素を指定する必要があります。
権限
このプロシージャの実行権限は、既定では sysadmin 固定サーバー ロールのメンバーに与えられています。
例
A. すべてのアカウントの情報を一覧表示する
次の例では、インスタンス内のすべてのアカウントについて、アカウント情報を一覧表示します。
EXECUTE msdb.dbo.sysmail_help_account_sp ;
次に結果セットを示します。行の長さは調整されています。
account_id name description email_address display_name replyto_address servertype servername port username use_default_credentials enable_ssl
----------- ---------------------------- --------------------------------------- ------------------------- -------------------------------- --------------- ---------- ------------------------- ----------- -------- ----------------------- ----------
148 AdventureWorks2008R2 Administrator Mail account for administrative e-mail. dba@Adventure-Works.com AdventureWorks Automated Mailer NULL SMTP smtp.Adventure-Works.com 25 NULL 0 0
149 Audit Account Account for audit e-mail. audit@Adventure-Works.com Automated Mailer (Audit) NULL SMTP smtp.Adventure-Works.com 25 NULL 0 0
B. 特定のジョブに関する情報を一覧表示する
次の例では、AdventureWorks Administrator というアカウントについて、アカウント情報を一覧表示します。
EXECUTE msdb.dbo.sysmail_help_account_sp
@account_name = 'AdventureWorks2008R2 Administrator' ;
次に結果セットを示します。行の長さは調整されています。
account_id name description email_address display_name replyto_address servertype servername port username use_default_credentials enable_ssl
----------- ---------------------------- ------------------------------------------------------ ------------------------- ---------------- ---------- ------------------------- ----------- -------- ----------------------- ----------
148 AdventureWorks2008R2 Administrator Mail account for administrative e-mail. dba@Adventure-Works.com AdventureWorks Automated Mailer NULL SMTP smtp.Adventure-Works.com 25 NULL 0 0