• Статья

sysmail_update_profileaccount_sp (Transact-SQL)

Обновляет порядковый номер учетной записи в профиле компонента 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 имеет тип int и не имеет значения по умолчанию. Порядковый номер определяет порядок, в соответствии с которым учетные записи используются в профиле.

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

0 (успешное завершение) или 1 (неуспешное завершение)

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

Нет

Замечания

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

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

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

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

Разрешения

Разрешения на выполнение этой процедуры принадлежат, по умолчанию, членам предопределенной роли сервера sysadmin.

Примеры

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

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