バージョン1.xから2.0へのプロジェクト定義ファイルの移行¶
バージョン1.xのプロジェクト定義ファイルをバージョン2フォーマットに変換するには、以下のようにします:
バージョン1.xの
snowflake.ymlファイルを含むプロジェクト・ディレクトリに移動します。snow helpers v1-to-v2コマンドを入力します。バージョン1.xのファイル変換が成功すると、コマンドは以下のようなメッセージを表示します:
プロジェクト定義ファイルがすでにバージョン2に更新されている場合、コマンドは以下のメッセージを表示します:
If you try to convert a project file that contains a
snowflake.local.ymlfile, without using the--[no]-migrate-local-overridesoption, the command generates an error similar to the following:
--accept-templatesオプションを使用せずに、テンプレートを含むプロジェクト・ファイルを変換しようとすると、コマンドは次のようなエラーを生成します:テンプレートを含むプロジェクト定義ファイルを変換するときに:codenowrap:
--accept-templatesオプションを使用すると、コマンドはファイルを変換し、次のような警告メッセージを表示します:
Native Appsのプロジェクトを変換する¶
このセクションでは、 Snowflake Native App プロジェクトの V1 から V2 への変換の例を示し、プロパティ名の変更点を列挙し、移行に役立ついくつかのヒントを示します。
Snowflake Native App 変換例¶
V1プロジェクトファイル |
V2プロジェクトファイル |
|---|---|
Native Appsのプロジェクト定義 V1 から V2 へのプロパティ変更¶
V1プロパティ |
V2プロパティ |
|---|---|
|
同等のものはありません。必要であれば、テンプレート変数を使って移植します。 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
移行のヒント¶
Snowflake Native App のパッケージスクリプトを移行する場合、
v1-to-v2コマンドは、それらを:codenowrap:package post-deployフックに変換し、パッケージスクリプトファイル内の:codenowrap:{{package_name}}を同等のテンプレート式に置き換えます。既存のテンプレート式を移行する場合、
ctx.native_app、ctx.streamlit、および:codenowrap:ctx.snowpark変数は受け付けられなくなります。v1-to-v2コマンドの代わりに、特定のエンティティ名を参照する同等のテンプレート式。例えば、ctx.native_app.package.nameは、パッケージがsnowflake.ymlファイルの:codenowrap:pkgという名前のエンティティに移行された場合、ctx.entities.pkg.identifierに置き換えることができます。
Streamlitプロジェクトの変換¶
このセクションでは、StreamlitプロジェクトのV1からV2への変換例を示し、プロパティ名の変更点を列挙し、移行に役立ついくつかのヒントを提供します。
Streamlit変換例¶
V1プロジェクトファイル |
V2プロジェクトファイル |
|---|---|
Streamlit プロジェクト定義 V1 から V2 へのプロパティ変更¶
V1プロパティ |
V2プロパティ |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Streamlit移行のヒント¶
なし。
Snowparkプロジェクトを変換する¶
このセクションでは、SnowparkプロジェクトのV1からV2への変換の例を示し、プロパティ名の変更点を列挙し、移行に役立ついくつかのヒントを提供します。
Snowparkの変換例¶
V1プロジェクトファイル |
V2プロジェクトファイル |
|---|---|
Snowparkプロジェクト定義 V1からV2へのプロパティ変更¶
V1プロパティ |
V2プロパティ |
|---|---|
|
プロジェクトから移行された各関数またはプロシージャについての:codenowrap: |
|
プロジェクトから移行された各関数やプロシージャーについての:codenowrap: |
|
|
|
|
|
|
V1プロパティ |
V2プロパティ |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Snowpark移行のヒント¶
Snowparkプロジェクトを移行する場合、各関数(
snowpark.functions配列から)または各プロシージャ(snowpark.procedures配列から)はトップレベルのエンティティにマッピングされます。これで、すべてのトップレベルのSnowparkプロジェクトプロパティ(例:
src)が、関数とプロシージャごとに定義されるようになりました。重複を減らすため、Snowflakeでは:codenowrap:mixinを宣言し、移行した関数とプロシージャの各エンティティに含めることを推奨しています。