sysmail_add_profile_sp (Transact-SQL)

  • Artículo

Se aplica a:SQL ServerAzure SQL Managed Instance

Crea un nuevo perfil de Correo electrónico de base de datos.

Convenciones de sintaxis de Transact-SQL

Sintaxis

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

Argumentos

[ @profile_name = ] 'profile_name'

Nombre del nuevo perfil. @profile_name es sysname, sin valor predeterminado.

Para enviar correo electrónico mediante trabajos de Agente SQL Server en Azure SQL Instancia administrada, Agente SQL Server solo puede usar un perfil de Correo electrónico de base de datos y se debe llamar a AzureManagedInstance_dbmail_profile. Para obtener más información y conseguir un script de ejemplo, vea Notificaciones de trabajo del Agente SQL de Azure SQL Managed Instance.

[ @description = ] N'description'

Descripción opcional del nuevo perfil. @description es nvarchar(256), sin ningún valor predeterminado.

[ @profile_id = ] new_profile_id OUTPUT

Devuelve el identificador del nuevo perfil. @profile_id es int, con un valor predeterminado de NULL.

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Comentarios

Un perfil de Correo electrónico de base de datos contiene cualquier número de cuentas de Correo electrónico de base de datos. Correo electrónico de base de datos procedimientos almacenados pueden hacer referencia a un perfil mediante el nombre del perfil o el identificador de perfil generado por este procedimiento. Para obtener más información sobre cómo agregar una cuenta a un perfil, consulte sysmail_add_profileaccount_sp (Transact-SQL).

El nombre y la descripción del perfil se pueden cambiar con el procedimiento sysmail_update_profile_spalmacenado, mientras que el identificador de perfil permanece constante durante la vida útil del perfil.

El nombre del perfil debe ser único en la instancia de SQL Server Motor de base de datos o el procedimiento almacenado devuelve un error.

El procedimiento sysmail_add_profile_sp almacenado está en la msdb base de datos y es propiedad del dbo esquema. El procedimiento debe ejecutarse con un nombre de tres partes si la base de datos actual no msdbes .

Permisos

Este procedimiento almacenado es propiedad del rol db_owner . Puede conceder EXECUTE permisos para cualquier usuario, pero estos permisos se pueden invalidar durante una actualización de SQL Server.

Ejemplos

A Crear nuevo perfil

En el ejemplo siguiente se crea un nuevo perfil de Correo electrónico de base de datos denominado AdventureWorks Administrator.

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

B. Cree un nuevo perfil y guarde el identificador de perfil en una variable.

En el ejemplo siguiente se crea un nuevo perfil de Correo electrónico de base de datos denominado AdventureWorks Administrator. En el ejemplo se almacena el número de id. de perfil en la variable @profileId y se devuelve un conjunto de resultados que contiene el número de id. de perfil para el nuevo perfil.

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;

Contenido relacionado