SnowSQL を介した接続

このトピックでは、接続パラメーターを手動で入力してSnowflakeに接続する方法について説明します。このトピックでは、使いやすいようにデフォルトの接続を構成する方法と、代替接続設定を使用したり、複数の同時セッションを作成したりするために1つ以上の 名前付き接続 を構成する方法について説明します。

注釈

Snowflakeは SnowSQL の複数のインスタンスを同じマシンで同時に実行することをサポートしていません。例えば、2つの MacOS ターミナルやLinuxシェルアプリケーションを開いて、同時に両方で snowsql を実行することはできません。

このトピックの内容:

接続構文

$ snowsql <connection_parameters>
Copy

ここで、 <接続パラメーター> は次の1つ以上です。各パラメーターの詳細については、 接続パラメーターリファレンス (このトピック内)をご参照ください。

パラメーター

説明

-a, --accountname TEXT

使用するアカウント識別子。$SNOWSQL_ACCOUNT を受け入れます。

-u, --username TEXT

Snowflakeに接続するユーザー名。$SNOWSQL_USER を受け入れます。

-d, --dbname TEXT

使用するデータベース。$SNOWSQL_DATABASE を受け入れます。

-s, --schemaname TEXT

使用するデータベースのスキーマ。$SNOWSQL_SCHEMA を受け入れます。

-r, --rolename TEXT

使用するロール名。$SNOWSQL_ROLE を受け入れます。

-w, --warehouse TEXT

使用するウェアハウス名。$SNOWSQL_WAREHOUSE を受け入れます。

-h, --host TEXT

接続用のホストアドレス。$SNOWSQL_HOST を受け入れます。(廃止)

-p, --port INTEGER

接続用のポート番号。$SNOWSQL_PORT を受け入れます。(廃止)

--region TEXT

リージョン。$SNOWSQL_REGION を受け入れます。(廃止。代わりに -aまたは--accountnameを使用)

-m, --mfa-passcode TEXT

多要素認証(MFA)に使用するトークン

--mfa-passcode-in-password

パスワードの最後に MFA パスコードを追加します。

--abort-detached-query

クライアントとサーバー間の接続が失われた場合、クエリを中止します。デフォルトでは、接続が失われても中止されません。

--probe-connection

Snowflakeへの接続をテストします。このオプションは、主に TLS (トランスポート層セキュリティ)証明書チェーンを出力するために使用されます。

--proxy-host TEXT

(DEPRECATED。HTTPS_PROXY および HTTP_PROXY 環境変数を使用してください。)プロキシサーバーのホスト名。$SNOWSQL_PROXY_HOST を受け入れます。

--proxy-port INTEGER

(DEPRECATED。HTTPS_PROXY および HTTP_PROXY 環境変数を使用してください。)プロキシサーバーのポート番号。$SNOWSQL_PROXY_PORT を受け入れます。

--proxy-user TEXT

(DEPRECATED。HTTPS_PROXY および HTTP_PROXY 環境変数を使用してください。)プロキシサーバーのユーザー名。$SNOWSQL_PROXY_USER を受け入れます。プロキシサーバーのパスワードに $SNOWSQL_PROXY_PWD を設定します。

--authenticator TEXT

認証コード: 「snowflake」、「externalbrowser」(任意の IdP と ウェブブラウザーを使用する場合)、https://<Oktaアカウント名>.okta.com(Oktaをネイティブで使用する場合)、または「oauth」(OAuth を使用して認証する場合)。

-v, --version

現在の SnowSQL バージョンを表示するか、値として指定されている場合は特定のバージョンを使用します。

--noup

この実行の自動アップグレードを無効化します。-vにバージョンが指定されていない場合は、~/.snowsql/にある最新バージョンが使用されます。

-D, --variable TEXT

&<バージョン> で参照される変数を設定します。-D tablename=CENUSTRACKONE または --variable db_key=$DB_KEY

-o, --option TEXT

SnowSQL オプションを設定します。Snowflakeドキュメントのオプションリファレンスをご参照ください。

-f, --filename PATH

実行するファイル。

-q, --query TEXT

実行するクエリ。

--query_tags TEXT

クエリ実行時に使用するタグ。デフォルトでは、 --query_tagSNOWSQL_QUERY_TAG 環境変数の値を読み込みます。

