Delen via

sysmail_add_profile_sp (Transact-SQL)

Van toepassing op:SQL ServerAzure SQL Managed Instance

Hiermee maakt u een nieuw Database Mail-profiel .

Transact-SQL syntaxis-conventies

Syntaxis

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

Argumenten

[ @profile_name = ] 'profile_name'

De naam voor het nieuwe profiel. @profile_name is sysname, zonder standaardwaarde.

Als u e-mail wilt verzenden met behulp van SQL Server Agent-taken in Azure SQL Managed Instance, kan SQL Server Agent slechts één Database Mail-profiel gebruiken en deze moet worden aangeroepen AzureManagedInstance_dbmail_profile. Zie Azure SQL Managed Instance SQL Agent-taakmeldingenvoor meer informatie en een voorbeeldscript.

[ @description = ] Beschrijving van'

De optionele beschrijving voor het nieuwe profiel. @description is nvarchar(256), zonder standaardinstelling.

[ @profile_id = ] new_profile_id UITVOER

Retourneert de id voor het nieuwe profiel. @profile_id is int, met een standaardwaarde van NULL.

Codewaarden retourneren

0 (geslaagd) of 1 (mislukt).

Opmerkingen

Een Database Mail-profiel bevat een willekeurig aantal Database Mail-accounts. Opgeslagen procedures voor Database Mail kunnen verwijzen naar een profiel door de profielnaam of de profiel-id die door deze procedure wordt gegenereerd. Zie sysmail_add_profileaccount_sp voor meer informatie over het toevoegen van een account aan een profiel.

De profielnaam en -beschrijving kunnen worden gewijzigd met de opgeslagen procedure sysmail_update_profile_sp, terwijl de profiel-id constant blijft voor de levensduur van het profiel.

De profielnaam moet uniek zijn in het SQL Server Database Engine-exemplaar of de opgeslagen procedure retourneert een fout.

De opgeslagen procedure sysmail_add_profile_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

Eén. Een nieuw profiel maken

In het volgende voorbeeld wordt een nieuw Database Mail-profiel gemaakt met de naam AdventureWorks Administrator.

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

B. Een nieuw profiel maken, de profiel-id opslaan in een variabele

In het volgende voorbeeld wordt een nieuw Database Mail-profiel gemaakt met de naam AdventureWorks Administrator. In het voorbeeld wordt het profiel-id-nummer opgeslagen in de variabele @profileId en wordt een resultatenset geretourneerd die het profiel-id-nummer voor het nieuwe profiel bevat.

DECLARE @profileId AS INT;

EXECUTE msdb.dbo.sysmail_add_profile_sp
    @profile_name = 'AdventureWorks Administrator',
    @description = 'Profile used for administrative mail.',
    @profile_id = @profileId OUTPUT;

SELECT @profileId;

Verwante inhoud