SnowConvert AI - プレビュー機能の設定

プレビュー機能の設定

SnowConvert AIのプレビュー機能の設定では、 Snowflakeパブリックプレビューの機能 を利用した変換を有効にすることができます。利用可能なフラグ のいずれかをテキストボックスに入力することで、SnowConvert AIは、一般提供ステータス(GA)のSnowflake機能のみに制限されるのではなく、現在パブリックプレビューステータスのSnowflake機能を利用するコードを生成することができます。

image

警告

プレビュー機能とは、評価およびテスト目的で利用可能なSnowflakeの機能ですが、まだ一般提供(GA)ではありません。実稼働システムでは使用しないでください。Snowflakeプレビュー機能の詳細については、 Snowflakeプレビュー利用規約 を参照してください。

Snowflakeのプレビュー機能を理解する

Snowflakeパブリックプレビューの機能は、Snowflakeに実装されテストされた新機能ですが、ユーザビリティやコーナーケースの処理が完全でない場合があります。SnowConvert AIでプレビュー機能を有効にすると、変換プロセスでより良い変換結果が得られる場合に、これらのプレビュー機能を使用するコードを生成できます。

プレビュー機能の使い方

  1. **SnowConvert AIで有効:**プレビュー機能の設定内のテキストボックスに、 利用可能なフラグ のいずれかを入力すると、SnowConvert AIがSnowflakeのプレビュー機能を使用してコードを生成できるようになります。

  2. Snowflakeで有効にする:SYSTEM_ENABLE_PREVIEW_ACCESS のようなシステム機能を使用して、Snowflakeアカウントでプレビュー機能が有効になっていることを確認してください。

  3. **徹底的にテストする:**プレビュー機能を使用する場合は、必ず本番環境以外のSnowflake環境で変換したコードをテストしてください。

重要な考慮事項

  • Snowflakeアカウントの互換性 :生成されたコードを使用するには、Snowflakeアカウントでプレビュー機能を有効にする必要があります

  • 機能の安定性 :Snowflakeのプレビュー機能は、将来のSnowflakeリリースで動作が変更されたり、削除されたりする可能性があります

  • 実稼働の制限 :プレビュー機能を使用したコードは、実稼働のSnowflake環境にデプロイしないでください。

  • ドキュメント :SnowConvert AIは、プレビュー機能が使用されていることを示すコメントを追加する場合があります

プレビュー機能の設定にアクセスする

SnowConvert AIでプレビュー機能を設定するには、以下を行います。

  1. SnowConvert AIインターフェースの Conversion Settings セクションに移動します。

  2. Preview Features タブまたはセクションを選択します。

  3. 利用可能なフラグ のいずれかをテキストボックスに入力し、SnowConvert AIがSnowflakeのプレビュー機能を使用できるようにします。各フラグのスペルが正しいことを確認してください。いずれかのフラグのスペルが間違っていると、変換時にすべてのフラグが無視されます。

  4. 変換を進めます。SnowConvert AIは、変換結果を向上させるプレビュー機能を自動的に使用します。

CLIからのプレビュー機能の使用

コマンドラインインターフェース(CLI)からSnowConvert AIを使用する場合、 --previewFlags 引数を使用することでプレビュー機能を有効にすることができます。値は引用符でくくられ、以下の形式でフラグが含まれていなければなりません。

--previewFlags "\"--enableFlag1 --enableFlag2\""
Copy

例:

snowct [command] --previewFlags "\"--enableFlag\"" [other arguments]
Copy

複数のフラグの場合:

snowct [command] --previewFlags "\"--enableFlag --enableAnotherFlag\"" [other arguments]
Copy

ベストプラクティス

  • 意味を理解する :変換されたコードでは、Snowflakeのプレビュー機能を有効にする必要があることを理解してください

注釈

どのSnowflakeプレビュー機能(SnowConvert AI)を利用できるかについての最新情報については、最新のSnowConvert AIリリースノートを参照するか、サポートにお問い合わせください。

利用可能なプレビュー機能

以下のセクションでは、変換中に特定のSnowflakeプレビュー機能を有効にするためにテキストボックスに入力できるプレビュー機能フラグの一覧を示します。各フラグにより、SnowConvert AIで特定のSnowflakeプレビュー機能を使用できます。

--enableSnowScriptUDF

バージョン1.19.7から非推奨。この機能はすでに一般提供されています。

このオプションにより、SnowScript UDFプレビュー機能を利用して、SnowConvert AIはユーザー定義関数を変換することができます。詳しくはこちらのドキュメントを参照してください: SnowflakeスクリプトUDFs

以下の言語でのみ利用可能です:

  • SQL Server

  • Azure Synapse