Étapes de résolution des problèmes généraux liés à Database Mail

Article
08/23/2023

S’applique à :SQL Server Azure SQL Managed Instance

Le dépannage de la messagerie de base de données implique de vérifier les aspects généraux du système de messagerie de base de données décrits ci-dessous. Ces procédures sont présentées dans un ordre logique, mais elles peuvent être évaluées dans n'importe quel ordre.

Autorisations

Vous devez être membre du rôle serveur fixe sysadmin pour pouvoir dépanner tous les aspects de Database Mail. Les utilisateurs qui ne sont pas membres du rôle serveur fixe sysadmin peuvent uniquement obtenir des informations sur les e-mails qu’ils tentent d’envoyer, et non sur les e-mails envoyés par d’autres utilisateurs.

Database Mail est-il activé ?

Dans SQL Server Management Studio, connectez-vous à une instance de SQL Server à l’aide d’une fenêtre d’éditeur de requête, puis exécutez le code suivant :
```
sp_configure 'show advanced', 1; 
GO
RECONFIGURE;
GO
sp_configure;
GO
```
Dans le volet de résultats, vérifiez que run_value pour Database Mail XPs est défini sur 1. Si la run_value n’est pas 1, la messagerie de base de données n’est pas activée. La messagerie de base de données n’est pas automatiquement activée pour réduire le nombre de fonctionnalités disponibles pour l’attaque par un utilisateur malveillant. Pour plus d’informations, consultez Présentation de la configuration de la surface d’exposition.
Si vous décidez qu’il est approprié d’activer la messagerie de base de données, exécutez le code suivant :
```
sp_configure 'Database Mail XPs', 1; 
GO
RECONFIGURE;
GO
```
Pour restaurer la procédure sp_configure à son état par défaut, qui n’affiche pas d’options avancées, exécutez le code suivant :
```
sp_configure 'show advanced', 0; 
GO
RECONFIGURE;
GO
```

Les utilisateurs sont-ils correctement configurés pour envoyer du courrier ?

Pour envoyer la messagerie de base de données, les utilisateurs doivent être membres du rôle de base de données DatabaseMailUserRole dans la msdb base de données. Les membres du rôle serveur fixe sysadmin et msdbdb_owner rôle sont automatiquement membres du rôle DatabaseMailUserRole . Pour répertorier tous les autres membres de DatabaseMailUserRole , exécutez l’instruction suivante :
```
EXEC msdb.sys.sp_helprolemember 'DatabaseMailUserRole';
```

Pour ajouter des utilisateurs au rôle DatabaseMailUserRole , utilisez l’instruction suivante :

USE msdb;
GO

sp_addrolemember @rolename = 'DatabaseMailUserRole'
,@membername = '<database user>';

Pour pouvoir envoyer des messages à l'aide de la messagerie de base de données, les utilisateurs doivent avoir accès à au moins un profil de messagerie de base de données. Pour afficher les utilisateurs (principaux) et les profils auxquels ils ont accès, exécutez l'instruction suivante :
```
EXEC msdb.dbo.sysmail_help_principalprofile_sp;
```
Utilisez l'Assistant Configuration de la messagerie de base de données pour créer des profils et pour accorder l'accès des profils aux utilisateurs.

Database Mail est-il démarré ?

Le programme externe Database Mail est activé quand il y a des e-mails à traiter. S'il n'y a eu aucun message à envoyer pendant le délai d'attente spécifié, le programme est fermé. Pour confirmer que l’activation de Database Mail est démarrée, exécutez l’instruction suivante :
```
EXEC msdb.dbo.sysmail_help_status_sp;
```
Si l’activation de la messagerie de base de données n’est pas démarrée, exécutez l’instruction suivante pour la démarrer :
```
EXEC msdb.dbo.sysmail_start_sp;
```
Si le programme externe de messagerie de base de données est démarré, vérifiez l'état de la file d'attente des messages à l'aide de l'instruction suivante :
```
EXEC msdb.dbo.sysmail_help_queue_sp @queue_type = 'mail';
```
La file d’attente de courrier doit avoir l’état .RECEIVES_OCCURRING La file d'attente des états peut varier d'un moment à l'autre. Si l’état de la file d’attente de messagerie n’est pas RECEIVES_OCCURRINGle cas, essayez de redémarrer la file d’attente. Arrêtez la file d’attente à l’aide de l’instruction suivante :