--config PATH

SnowSQL 構成ファイルのパスと名前。デフォルトでは、~/.snowsql/config。

-P, --prompt

インタラクティブパスワードプロンプト を強制的に表示して、$SNOWSQL_PWD 環境変数に保存されているパスワードとは異なるパスワードを指定できるようにします。

-M, --mfa-prompt

MFA 用に2番目のトークンのプロンプトを強制します。

-c, --connection TEXT

使用する接続パラメーターの名前付きセット。

--single-transaction

自動コミットを無効にして接続します。ステートメントを BEGIN/COMMIT で囲んで単一のトランザクションとして実行し、すべてのコマンドを正常に完了するか、変更が適用されないようにします。

--private-key-path PATH

秘密キーファイルへのパス。

--disable-request-pooling

接続プーリングを無効にします。

-U, --upgrade

SnowSQL を最新バージョンに強制的にアップグレードします。

-K, --client-session-keep-alive

ユーザーのアクティビティがない場合でも、セッションを無期限にアクティブに保ちます。

--include_connector_version

SnowSQL バイナリのパッケージ内に含まれているPython用Snowflakeコネクタソフトウェアのバージョンを表示します。

-?, --help

このメッセージを表示して終了します。

接続時のパスワードの指定

接続パラメーターを介してパスワードを渡すことはできません。パスワードは、次のいずれかの方法で指定する必要があります。

注釈

Windows環境では、Cygwin端末でアカウント識別子、ユーザー名、またはパスワードの入力を求められることはありません。これは、SnowSQL がCygwin端末で TTY モードを有効化できないためです。

環境変数の使用

現在、環境変数は、パスワード、ホスト、データベースなどの一部のコマンドラインパラメーター値を事前に指定するためにのみ使用できます。環境変数は、 -D または --variable 接続パラメーターを使用して、SnowSQL を開始するときにコマンドラインで明示的に指定されない限り、SnowSQL 変数置換で使用できません。例:

Linux/macOS:
$ snowsql ... -D tablename=CENUSTRACKONE --variable db_key=$DB_KEY
Copy
Windows:
$ snowsql ... -D tablename=CENUSTRACKONE --variable db_key=%DB_KEY%
Copy

上記の例では、 --variabledb_key というSnowflake変数を DB_KEY 環境変数に設定します。

デフォルト接続設定の構成

接続プロセスを簡素化するために、デフォルトの接続パラメーターを構成することをお勧めします。それ以降は、Snowflakeに接続するときに、Snowflakeアカウント識別子、ユーザー名、およびデフォルト値として設定したその他のパラメーターを省略できます。

デフォルト設定を構成するには、次を実行します。

  1. テキストエディターで、 SnowSQL構成ファイル (名前 config)を開きます。ファイルのデフォルトの場所は次のとおりです。

    Linux/macOS:

    ~/.snowsql/

    Windows:

    %USERPROFILE%\.snowsql\

    注釈

    SnowSQL の起動時に、 --config path コマンドラインフラグを指定すると、デフォルトの場所を変更できます。

  1. [connections] セクションで、以下のパラメーターのいずれかからコメント記号を削除し、正しい値を指定することにより、デフォルトの接続パラメーターを構成します。

    [connections]
    #accountname = <string>   # Account identifier to connect to Snowflake.
    #username = <string>      # User name in the account. Optional.
    #password = <string>      # User password. Optional.
    #dbname = <string>        # Default database. Optional.
    #schemaname = <string>    # Default schema. Optional.
    #warehousename = <string> # Default warehouse. Optional.
    #rolename = <string>      # Default role. Optional.
    #authenticator = <string> # Authenticator: 'snowflake', 'externalbrowser' (to use any IdP and a web browser),  https://<okta_account_name>.okta.com (to use Okta natively), 'oauth' to authenticate using OAuth.
    
    Copy

    注意

    • パスワードは、 config ファイルにプレーンテキストで保存されます。アクセスを制限するには、ファイルを明示的に保護する必要があります。例えば、LinuxまたはmacOSで、 chmod を実行することにより、読み取り権限のみを設定できます。

      $ chmod 700 ~/.snowsql/config
      
      Copy
    • パスワードに特殊文字が含まれる場合、パスワードを一重引用符または二重引用符で囲む必要があります。

