Snowpark Migration Accelerator: Konvertierung einrichten¶
Wenn Sie den Snowpark Migration Accelerator (SMA) zum ersten Mal starten, müssen Sie entweder ein neues Projekt erstellen oder ein bestehendes Projekt öffnen. Jedes Projekt kann mehrere SMA-Ausführungen sowohl für die Bewertungs- als auch für die Konvertierungsphase speichern. Nachdem Sie die Bewertungsphase abgeschlossen haben, müssen Sie Ihr Projekt für die Konvertierungsphase konfigurieren.
Seite zur Einrichtung der Konvertierung¶
Während des Konvertierungsprozesses stehen Ihnen mehrere Konfigurationsoptionen zur Verfügung, obwohl die Standardeinstellungen in den meisten Fällen gut funktionieren sollten.
Eingabeordnerpfad - Dies ist das Verzeichnis, das die Codedateien enthält, die Sie analysieren möchten. Dieser Pfad kann derselbe sein, der [bei der Projekterstellung angegeben wurde (../project-overview/project-setup.md#creating-a-new-project), aber Sie können aber auch ein anderes Verzeichnis wählen. SMA führt eine neue Bewertung durch, um genaue Konvertierungsergebnisse sicherzustellen, auch wenn sich Ihr Code seit der ersten Bewertung geändert hat.
Bemerkung
Das Tool analysiert nur bestimmte Dateierweiterungen
Sie können bestimmte Unterordner oder einzelne Dateien auswählen, indem Sie die Schaltflächen neben den Ordnernamen verwenden
Der Bewertungsbericht wird als Teil dieses Prozesses erneut erstellt
Bemerkung
When you hover your mouse over any path label in the interface, a tooltip will display the complete file path. This feature works for all fields containing shortened paths, such as input and output folder locations.
Ausgabeordnerpfad - Wählen Sie den Zielordner, in dem SMA alle generierten Dateien, einschließlich Protokolle, Berichte und konvertierten Code, speichert.
Geben Sie einen neuen Zugangscode ein - Geben Sie Ihren Zugangscode in dieses Feld ein. Wenn Sie noch keinen Zugangscode haben, können Sie einen anfordern. Wie Sie einen Zugangscode erhalten, erfahren Sie im nächsten Abschnitt.
Select Change Conversion Settings to change settings that govern details of the conversion. For more information, see Conversion settings.
Eingabe und Abfrage eines Zugangscodes¶
Um eine Konvertierung mit dem Snowpark Migration Accelerator (SMA) durchzuführen, benötigen Sie einen Zugangscode. Diese Codes sind in der Regel mit einzelnen Benutzern oder E-Mail-Adressen verknüpft und bestimmen, welche Features von SMA Sie nutzen können. Beachten Sie, dass Sie eine Bewertung auch ohne einen Zugangscode durchführen können. Sie werden erst im Stagingbereich nach einem solchen Code gefragt.
Einen Zugangscode anfordern¶
Ein Zugangscode kann jederzeit über das Menür „Hilfe“ angefordert werden. Alternativ können Sie auf der Seite zur Einrichtung der Konvertierung auf Erfragen eines Zugangscodes klicken.
Es wird ein Formular zur Anforderung des Zugangscodes angezeigt.
Eingabe eines Zugangscodes¶
Nachdem Sie einen Zugangscode angefordert haben, wird dieser an die E-Mail-Adresse geschickt, die Sie im Formular angegeben haben. Die E-Mail wird von sma-notifications@snowflake.com gesendet. Bitte beachten Sie, dass der Zugangscode nicht automatisch in der SMA-Benutzeroberfläche angezeigt wird. Sie müssen Ihre E-Mail überprüfen, um ihn abzurufen.
Kopieren Sie den Zugangscode aus Ihrer E-Mail und fügen Sie ihn in das Feld „Geben Sie einen neuen Zugangscode ein oder wählen Sie einen aus“ in der Konvertierungseinrichtung ein. Der Zugangscode besteht aus Buchstaben, Bindestrichen und Zahlen und muss genau so eingegeben werden, wie in der E-Mail angegeben.
Wichtige Informationen zur Validierung des Zugangscodes:
Wenn Sie den Zugangscode eingeben, drücken Sie „ Enter “ (oder „ Return “), um ihn zu aktivieren. Das einfache Einfügen des Codes reicht nicht aus. Sie müssen „ Enter “ drücken. Das Tool zeigt eine Meldung an, die angibt, ob der Zugangscode erfolgreich aktiviert wurde oder nicht. Wenn Sie keine Meldung sehen, klicken Sie auf das Feld für den Zugangscode und drücken Sie erneut „ Enter “.
SMA validiert Zugangscodes über die SMA-Zugangs-API, die eine Internetverbindung erfordert. Ohne Internetzugang funktionieren die Features zur Code-Validierung und Konvertierung nicht. Wenn die Sicherheit Ihres Netzwerks ein Whitelisting der Zugangs-API erfordert, wenden Sie sich an sma-support@snowflake.com, um Unterstützung bei der Validierung des Zugangscodes zu erhalten.
Nach der Validierung Ihrer Lizenz zeigt SMA eine Zusammenfassung der Details Ihres Zugangscodes an. Dazu gehören das Ablaufdatum und die zugehörige E-Mail-Adresse, wie in der Abbildung oben gezeigt.
Um einen Zugangscode für den Snowpark Migration Accelerator (SMA) zu erhalten, lesen Sie bitte den Abschnitt „Zugang“ in dieser Dokumentation.
Einrichtung abgeschlossen¶
Nachdem Sie Ihre Konvertierungseinstellungen konfiguriert haben, klicken Sie auf Konvertierung starten am unteren Rand der Anwendung. Diese Aktion wird sowohl den SMA-Bewertungs- als auch den Konvertierungsprozess in Gang setzen. Sie sehen den Statusbildschirm, der identisch ist mit dem, der während der Bewertungsphase angezeigt wird.
Klicken Sie auf Ergebnisse anzeigen, um den Bildschirm „Konvertierungsausgabe“ zu öffnen.
Conversion Settings¶
With the following settings from the user interface, you can more finely control how the SMA performs conversion.
Pandas
Convert Pandas API to Snowpark API - Specifies to automatically convert Pandas code to the Snowpark equivalent Pandas API (Snowpark Pandas). When enabled, the tool transforms any Pandas operations it finds in your code into their Snowpark counterparts.
DBX
Convert DBX notebooks to Snowflake notebooks - Specifies to convert the .dbc into Jupyter files in a new folder with the .dbc name.
Bemerkung
When exporting notebooks, consider exporting them as Databricks, rather than Jupyter. When Jupyter files contain different sources than Python, SMA behavior may be unexpected.
Checkpoints
Identify and collect checkpoints - Activates the feature.
Collect checkpoints as active - Specifies to execute the collected checkpoint in VS Code when running the workload.
Collect user-defined functions returning data frame type - Specifies to validate that dataframes should be collected if the user has their own functions that return DataFrames.
Mode - Specifies the mode type to validate (Schema or DataFrame).
Sample - Specifies the sampling percentage of each DataFrame to validate.
Relevant PySpark functions to collect - Specifies the PySpark packages to collect (by default, all of them are checked). You can also add more packages by adding the package’s full name.