Snowpark Migration Accelerator:配置和设置

使用 Snowpark Migration Accelerator (SMA) 设置新项目是一个简单的过程。此页面介绍了应用程序中所有可用的设置、更新和自定义选项。

更新应用程序

当您启动程序时,Snowpark Migration Accelerator (SMA) 会自动检查是否有新版本。如果有更新的版本可用,您将在屏幕的右上角看到一条通知消息。

![待更新] (../../../../images/migrations/sma-assets/1-PendingUpdates.png "image")

如果您选择“Update Now”,应用程序将立即下载并安装最新版本。

正在下载更新

下载完成后,点击“Close and Install”以更新应用程序。

下载成功

应用程序重新启动后,可以在窗口的右上角验证当前版本号。

更新完成

检查更新

要检查应用程序的新版本,点击菜单中的“Check for Updates”选项。

如果您的应用程序已是最新版本,您将在右上角看到一条确认此状态的通知。

检查更新 - 已是最新版本

如果您的应用程序未运行最新版本,系统将提示您对其进行更新。

检查更新 - 更新

转换设置

在开始转换过程之前,您可使用以下两个选项之一配置转换设置:

在屏幕顶部的菜单栏中配置:

转换设置的菜单栏选项

在转换屏幕上配置:

转换设置选项

转换设置部分包含可用转换设置的列表。要访问这些设置,请执行以下操作:

将 Pandas 转换为 Snowpark:选择是否自动将 Pandas 代码转换为 Snowpark 等效的 Pandas API (Snow Pandas)。启用后,该工具将把它在代码中找到的任何 Pandas 操作转换为对应的 Snowpark 操作。

转换设置

关于

要查看您安装的 Snowpark Migration Accelerator 的版本信息,请点击菜单中的 About Snowpark Migration Accelerator 选项。

关于 Snowpark Migration Accelerator

要查看不同版本之间的更改,请查看发行说明。

File 菜单

在“File”菜单中,您可以:

  • 通过选择 New Project* 来创建新项目

  • Open Recents 菜单中打开以前使用过的项目

File 菜单

当您选择“New Project”或打开其他项目时,会出现一个提示,询问您是否要“Save Changes & Create New Project”。

Help 菜单

“Help”菜单提供了几个根据您的特定需求定制的支持选项。

Help 菜单

以下各部分描述了“Help”菜单中可用的每个选项。

文档

要返回主文档页面(欢迎页!),请点击 此处

版本说明

版本说明可以在我们的文档网站的常规部分找到。点击 此处 可进行查看。

词汇表

Glossary 选项将引导您至Glossary 部分,在这里您可以找到本文档中使用的术语的定义。

申请新的访问码

需要访问码才能使用 SMA 的转换功能。您必须具有有效的访问码才能进行任何转换。

您可以在“Help”菜单中点击 Inquire about an access code 来获取访问码。

“Help”菜单中的“Inquire about an access code”

将显示 Request Access Code 表单(如下所示)。如果您需要访问码或不确定是否有访问码,请通过以下方式联系 Snowpark Migration Accelerator (SMA) 支持团队:sma-support@snowflake.com

在请求访问码时,Snowpark Migration Accelerator (SMA) 将要求您提供以下信息:

请求访问码

访问码将发送到您提供的电子邮件地址。必须填写所有字段才能收到访问码。

联系我们

“Contact Us”按钮可打开您的默认电子邮件应用程序。点击后,您可以发送电子邮件到 sma-info@snowflake.com 讨论有关 Snowpark Migration Accelerator 的任何问题或疑虑。

有关联系 Snowpark Migration Accelerator (SMA) 团队的更多方式,请访问我们的联系我们部分

报告问题

您可以随时报告问题。这包括在运行工具时遇到的问题或与使用工具相关的任何其他问题。

当您选择此问题时,将显示一个表单。

报告问题

为帮助我们快速解决您的问题,请提供:

  1. 对问题的详细描述

  2. 您的电子邮件地址,以便我们与您联系

  3. 任何相关文件,例如显示问题的屏幕截图

  4. 运行工具时的日志文件

提交问题后,SMA 支持团队将收到通知。如果您提供了电子邮件地址,我们的团队将立即与您联系。

在线设置

Snowpark Migration Accelerator (SMA) 连接到 Snowflake 以执行特定操作。请务必注意,您的代码永远不会传输到 Snowflake。该工具在三种特定情况下与 Snowflake 通信:

  1. 当用户请求验证或提出特定请求时

  2. 启动执行时

  3. 启动启动时

您可以通过 Online Settings 菜单禁用第二种和第三种通信方式。让我们来研究一下每个通信场景的细节。

SMA 工具通过遥测 API 与 Snowflake 通信,用于以下活动:

  • 请求 访问码

  • 检查访问码是否有效

  • 当用户填写 报告问题 表单时,向 Snowflake 提交问题

  • 当用户同意报告时,向 Snowflake 发送崩溃报告和致命错误日志

  • 下载并安装工具更新

每次运行 SMA 时,它都会向遥测 API 发送摘要信息。这些信息包括:

  • 项目评估详情,包括项目信息和有关 Spark 使用模式的统计数据

  • 工具使用情况指标,包括按钮交互数据和操作日志

当您启动该工具时,它会与 Snowflake 建立一个连接,以验证您的凭据和访问权限。

检查是否有更新的版本可用。

您可以启用或禁用所有这些信息设置。要修改这些设置,请执行以下步骤:

  1. 在 SMA 中打开“Help”菜单

  2. 选择 Online Settings

请注意,在配置这些设置后,SMA 可以完全离线运行。

从“Help”菜单中选择“Online Settings”

当您点击 Online Settings 时,将出现一个菜单,其中包含以下选项:

在线设置菜单

您可以根据需要启用或禁用这些设置中的任何一个。

该工具可以在没有互联网连接的情况下运行。在离线模式下,您可以运行评估而不会出现任何问题。但是,若要执行转换,该工具需要在线验证您的访问码。如果您无法连接到互联网,请与 SMA 团队联系 (sma-support@snowflake.com),请求特殊的离线访问码。

EULA

此链接指向最终用户许可协议 (EULA) 页面,您可以在其中查看使用条款。


让我们开始使用 Snowpark Migration Accelerator (SMA) 工具来转换代码吧。

语言: 中文