SnowCD を使用したSnowflakeへのネットワーク接続の確認

設定後、 SnowCD を使用して、Snowflakeへのネットワーク接続を評価およびトラブルシューティングできます。

初期設定プロセス中にオンデマンドで SnowCD をいつでも使用して、Snowflakeへのネットワーク接続を評価およびトラブルシューティングできます。

名前付き接続の使用

Snowflakeへの複数の同時接続を行うため、または単に接続構成の異なるセットを格納するために、1つ以上の 名前付き 接続を定義できます。

構成ファイルでの名前付き接続の定義

  1. テキストエディターで config 構成ファイルを開きます。デフォルトでは、ファイルは次の場所にあります。

    Linux/macOS:

    ~/.snowsql/

    Windows:

    %USERPROFILE%\.snowsql\

  2. 名前付き接続ごとに一意の名前を持つ個別の [connections] セクションを追加します。

    次の例は、 アカウント識別子 myorganization-myaccount を使用した、Snowflakeアカウントの my_example_connection という名前の接続を示しています。

    [connections.my_example_connection]
    accountname = myorganization-myaccount
    username = jsmith
    password = xxxxxxxxxxxxxxxxxxxx
    dbname = mydb
    schemaname = public
    warehousename = mywh
    
    Copy

名前付き接続を使用したSnowflakeへの接続

-c <ストリング> (または --connection <ストリング>)接続パラメーターを使用して、名前付き接続を指定します。 <ストリング> は、 構成ファイル で定義された接続の名前です。

たとえば、(このトピックの) 構成ファイルでの名前付き接続の定義 (このトピック内)で作成した my_example_connection 接続を使用して接続します。

$ snowsql -c my_example_connection
Copy

キーペア認証とキーペアローテーションの使用

SnowSQLはキーペア認証とキーローテーションをサポートします。暗号化されていない、または暗号化されたキーペアを使用できます。

注意

暗号化されていない秘密キーがサポートされていますが、Snowflakeに接続する場合は、暗号化された秘密キーを使用することを強くお勧めします。暗号化されていない秘密キーは、許可されていない人がアクセスした場合、許可されていない使用に対する保護はありません。

次の手順は、推奨される暗号化されたキーペア認証を使用することを前提としています。

  1. 開始するには、指示に従って キーペア認証とキーペアローテーション を構成します。

  2. 構成ファイルまたはコマンドラインのいずれかで、秘密キーファイルへのパスを指定します。

  • 構成ファイルで、次を実行します。

    • 接続設定に private_key_path 接続パラメーターを追加し、作成した秘密鍵ファイルへのローカルパスを指定します。構文は OS固有ではありません。

      サポートされた OS:
      private_key_path = <path>/rsa_key.p8
      
      Copy
    • SNOWSQL_PRIVATE_KEY_PASSPHRASE 環境変数を使用して、秘密鍵ファイルを復号化するためのパスフレーズを設定します。Linuxまたは MacOS の場合はパスフレーズを引用符で囲みませんが、Windowsの場合は一重引用符または二重引用符を使用する必要があることに注意してください。

      Linux/macOS:
      export SNOWSQL_PRIVATE_KEY_PASSPHRASE=<passphrase>
      
      Copy
      Windows:
      set SNOWSQL_PRIVATE_KEY_PASSPHRASE='<passphrase>'
      
      Copy
  • コマンドラインで、次を実行します。

    private-key-path 接続パラメーターを含めて、暗号化された秘密鍵ファイルへのパスを指定します。

    $ snowsql -a <account_identifier> -u <user> --private-key-path <path>/rsa_key.p8
    
    Copy

    SnowSQL がパスフレーズの入力を求めます。または、 SNOWSQL_PRIVATE_KEY_PASSPHRASE 環境変数を使用して、秘密キーファイルを復号化するためのパスフレーズを設定します(上記をご参照ください)。

プロキシサーバーの使用

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

  • 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

Tip

Snowflakeは、Snowflakeが発行した証明書以外のトランスポートレイヤーセキュリティ(TLS)証明書を提示する HTTPS プロキシを遮断する構成をサポートしていません。この構成を避けることで、危険なプロキシを介した MITM (中間者)攻撃などの潜在的なセキュリティリスクを減らすことができます。

