sysmail_update_profileaccount_sp (Transact-SQL)
Обновляет порядковый номер учетной записи в профиле компонента Database Mail.
.gif "Значок ссылки на раздел")
Синтаксические обозначения в 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 в профиле AdventureWorks Administrator в базе данных msdb. После выполнения этого кода порядковым номером для этой учетной записи будет 3, и, следовательно, эта учетная запись будет использована, если использование первых двух учетных записей завершится с ошибкой.
EXECUTE msdb.dbo.sysmail_update_profileaccount_sp
@profile_name = 'AdventureWorks Administrator',
@account_name = 'Admin-BackupServer',
@sequence_number = 3 ;
См. также
Справочник
Хранимые процедуры служб Database Mail и SQL Mail (Transact-SQL)
Другие ресурсы
Компонент Database Mail
Учетные записи компонента Database Mail
Профили Database Mail
Выбор задачи конфигурации (компонент Database Mail)