De configuratie-instellingen voor databasemail in SQL Server (T-SQL) wijzigen

Als u Database Mail in SQL Server gebruikt, kunt u de configuratie-instellingen wijzigen door het uitvoeren van de sysmail_configure_sp opgeslagen procedure in de msdb database.

Syntaxis

De syntaxis gaat als volgt:

sysmail_configure_sp [ [ @parameter_name = ] 'parameter_name' ]  
    [ , [ @parameter_value = ] 'parameter_value' ]  
    [ , [ @description = ] 'description' ]

Je geeft dus de instellingsnaam op, gevolgd door de gewenste waarde. Je kunt ook de beschrijving voor die instelling bijwerken.

Merk op dat de sysmail_configure_sp opgeslagen procedure staat in de msdb database en het is eigendom van de dbo schema. Daarom moet de procedure worden aangeroepen met een driedelige naam als msdb is niet de huidige database.

Voorbeeld

Hier is een voorbeeld van het wijzigen van de maximale bestandsgrootte voor bijlagen:

EXECUTE msdb.dbo.sysmail_configure_sp  
    'MaxFileSize', '2000000';

In dit geval heb ik de parameterwaarde gewijzigd in 2000000, maar ik heb de beschrijving niet gewijzigd. Daarom blijft de beschrijving hetzelfde als die was.

Een andere manier om dit te doen is door expliciet de argumentnamen te gebruiken.

EXECUTE msdb.dbo.sysmail_configure_sp  
    @parameter_name = 'MaxFileSize', 
    @parameter_value = '1000000',
    @description = 'Default maximum file size';

In dit geval zet ik de bestandsgrootte terug naar de standaardwaarde en geef ik de standaardbeschrijvingstekst op (die in het vorige voorbeeld toch niet echt is gewijzigd).

Alle configuratie-instellingen

U kunt een lijst met de huidige configuratie-instellingen krijgen door de opdracht sysmail_help_configure_sp uit te voeren opgeslagen procedure zonder argumenten door te geven.

EXEC msdb.dbo.sysmail_help_configure_sp;

Resultaat:

+--------------------------------+----------------+------------------------------------------------------------------------------
| paramname                      | paramvalue     | description                                                                  
|--------------------------------+----------------+------------------------------------------------------------------------------
| AccountRetryAttempts           | 1              | Number of retry attempts for a mail server                                   
| AccountRetryDelay              | 60             | Delay between each retry attempt to mail server                              
| DatabaseMailExeMinimumLifeTime | 600            | Minimum process lifetime in seconds                                          
| DefaultAttachmentEncoding      | MIME           | Default attachment encoding                                                  
| LoggingLevel                   | 2              | Database Mail logging level: normal - 1, extended - 2 (default), verbose - 3 
| MaxFileSize                    | 1000000        | Default maximum file size                                                    
| ProhibitedExtensions           | exe,dll,vbs,js | Extensions not allowed in outgoing mails                                     
+--------------------------------+----------------+------------------------------------------------------------------------------

Een specifieke configuratie-instelling retourneren

Als u slechts één configuratie-instelling wilt retourneren, kunt u die doorgeven aan de opgeslagen procedure met behulp van de @parameter_name argument.

EXEC msdb.dbo.sysmail_help_configure_sp
    @parameter_name = MaxFileSize;

Resultaat:

+-------------+--------------+---------------------------+
| paramname   | paramvalue   | description               |
|-------------+--------------+---------------------------|
| MaxFileSize | 1000000      | Default maximum file size |
+-------------+--------------+---------------------------+