Megosztás a következőn keresztül:

sysmail_add_profile_sp (Transact-SQL)

A következőkre vonatkozik:SQL ServerAzure SQL Managed Instance

Létrehoz egy új Database Mail-profilt .

Transact-SQL szintaxis konvenciók

Szemantika

sysmail_add_profile_sp [ @profile_name = ] 'profile_name'
    [ , [ @description = ] N'description' ]
    [ , [ @profile_id = ] new_profile_id OUTPUT ]
[ ; ]

Érvek

[ @profile_name = ] 'profile_name'

Az új profil neve. @profile_namesysname, alapértelmezés nélkül.

Ha SQL Server Agent-feladatokkal szeretne e-mailt küldeni a felügyelt Azure SQL-példányban, az SQL Server Agent csak egy Database Mail-profilt használhat, és meg kell hívni AzureManagedInstance_dbmail_profile. További információ és példaszkript: Azure SQL Managed Instance SQL Agent-feladatértesítések.

[ @description = ] N'leírás'

Az új profil opcionális leírása. @descriptionnvarchar(256), alapértelmezés nélkül.

[ @profile_id = ] new_profile_id KIMENET

Az új profil azonosítóját adja vissza. @profile_idint, alapértelmezés szerint NULL.

Kódértékek visszaadása

0 (sikeres) vagy 1 (hiba).

Megjegyzések

A Database Mail-profilok tetszőleges számú Database Mail-fiókot tárolnak. A Database Mail tárolt eljárásai az eljárás által létrehozott profilnév vagy profilazonosító alapján hivatkozhatnak egy profilra. További információ a fiók profilhoz való hozzáadásáról: sysmail_add_profileaccount_sp.

A profil neve és leírása a tárolt eljárással sysmail_update_profile_spmódosítható, míg a profilazonosító állandó marad a profil élettartamához.

A profilnévnek egyedinek kell lennie az SQL Server adatbázismotor-példányában, vagy a tárolt eljárás hibát ad vissza.

A tárolt eljárás sysmail_add_profile_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

Egy. Új profil létrehozása

Az alábbi példa egy új Database Mail-profilt AdventureWorks Administratorhoz létre.

EXECUTE msdb.dbo.sysmail_add_profile_sp
    @profile_name = 'AdventureWorks Administrator',
    @description = 'Profile used for administrative mail.';

B. Új profil létrehozása, a profilazonosító mentése változóban

Az alábbi példa egy új Database Mail-profilt AdventureWorks Administratorhoz létre. A példa tárolja a profilazonosító számát a változóban @profileId , és visszaad egy eredményhalmazt, amely az új profil profilazonosító-számát tartalmazza.

DECLARE @profileId AS INT;

EXECUTE msdb.dbo.sysmail_add_profile_sp
    @profile_name = 'AdventureWorks Administrator',
    @description = 'Profile used for administrative mail.',
    @profile_id = @profileId OUTPUT;

SELECT @profileId;

Kapcsolódó tartalom

  • Last updated on