Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
A következőkre vonatkozik:
SQL ServerAzure SQL Managed Instance
Létrehoz egy új Database Mail-fiókot, amely egy SMTP-fiók adatait tartalmazza.
Transact-SQL szintaxis konvenciók
Szemantika
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 ]
[ ; ]
Érvek
[ @account_name = ] 'account_name'
A hozzáadni kívánt fiók neve. @account_namea sysname, alapértelmezés nélkül.
[ @email_address = ] 'email_address'
A feladó e-mail címe. Ennek a címnek internetes e-mail-címnek kell lennie.
@email_addressnvarchar(128), alapértelmezés nélkül. Az SQL Server Agent-fiók például e-mailt küldhet a címről SqlAgent@adventure-works.com.
[ @display_name = ] 'display_name'
A fiók e-mail üzeneteihez használandó megjelenítendő név.
@display_namenvarchar(128), alapértelmezett értéke NULL. Előfordulhat például, hogy egy SQL Server Agent-fiók megjeleníti a nevet SQL Server Agent Automated Mailer az e-mailekben.
[ @replyto_address = ] 'replyto_address'
Az a cím, amely a fiókból érkező üzenetekre válaszol.
@replyto_addressnvarchar(128), alapértelmezés szerint NULL. Az SQL Server-ügynökhöz tartozó fiókra adott válaszok például az adatbázis rendszergazdájához fordulhatnak. danw@adventure-works.com
[ @description = ] 'leírás'
A fiók leírása.
@descriptionnvarchar(256), alapértelmezett értéke NULL.
[ @mailserver_name = ] 'server_name'
A fiókhoz használandó SMTP-levelezési kiszolgáló neve vagy IP-címe. Az SQL Servert futtató számítógépnek képesnek kell lennie a @mailserver_name IP-címre való feloldására. @mailserver_namesysname, alapértelmezés nélkül.
[ @mailserver_type = ] 'server_type'
Az e-mail-kiszolgáló típusa.
@mailserver_typea sysname, alapértelmezés szerint SMTPa .
[ @port = ] port_number
Az e-mail-kiszolgáló portszáma.
@portint, alapértelmezés szerint 25.
[ @username = ] "felhasználónév"
Az e-mail-kiszolgálóra való bejelentkezéshez használt felhasználónév.
@usernamenvarchar(128), alapértelmezett értéke NULL. Ha ez a paraméter, a NULLDatabase Mail nem használ hitelesítést ehhez a fiókhoz. Ha a levelezési kiszolgáló nem igényel hitelesítést, használja NULL a felhasználónevet.
[ @password = ] 'password'
Az e-mail-kiszolgálóra való bejelentkezéshez használt jelszó.
@passwordnvarchar(128), alapértelmezett értéke NULL. Nincs szükség jelszó megadására, hacsak nincs megadva felhasználónév.
[ @use_default_credentials = ] use_default_credentials
Megadja, hogy az SQL Server adatbázismotor hitelesítő adataival küldje-e el az e-mailt az SMTP-kiszolgálónak.
@use_default_credentialsbit, alapértelmezés szerint 0. Ha ez a paraméter, a 1Database Mail az adatbázismotor hitelesítő adatait használja. Ha ez a paraméter jelen van 0, a Database Mail elküldi a @username és @password paramétereket, ellenkező esetben @username és @password paraméterek nélkül küld leveleket.
[ @enable_ssl = ] enable_ssl
Megadja, hogy a Database Mail titkosítja-e a kommunikációt a Secure Sockets Layer használatával.
@enable_sslbit, alapértelmezés szerint 0.
[ @account_id = ] account_id KIMENET
Az új fiók fiókazonosítóját adja vissza.
@account_idint, alapértelmezés szerint NULL.
Kódértékek visszaadása
0 (sikeres) vagy 1 (hiba).
Megjegyzések
A Database Mail külön paramétereket biztosít @email_address, @display_name és @replyto_address számára. A @email_address paraméter az a cím, amelyről az üzenet el lesz küldve. A @display_name paraméter az e-mail mezőjében From: látható név. A @replyto_address paraméter az a cím, ahol az e-mailre adott válaszok lesznek elküldve. Az SQL Server Agenthez használt fiók például e-mail üzeneteket küldhet egy olyan e-mail címről, amelyet csak az SQL Server Agenthez használnak. A címről érkező üzeneteknek felhasználóbarát nevet kell megjelenítenie, így a címzettek könnyen megállapíthatják, hogy az SQL Server-ügynök küldte-e az üzenetet. Ha egy címzett válaszol az üzenetre, a válasznak az SQL Server Agent által használt cím helyett az adatbázis rendszergazdájához kell mennie. Ebben az esetben a fiók e-mail-címként szolgál SqlAgent@adventure-works.com . A megjelenítendő név a következőre SQL Server Agent Automated Mailervan állítva: . A fiók válaszként használja danw@adventure-works.com a címet, így az ebből a fiókból küldött üzenetekre adott válaszok az SQL Server Agent e-mail címe helyett az adatbázis rendszergazdájához kerülnek. A három paraméter független beállításainak biztosításával a Database Mail lehetővé teszi az üzenetek igényeinek megfelelő konfigurálását.
A @mailserver_type paraméter támogatja az értéket SMTP.
Ha @use_default_credentials van 1, a rendszer az SQL Server adatbázismotorjának hitelesítő adataival küldi el a leveleket az SMTP-kiszolgálónak. Ha @use_default_credentials van 0 , és egy fiókhoz @username és @password van megadva, a fiók SMTP-hitelesítést használ. A @username és a @password a fiók által az SMTP-kiszolgálóhoz használt hitelesítő adatok, nem pedig az SQL Server vagy a számítógép hálózatának hitelesítő adatai.
A tárolt eljárás sysmail_add_account_sp az msdb adatbázisban található, és a séma tulajdonosa dbo . Az eljárást háromrészes névvel kell végrehajtani, ha az aktuális adatbázis nem msdb.
Engedélyek
Ehhez az eljáráshoz EXECUTE engedélyeket adhat meg, de előfordulhat, hogy ezek az engedélyek felül lesznek bírálva egy SQL Server-frissítés során.
Példák
Az alábbi példa létrehoz egy fiókot AdventureWorks Administrator. A fiók az e-mail címet dba@adventure-works.com használja, és e-mailt küld az SMTP levelezőkiszolgálónak smtp.adventure-works.com. A fiókból küldött e-mailek az From: üzenet sorában jelennek megAdventureWorks Automated Mailer. Az üzenetekre adott válaszokat a rendszer a következőre danw@adventure-works.comirányítja: .
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';