Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Van toepassing op:
SQL Server
Hiermee voegt u een Database Mail-account toe aan een Database Mail-profiel. Voer sysmail_add_profileaccount_sp uit nadat een databaseaccount is gemaakt met sysmail_add_account_sp en er wordt een databaseprofiel gemaakt met sysmail_add_profile_sp.
Transact-SQL syntaxis-conventies
Syntaxis
sysmail_add_profileaccount_sp { [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' } ,
{ [ @account_id = ] account_id | [ @account_name = ] 'account_name' }
[ , [ @sequence_number = ] sequence_number ]
[ ; ]
Argumenten
[ @profile_id = ] profile_id
De profiel-id waaraan het account moet worden toegevoegd.
@profile_id is int, met een standaardwaarde van NULL. De @profile_id of de @profile_name moeten worden opgegeven.
[ @profile_name = ] 'profile_name'
De profielnaam waaraan het account moet worden toegevoegd.
@profile_name is sysname, met een standaardwaarde van NULL. De @profile_id of de @profile_name moeten worden opgegeven.
[ @account_id = ] account_id
De account-id die moet worden toegevoegd aan het profiel.
@account_id is int, met een standaardwaarde van NULL. De @account_id of de @account_name moeten worden opgegeven.
[ @account_name = ] 'account_name'
De naam van het account dat u aan het profiel wilt toevoegen.
@account_name is sysname, met een standaardwaarde van NULL. De @account_id of de @account_name moeten worden opgegeven.
[ @sequence_number = ] sequence_number
Het volgnummer van het account binnen het profiel. @sequence_number is niet standaard ingesteld. Het volgnummer bepaalt de volgorde waarin accounts worden gebruikt in het profiel.
Codewaarden retourneren
0 (geslaagd) of 1 (mislukt).
Opmerkingen
Zowel het profiel als het account moeten al bestaan. Anders retourneert de opgeslagen procedure een fout.
Met deze opgeslagen procedure wordt het volgnummer van een account dat al aan het opgegeven profiel is gekoppeld, niet gewijzigd. Zie sysmail_update_profileaccount_sp voor meer informatie over het bijwerken van het volgnummer van een account.
Het volgnummer bepaalt de volgorde waarin Database Mail accounts in het profiel gebruikt. Voor een nieuw e-mailbericht begint Database Mail met het account met het laagste volgnummer. Als dat account mislukt, gebruikt Database Mail het account met het eerstvolgende hoogste volgnummer, enzovoort, totdat Database Mail het bericht met succes verzendt, of het account met het hoogste volgnummer mislukt. Als het account met het hoogste volgnummer mislukt, onderbreekt Database Mail pogingen om de e-mail te verzenden voor de hoeveelheid tijd die is geconfigureerd in de AccountRetryDelay parameter van sysmail_configure_sp, en start het proces van het opnieuw verzenden van de e-mail, beginnend met het laagste reeksnummer. Gebruik de AccountRetryAttempts parameter van sysmail_configure_sp, om het aantal keren te configureren dat het externe e-mailproces probeert het e-mailbericht te verzenden met elk account in het opgegeven profiel.
Als er meer dan één account bestaat met hetzelfde volgnummer, gebruikt Database Mail slechts één van deze accounts voor een bepaald e-mailbericht. In dit geval geeft Database Mail geen garanties over welke van de accounts wordt gebruikt voor dat volgnummer of dat hetzelfde account wordt gebruikt van bericht naar bericht.
De opgeslagen procedure sysmail_add_profileaccount_sp bevindt zich in de msdb database en is eigendom van het dbo-schema . De procedure moet worden uitgevoerd met een driedelige naam als de huidige database dat niet msdbis.
Machtigingen
U kunt EXECUTE machtigingen verlenen voor deze procedure, maar deze machtigingen worden mogelijk overschreven tijdens een SQL Server-upgrade.
Voorbeelden
In het volgende voorbeeld wordt het profiel AdventureWorks Administrator gekoppeld aan het account Audit Account. Het auditaccount heeft een volgnummer van 1.
EXECUTE msdb.dbo.sysmail_add_profileaccount_sp
@profile_name = 'AdventureWorks Administrator',
@account_name = 'Audit Account',
@sequence_number = 1;