sysmail_add_account_sp (Transact-SQL)

2025-06-28

Dotyczy:SQL Server Azure SQL Managed Instance

Tworzy nowe konto poczty bazy danych zawierające informacje o koncie SMTP.

Składnia

sysmail_add_account_sp [ @account_name = ] 'account_name' ,
    [ @email_address = ] 'email_address' ,
    [ [ @display_name = ] 'display_name' , ]
    [ [ @replyto_address = ] 'replyto_address' , ]
    [ [ @description = ] 'description' , ]
    [ @mailserver_name = ] 'server_name'
    [ , [ @mailserver_type = ] 'server_type' ]
    [ , [ @port = ] port_number ]
    [ , [ @username = ] 'username' ]
    [ , [ @password = ] 'password' ]
    [ , [ @use_default_credentials = ] use_default_credentials ]
    [ , [ @enable_ssl = ] enable_ssl ]
    [ , [ @account_id = ] account_id OUTPUT ]
[ ; ]

Argumenty (w programowaniu)

[ @account_name = ] 'account_name'

Nazwa konta do dodania. @account_name jest nazwą systemu bez wartości domyślnej.

[ @email_address = ] 'email_address'

Adres e-mail do wysłania wiadomości. Ten adres musi być adresem e-mail internetowym. @email_address to nvarchar(128), bez wartości domyślnej. Na przykład konto agenta programu SQL Server może wysyłać wiadomość e-mail z adresu SqlAgent@adventure-works.com.

[ @display_name = ] 'display_name'

Nazwa wyświetlana do użycia w wiadomościach e-mail z tego konta. @display_name to nvarchar(128), z wartością domyślną NULL. Na przykład konto agenta programu SQL Server może wyświetlać nazwę SQL Server Agent Automated Mailer w wiadomościach e-mail.

[ @replyto_address = ] 'replyto_address'

Adres, do którego są wysyłane odpowiedzi na komunikaty z tego konta. @replyto_address to nvarchar(128), z wartością domyślną NULL. Na przykład odpowiedzi na konto agenta programu SQL Server mogą przejść do administratora bazy danych, danw@adventure-works.com.

[ @description = ] "opis"

Opis konta. @description to nvarchar(256), z wartością domyślną NULL.

[ @mailserver_name = ] 'server_name'

Nazwa lub adres IP serwera poczty SMTP do użycia dla tego konta. Komputer z uruchomionym programem SQL Server musi mieć możliwość rozpoznania @mailserver_name na adres IP. @mailserver_name to nazwa systemu bez wartości domyślnej.

[ @mailserver_type = ] 'server_type'

Typ serwera poczty e-mail. @mailserver_type to nazwa systemu z wartością domyślną SMTP.

[ @port = ] port_number

Numer portu serwera poczty e-mail. @port jest int z wartością domyślną 25.

[ @username = ] 'username'

Nazwa użytkownika używana do logowania się na serwerze poczty e-mail. @username to nvarchar(128), z wartością domyślną NULL. Jeśli ten parametr ma NULLwartość , poczta bazy danych nie używa uwierzytelniania dla tego konta. Jeśli serwer poczty nie wymaga uwierzytelniania, użyj nazwy NULL użytkownika.

[ @password = ] 'password'

Hasło używane do logowania się na serwerze poczty e-mail. @password to nvarchar(128), z wartością domyślną NULL. Nie ma potrzeby podawania hasła, chyba że zostanie określona nazwa użytkownika.

[ @use_default_credentials = ] use_default_credentials

Określa, czy wysyłać pocztę na serwer SMTP przy użyciu poświadczeń aparatu bazy danych programu SQL Server. @use_default_credentials jest bitowa z wartością domyślną 0. Gdy ten parametr to 1, poczta bazy danych używa poświadczeń aparatu bazy danych. Jeśli ten parametr ma 0wartość , poczta bazy danych wysyła parametry @username i @password , jeśli są obecne, w przeciwnym razie wysyła wiadomość e-mail bez parametrów @username i @password .

[ @enable_ssl = ] enable_ssl

Określa, czy poczta bazy danych szyfruje komunikację przy użyciu protokołu Secure Sockets Layer. @enable_ssl jest bitowa z wartością domyślną 0.

[ @account_id = ] account_id DANE WYJŚCIOWE

Zwraca identyfikator konta dla nowego konta. @account_id jest int z wartością domyślną NULL.

Zwracanie wartości kodu

0 (powodzenie) lub 1 (niepowodzenie).

Uwagi

Poczta bazy danych udostępnia oddzielne parametry dla @email_address, @display_name i @replyto_address. Parametr @email_address to adres, z którego jest wysyłany komunikat. Parametr @display_name to nazwa wyświetlana w From: polu wiadomości e-mail. Parametr @replyto_address to adres, w którym będą wysyłane odpowiedzi na wiadomość e-mail. Na przykład konto używane dla agenta programu SQL Server może wysyłać wiadomości e-mail z adresu e-mail, który jest używany tylko dla agenta programu SQL Server. Komunikaty z tego adresu powinny wyświetlać przyjazną nazwę, aby adresaci mogli łatwo określić, że program SQL Server Agent wysłał wiadomość. Jeśli adresat odpowiada na wiadomość, odpowiedź powinna zostać wysłana do administratora bazy danych, a nie adresu używanego przez agenta programu SQL Server. W tym scenariuszu konto jest używane SqlAgent@adventure-works.com jako adres e-mail. Nazwa wyświetlana jest ustawiona na SQL Server Agent Automated Mailer. Konto używa danw@adventure-works.com jako odpowiedzi na adres, dlatego odpowiada na wiadomości wysyłane z tego konta do administratora bazy danych, a nie adresu e-mail agenta programu SQL Server. Udostępniając niezależne ustawienia dla tych trzech parametrów, poczta bazy danych umożliwia skonfigurowanie wiadomości zgodnie z potrzebami.

Parametr @mailserver_type obsługuje wartość SMTP.

Gdy @use_default_credentials to 1, poczta jest wysyłana do serwera SMTP przy użyciu poświadczeń aparatu bazy danych programu SQL Server. Gdy @use_default_credentials i 0@username i @password są określone dla konta, konto używa uwierzytelniania SMTP. @username i@password to poświadczenia używane przez konto dla serwera SMTP, a nie poświadczenia dla programu SQL Server lub sieci, na których znajduje się komputer.

Procedura sysmail_add_account_sp składowana znajduje się w msdb bazie danych i jest własnością schematu dbo . Procedura musi być wykonywana z trzyczęściową nazwą, jeśli bieżąca baza danych nie msdbjest .

Uprawnienia

Możesz udzielić EXECUTE uprawnień do tej procedury, ale te uprawnienia mogą zostać zastąpione podczas uaktualniania programu SQL Server.

Przykłady

Poniższy przykład tworzy konto o nazwie AdventureWorks Administrator. Konto używa adresu dba@adventure-works.com e-mail i wysyła wiadomość e-mail na serwer smtp.adventure-works.compoczty SMTP. Wiadomości e-mail wysyłane z tego konta są wyświetlane AdventureWorks Automated Mailer w From: wierszu wiadomości. Odpowiedzi na komunikaty są kierowane do .danw@adventure-works.com

EXECUTE msdb.dbo.sysmail_add_account_sp
    @account_name = 'AdventureWorks Administrator',
    @description = 'Mail account for administrative e-mail.',
    @email_address = 'dba@adventure-works.com',
    @display_name = 'AdventureWorks Automated Mailer',
    @mailserver_name = 'smtp.adventure-works.com';