sysmail_add_profile_sp (Transact-SQL)

  • Artikel

Gilt für:SQL ServerAzure SQL Managed Instance

Erstellt ein neues Datenbank-E-Mail Profil.

Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

[ @profile_name = ] 'profile_name'

Der Name des neuen Profils. @profile_name ist "sysname" ohne Standard.

Um E-Mails mit SQL Server-Agent Aufträgen in Azure SQL verwaltete Instanz zu senden, kann SQL Server-Agent nur ein Datenbank-E-Mail Profil verwenden und muss aufgerufen AzureManagedInstance_dbmail_profilewerden. Weitere Informationen und ein Beispielskript finden Sie unter Azure SQL verwaltete Instanz SQL Agent-Auftragsbenachrichtigungen.

[ @description = ] N'description'

Die optionale Beschreibung für das neue Profil. @description ist nvarchar(256) ohne Standard.

[ @profile_id = ] new_profile_id OUTPUT

Gibt die ID für das neue Profil zurück. @profile_id ist int, mit einem Standardwert von NULL.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler).

Hinweise

Ein Datenbank-E-Mail-Profil kann eine beliebige Anzahl von Datenbank-E-Mail-Konten enthalten. Datenbank-E-Mail gespeicherten Prozeduren können entweder anhand des Profilnamens oder der von diesem Verfahren generierten Profil-ID auf ein Profil verweisen. Weitere Informationen zum Hinzufügen eines Kontos zu einem Profil finden Sie unter sysmail_add_profileaccount_sp (Transact-SQL).

Der Profilname und die Beschreibung können mit der gespeicherten Prozedur sysmail_update_profile_spgeändert werden, während die Profil-ID für die Lebensdauer des Profils konstant ist Standard.

Der Profilname muss in der SQL Server-Datenbank-Engine Instanz eindeutig sein, oder die gespeicherte Prozedur gibt einen Fehler zurück.

Die gespeicherte Prozedur sysmail_add_profile_sp befindet sich in der msdb Datenbank und gehört dem dbo Schema. Die Prozedur muss mit einem dreiteiligen Namen ausgeführt werden, wenn die aktuelle Datenbank nicht msdbvorhanden ist.

Berechtigungen

Diese gespeicherte Prozedur gehört der db_owner Rolle. Sie können berechtigungen für jeden Benutzer erteilen EXECUTE , diese Berechtigungen können jedoch während eines SQL Server-Upgrades außer Kraft gesetzt werden.

Beispiele

.A Neues Profil erstellen

Im folgenden Beispiel wird ein neues Datenbank-E-Mail-Profil mit dem Namen AdventureWorks Administrator erstellt.

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

B. Erstellen eines neuen Profils, Speichern der Profil-ID in einer Variablen

Im folgenden Beispiel wird ein neues Datenbank-E-Mail-Profil mit dem Namen AdventureWorks Administrator erstellt. Im Beispiel wird die Profil-ID-Nummer in der Variablen @profileId gespeichert und ein Resultset zurückgegeben, das die Profil-ID-Nummer für das neue Profil enthält.

DECLARE @profileId INT;

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

SELECT @profileId;

Zugehöriger Inhalt