Tutoriel pour effectuer votre première traduction de code avec Azure Synapse Pathway

S’applique à :yesAzure Synapse Analytics

Azure Synapse Pathway introduit la prise en charge de la traduction des schémas, des tables, des vues, des fonctions, etc. depuis IBM Netezza, Microsoft SQL Server et Snowflake en code conforme à T-SQL qui automatise la migration vers Azure Synapse Analytics.

Pour plus d’informations, consultez Vue d’ensemble d’Azure Synapse Pathway.

Dans ce tutoriel, vous allez apprendre à :

  • Exécuter votre première traduction des scripts SQL de votre entrepôt de données existant en scripts T-SQL pour Azure Synapse SQL
  • Choisir une des sources disponibles
  • Visualiser les erreurs et les avertissements relatifs aux objets qui n’ont pas été traduits

Prérequis

Pour suivre ce tutoriel, vérifiez que vous avez installé Azure Synapse Pathway. Si vous avez besoin d’une présentation, consultez Vue d’ensemble d’Azure Synapse Pathway.

Exécuter la traduction

  1. Lancez le fichier MSI d’Azure Synapse Pathway.

  2. Sélectionnez une des sources disponibles ; celles qui seront ajoutées bientôt apparaissent en grisé.

  3. Dans le dossier du répertoire Entrée, sélectionnez Parcourir et faites pointer l’outil vers l’emplacement des scripts DDL et DML qui doivent être traduits.

    Notes

    Seuls des fichiers avec l’extension .sql peuvent être fournis comme source d’entrée. Si l’utilisateur fournit des scripts DDL et DML dans un fichier .txt, l’outil n’effectue pas de traduction.

  4. Lors de la traduction du code Netezza vers Azure Synapse Analytics, choisissez IBM Netezza dans la liste déroulante Type de traduction. Azure Synapse assessment input.

  5. Pour sélectionner le répertoire de sortie, sélectionnez Parcourir pour spécifier l’emplacement où la sortie sera générée. Azure Synapse output directory.

  6. Sélectionnez Traduire pour démarrer la traduction.

Afficher les résultats

  1. La durée de l’évaluation dépend du nombre de bases de données ajoutées et de la taille du schéma de chaque base de données. Les résultats sont affichés pour chaque base de données dès qu’ils sont disponibles. Azure Synapse assessment report.

  2. Quand vous sélectionnez Afficher les résultats, vous êtes dirigé vers le répertoire de sortie spécifié à l’étape précédente et vous voyez le ou les fichiers de script traduits en fonction de la structure de votre répertoire d’entrée.

  3. Il comprend la structure du projet, qui peut être facilement commitée dans votre dépôt GitHub.

  4. Un fichier de résultats avec une liste d’erreurs et d’avertissements est chargé dans le même répertoire de sortie.

Exécuter la traduction en utilisant la ligne de commande

  1. Au moment de l’installation, AspCmd.exe est disponible dans C:\Program Files (x86)\Azure Synapse Pathway
  2. Lancez l’invite de commandes et accédez à l’emplacement du fichier
  3. Tapez aspcmd.exe --help pour obtenir la liste des commandes

Azure Synapse assessment command line help commands.

  1. Vous pouvez lancer l’exécution des traductions en utilisant la ligne de commande

Azure Synapse assessment using command line.

Étapes suivantes

Découvrir comment enregistrer et charger l’évaluation