TLS プロキシを使用する 必要 がある場合は、通信中に証明書が変更されないように、サーバーポリシーを更新してSnowflake証明書を渡すことをSnowflakeは強くお勧めします。

オプションで、 NO_PROXY を使用して、特定の通信のプロキシをバイパスできます。たとえば、 NO_PROXY=".amazonaws.com" を指定すると、Amazon S3アクセスをバイパスできます。

フェデレーション認証/SSO 用のウェブブラウザーの使用

SnowSQL で ブラウザーベースの SSO 認証 を使用するには、 --authenticator externalbrowser をご使用の SnowSQL 接続パラメーター に追加します。

例:

$ snowsql -a <account_identifier> -u <username> --authenticator externalbrowser
Copy

フェデレーション認証/SSO の詳細については、 フェデレーション認証の管理/使用 をご参照ください。

OCSP コネクタまたはドライバーバージョンの確認

Snowflakeは、Snowflakeへの接続の際、 OCSP を使用して証明書チェーンを評価します。ドライバーまたはコネクターのバージョンとその構成により、 OCSP の動作が決まります。ドライバーまたはコネクタのバージョン、それらの構成、および OCSP の動作の詳細については、 OCSP 設定 をご参照ください。

OCSP 応答キャッシュサーバー

注釈

現在、OCSP 応答キャッシュサーバーは SnowSQL 1.1.55以降でサポートされています。

Snowflakeクライアントは、実際にデータを転送する前に安全な接続を確立する「ハンドシェイク」を使用して、Snowflakeサービスエンドポイントへのすべての接続を開始します。ハンドシェイクの一部として、クライアントはサービスエンドポイントの TLS 証明書を認証します。証明書の失効ステータスは、 CA (認証機関)の OCSP (オンライン証明書ステータスプロトコル)サーバーの1つにクライアント証明書リクエストを送信することにより確認されます。

OCSP サーバーからの応答が妥当な時間を超えて遅延すると、接続エラーが発生します。次のキャッシュは失効ステータスを保持し、これらの問題の軽減に役立ちます。

  • プロセスの存続期間中保持されるメモリキャッシュ。

  • ファイルキャッシュ。キャッシュディレクトリ(例: ~/.cache/snowflake または ~/.snowsql/ocsp_response_cache)が削除されるまで保持します。

  • Snowflake OCSP 応答キャッシュサーバー。 CA の OCSP サーバーから OCSP 応答を1時間ごとに取得し、24時間保存します。クライアントは、このサーバーキャッシュから特定のSnowflake証明書の検証ステータスをリクエストできます。

    重要

    サーバーポリシーでほとんどまたはすべての外部 IP アドレスおよびウェブサイトへのアクセスが拒否された場合、通常のサービス操作を許可するには、キャッシュサーバーアドレスを許可リストに登録することが 必須 です。キャッシュサーバーのホスト名は ocsp*.snowflakecomputing.com:80 です。

    何らかの理由でキャッシュサーバーを無効化する必要がある場合は、 SF_OCSP_RESPONSE_CACHE_SERVER_ENABLED 環境変数を false に設定します。値は大文字と小文字が区別され、小文字にする 必要がある ことに注意してください。

キャッシュレイヤーに OCSP 応答が含まれていない場合、クライアントは CAの OCSP サーバーから検証ステータスを直接取得しようとします。

接続エラー処理

Cannot open self /usr/bin/snowsql or archive /usr/bin/snowsql.pkg (Linuxのみ)

pyinstaller (Pythonソースコードからスタンドアロンの実行可能ファイルに SnowSQL をパッケージ化するプログラム)の制限により、 prelinksnowsql 実行可能ファイルの一部を誤って削除し、このエラーを引き起こします。

この問題を回避するために、 SnowSQL インストーラーは /etc/prelink.conf.d/snowsql.confsnowsql 実行可能ファイル用の prelink 構成ファイルの更新を試みるため、 prelink でファイルは変更されません。残念ながら、この構成は SnowSQL 自動アップグレードプロセスでは更新できません。

システム管理者と協力して、ワークステーションで次のコマンドを実行します。

$ sudo bash -c "echo '-b snowsql' > /etc/prelink.conf.d/snowsql.conf"
Copy

