sysmail_help_account_sp (Transact-SQL)

適用対象:SQL Server

データベース メール アカウントに関する、パスワード以外の情報を一覧表示します。

Transact-SQL 構文表記規則

構文

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) 電子メール サーバーが認証を使用する場合に、電子メール サーバーへのサインインに使用するユーザー名。 NULL の場合username、データベース メールはこのアカウントの認証を使用しません。
use_default_credentials bit SQL Server データベース エンジンの資格情報を使用して SMTP サーバーにメールを送信するかどうかを指定します。 このパラメーターの場合、1データベース メールは SQL Server データベース エンジン サービスの資格情報を使用します。 このパラメーターの場合、0データベース メールは SMTP サーバーでの認証に@username@passwordを使用します。 @username@passwordが NULL の場合、データベース メールは匿名認証を使用します。 このパラメーターを指定する前に、SMTP 管理者に問い合わせてください。
enable_ssl bit データベース メールトランスポート層セキュリティ (TLS) (以前は Secure Sockets Layer (SSL) と呼ばれる) を使用して通信を暗号化するかどうかを指定します。 SMTP サーバーで TLS が必要な場合は、このオプションを使用します。 1は、TLS を使用して通信データベース メール暗号化を示します。 0 は、TLS 暗号化なしでメールを送信データベース メールを示します。

解説

account_idまたはaccount_nameが指定されていない場合は、 sysmail_help_account Microsoft SQL Server インスタンス内のすべてのデータベース メール アカウントに関する情報を一覧表示します。

ストアド プロシージャsysmail_help_account_spはデータベース内msdbにあり、dbo スキーマによって所有されています。 現在のデータベースが実行されていない msdb場合は、プロシージャを 3 部構成の名前で実行する必要があります。

アクセス許可

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

A. すべてのアカウントの情報を一覧表示する

次の例は、インスタンス内のすべてのアカウントのアカウント情報の一覧を示しています。

EXEC 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         AdventureWorks 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 というアカウントについて、アカウント情報を一覧表示します。

EXEC msdb.dbo.sysmail_help_account_sp
    @account_name = 'AdventureWorks Administrator';

次に結果セットを示します。行の長さは編集されています。

account_id  name                         description                             email_address             display_name                     replyto_address servertype servername                port        username use_default_credentials enable_ssl
----------- ---------------------------- ------------------------------------------------------ ------------------------- ---------------- ---------- ------------------------- ----------- -------- ----------------------- ----------
148         AdventureWorks Administrator Mail account for administrative e-mail. dba@adventure-works.com   AdventureWorks Automated Mailer  NULL            SMTP       smtp.adventure-works.com  25          NULL     0                       0