SnowConvert AI :移行アシスタント - はじめるにあたり¶

1.Snowflake Visual Studio Code拡張機能をインストールする¶

[Visual Studio Marketplace]（https://docs.snowflake.com/ja/user-guide/vscode-ext#install-the-vs-code-extension-from-visual-studio-marketplace）または[.vsixファイル]（https://docs.snowflake.com/ja/user-guide/vscode-ext#install-the-vs-code-extension-from-a-vsix-file）からインストールする方法については、Snowflakeのドキュメントを参照してください。

バージョン GA 1.14.0 以降を使用していることを確認してください。

2.Visual Studio Code拡張機能を使ってSnowflakeにサインインする¶

VS Code拡張機能を使ってSnowflakeに[サインイン]（https://docs.snowflake.com/ja/user-guide/vscode-ext#sign-in-to-snowflake-with-the-vs-code-extension）する方法については、Snowflakeのドキュメントを参照してください。

3.Snowflake VS Code 拡張機能の設定で SnowConvert AI 移行アシスタントを有効にします¶

VS Codeの設定パネルを開き、[Extentions]に移動します[Snowflake extension]を選択し、Snowflake拡張機能の設定パネルを開きます。

![Settings panel > Extensions]（../../../images/migrations/sc-assets/MigrationAssistantSettingsPanelExtension.png 「設定パネル > 拡張機能」）

![Snowflake extension > settings]（../../../images/migrations/sc-assets/MigrationAssistantSnowflakeExtensionSettings.png 「Snowflake拡張機能 > 設定」）

Snowflake拡張機能の設定では、次の動作を行う必要があります。

• 「SnowConvert AI 移行アシスタントを有効にする」にチェックを入れる

![SnowConvert AI 移行アシスタントの設定を有効にする]（../../images/migrations/sc-assets/MigrationAssistantEnableMigrationAssistant.png 「SnowConvert AI 移行アシスタントの設定を有効にする」）

4.モデルの優先順位を設定する¶

モデルの優先順位の設定方法の詳細については、[モデル設定]（#model-preference）のドキュメントを確認してください。

5.SnowConvert AI 移行結果を含むワークスペースフォルダーを開く¶

まず、Visual Studio Codeでワークスペースフォルダーが開いていることを確認します。次に、左側のアクティビティバーからSnowflake拡張機能のアイコンを選択してアクセスします。Snowflake拡張機能のビューの下部に「SnowConvert AI の問題」パネルが表示されます。このパネルには、SnowConvert AI 移行問題がある現在のワークスペース内のすべてのフォルダーとファイルのリストが自動的に入力されます。ワークスペースが選択されていない場合、SnowConvert AI の問題パネルに次のメッセージが表示されます。「NoSnowConvert AI Migration issues found」

![SnowConvert AI の問題パネル]（../../../images/migrations/sc-assets/MigrationAssistantSnowConvertIssuePanel.png 「SnowConvert AI の問題パネル」）

SnowConvert AI 移行問題を含むワークスペースフォルダーを開いたら、「SnowConvert AI の問題」パネルにカーソルを合わせてツールバーにアクセスできます。パネルの左上隅にあるこのツールバーで、特定された移行の問題リストを操作することができます。

![SnowConvert AI の問題パネルツールバー]（../../../images/migrations/sc-assets/MigrationAssistantSnowConvertIssuePanelToolbar.png 「SnowConvert AI の問題パネルツールバー」）

• 🏠（ワークスペースルートに戻る）: このアイコンをクリックすると、ビューがリセットされ、ワークスペースフォルダー全体の初期状態が表示されます。

• 📁（フォルダーの選択）: ワークスペース内の特定のサブフォルダーに移動して選択し、問題リストにフォーカスを当てることができます。

• 🔄（問題の更新）: これを使用して、SnowConvert AI の移行問題リストを手動で更新します。また、問題が解決されたり、新しい問題が検出されたりすると、リストは自動的に更新されます。

• ➖（すべて折りたたむ）: 問題リストで展開されているすべての項目を折りたたみ、よりコンパクトに表示します。

6.SnowConvert AI 移行の問題を参照し、キラキラアイコンをクリックして解決するためのヘルプを参照してください¶

移行の問題がある.sqlファイルを含むフォルダーを開くと、そのフォルダー内のすべてのEWIs 、FDMs 、PRFs 、それらを含むファイルのリストが表示されます。リストから移行の問題をクリックすると、問題が見つかったコード行にコードエディターがフォーカスされます。

![SnowConvert AI 移行の問題パネル]（../../../images/migrations/sc-assets/MigrationAssistantSnowconvertMigrationIssuesPanel.png 「SnowConvert AI 移行の問題パネル」）

移行の問題に対して AI を活用した支援と推奨ソリューションを入手するには、2つの方法があります。

1. リストの移行の問題の横にあるキラキラアイコンをクリックします。

![キラキラアイコンで説明と提案を受ける]（../../../images/migrations/sc-assets/MigrationAssistantSuggestionSparklesIcon.png 「キラキラアイコンで説明と提案を受ける」）

2. すべての移行の問題の上にある、 _SnowConvert AI で識別された CodeLenses をクリックします。

![CodeLens で説明と提案を受ける]（../../../images/migrations/sc-assets/MigrationAssistantSuggestionCodeLens.png 「CodeLens で説明と提案を受ける」）

7.ヘルプの表示¶

キラキラアイコンまたは CodeLenses をクリックすると、SnowConvert AI 移行アシスタントが Snowflake Cortex AI に移行の問題と、移行の問題を取り巻くコードコンテキストのスニペットを問い合わせます。Cortexへの呼び出しは、Snowflake VS Code拡張機能で設定した接続詳細を使用して、すべて Snowflake アカウント内で行われます。

結果が生成されると、コードエディターの右側にあるパネルに表示されます。結果には、コードの文脈における移行の問題の説明と、Snowflake上でコードを正しく実行するための修正案が含まれます。アシスタントが高い信頼性で応答を生成できない場合、推奨される解決策を提供することを控えます。

![説明と提案パネル]（../../../images/migrations/sc-assets/MigrationAssistantExplanationSuggestionPanel.png 「説明と提案パネル」）

8.移行アシスタントとの対話¶

• ソリューションを改善する: AI の提案が正しくない場合、または別のアプローチを希望する場合は、チャットボックスに希望する変更または指示を入力してください。

• SQL 関連の質問をする: 提案が正しい場合でも、SQL 関連のトピックについて、説明やさらなる説明を求めることができます。

• コード変更を: スクリプトにヘッダーを追加するなど、特定のコード変更を依頼することもできます。

![SnowConvert AI 移行アシスタントのチャットインタラクション]（../../../images/migrations/sc-assets/MigrationAssistantChatInteraction.png 「SnowConvert AI 移行アシスタントのチャットインタラクション」）

![非 SQL 関連質問中止メッセージ]（../../../images/migrations/sc-assets/MigrationAssistantNonSqlRelatedQuestion.png 「非 SQL 関連質問中止メッセージ」）