注釈

ユーザーのホームディレクトリに snowsql をインストールすると、デフォルトで共有バイナリディレクトリをスキャンするように prelink が構成されているため、この問題は発生しにくくなります(例: /usr/bin または /bin)。ホームディレクトリのプログラムは変更されません。

接続パラメーターリファレンス

-a--accountname

説明:

必須

使用する アカウント識別子 を指定します。

この接続パラメーターは、 構成ファイル でも設定できます。

:

文字列

また、値は環境変数にすることもできます。

Linux/macOS:

$SNOWSQL_ACCOUNT

Windows:

%SNOWSQL_ACCOUNT%

たとえば、Linuxまたは macOSでは、次のようになります。

$ export SNOWSQL_ACCOUNT=myorganization-myaccount

$ snowsql -a $SNOWSQL_ACCOUNT
Copy
デフォルト:

なし

-u--username

説明:

指定したアカウントに接続するユーザーのログイン名を指定します。

この接続パラメーターは、 構成ファイル でも設定できます。

:

文字列

値は環境変数にすることができます。

Linux/macOS:

$SNOWSQL_USER

Windows:

%SNOWSQL_USER%

たとえば、Linuxまたは macOSでは、次のようになります。

$ export SNOWSQL_USER=jdoe

$ snowsql -u $SNOWSQL_USER
Copy
デフォルト:

なし

-d--dbname

説明:

クライアントセッションでデフォルトで使用するデータベースを指定します(ログイン後に変更できます)。

:

文字列

値は環境変数にすることができます。

Linux/macOS:

$SNOWSQL_DATABASE

Windows:

%SNOWSQL_DATABASE%

この接続パラメーターは、 構成ファイル でも設定できます。

デフォルト:

なし

-s--schemaname

説明:

クライアントセッションでデフォルトで使用するデータベーススキーマを指定します(ログイン後に変更できます)。

:

文字列

値は環境変数にすることができます。

Linux/macOS:

$SNOWSQL_SCHEMA

Windows:

%SNOWSQL_SCHEMA%

この接続パラメーターは、 構成ファイル でも設定できます。

デフォルト:

なし

-r--rolename

説明:

クライアントセッションでSnowflakeオブジェクトにアクセスするためにデフォルトで使用するロールを指定します(ログイン後に変更できます)。

この接続パラメーターは、 構成ファイル でも設定できます。

:

文字列

値は環境変数にすることができます。

Linux/macOS:

$SNOWSQL_ROLE

Windows:

%SNOWSQL_ROLE%

デフォルト:

なし

-w--warehouse

説明:

クライアントセッションのクエリ、ロードなどにデフォルトで使用する仮想ウェアハウスを指定します(ログイン後に変更できます)。

この接続パラメーターは、 構成ファイル でも設定できます。

:

文字列

値は環境変数にすることができます。

Linux/macOS:

$SNOWSQL_WAREHOUSE

Windows:

%SNOWSQL_WAREHOUSE%

デフォルト:

なし

-h--host --- 廃止

説明:

下位互換性/内部使用のために提供

Snowflakeで接続するホストのアドレスを指定します。

ホストアドレスは、指定したアカウント識別子(-a または --account を使用)とSnowflakeドメイン(snowflakecomputing.com)を連結することで自動的に決定されるため、このパラメーターは使用されなくなりました。

:

文字列

デフォルト:

なし

-p--port --- 廃止

説明:

下位互換性/内部使用のために提供

接続に使用するポート番号を指定します。

Snowflakeのポート番号は常に 443 であるため、このパラメーターは使用されなくなりました。

:

文字列

デフォルト:

なし

--region --- 廃止

説明:

下位互換性/内部使用のために提供

アカウントが存在する 地域 の ID を指定します。

このパラメーターは使用されなくなりました。詳細については、 -a 、 --accountname (このトピック内)をご参照ください。

:

N/A

デフォルト:

N/A

-m--mfa-passcode

説明:

コマンドラインでパスコードを渡す場合、MFA (多要素認証)の2番目のトークンを指定します。

:

文字列

デフォルト:

なし

--mfa-passcode-in-password

説明:

パスワードの最後に MFA パスコードを追加します。

