Snowflake CLI の構成¶

.toml 構成ファイルの場所¶

デフォルトでは、 Snowflake CLI は、 ~/.snowflake ディレクトリにある config.toml ファイルを探すか、このディレクトリが存在しない場合は、以下に示すシステム固有の場所にある ファイルを探します。また、 --config-file フラグまたは SNOWFLAKE_HOME 環境変数を使用して、どの構成ファイルを使用するかを指定することもできます。

• --config-file オプションを指定すると（snow --config-file ./my-config-file-path のように）、 Snowflake CLI は指定された構成ファイルを使用します。

• SNOWFLAKE_HOME 環境変数が設定されている場合、 Snowflake CLI はこの変数で指定された場所を使用します。

• マシンに ~/.snowflake ディレクトリが存在する場合、 Snowflake CLI は ~/.snowflake/config.toml ファイルを使用します。

• そうでない場合、 Snowflake CLI はオペレーティングシステムに応じて、次のいずれかの場所にある config.toml ファイルを使用します。

  • Linux: ~/.config/snowflake/config.toml、ただし、 XDG 変数で更新可

  • Windows： %USERPROFILE%\AppData\Local\snowflake\config.toml

  • Mac: ~/Library/Application Support/snowflake/config.toml

chown $USER config.toml
chmod 0600 config.toml

snow --config-file="my_config.toml" connection test

SNOWFLAKE_<config-section>_<variable>=<value>

Snowflake CLI のみにアクセスを制限する認証ポリシーを追加します。¶

ユーザーは、ドライバーへのアクセス許可を制限する 認証ポリシー を作成できるほか、 Snowflake CLI も作成できます。Snowflake CLI （ドライバーを除く）のみにアクセスを許可したい場合は、以下のようにします。

• Snowflake CLI へのアクセスを厳密に制限する新しい認証ポリシーを作成します。

• config.toml ファイルでポリシーを有効にします。

[cli.features]
enable_separate_authentication_policy_id = true

プロキシサーバーの使用¶

プロキシサーバーを使用するには、次の環境変数を構成します。

• HTTP_PROXY

• HTTPS_PROXY

• NO_PROXY

例:

Linuxまたは macOS:

export HTTP_PROXY='http://username:password@proxyserver.example.com:80'
export HTTPS_PROXY='http://username:password@proxyserver.example.com:80'

Copy

Windows:

set HTTP_PROXY=http://username:password@proxyserver.example.com:80
set HTTPS_PROXY=http://username:password@proxyserver.example.com:80

Copy

ログの構成¶

デフォルトでは、 Snowflake CLI は自動的に INFO、 WARNING、 ERROR レベルのメッセージをログファイルに保存します。ログを無効化またはカスタマイズするには、 config.toml ファイルに [cli.logs] セクションを作成します。

[cli.logs]
save_logs = true
level = "info"
path = "/home/<username>/.snowflake/logs"

条件:

• save_logs は、ログをファイルに保存するかどうかを示します。デフォルト: true。

• level はログファイルに保存するメッセージのレベルを指定します。 次のレベルから選択します。選択したレベル以下のすべてのレベルが含まれます。

  • debug

    警告

    ログレベルを debug に切り替えると、実行された SQL クエリなどの機密情報が公開される可能性があります。このレベルを有効にする場合は注意してください。

  • info

  • warning

  • error

  デフォルト: info

• path はログファイルを保存する絶対パスを指定します。パスの形式は、次に示されるようにオペレーティングシステムに応じて異なります。

  • Linux: path = "/home/<your_username>/.config/snowflake/logs"

  • MacOS: path = "/Users/<your_username>/Library/Application Support/snowflake/logs"

  • Windows: path = "C:\\Users\\<your_username>\\AppData\\Local\\snowflake\\logs"

  指定しない場合は、デフォルトの config.toml ファイルの場所に logs ディレクトリを作成します。

config.toml が自動的に作成された場合、 config.toml ファイルにはデフォルト値が入力された `` |cli.logs| `` セクションが含まれます。

1日のログがファイル snowflake-cli.log に追加され、後で snowflake-cli.log.YYYY-MM-DD に名前が変更されます。

ls logs/

snowflake-cli.log            snowflake-cli.log.2024-10-22

トラブルシューティングのために、通常、次の例に示すように、:file:`config.toml`ファイルに:codenowrap:`[log]`セクションを追加して、Snowflake Connector for Pythonのログ記録も構成する必要もあります。

[log]
save_logs = true
path = "/home/<username>/.snowflake/logs"
level = "DEBUG"

Snowflake Connector for Pythonのログ記録の詳細については、Snowflake Connector for Pythonドキュメントの:ref:`label-python_easy_logging`をご参照ください。

バージョン更新通知の抑制¶

デフォルトでは、 Snowflake CLI で新しいバージョンのチェックを行い、新しいバージョンが利用可能になったときに通知メッセージを表示します。次のように、構成ファイルの設定または環境変数を使用して、これらの通知を抑制できます。

• config.toml`ファイルに :codenowrap:`ignore_new_version_warning 設定を追加します。

  [cli]
  ignore_new_version_warning = true
  

  Copy

• codenowrap:SNOWFLAKE_CLI_IGNORE_NEW_VERSION_WARNING 環境変数を設定します。

  export SNOWFLAKE_CLI_IGNORE_NEW_VERSION_WARNING=true
  

  Copy