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.
# Connecter vos données
## Conditions préalables
Avant de commencer l'intégration des données, assurez-vous de disposer des éléments suivants :
+ Instance Amazon Connect Decisions
+ Votre instance devrait déjà être créée avec un compartiment S3 associé
+ Données préparées
+ Collaborez avec votre homologue Customer Success pour déterminer les données dont vous avez besoin en fonction de la manière dont vous prévoyez d'utiliser Amazon Connect Decisions. Les exigences relatives aux données de base incluent :
+ Sales/Order Historique : plus de 12 mois d'enregistrements de transactions
+ Détails du produit : Catalogue de produits complet avec spécifications
+ Site/Location Informations : entrepôts, centres de distribution, points de vente
+ Stocks actuels : On-hand inventaire de chaque site
+ Toutes les données sources au format CSV avec UTF-8 encodage
## Création de votre premier flux source
Pour commencer à intégrer vos données, accédez à l'onglet **Gestion des données** dans Amazon Connect Decisions. Vous pouvez voir ici tous vos flux source existants. Si vous n'en avez pas encore configuré, choisissez **« Créer une nouvelle source »** pour commencer.
## Téléchargez vos données sources
Téléchargez vos fichiers CSV contenant des données sources basées sur les tableaux CDM requis pour votre cas d'utilisation. Vous pouvez choisir la manière dont vous souhaitez gérer les mises à jour des données :
+ **Ajouter :** ajouter de nouvelles données aux données existantes
+ **Remplacer** : remplacer les données existantes par de nouvelles données
Lorsque vous chargez des fichiers, Amazon Connect Decisions crée automatiquement une structure de dossiers dans S3 pour ces données, notamment :
+ Un dossier parent nommé d'après le système source que vous avez sélectionné
+ Un sous-dossier nommé d'après le nom de la table source que vous avez sélectionnée
+ Tous les fichiers d'un sous-dossier sont enregistrés dans la même table source
+ Cette structure de fichier est également utilisée pour créer le chemin du dossier Amazon S3.
## Source-to-CDM mappage des destinations
Une fois vos fichiers chargés, Amazon Connect Decisions commence à analyser vos données et à les mapper automatiquement à une ou plusieurs tables de destination CDM d'Amazon Connect Decisions.
**À quoi s'attendre**
+ Cette étape peut prendre entre 10 et 15 minutes en fonction de la quantité de données téléchargées
+ L'agent de données fonctionne en arrière-plan pour identifier les meilleurs ensembles de données de destination CDM pour vos données sources.
+ *Si vous quittez cette page, les mappages automatisés échoueront.* Pendant que vous attendez, laissez l'onglet Amazon Connect Decisions and Data Management ouvert pour vous assurer que le mappage automatique est terminé.
Une fois terminé, l'agent de données fournit une justification des mappages source-destination sur la base de données qui se chevauchent, que vous pouvez examiner et poser des questions à l'agent sur tous les résultats de mappage.
Pour consulter et modifier les mappages de sources, vous pouvez :
+ Interagissez directement avec l'agent de données à l'aide du langage naturel pour mettre à jour les mappages source-destination.
+ Choisissez les options d'action et sélectionnez **« Modifier les sources »**.
### Modification de mappages
À partir de là, vous pouvez :
+ Mettez à jour le mappage de la source et de la destination manuellement si nécessaire
+ Posez des questions à l'aide de l'agent de données situé sur le côté droit de l'écran pour confirmer les mappages
+ Consultez les [guides de l'utilisateur](https://docs.aws.amazon.com/aws-supply-chain/latest/userguide/data-model-asc.html) pour en savoir plus sur des ensembles de données spécifiques
## Column/Data cartographie
Une fois le mappage source-destination terminé, Amazon Connect Decisions crée automatiquement des requêtes de transformation SQL depuis votre ensemble de données source vers la destination CDM. Une fois l'un de vos mappages terminé, vous recevrez une notification de l'agent de données détaillant le résultat du mappage :
À partir de là, vous devez examiner le code SQL généré pour les mappages en sélectionnant **« Réviser le code SQL »** dans le menu Action.
En examinant le mappage (SQL), vous verrez :
+ Colonnes du jeu de données source que vous avez ajoutées
+ Colonnes du tableau CDM de destination à titre de référence
+ Le SQL de transformation qui les connecte
+ Justification de la cartographie fournie par l'agent de données
### Modification de mappages
Deux options s'offrent à vous pour modifier les mappages :
+ **Utilisation de l'agent de données** : utilisez le langage naturel pour poser des questions, gérer et mettre à jour les mappages
+ **Modifier directement le code SQL** : si vous connaissez le langage SQL, vous pouvez modifier directement la requête
### Tester vos modifications
Lorsque vous modifiez la requête de mappage, continuez à la tester à l'aide de la fonctionnalité **« Test Query »** qui vous donnera un aperçu défilant de la façon dont un échantillon de la façon dont vos données sont transformées en CDM de destination. Utilisez-le pour vous assurer que votre transformation s'exécute correctement et pour valider les mises à jour appropriées depuis votre CDM de la source vers la destination.
Une fois que vous êtes satisfait de la sortie de mappage, sélectionnez « Enregistrer la requête » pour enregistrer la requête de transformation pour cette paire source-destination.
## Vérifiez et acceptez les mappages
Passez en revue les mappages restants pour chacun de vos ensembles de données sources. L'agent de données reste présent sur le côté droit de l'écran pour répondre aux questions ou obtenir de l'aide pour résoudre les problèmes.
Une fois que vous êtes satisfait de tous les mappages, acceptez-les pour terminer l'intégration des données.
**Gérer les mappages ayant échoué**
En cas d'échec d'un mappage, vous pouvez sélectionner **« Redémarrer le mappage »** pour redémarrer tous les mappages, ou réessayer manuellement un seul mappage dans le menu Actions via **« Réessayer** la génération SQL ». L'agent de données peut également réessayer les mappages en langage naturel et continuera à vous aider à identifier et à résoudre les problèmes si les erreurs persistent.
## Surveillez vos flux
### Onglet Destinations
Après avoir accepté les mappages, vous serez dirigé vers l'onglet **Destinations** de la **gestion des données**, où vous pourrez :
+ Passez en revue les flux de destination
+ Gérer et modifier les mappages (« Gérer le flux »)
+ Supprimer les flux obsolètes
+ Vérifiez l'état d'exécution de ces flux
La sélection de **« Gérer le flux »** vous ramènera à l'expérience de mappage des données, dans laquelle vous pourrez continuer à travailler avec l'agent de données pour affiner les mappages au fil du temps.
### Onglet Sources
En revenant à l'onglet **Sources**, vous trouverez :
+ Le jeu de données source qui a été créé
+ Son compartiment S3 associé
+ Options pour :
+ Ajouter des données sources supplémentaires via un autre téléchargement de fichier
+ Gérez le flux
+ Supprimer le flux
+ Examiner les exécutions
La sélection de **« Gérer le flux »** vous ramènera à l'expérience de mappage des données, dans laquelle vous pourrez continuer à travailler avec l'agent de données pour affiner les mappages au fil du temps.
Vous avez également accès à la **fonction Créer une nouvelle source** si nécessaire pour redémarrer le processus d'intégration des données pour toute nouvelle source de données.
## Bonnes pratiques
**Préparation des données**
+ Suivez les étapes décrites dans la section Prérequis
+ Utiliser le UTF-8 codage pour tous les fichiers CSV
+ Assurez-vous que les noms de fichiers sont uniques
+ Valider la qualité des données avant de les télécharger
**Utilisation de l'agent de données**
+ Soyez précis dans vos demandes
+ Demandez des explications lorsque vous ne comprenez aucune de ses décisions
+ Testez toutes les modifications SQL avant de les accepter
+ Utiliser la fonction d'aperçu pour vérifier les transformations
**Maintenance continue**
+ Maintenez vos données sources à jour
+ Surveillez régulièrement l'exécution du flux
+ Corrigez rapidement les erreurs de données dès qu'elles sont signalées
+ Documentez les transformations personnalisées pour votre équipe