SnowConvert AI – Migrationsassistent – Erste Schritte¶

1. Install the Snowflake Visual Studio Code extension¶

Weitere Informationen zur Installation über Visual Studio Marketplace oder über eine .vsix-Datei finden Sie in der Snowflake-Dokumentation.

Stellen Sie sicher, dass Sie die Version GA 1.14.0 oder höher verwenden.

2. Sign in to Snowflake with the Visual Studio Code extension¶

In der Snowflake-Dokumentation erfahren Sie, wie Sie sich bei Snowflake mit der VS Code-Erweiterung anmelden.

3. Enable SnowConvert AI Migration Assistant in the Snowflake VS Code Extension Settings¶

Öffnen Sie den VS Code-Einstellungsbereich, und navigieren Sie zu „Extensions“. Wählen Sie die Snowflake-Erweiterung aus, und öffnen Sie das Einstellungsfenster für die Snowflake-Erweiterung.

In den Einstellungen der Snowflake-Erweiterung müssen Sie Folgendes tun:

• Setzen Sie ein Häkchen bei „Enable SnowConvert AI Migration Assistant“.

4. Set up Model Preference¶

Weitere Informationen zum Einrichten der Modelleinstellung finden Sie in der Dokumentation Modelleinstellung.

5. Open a workspace folder containing SnowConvert AI migration results¶

Stellen Sie zunächst sicher, dass in Visual Studio Code ein Arbeitsbereichsordner geöffnet ist. Greifen Sie dann auf die Snowflake-Erweiterung zu, indem Sie das entsprechende Symbol in der Aktivitätsleiste auf der linken Seite auswählen. Der Bereich „SnowConvert AI Issues“ wird unten in der Ansicht der Snowflake-Erweiterung angezeigt. Dieser Bereich wird automatisch mit einer Liste aller Ordner und Dateien im aktuellen Arbeitsbereich gefüllt, der über SnowConvert AI-Migrationsprobleme verfügt. Wenn kein Arbeitsbereich ausgewählt ist, wird im Bereich „SnowConvert AI Issues“ die folgende Meldung angezeigt: „No SnowConvert AI Migration issues found“.

Sobald Ihr Arbeitsbereichsordner, derSnowConvert AI-Migrationsprobleme enthält, geöffnet ist, können Sie auf die Symbolleiste zugreifen, indem Sie den Mauszeiger über den Bereich „SnowConvert AI Issues“ bewegen. Über diese Symbolleiste in der linken oberen Ecke des Bereichs können Sie mit der Liste der identifizierten Migrationsprobleme interagieren.

• 🏠 (Return to Workspace Root): Wenn Sie auf dieses Symbol klicken, wird die Ansicht zurückgesetzt und zeigt den Anfangsstatus des gesamten Arbeitsbereichsordners an.

• 📁 (Select Folder): Über diese Option können Sie durch die Ordner navigieren und einen bestimmten Unterordner innerhalb Ihres Arbeitsbereichs auswählen, um die Problemliste zu fokussieren.

• 🔄 (Refresh Issues): Über diese Option können Sie die Liste der SnowConvert AI-Migrationsprobleme manuell aktualisieren. Die Liste wird außerdem automatisch aktualisiert, sobald ein Problem behoben oder ein neues Problem erkannt wird.

• ➖ (Collapse All): Blendet alle erweiterten Elemente in der Problemliste aus, um eine kompaktere Ansicht zu bieten.

6. See SnowConvert AI Migration Issues and click the sparkles for help resolving¶

Nachdem Sie einen Ordner geöffnet haben, der .sql-Dateien mit Migrationsproblemen enthält, sehen Sie eine Liste aller EWIs, FDMs und PRFs in diesem Ordner sowie die Dateien, die sie enthalten. Wenn Sie in der Liste auf ein Migrationsproblem klicken, wird der Code-Editor auf die Codezeile fokussiert, in der das Problem gefunden wurde.

Es gibt zwei Möglichkeiten, für ein Migrationsproblem AI-gestützte Hilfe und empfohlene Lösungen zu erhalten:

1. Klicken Sie neben dem Migrationsproblem in der Liste auf das Glitzersterne-Symbol.

2. Klicken Sie auf „CodeLenses identified by SnowConvert AI“, die sich über jedem Migrationsproblem befinden.

7. Get help¶

Nachdem Sie auf das Glitzersterne-Symbol oder CodeLenses geklickt haben, fragt der SnowConvert AI-Migrationsassistent Snowflake Cortex AI mit dem Migrationsproblem und einem Codeausschnitt des Codekontexts, der das Migrationsproblem umgibt, ab. Der Aufruf von Cortex erfolgt komplett innerhalb Ihres Snowflake-Kontos unter Verwendung der Verbindungsdetails, die Sie in der Snowflake VS Code-Erweiterung konfiguriert haben.

Sobald ein Ergebnis generiert wurde, wird es in einem Bereich rechts neben dem Code-Editor angezeigt. Das Ergebnis enthält eine Erläuterung des Migrationsproblems im Kontext Ihres Codes sowie einen Vorschlag zur Korrektur, damit der Code in Snowflake korrekt ausgeführt wird. Wenn der Assistent nicht in der Lage ist, eine Antwort mit hoher Konfidenz zu generieren, wird er keine Lösung empfehlen.

8. Interacting with the Migration Assistant¶

• Lösungen verfeinern: Wenn ein AI-Vorschlag falsch ist oder Sie einen anderen Ansatz bevorzugen, geben Sie die gewünschten Änderungen oder Anweisungen in das Chatfeld ein.

• SQL-bezogene Fragen stellen: Wenn der Vorschlag korrekt ist, können Sie trotzdem um Klarstellung oder weitere Erklärungen zu jedem SQL-bezogenes Thema bitten.

• Codeänderungen anfordern: Sie können auch um bestimmte Codeänderungen bitten, wie z. B. das Hinzufügen eines Headers zu Ihrem Skript.