Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Bonnes pratiques et dépannage
<a name="sql-server-best-practices"></a>

Les meilleures pratiques, les problèmes courants et leur résolution au cours du processus de modernisation.

## Journaux des applications ECS
<a name="sql-server-ecs-application-logs"></a>

### CloudWatch journaux
<a name="sql-server-cloudwatch-logs"></a>
+ Tous les journaux de conteneurs ECS sont automatiquement envoyés à CloudWatch Logs
+ Accédez aux journaux dans la CloudWatch console sous Log Groups
+ Format de dénomination des groupes de journaux :/aws/ecs/{application-name}
+ Chaque instance de conteneur crée un nouveau flux de journaux au sein du groupe

### Affichage des journaux
<a name="sql-server-viewing-logs"></a>

**Par le biais AWS de la console : **
+ Accédez à CloudWatch > Groupes de journaux
+ Sélectionnez le groupe de journaux de votre application
+ Choisissez le flux de journaux approprié pour afficher les journaux des conteneurs

**En utilisant la AWS CLI : **

```
aws logs get-log-events --log-group-name /aws/ecs/your-app-name --log-stream-name your-stream-name
```

### Emplacements courants des journaux
<a name="sql-server-common-log-locations"></a>
+ Journaux des applications : CloudWatch journaux
+ Événements de service ECS : console ECS > Cluster > Service > onglet Événements
+ Conteneur health/status : ECS Console > Cluster > Service > onglet Tâches

## Gestion des connexions aux bases de données
<a name="sql-server-database-connection-management"></a>

Les applications utilisent des variables d'environnement pour les paramètres de connexion à la base de données

Si vous rencontrez des problèmes de connectivité :
+ Vérifiez les paramètres de connexion actuels dans vos variables d'environnement
+ Mettez à jour les variables d'environnement pour modifier les chaînes de connexion à la base de données si nécessaire
+ Les modifications de la chaîne de connexion peuvent être effectuées par le biais de mises à jour des variables d'environnement sans redéploiement de l'application

## Problèmes de connexion aux bases de données
<a name="database-connection-issues"></a>

**Problème : ** Impossible de connecter AWS Transform à SQL Server

Solutions :
+ Vérifiez la connectivité réseau entre AWS Transform et SQL Server
+ Vérifiez les règles du groupe de sécurité pour un accès correct aux ports (1433)
+ Vérifiez les informations d'identification de la base de données dans Secrets
+ Testez les autorisations de base de données avec l'utilisateur créé
+ Assurez-vous que SQL Server est configuré pour l'authentification en mode mixte
+ Vérifier que le secret possède les balises requises (Projet : atx-db-modernization, propriétaire : database-connector)

## Problèmes liés au pare-feu et aux groupes de sécurité
<a name="firewall-security-group-issues"></a>

**Problème : expiration du délai de ** connexion ou erreur « Impossible d'accéder à la base de données »

**Cause principale : groupes ** de sécurité ou ACL réseau bloquant le trafic

Solutions :

1. Vérifiez la configuration du groupe de sécurité :
   + Vérifiez que votre groupe de sécurité SQL Server dispose d'une règle entrante autorisant le port 1433 depuis le groupe de sécurité DMS Schema Conversion
   + Vérifiez que la source est l'ID du groupe de sécurité (par exemple, sg-0123456789abcdef0), et non une adresse IP
   + Vérifiez que le groupe de sécurité DMS Schema Conversion est correctement spécifié dans le profil d'instance
   + Assurez-vous qu'il n'y a pas de règles de refus contradictoires

1. Vérifiez les ACL réseau :
   + Vérifiez que les ACL réseau au niveau du sous-réseau autorisent le trafic entrant sur le port 1433
   + Assurez-vous que les ACL réseau autorisent les ports éphémères sortants pour le trafic de retour
   + Vérifiez à la fois le sous-réseau de la base de données et le sous-réseau DMS (ACL) réseau

