sysmail_update_profileaccount_sp (Transact-SQL)

Область применения: SQL Server

Обновляет порядковый номер учетной записи в профиле компонента Database Mail.

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

Синтаксис

sysmail_update_profileaccount_sp { [ @profile_id = ] profile_id
| [ @profile_name = ] 'profile_name' } ,
    { [ @account_id = ] account_id | [ @account_name = ] 'account_name' } ,
    [ @sequence_number = ] sequence_number
[ ; ]

Аргументы

[ @profile_id = ] profile_id

Идентификатор профиля для обновляемого профиля. @profile_id имеет значение int с значением по умолчаниюNULL. Необходимо указать @profile_id или @profile_name.

[ @profile_name = ] 'profile_name'

Имя профиля для обновляемого профиля. @profile_name имеет имя sysname с значением по умолчаниюNULL. Необходимо указать @profile_id или @profile_name.

[ @account_id = ] account_id

Идентификатор обновляемой учетной записи. @account_id имеет значение int с значением по умолчаниюNULL. Необходимо указать @account_id или @account_name.

[ @account_name = ] 'account_name'

Имя обновляемой учетной записи. @account_name имеет имя sysname с значением по умолчаниюNULL. Необходимо указать @account_id или @account_name.

[ @sequence_number = ] sequence_number

Новый порядковый номер для учетной записи в профиле. @sequence_number не используется без значения по умолчанию. Порядковый номер определяет порядок, в соответствии с которым учетные записи используются в профиле.

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

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

Результирующий набор

Нет.

Замечания

Возвращает ошибку, если указанная учетная запись не связана с указанным профилем.

Порядковый номер определяет порядок, в соответствии с которым компонент Database Mail использует учетные записи в профиле. Для нового сообщения электронной почты database Mail начинается с учетной записи, которая является самым низким порядковым номером. Если эта учетная запись завершается ошибкой, компонент Database Mail использует учетную запись со следующим самым высоким порядковым номером и т. д., пока компонент Database Mail не отправит сообщение успешно или учетная запись с самым высоким порядковым номером завершается ошибкой. Если использование учетной записи с наибольшим порядковым номером оказывается безуспешным, создание почтового сообщения завершается ошибкой.

Если существует больше одной учетной записи с одним и тем же порядковым номером, компонент Database Mail использует только одну из них для данного почтового сообщения. В этом случае компонент Database Mail не указывает, какая учетная запись используется для этого порядкового номера, и не гарантирует того, что от сообщения к сообщению используется одна и та же учетная запись.

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

Разрешения

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

Примеры

В следующем примере изменяется порядковый номер учетной записи Admin-BackupServer в профиле AdventureWorks Administrator в msdb базе данных. После выполнения этого кода порядковым номером для этой учетной записи будет 3, и, следовательно, эта учетная запись будет использована, если использование первых двух учетных записей завершится с ошибкой.

EXEC msdb.dbo.sysmail_update_profileaccount_sp
    @profile_name = 'AdventureWorks Administrator',
    @account_name = 'Admin-BackupServer',
    @sequence_number = 3;