パスワードプロンプトを強制し、パスワードの後に MFA パスコードを入力できます。例えば、MFA トークンが 123456 で、パスワードが PASSWORD の場合は、次のようになります。

$ snowsql ... -P ...

Password: PASSWORD123456
Copy
:

なし(パラメーターは値を取らない)

デフォルト:

N/A

--abort-detached-query

説明:

クライアントとサーバー間の接続が失われた場合、クエリを中止します。

:

ブール値

デフォルト:

False(接続が失われてもアクティブなクエリは中止されない)

--probe-connection

説明:

Snowflakeへの接続をテストし、結果を報告します。これは、主に TLS 証明書チェーンを出力するために使用される試験的なオプションであることに注意してください。

:

なし(パラメーターは値を取らない)

デフォルト:

N/A

--authenticator

説明:

ユーザーログイン認証情報の検証に使用する認証方式を指定します。

:

文字列(定数):

  • snowflake では、内部Snowflake認証方式を使用します。

  • externalbrowser は、 ウェブブラウザーを使用 して、Okta、AD FS、またはアカウントに定義されている他のSAML 2.0準拠の識別プロバイダー(IdP)で認証します。

  • https://<Oktaのアカウント名>.okta.com (つまり、OktaのURLエンドポイント)は、 ネイティブOktaの を介して認証します(IdPがOktaの場合のみサポート)。

  • oauth は、OAuthを使用して認証します。OAuth が認証コードとして指定されている場合は、 OAuth トークンを指定するために --token パラメーターも設定する必要があります( 以下を参照)。

詳細については、 フェデレーション認証の管理/使用 および クライアント、ドライバー、およびコネクタ をご参照ください。

デフォルト:

snowflake

注釈

externalbrowser 認証方式は、ウェブブラウザーにアクセスできるターミナルウィンドウでのみサポートされます。たとえば、SSH(Secure Shell)セッションを介してアクセスされるリモートマシンのターミナルウィンドウでは、ウェブブラウザーを開くために追加設定が必要になる場合があります。

