sysmail_add_profile_sp (Transact-SQL)

  • Articolo

Si applica a: SQL Server Istanza gestita di SQL di Azure

Crea un nuovo profilo Posta elettronica database.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

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

Argomenti

[ @profile_name = ] 'profile_name'

Nome del nuovo profilo. @profile_name è sysname, senza impostazione predefinita.

Per inviare messaggi di posta elettronica tramite processi di SQL Server Agent in Istanza gestita di SQL di Azure, SQL Server Agent può usare un solo profilo Posta elettronica database e deve essere chiamato AzureManagedInstance_dbmail_profile. Per altre informazioni e uno script di esempio, vedere le notifiche dei processi di SQL Agent in Istanza gestita di SQL di Azure.

[ @description = ] N'description'

Descrizione facoltativa del nuovo profilo. @description è nvarchar(256), senza impostazione predefinita.

[ @profile_id = ] new_profile_id OUTPUT

Restituisce l'ID del nuovo profilo. @profile_id è int, con il valore predefinito NULL.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Osservazioni:

Un profilo di Posta elettronica database include qualsiasi numero di account di Posta elettronica database. Posta elettronica database stored procedure può fare riferimento a un profilo in base al nome del profilo o all'ID del profilo generato da questa procedura. Per altre informazioni sull'aggiunta di un account a un profilo, vedere sysmail_add_profileaccount_sp.

Il nome e la descrizione del profilo possono essere modificati con la stored procedure sysmail_update_profile_sp, mentre l'ID profilo rimane costante per la durata del profilo.

Il nome del profilo deve essere univoco nell'istanza di SQL Server motore di database oppure la stored procedure restituisce un errore.

La stored procedure sysmail_add_profile_sp si trova nel msdb database ed è di proprietà dello dbo schema. La procedura deve essere eseguita con un nome in tre parti se il database corrente non msdbè .

Autorizzazioni

Questa stored procedure è di proprietà del ruolo db_owner . È possibile concedere EXECUTE autorizzazioni per qualsiasi utente, ma queste autorizzazioni possono essere sottoposte a override durante un aggiornamento di SQL Server.

Esempi

R. Crea nuovo profilo

Nell'esempio seguente viene creato un nuovo profilo di Posta elettronica database denominato AdventureWorks Administrator.

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

B. Creare un nuovo profilo, salvando l'ID profilo in una variabile

Nell'esempio seguente viene creato un nuovo profilo di Posta elettronica database denominato AdventureWorks Administrator. Nell'esempio viene archiviato il numero ID del profilo nella variabile @profileId e viene restituito un set di risultati contenente il numero ID del profilo per il nuovo profilo.

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;

Contenuto correlato