Sdílet prostřednictvím


sysmail_add_account_sp (Transact-SQL)

platí pro:SQL Serverazure SQL Managed Instance

Vytvoří nový účet Databázové pošty, který obsahuje informace o účtu SMTP.

Transact-SQL konvence syntaxe

Syntaxe

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

[ @account_name = ] 'account_name'

Název účtu, který chcete přidat. @account_name je sysname bez výchozího nastavení.

[ @email_address = ] 'email_address'

E-mailová adresa, ze které chcete zprávu odeslat. Tato adresa musí být internetová e-mailová adresa. @email_address je nvarchar(128) bez výchozího nastavení. Například účet agenta SQL Serveru může odesílat e-maily z adresy SqlAgent@adventure-works.com.

[ @display_name = ] 'display_name'

Zobrazovaný název, který se má použít u e-mailových zpráv z tohoto účtu. @display_name je nvarchar(128) s výchozím nastavením NULL. Například účet agenta SQL Serveru může zobrazovat jméno SQL Server Agent Automated Mailer v e-mailových zprávách.

[ @replyto_address = ] 'replyto_address'

Adresa, do které se odesílají odpovědi na zprávy z tohoto účtu. @replyto_address je nvarchar(128), s výchozí hodnotou NULL. Odpovědi na účet agenta SQL Serveru můžou například přejít na správce databáze. danw@adventure-works.com

[ @description = ] 'popis'

Popis účtu. @description je nvarchar(256) s výchozím nastavením NULL.

[ @mailserver_name = ] 'server_name'

Název nebo IP adresa poštovního serveru SMTP, který se má použít pro tento účet. Počítač se systémem SQL Server musí být schopen přeložit @mailserver_name na IP adresu. @mailserver_name je sysname bez výchozího nastavení.

[ @mailserver_type = ] 'server_type'

Typ e-mailového serveru. @mailserver_type je sysname s výchozím nastavením SMTP.

[ @port = ] port_number

Číslo portu pro e-mailový server. @port je int, s výchozím nastavením 25.

[ @username = ] 'username'

Uživatelské jméno, které se má použít k přihlášení k e-mailovému serveru. @username je nvarchar(128), s výchozím nastavením NULL. Pokud je NULLtento parametr, databázová pošta pro tento účet nepoužívá ověřování. Pokud poštovní server nevyžaduje ověření, použijte NULL ho pro uživatelské jméno.

[ @password = ] 'password'

Heslo, které se má použít pro přihlášení k e-mailovému serveru. @password je nvarchar(128), s výchozím nastavením NULL. Není nutné zadávat heslo, pokud není zadané uživatelské jméno.

[ @use_default_credentials = ] use_default_credentials

Určuje, jestli se má pošta odeslat na server SMTP pomocí přihlašovacích údajů databázového stroje SQL Serveru. @use_default_credentials je bit s výchozím nastavením 0. Pokud je 1tento parametr , Database Mail používá přihlašovací údaje databázového stroje. Pokud je 0tento parametr , Databázová pošta odešle parametry @username a @password , pokud jsou k dispozici, v opačném případě odešle poštu bez @username a @password parametrů.

[ @enable_ssl = ] enable_ssl

Určuje, jestli databázová pošta šifruje komunikaci pomocí protokolu Secure Sockets Layer. @enable_ssl je bit, s výchozím nastavením 0.

[ @account_id = ] account_id VÝSTUP

Vrátí ID účtu pro nový účet. @account_id je int s výchozím nastavením NULL.

Hodnoty návratového kódu

0 (úspěch) nebo 1 (selhání).

Poznámky

Databázová pošta poskytuje samostatné parametry pro @email_address, @display_name a @replyto_address. Parametr @email_address je adresa, ze které je zpráva odeslána. Parametr @display_name je název zobrazený v From: poli e-mailové zprávy. Parametr @replyto_address je adresa, na kterou se budou odesílat odpovědi na e-mailovou zprávu. Například účet používaný pro agenta SQL Serveru může odesílat e-mailové zprávy z e-mailové adresy, která se používá pouze pro agenta SQL Serveru. Zprávy z této adresy by měly zobrazovat popisný název, aby příjemci mohli snadno určit, že agent SQL Serveru zprávu odeslal. Pokud příjemce odpoví na zprávu, měla by odpověď přejít na správce databáze místo adresy používané agentem SQL Serveru. V tomto scénáři se účet používá SqlAgent@adventure-works.com jako e-mailová adresa. Zobrazovaný název je nastaven na SQL Server Agent Automated Mailerhodnotu . Účet používá danw@adventure-works.com jako odpověď na adresu, takže odpovědi na zprávy odeslané z tohoto účtu se místo e-mailové adresy agenta SQL Serveru přejdou na správce databáze. Poskytnutím nezávislých nastavení těchto tří parametrů umožňuje Databázová pošta nakonfigurovat zprávy tak, aby vyhovovaly vašim potřebám.

Parametr @mailserver_type podporuje hodnotu SMTP.

Při @use_default_credentials se 1pošta odešle na server SMTP pomocí přihlašovacích údajů databázového stroje SQL Serveru. Pokud je0 @use_default_credentials a pro účet se zadává @username a @password , účet používá ověřování SMTP. @username a @password jsou přihlašovací údaje, které účet používá pro server SMTP, nikoli přihlašovací údaje pro SQL Server nebo síť, na které je počítač.

Uložená procedura sysmail_add_account_sp je v msdb databázi a je vlastněna schématem dbo . Pokud aktuální databáze není msdb, je nutné provést postup se třemi částmi.

Povolení

K tomuto postupu můžete udělit oprávnění EXECUTE, ale tato oprávnění se můžou při upgradu SQL Serveru přepsat.

Příklady

Následující příklad vytvoří účet s názvem AdventureWorks Administrator. Účet používá e-mailovou adresu dba@adventure-works.com a odesílá poštu na poštovní server smtp.adventure-works.comSMTP . E-mailové zprávy odeslané z tohoto účtu se zobrazují AdventureWorks Automated Mailer na From: řádku zprávy. Odpovědi na zprávy jsou směrovány na 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';