Snowflake CLI の構成¶

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

デフォルトでは、 Snowflake CLI は、 ~/.snowflake ディレクトリにある config.toml ファイルを探すか、このディレクトリが存在しない場合は、以下に示すシステム固有の場所にある ファイルを探します。また、--config-file フラグまたは:codenowrap: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.company.com:80'
export HTTPS_PROXY='http://username:password@proxyserver.company.com:80'

Copy

Windows:

set HTTP_PROXY=http://username:password@proxyserver.company.com:80
set HTTPS_PROXY=http://username:password@proxyserver.company.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