ウェブブラウザーへのアクセスがなくても、IdPがOktaの場合は、ネイティブOktaを使用できます(つまり、認証方式を https://<Oktaのアカウント名>.okta.com に設定)。

--token

説明:

認証に使用する OAuth トークンを指定します。このパラメーターは、 --authenticator=oauth を指定する場合にのみ必要です。

:

文字列

デフォルト:

なし

-v--version

説明:

指定された SnowSQL バージョンを使用するか、バージョンが指定されていない場合は、インストールされている最新の SnowSQL バージョンを表示します。

:

文字列

デフォルト:

なし

--versions

説明:

インストールして実行できる SnowSQL の利用可能なすべてのバージョンをリストします。リストから以前の SnowSQL バージョンをインストールするには、 -v オプションを使用して、インストールするバージョンを指定します。

:

なし(パラメーターは値を取らない)

デフォルト:

N/A

--noup

説明:

この実行の自動アップグレードを無効化します。このオプションが含まれておらず、新しいバージョンが利用可能な場合、SnowSQL は自動的に新しいバージョンをダウンロードしてインストールします。次回の SnowSQL実行時には、新しいバージョンが使用されます。

:

なし(パラメーターは値を取らない)

デフォルト:

N/A

-D--variable

説明:

コマンドラインで SnowSQL 変数を定義します。このオプションを使用して、Snowflakeで使用する特定の変数を設定できます。

:

文字列

例:

$ snowsql ... -D tablename=CENUSTRACKONE --variable db_key=$DB_KEY ...
Copy
デフォルト:

なし

-o--option

説明:

コマンドラインで SnowSQL 構成オプションを定義します。これらのオプションは、 SnowSQL 構成ファイルで設定されたオプションを上書きします。設定/オーバーライドできるオプションの説明については、 SnowSQL 構成オプションリファレンス をご参照ください。

:

文字列

デフォルト:

なし

-f--filename

説明:

バッチモードで実行する SQL ファイルを指定します。

値は、ファイル名(必要に応じてディレクトリパスを含む)またはファイルへの URL です。

:

文字列

デフォルト:

なし

-q--query

説明:

実行する SQL クエリを指定します。

値は、単一の SQL クエリ、または実行するクエリのセミコロン区切りのリスト(例: 'select current_user(); select current_role()')です。

クエリを ;> で区切ることにより、非同期で実行する複数のクエリを指定することもできます。次の例では、 SnowSQL を開始し、4つのクエリすべてを非同期で実行します。

snowsql -o log_level=DEBUG -q "select * from SNOWSQLTABLE;> insert into table table1 values(2);> select 5;>select count(*) from testtable;"

:

文字列

デフォルト:

なし

--query_tag

説明:

クエリ実行時に使用するタグを指定します。

値は1つのタグか、セミコロンで区切られたタグのリストです。

:

文字列

デフォルト:

SNOWSQL_QUERY_TAG 環境変数の値。

--config

説明:

SnowSQL 構成ファイルの場所(ディレクトリパス)を指定します。デフォルトの場所から構成ファイルを移動またはコピーする場合は、このコネクタパラメーターを含めます。

:

文字列

デフォルト:

OS固有:

Linux/macOS:

~/.snowsql/

Windows:

%USERPROFILE%\.snowsql\

-P--prompt

説明:

インタラクティブパスワードプロンプトを強制します。

デフォルトでは、 SnowSQL は $SNOWSQL_PWD 環境変数に保存されているパスワードを使用します。このオプションを使用すると、 $SNOWSQL_PWD で定義されたパスワードを上書きできます。

:

なし(パラメーターは値を取らない)

デフォルト:

N/A

-M--mfa-prompt

説明:

MFA の2番目のトークンのプロンプトを強制します。または、コマンドラインに渡す場合は --mfa-passcode <文字列> を使用します。

:

なし(パラメーターは値を取らない)

デフォルト:

N/A

-c--connection

説明:

使用する接続を指定します。指定された文字列は、SnowSQL 構成ファイルで定義された接続の名前です。詳細については、 名前付き接続の使用 (このトピック)をご参照ください。

:

文字列

デフォルト:

なし

--single-transaction

説明:

このオプションは、 --filename--query、または標準入力コマンドと組み合わせて、ステートメントを BEGIN/COMMIT でラップし、すべてのコマンドが正常に完了するか、変更が適用されないようにします。

:

なし(パラメーターは値を取らない)

デフォルト:

N/A

注釈

入力コマンドで BEGIN、 COMMIT、または ROLLBACKを使用する場合、このオプションは正しく機能しないことに注意してください。また、トランザクションブロック内でコマンドを実行できない場合、このオプションによりコマンドが失敗します。

--private-key-path

説明:

秘密キーファイルへのパス。

注意

暗号化されていない秘密キーがサポートされていますが、Snowflakeに接続する場合は、暗号化された秘密キーを使用することを強くお勧めします。

詳細については、 キーペア認証およびキーペアローテーションの使用 をご参照ください。

この接続パラメーターは、 構成ファイル でも設定できます。

:

文字列

デフォルト:

なし

--disable-request-pooling

説明:

デフォルトでは、snowsqlは接続プーリングを使用します。接続プーリングは、通常、接続を確立するための遅延時間を短縮します。ただし、DNS の問題が発生すると、代替の DNS へのクライアントフェールオーバーが遅くなる可能性があります。このパラメーターを使用すると、接続プーリングをオフにできます。

このパラメーターは、複製が有効化されている顧客にのみ適用されます。

:

なし(パラメーターは値を取らない)

デフォルト:

N/A

-U--upgrade

説明:

ローカルディレクトリにダウンロードされていない場合、SnowSQL を最新バージョンに強制的にアップグレードします。

:

なし(パラメーターは値を取らない)

デフォルト:

N/A

注釈

SnowSQL 1.1.63以降のバージョンのブートストラップ実行可能ファイルが必要です。 UIからダウンロードします。

-K--client-session-keep-alive

説明:

ユーザーのアクティビティがない場合でも、セッションを無期限にアクティブに保ちます。

:

なし(パラメーターは値を取らない)

デフォルト:

N/A

--include_connector_version

説明:

SnowSQL バイナリのパッケージ内に含まれているPython用Snowflakeコネクタソフトウェアのバージョンを表示します。

:

なし(パラメーターは値を取らない)

デフォルト:

N/A

-?--help

説明:

コマンドラインのクイック使用ガイドを表示します。

:

なし(パラメーターは値を取らない)

デフォルト:

N/A