Snowpark Migration Accelerator: 项目设置

第一次打开 Snowpark Migration Accelerator (SMA) 时,将会看到两个选项:

  • Start:开始处理新项目

  • Activate:输入访问码以仅使用转换功能

开始页面

Start 或 Activate

以下部分说明每个可用选项:

  • Start – 打开项目页面,可在其中创建新项目、打开现有项目或浏览示例项目。

  • Activate – 打开激活页面,如果您或您的组织符合条件,则可在其中输入或申请访问码。

备注

如果您以前输入过访问码,则会跳过此屏幕并定向到项目页面。

项目页面

在项目页面上,可以看到以下三个选项:

Accelerator 项目页面

在此页面上,可以看到三个可用的选项:

  • Open Project – 浏览并选择先前创建的项目文件。有关打开现有项目的更多详细信息,请参阅 [有关打开现有项目的更多信息](project-setup.md #open-a-project)。

  • New Project – 选择此选项可创建新项目。了解有关 创建新项目 的更多信息。

  • *See sample project – 尝试操作示例项目以熟悉 SMA。有关分步说明,请访问 运行示例项目 指南。

创建新项目

点击“New Project”按钮将打开“Project Creation”屏幕。

Project Creation 页面

“Project Creation”页面包含您需要填写的多个字段。

  1. Project Name:输入项目的名称。此名称将用于存储您的设置和跟踪多次执行。下文提供了有关项目文件的更多详细信息。

  2. Input Folder Path:选择包含您的源代码的文件夹。请注意,SMA 只会分析 支持的文件类型。您可以:

    • 使用文件夹名称旁边的单选按钮选择特定的子文件夹或文件

    • 选择特定的子目录后,只会分析代码库的一部分

子文件夹下拉菜单

  • 注意: 将鼠标悬停在路径标签上时,工具提示会显示完整路径。这适用于所有包含缩短路径(输入文件夹路径、输出文件夹路径等)的字段。

    • 创建项目时,会在此目录中创建 .snowma 项目文件。有关此文件夹的更多详细信息,请参见下文。

  1. Output Folder Path:选择 SMA 存储输出文件的目录;输出文件包括日志、报告和转换后的代码(在转换模式下)。

  2. SQL Language:选择 SparkSQL 或 HiveSQL,具体视您的源代码而定。(可选)

  3. Email Address:输入您的电子邮件地址以将自己标识为工具用户。仅当您进入转换模式时,Snowflake 才会通过此电子邮件地址向您发送 Snowpark 资格报告和您的转换访问码。

  4. Customer's Company:输入您要处理其代码的组织的名称。如果您要分析自己的代码,请输入您所在组织的名称。如果您要处理他组织的代码,请输入他们的名称。这有助于按组织整理项目。

必须填写所有字段才能运行该工具。

完成项目设置后,将会显示三个选项:

  • 点击“Save & Start Assessment”可保存您的项目并开始评估过程

  • 点击“Save & Skip Assessment”可保存您的项目而不运行评估

  • 点击“Cancel”可退出而不保存

项目创建后续步骤

在继续转换过程之前,您需要决定是否进行评估。除非您确定要直接跳到转换,否则建议您从评估开始。如果您有任何疑问,最好从评估阶段开始。

点击“Cancel”将返回主屏幕。如果选择“Start”或“Skip”,项目设置将保存在 .snowma 文件中。此文件可让您稍后重新打开项目,并保留所有配置设置。

关于 SMA 项目文件 (.snowma) 的说明

.snowma 文件是项目配置文件,用于存储项目设置和评估历史记录。使用此文件可以:

  • 使用相同的配置设置重新运行该工具

  • 访问和查看既往运行产生的评估数据

每次点击“Save & Skip Assessment”或“Save & Start Assessment”时,SMA 都会在您选择的输入文件夹中创建一个项目文件(扩展名为 .snowma)。此项目文件标有 SMA 图标,包含您要转换的源代码。

.snowma 项目文件

作为用户,您可以执行以下操作:

  • 双击 .snowma 文件打开现有项目

  • 在主屏幕上点击“Open Project”打开现有项目

项目页面

查看最近打开的项目:要在 SMA 中查看最近打开的项目列表,请在菜单栏中点击“File”>“Open Recents”。

Open Recents

当您恢复这些工作流程之一时,工具将返回到您之前会话中断的相同位置。

打开项目

在主屏幕上,点击 Open Project 以启动文件浏览器。选择扩展名为 .snowma 的项目文件以打开“Project Creation”页面。无论您的项目完成状态如何,此操作都有效。

“Project Creation”页面上的导航面板允许您重新访问以前访问过的任何屏幕。

导航面板

完成项目详细信息后,点击“Save & Start Assessment”以开始运行加速器。

下一节说明使用该应用程序时可用的配置选项和设置。

语言: 中文