Sdílet prostřednictvím

sysmail_add_profile_sp (Transact-SQL)

platí pro:SQL Serverazure SQL Managed Instance

Vytvoří nový profil databázové pošty .

Transact-SQL konvence syntaxe

Syntaxe

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

Argumenty

[ @profile_name = ] 'profile_name'

Název nového profilu. @profile_name je sysname bez výchozího nastavení.

Pokud chcete odesílat e-maily pomocí úloh agenta SQL Serveru ve službě Azure SQL Managed Instance, může agent SQL Serveru používat pouze jeden profil databázové pošty a musí být volán AzureManagedInstance_dbmail_profile. Další informace a ukázkový skript najdete v tématu oznámení úlohy agenta SQL služby Azure SQL Managed Instance.

[ @description = ] N'popis'

Volitelný popis nového profilu. @description je nvarchar(256) bez výchozího nastavení.

[ @profile_id = ] new_profile_id VÝSTUP

Vrátí ID nového profilu. @profile_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

Profil databázové pošty obsahuje libovolný počet databázových poštovních účtů. Uložené procedury Databázové pošty můžou odkazovat na profil buď názvem profilu, nebo ID profilu vygenerovaným tímto postupem. Další informace o přidání účtu do profilu najdete v tématu sysmail_add_profileaccount_sp.

Název a popis profilu lze změnit pomocí uložené procedury sysmail_update_profile_sp, zatímco ID profilu zůstává konstantní po dobu životnosti profilu.

Název profilu musí být jedinečný v instanci databázového stroje SQL Serveru nebo uložená procedura vrátí chybu.

Uložená procedura sysmail_add_profile_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

A. Vytvoření nového profilu

Následující příklad vytvoří nový profil databázové pošty s názvem AdventureWorks Administrator.

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

B. Vytvoření nového profilu, uložení ID profilu do proměnné

Následující příklad vytvoří nový profil databázové pošty s názvem AdventureWorks Administrator. Příklad uloží číslo ID profilu do proměnné @profileId a vrátí sadu výsledků obsahující číslo ID profilu pro nový profil.

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;

Související obsah

  • Last updated on