1. Vérifiez la configuration du VPC :
   + Vérifiez que l'instance de conversion de schéma DMS et SQL Server se trouvent dans le même VPC ou disposent d'un peering VPC approprié
   + Vérifiez que les tables de routage autorisent le trafic entre les sous-réseaux
   + Vérifiez qu'aucune appliance de pare-feu ne bloque le trafic

1. Testez la connectivité :
   + Lancer une instance EC2 de test dans le même sous-réseau que DMS Schema Conversion
   + Attachez le même groupe de sécurité que DMS Schema Conversion
   + Testez la connexion à SQL Server à l'aide de Telnet ou de SQL Server Management Studio
   + Si le test réussit, le problème provient de la configuration de AWS Transform ; s'il échoue, le problème est network/firewall

**Erreur courante : ** ouverture du port 1433 à 0.0.0. 0/0 (toutes sources confondues) constitue un risque pour la sécurité. Utilisez toujours le contrôle d'accès basé sur les groupes de sécurité pour limiter l'accès au seul groupe de sécurité DMS Schema Conversion.

## Problèmes de conversion de schéma
<a name="schema-conversion-issues"></a>

**Problème : la conversion de ** schéma affiche de nombreuses actions

Solutions :
+ Passer en revue les mesures à prendre dans le rapport de conversion
+ Prioriser en fonction de l'impact
+ Utilisez Amazon Q Developer pour les conversions SQL complexes
+ Consultez le AWS support pour obtenir des conseils
+ Envisagez une approche par étapes pour les bases de données complexes

## Problèmes liés à la transformation des applications
<a name="application-transformation-issues"></a>

**Problème : la transformation de ** l'application ne parvient pas à être créée

Solutions :
+ Examiner les erreurs de génération dans le rapport de transformation
+ Configurez NuGet les flux privés si nécessaire
+ Mettre à jour les références des packages si nécessaire
+ Vérifiez les Windows-specific dépendances
+ Consultez les journaux de transformation pour détecter les erreurs détaillées

## Problèmes liés à la migration des données
<a name="data-migration-issues"></a>

**Problème : échec de la validation de la migration des ** données

Solutions :
+ Examiner le rapport de validation pour détecter des défaillances spécifiques
+ Vérifiez les mappages de types de données
+ Vérifier la configuration de la colonne d'identité (GÉNÉRÉ PAR DÉFAUT ou GÉNÉRÉ TOUJOURS)
+ Passez en revue les expressions de colonnes calculées
+ Contactez le AWS support pour les problèmes complexes liés aux données

## Problèmes de nettoyage des ressources
<a name="resource-cleanup-issues"></a>

**Problème : échec de ** la tâche de transformation en raison d'erreurs liées aux ressources

Solutions :
+ Vérifiez les ressources DMS existantes (projets de migration, fournisseurs de données, profils d'instance)
+ Nettoyez les ressources échouées ou incomplètes des tentatives précédentes
+ Vérifiez que la suppression des secrets n'est pas programmée
+ Vérifiez les quotas de service pour DMS et Aurora PostgreSQL
+ Contactez AWS le support si le nettoyage ne résout pas le problème

## Problèmes de déploiement
<a name="deployment-issues"></a>

**Problème : l'application ** transformée ne peut pas se connecter à Aurora PostgreSQL

Solutions :
+ Vérifier le format de chaîne de connexion pour PostgreSQL
+ Vérifiez les règles des groupes de sécurité
+ Vérifiez les informations d'identification de base de données dans Secrets Manager
+ Assurez-vous qu' SSL/TLS il est correctement configuré
+ Testez la connexion à l'aide de psql ou pgAdmin

## Aide supplémentaire
<a name="getting-additional-help"></a>

Lorsque vous contactez AWS le support, veuillez fournir :
+ ID de tâche de transformation
+ AWS ID de compte
+ Région
+ Messages d'erreur et captures d'écran
+ Journaux de transformation (disponibles dans la console AWS Transform)