EXEC msdb.dbo.sysmail_stop_sp;

Ensuite, démarrez la file d’attente à l’aide de l’instruction suivante :

EXEC msdb.dbo.sysmail_start_sp;

Note

Utilisez la colonne de longueur dans le jeu de résultats pour sysmail_help_queue_sp déterminer le nombre de courriers électroniques dans la file d’attente de courrier.

Les problèmes affectent-ils tous les comptes ou seulement certains d’entre eux ?

Si vous avez déterminé que certains profils, mais pas tous les profils ne peuvent pas envoyer de courrier, vous pouvez rencontrer des problèmes avec les comptes de messagerie de base de données utilisés par les profils de problème. Pour déterminer quels comptes parviennent à envoyer des messages, exécutez l'instruction suivante :
```
SELECT sent_account_id, sent_date FROM msdb.dbo.sysmail_sentitems;
```
Si un profil non professionnel n’utilise aucun des comptes répertoriés, il est possible que tous les comptes disponibles pour le profil ne fonctionnent pas correctement. Pour tester des comptes individuels, utilisez l’Assistant Configuration de Database Mail pour créer un nouveau profil associé à un compte unique, puis utilisez la boîte de dialogue Envoyer un message électronique de test pour envoyer un message à l’aide du nouveau compte.
Pour afficher les messages d'erreur renvoyés par la messagerie de base de données, exécutez l'instruction suivante :
```
SELECT * FROM msdb.dbo.sysmail_event_log;
```
Note

Database Mail considère qu’un message a été envoyé quand il est remis à un serveur de messagerie SMTP. Les erreurs qui se produisent après, par exemple à cause d'une adresse de destinataire non valide, peuvent empêcher la remise du message, mais elles n'apparaissent pas dans le journal de la messagerie de base de données.

Nouvelles tentatives de remise de courrier

Si vous avez déterminé que la messagerie de base de données échoue parce que le serveur SMTP ne peut pas être atteint de manière fiable, vous pouvez augmenter votre taux de remise de courrier réussi en augmentant le nombre de tentatives d’envoi de la messagerie de base de données pour envoyer chaque message. Démarrez l’Assistant Configuration de Database Mail et sélectionnez l’option Afficher ou modifier les paramètres du système. Vous pouvez également associer davantage de comptes au profil afin qu’au moment du basculement à partir du compte principal, la messagerie de base de données utilise le compte de basculement pour envoyer des e-mails.
Dans la page Configurer les paramètres système, les valeurs par défaut de cinq fois pour les tentatives de nouvelle tentative de compte et 60 secondes pour le délai de nouvelle tentative de compte signifient que la remise des messages échoue si le serveur SMTP ne peut pas être atteint en 5 minutes. Augmentez ces paramètres pour accroître le délai imparti avant l’échec de la remise du courrier.

Note

Lorsqu'un grand nombre de messages est envoyé, l'utilisation de valeurs par défaut élevées peut améliorer la fiabilité, mais elle entraîne également une augmentation considérable de l'utilisation des ressources pour permettre à la messagerie de base de données d'envoyer à plusieurs reprises ces nombreux messages. Attaquez-vous au problème de base en essayant de résoudre le problème de réseau ou de serveur SMTP qui empêche la messagerie de base de données de contacter rapidement le serveur SMTP.

Vérifier que Service Broker est activé pour msdb

La messagerie de base de données nécessite que Service Broker soit activé pour la msdb base de données. Vérifiez si le service Broker est activé msdb avec le script T-SQL suivant :

SELECT is_broker_enabled FROM sys.databases WHERE name = 'msdb' ; -- should be 1

S’il n’est pas activé, le service Broker doit être activé. L’exemple de script suivant nécessite un accès exclusif aux msdb bases de données système. Toutefois, cela peut ne pas être possible pour s’exécuter pendant les heures ouvrées classiques. Pour plus d'informations, consultez OPTIONS ALTER DATABASE ... SET ENABLE_BROKER.

ALTER DATABASE msdb SET ENABLE_BROKER;