SnowConvert: よくある質問(FAQ)¶
SnowConvert が SQL のコードを翻訳する元のデータベースプラットフォーム¶
SnowConvert は、3つの主要なデータベースプラットフォームであるTeradata、Oracle、 SQL ServerからSnowflakeに SQL コードを翻訳することができます。
バージョン1.2.0のリリースによる、現在の SnowConvert ユーザーに対する変更点¶
SnowConvert 機能のロックを解除するには、ユーザーはSnowflakeからアクセスコードを取得する必要があります。このコードは、評価または変換のいずれかの関数を有効にします。このリリースでは、以下の変更が実施されます。
SnowConvert は、ユーザーからのリクエストに応じて自動的にアクセスコードを生成します。
プロセスが簡素化されました。 SnowConvert、評価レポートと変換コードの両方が1つのステップで作成されるようになり、評価モードと変換モードを分ける必要がなくなりました。
1つのアクセスコードで、1つのソースプラットフォームに限定されることなく、サポートされているすべてのプラットフォームへのアクセス権が付与されるようになりました。その他すべてのユーザーエクスペリエンスの側面は変わりません。
最高の変換結果を得るために、 SnowConvert の最新バージョンに定期的に更新することをお勧めします。新しいバージョンでは、変換ルールが改善され、コード品質が向上しています。
新しいバージョンの SnowConvert をインストールする前に、既存のバージョンをシステムからアンインストールしてください。アンインストール後、最新バージョンをダウンロードしてインストールします。
SnowConvert を入手する方法¶
SnowConvert は、無料の変換用 SnowConvert コース を完了した後にダウンロードできます。このコースでは、 SnowConvert を使った評価と変換の概要と実践トレーニングの両方を提供します。
コース終了後、ダウンロード方法を記載したメールをお送りします。その後、ツールのインターフェイスからアクセスコードを生成できます。
SnowConvert のアクセスコードの入手方法¶
アクセスコードは、 アクセスコードの入手方法 の指示に従って取得できます。
その他ご不明な点がございましたら、カスタマーサポート snowconvert-support@snowflake.com までご連絡ください。
SnowConvert を使用するためのシステム要件¶
MacOS の場合¶
macOS Ventura 13.3.1またはそれ以降のバージョン
最低4 GB の RAM
Windowsの場合¶
Windows 11またはそれ以降のバージョンのWindowsオペレーティングシステム
最低4 GB の RAM (より多くのメモリを推奨)
SnowConvert 構成フォルダーにアクセス権を付与する方法¶
SnowConvert 構成フォルダーへのアクセス権を付与する方法は、オペレーティングシステムによって異なります。
SnowConvert には、構成フォルダーの読み取り、書き込み、実行の権限が必要です(MacOS で .config
またはWindowsで AppData
)。このフォルダーには、仮ファイル、ログ、ライセンス情報が保存されます。このフォルダーへのアクセスを SnowConvert に許可するには、以下のステップに従います。
MacOs の場合¶
ターミナルウィンドウを開きます。
cd ~
と入力し、Enterキーを押してホームディレクトリに移動します。chmod 777 .config
と入力して、.configディレクトリの権限を変更します。「Operation not permitted」エラーが表示された場合は、sudoでコマンドsudo chmod 777 .config
を実行します。ターミナルウィンドウを閉じ、 SnowConvert を起動します。
Windowsの場合¶
キーボードの Windows+R を押して、 Run ダイアログを開きます。
%AppData%
と入力し、 Enter キーを押すか、 OK をクリックします。Snowflake Incフォルダーを見つけ、右クリックし、属性の下にある
読み取り専用
チェックボックスがオフになっていることを検証します。
.configがファイルではなくフォルダーであることを確認する方法¶
この問題は macOS システムにのみ影響します。
SnowConvert には、構成フォルダー(macOS 上の .config
)に対する読み取り、書き込み、実行の権限が必要です。このフォルダーは、仮ファイル、ログファイル、ライセンス情報を保存するために使用されます。
.config
はディレクトリ(フォルダー)でなければなりません。.config
がファイルとして存在する場合は、それをディレクトリに変換し、適切な権限を設定する必要があります。
この問題を解決するには、以下のステップに従います。
.config
ファイルをホームディレクトリの'/Users/[ユーザー名]/'
で検索します。.config
ファイルを削除します。同じ場所に
.config
という新しいフォルダーを作成します。Terminalを起動します。
cd ~
と入力し、Enterキーを押してホームディレクトリに移動します。chmod 777 .config
と入力して、フォルダーの権限を変更します。Operation not permitted
エラーが表示された場合は、代わりにsudo chmod 777 .config
を使用します。Terminalを終了し、 SnowConvert を起動します。
トップレベルコードユニットとは¶
コードユニットとは、実行可能な独立したコードの小片のことです。コードユニットは通常、個々のステートメントで構成されていますが、スクリプトファイル全体を1つのユニットとして実行することもできます。コードユニットは階層化することができ、ユニットが他のユニットの中に含まれる場合もあります。コードユニットが他のユニットの中にネストされていない場合は、トップレベルのコードユニットと呼ばれます。
SnowConvert が SQL コードの翻訳方法を理解するためのリソースを提供する場合¶
各出典元の翻訳参照は、以下の場所にあります。
コードの完全性のメトリックとは¶
コード完全性スコアは、必要なコードコンポーネントがすべてコードベースに存在するかどうかを示します。スコアが100を下回る場合は、移行を成功させるために必要と思われるオブジェクトの参照が欠落していることを SnowConvert が検出したことを示します。
SnowConvert の以前のバージョンのリリースノートがある場所¶
リリースノートはこちらから入手可能です。 リリースノート
SnowConvert は無料のツールかどうか、また有料プランの有無について¶
SnowConvert には2つの操作モードがあります。
評価モード(無料):
既存のコードを分析します
テーブル定義を変換します
変換モード(プロフェッショナルサービスが必要):
完全なワークロード変換機能を提供します
すべての変換機能が含まれます
SnowConvert が自動でアップデートされない理由¶
インターネット接続¶
SnowConvert は、アクティブなインターネット接続があると、新しいバージョンを自動的にチェックします。エラーメッセージが表示された場合は、まずシステムがインターネットに接続され、接続が正常に機能していることを検証します。
それでも接続に問題がある場合は、ファイアウォールのルールがアクセスをブロックしている可能性があります。
ファイアウォールがブロック¶
SnowConvert は、Azure Blob Storageアカウントに接続してアップデートをチェックします。ファイヤーウォールがこのサイトへのアクセスをブロックしている場合は、アップデートを入手することができません。サイトがブロックされているかどうかを確認するには、 https://sctoolsartifacts.blob.core.windows.net/ をご覧ください。「Destination unreachable」メッセージが表示された場合は、ネットワーク管理者に sctoolartifacts
ウェブサイトをホワイトリストに登録するよう依頼します。
ライセンスの削除方法¶
すべての SnowConvert ライセンスを削除するには、configフォルダー内の .profile
ファイルを削除する必要があります。ファイルの場所はオペレーティングシステムによって異なります。お使いのシステム固有の手順に従って、このファイルを探し、削除します。
Windows¶
SnowConvert を完全に終了します。
Windowsキー(
⊞ Win
)と「R」キーを同時に押して、Runコマンドウィンドウを開きます。%appdata%Snowflake Inc
と入力し、Enterキーを押します。.profile
というファイルを見つけて削除します。
MacOS¶
SnowConvert を実行中の場合は終了します。
Finderを開き、キーボードショートカット
⌘ + Shift ⇧ + G
で「フォルダーへ移動」を開きます。~/.config/Snowflake Inc/
と入力し、構成ディレクトリにアクセスします。「.profile」ファイルを探します。Macシステムでは、これは隠しファイルです。隠しファイルを表示するには、キーボードショートカット
⌘ + Shift ⇧ + .
を使用します。「.profile」ファイルを探し、削除します。
ファイルを削除した後に SnowConvert を開くと、空のライセンスリストが表示されます。
アクセスコードが届かない理由¶
SnowConvert は、 API と通信し、アクセスコードを生成します。この通信に失敗すると、次のようなエラーメッセージが表示されます。
SnowConvert を使用するには、ネットワークが https://api-sc-licensing-prod.azurewebsites.net/ で API のライセンスへの着信と発信の両方の接続を許可していることを確認する必要があります。これらの権限を構成するには、ネットワーク管理者と協力してください。