Поделиться через

sysmail_add_profile_sp (Transact-SQL)

  • Статья

Область применения: SQL Server Управляемый экземпляр SQL Azure

Создает новый профиль Database Mail .

Соглашения о синтаксисе Transact-SQL

Синтаксис

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

Аргументы

[ @profile_name = ] 'profile_name'

Имя нового профиля. @profile_name — sysname без значения по умолчанию.

Чтобы отправить электронную почту с помощью заданий агент SQL Server в Управляемый экземпляр SQL Azure, агент SQL Server может использовать только один профиль Database Mail, и его необходимо вызватьAzureManagedInstance_dbmail_profile. Дополнительные сведения и пример скрипта см. в Управляемый экземпляр SQL Azure уведомления о задании агента SQL.

[ @description = ] N'description'

Необязательное описание нового профиля. @description — nvarchar(256), без значения по умолчанию.

[ @profile_id = ] new_profile_id ВЫХОДНЫЕ ДАННЫЕ

Возвращает идентификатор нового профиля. @profile_id имеет значение int с значением по умолчаниюNULL.

Значения кода возврата

0 (успешно) или 1 (сбой).

Замечания

Профиль компонента Database Mail может хранить любое число учетных записей Database Mail. Хранимые процедуры Database Mail могут ссылаться на профиль по имени профиля или идентификатору профиля, созданному этой процедурой. Дополнительные сведения о добавлении учетной записи в профиль см. в sysmail_add_profileaccount_sp (Transact-SQL).

Имя и описание профиля можно изменить с помощью хранимой процедуры sysmail_update_profile_sp, а идентификатор профиля остается постоянным для жизни профиля.

Имя профиля должно быть уникальным в экземпляре SQL Server ядро СУБД или хранимая процедура возвращает ошибку.

Хранимая процедура sysmail_add_profile_sp находится в msdb базе данных и принадлежит схеме dbo . Процедура должна выполняться с трехкомпонентным именем, если текущая база данных не msdbявляется.

Разрешения

Эта хранимая процедура принадлежит роли db_owner . Вы можете предоставить EXECUTE разрешения для любого пользователя, но эти разрешения могут быть переопределены во время обновления SQL Server.

Примеры

А. Создать новый профиль

В следующем примере показано создание профиля компонента Database Mail с именем AdventureWorks Administrator.

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

B. Создание нового профиля, сохранение идентификатора профиля в переменной

В следующем примере показано создание профиля компонента Database Mail с именем AdventureWorks Administrator. В примере хранится номер идентификатора профиля в переменной @profileId и возвращается результирующий набор, содержащий номер идентификатора профиля для нового профиля.

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;

Связанный контент