通过

使用 Azure Synapse Pathway 执行首次代码转换的教程

  • 项目

适用于：Azure Synapse Analytics

Azure Synapse Pathway 引入了对将 IBM Netezza、Microsoft SQL Server 和 Snowflake 中的架构、表、视图、函数等转换为 T-SQL 兼容代码的支持，这些代码可自动执行向 Azure Synapse Analytics 的迁移 。

有关详细信息，请参阅 Azure Synapse Pathway 概述。

本教程介绍如何执行下列操作：

  • 运行从现有数据仓库中的 SQL 脚本到 Azure Synapse SQL 的 T-SQL 脚本的首次转换
  • 选择一个可用的源
  • 查看有关未转换对象的错误和警告

先决条件

若要完成本教程，请确保安装 Azure Synapse Pathway。 如果需要简介，请参阅 Azure Synapse Pathway 概述。

运行转换

  1. 启动 Azure Synapse Pathway MSI。

  2. 选择一个可用的源，即将添加的源呈灰色显示。

  3. 在输入目录文件夹中，选择“浏览”，然后将工具指向需要转换的 DDL 和 DML 脚本的文件夹位置 。

    注意

    只有扩展名为 .sql 的文件才能作为输入源提供。 如果用户提供 .txt 文件形式的 DDL 和 DML 脚本，则工具将不执行任何转换。

  4. 将 Netezza 代码转换到 Azure Synapse Analytics 时，请在“转换类型”下拉菜单中选择“IBM Netezza”。 Azure Synapse 评估输入。

  5. 若要选择输出目录，请选择“浏览”，指定要生成输出的位置。 Azure Synapse 输出目录。

  6. 选择“转换”，开始转换

查看结果

  1. 评估的持续时间取决于添加的数据库数和每个数据库的架构大小。 每个数据库的结果一旦生成，便会立即显示。 Azure Synapse 评估报告。

  2. 若选择“查看结果”，你将转到上一步中指定的输出目录，并且将看到基于输入目录结构的转换后的脚本文件。

  3. 它包含可轻松提交到 GitHub 存储库的项目结构。

  4. 包含错误和警告列表的结果文件被上传到相同的输出目录中。

使用命令行运行转换

  1. 安装时可从 C:\Program Files (x86)\Azure Synapse Pathway 获取 AspCmd.exe
  2. 启动命令提示符并转到文件位置
  3. 键入 aspcmd.exe --help 获取命令列表

Azure Synapse 评估命令行 help 命令。

  1. 可以使用命令行开始运行转换

使用命令行的 Azure Synapse 评估。

后续步骤

了解如何保存和加载评估