ODBC 構成および接続パラメーター¶

Windowsでのパラメーターの設定¶

Windowsの場合：

• 構成パラメーター は、 regedit と次のレジストリパスを使用してWindowsレジストリに設定されます。

  [HKEY_LOCAL_MACHINE\SOFTWARE\Snowflake\Driver]
  

  Copy

• 接続パラメーター はデータソース名（DSNs）で設定されます。

  • DSNs は通常、Windows Data Source Administration ツールを使用して作成および編集されます。

  • 必要に応じて regedit を使用して、 DSNs のレジストリキーをWindowsレジストリで直接編集できます。キーへのレジストリパスは、64ビットと32ビットのWindowsを使用しているか、ユーザーまたはシステム DSN を編集しているかによって異なります。

    • 64ビットWindows：

      [HKEY_CURRENT_USER\SOFTWARE\ODBC\ODBC.INI\<DSN_NAME>]
      
      [HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBC.INI\<DSN_NAME>]
      

      Copy

    • 32ビットWindows：

      [HKEY_CURRENT_USER\SOFTWARE\WOW6432NODE\ODBC\ODBC.INI\<DSN_NAME>]
      
      [HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432NODE\ODBC\ODBC.INI\<DSN_NAME>]
      

      Copy

    regedit を使用して接続パラメーターを追加するには、新しい String Value を追加し、作成した値をダブルクリックして、 ODBC パラメーターを Value name として、そしてパラメーター値を Value data として入力します。

macOS またはLinuxでのパラメーターの設定¶

macOS またはLinuxの場合：

• 構成パラメーター は、構成ファイル（simba.snowflake.ini）で設定されます。

• 接続パラメーター はデータソース名（DSN）ファイル（odbc.ini）で設定されます。

構成パラメーター¶

CABundleFile

証明機関（CA）のバンドルファイルの場所を設定します。CA 証明書の有効なリストを含むファイルを参照する必要があります。

Linuxの場合、 RPM および DEB インストーラーは自動的にファイルをコピーし、このパラメーターを設定します。

Macの場合、 PKG インストーラーはファイルをコピーし、このパラメーターを設定します。

Windowsの場合、 MSI インストーラーはファイルをコピーし、このパラメーターを設定します。

手動インストールでは、 https://curl.haxx.se/docs/caextract.html からファイルをダウンロードし、ファイルの場所を設定する必要があります。

client_config_file

ログレベルとログファイルを保存するディレクトリを定義するために使用する ログ構成ファイル のパスを指定します。

CURLVerboseMode

cURL の詳細ログを有効にするには、 true に設定します。ログファイル snowflake_odbc_curl.dmp が作成および更新されます。Snowflake ODBC ドライバーは、 cURL を HTTP および TLS ライブラリとして使用します。このパラメーターは、ネットワークの問題の診断に役立ちます。

DisableOCSPCheck

true に設定して、オンライン証明書状態プロトコル（OCSP）による TLS 証明書の失効ステータスチェックを無効にします。通常の状況では、このフラグは設定しないでください。ただし、 OCSP の可用性の問題が解決しないときは、アプリケーションがこのパラメーターを一時的に設定して、接続の問題のブロックを解除し、 OCSP の可用性の問題が解決されたときに削除する場合があります。

:codenowrap：DisableTelemetry

インバンドテレメトリーハンドラーの切り替えを有効にするかどうかを指定します。このドライバー構成設定が:codenowrap:true に設定されている場合、テレメトリーハンドラーはドライバー内に作成されません。

DriverManagerOverride

デフォルトでは、ドライバーは、使用するドライバーマネージャーを自動検出します。ただし、特定の状況でそれが必要な場合は、 ODBC ドライバーバージョン3.9.0以降では、この自動検出を無効にして、使用するドライバーマネージャーを手動で指定できます。

可能な値は UnixODBC と iODBC です。

DriverManagerOverride が指定されていない場合、ドライバーは、ドライバー管理の自動検出を使用（バックトレース()）して、ドライバーマネージャー情報を取得します。これがデフォルトの動作です。

パラメーターはLinuxおよび MacOS でのみ動作します。

EnableAutoIpdByDefault

ODBC ドライバーを構成するために false に設定して、 SQL_ATTR_ENABLE_AUTO_IPD を false （ODBC 標準のデフォルト値）に設定します。

それ以外の場合、デフォルトでは、ODBC ドライバーはサードパーティツールとの互換性のために SQL_ATTR_ENABLE_AUTO_IPD をtrueに設定します。

このパラメーターは、ODBC ドライバーのバージョン2.22.0で導入されました。

EnablePidLogFileNames

true に設定して、ログファイルの名前にプロセス ID を含めます。たとえば、プロセス ID が7394の場合、ログファイルには次の名前が付けられます。

• snowflake_odbc_connection_7394_0.log

• snowflake_odbc_generic7394_0.log

• snowflake_odbc_curl_7394.dmp

このパラメーターを設定して、異なるプロセスが同じログファイルを上書きしないようにすることができます。各プロセスは、独自のログファイルのセットを生成します。

デフォルトでは、このパラメーターの値は false です。

このパラメーターは、 ODBC ドライバーのバージョン2.22.2で導入されました。

get_size_threshold

GET コマンドでファイルをダウンロードするときに、ファイルを小さな部分に分割する最小ファイルサイズをメガバイト（MB）単位で指定します。このしきい値より小さいサイズのファイルは、マルチパートダウンロードを使用しません。

デフォルトは 5 （MB）です。

注釈

対応する しきい値サイズ取得 接続パラメーターを設定すると、特定のケースでこの値を上書きできます。

KeepLeadingTrailingZeros

文字列値としてフォーマットされた数値の先頭または後続のゼロの処理方法を決定します。デフォルトでは、パラメーターは true に設定されます。これは、ドライバーが先頭または後続のゼロを保持することを意味します。パラメーターを false に設定して、先頭または後続のゼロを削除します。たとえば、

• 0.23 は .23 に変更

• 7.00 は 7 に変更

LogFileCount

新しいログファイル用のスペースを確保するため、古いファイルをローテーションする前に、保持するログファイルの最大数を設定します。

LogFileSize

ログファイルの最大サイズをバイト単位で指定します。ログファイルが指定されたサイズに達すると、 ODBC ドライバーは自動的に新しいログファイルを作成します。

デフォルトは 20971520 です。

LogLevel

ODBC ドライバーを使用するクライアントについて記録される詳細レベルを指定します。

• 0 = オフ

• 1 = 致命的

• 2 = エラー

• 3 = 警告

• 4 = 情報

• 5 = デバッグ

• 6 = トレース

LogPath

ODBC ドライバーを使用するクライアントのSnowflakeログファイルの場所を指定します。

MapToLongVarchar

デフォルトの ODBC SQL_CHAR または SQL_VARCHAR データ型ではなく、 ODBC SQL_LONGVARCHAR データ型への文字列値のマッピングを開始する文字列の長さを指定します。

• < 0 （または設定解除）: 文字列値をデフォルトの ODBC データ型にマップします。デフォルト = -1。

• >= 0: デフォルトの ODBC 文字列データ型にマップする文字列文字の最大数を指定します。この値より大きいすべての文字列は、 SQL_LONGVARCHAR にマップされます。

このパラメーターを接続パラメーターとして指定することもできます。（Windows、 macOS およびLinuxnai 内にあるパラメーターの設定の手順をご参照ください。）接続パラメーター および 構成パラメーターの両方として設定されている場合は、 DSN （または接続文字列）の接続パラメーターが優先されます。

このパラメーターは、 ODBC ドライバーのバージョン2.24.3で導入されました。

NoExecuteInSQLPrepare

true に設定して、 ODBC ドライバーを構成し、 DDL ステートメント（CREATE や DROP など）を SQLPrepare() と SQLExecute() に渡すときに標準の ODBC 動作を使用します。

Snowflakeでは、デフォルトで、 DDL ステートメントを SQLPrepare() に渡すと、 ODBC ドライバーはデータソースにステートメントを送信して（準備ではなく）実行します。DDL ステートメントを SQLExecute() に渡すと、 ODBC ドライバーはステートメントをデータソースに送信しません。

NoExecuteInSQLPrepare を true に設定すると、 ODBC ドライバーは標準の ODBC 動作に従います。SQLPrepare() を呼び出すと、ステートメントがデータソースに送信され、準備されます（実行はしない）。SQLExecute() を呼び出すと、ステートメントがデータソースに送信されて実行されます。

このパラメーターは、ODBC ドライバーのバージョン2.21.6で導入されました。

NoProxy

プロキシサーバーをバイパスするホスト名パターンを指定します（例：Amazon S3アクセスをバイパスするには、 .amazonaws.com）。

注釈

Snowflake ODBC ドライバーは、 NoProxy 値をカールオプション CURLOPT_NOPROXY に渡します。

NoProxy 値の形式については、 CURLOPT_NOPROXY の説明の をご参照ください。

Proxy

ODBC ドライバーを使用するクライアント用に、プロキシサーバーを <ホスト>:<ポート> の形式で指定します。

注釈

Windowsでは、 ODBC ドライバーがインストールされると、 LogLevel および LogPath のエントリが作成され、デフォルト値が入力されます。ただし、インストール中に Proxy のエントリは作成されません。ドライバーで使用するプロキシを指定するには、ドライバーレジストリキーにエントリを手動で追加する必要があります。

1つ以上の IP アドレスまたは URLs のプロキシをバイパスするには、 NoProxy パラメーターを追加します。

:codenowrap：SSLVersion

TLS ハンドシェイクを開始するときに使用する最小の SSL/TLS バージョンを指定します。これらの値は、libcurlの機能に対応しています。詳細については、 <https://curl.se/libcurl/c/CURLOPT_SSLVERSION.html>`_ で説明された CURLOPT_SSLVERSION の:codenowrap:`CURL_SSLVERSION_* エントリをご参照ください。

可能な値： TLSv1、 SSLv2、 SSLv3、 TLSv1_0、 TLSv1_1、 TLSv1_2、 TLSv1_3のいずれか（デフォルト： TLSv1_2）。

Snowflakeは、特に変更する必要がない場合は、この設定をデフォルトのままにすることをお勧めします。

:codenowrap：SSLVersionMax

TLS ハンドシェイクを開始するときに使用する最大の SSL/TLS バージョンを指定します。これらの値は、libcurlの機能に対応しています。詳細については、 <https://curl.se/libcurl/c/CURLOPT_SSLVERSION.html>`_ で説明された CURLOPT_SSLVERSION の:codenowrap:`CURL_SSLVERSION_MAX_* エントリをご参照ください。

可能な値：TLSv1_0、 TLSv1_1、 TLSv1_2、 TLSv1_3のいずれか（デフォルト： TLSv1_3）。

Snowflakeは、特に変更する必要がない場合は、この設定をデフォルトのままにすることをお勧めします。

接続パラメーター¶

connections.toml ファイルを使用した接続¶

ODBC により、 connections.toml 構成ファイルに接続定義を追加できます。接続定義とは、接続に関連するパラメーターのコレクションのことです。ドライバは現在、 TOML バージョン1.0.0 をサポートしています。

toml ファイルフォーマットの詳細については、 TOML (Tom's Obvious Minimal Language) をご参照ください。

接続文字列の接頭辞: odbc:snowflake:auto は、定義済みの（デフォルトの）ファイルから接続設定を探すようドライバーに指示します。ODBC ドライバは、 connections.toml ファイルを以下の場所で順に探します。

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

• SNOWFLAKE_HOME 環境変数で指定された場所。

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

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

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

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

Snowsight で TOML 構成ファイルの基本設定を生成できます。詳細については、 Snowflakeに接続するためのクライアント、ドライバー、ライブラリ、またはサードパーティアプリケーションの構成 をご参照ください。

既存の複数の接続を切り替える場合は、 connections.toml ファイルで設定できます。デフォルトのキーは default ですが、 SNOWFLAKE_DEFAULT_CONNECTION_NAME シェル環境変数を設定することで、デフォルトの接続名を変更できます。

以下のサンプル・ファイル（connections.toml）では、2つの接続を定義しています。

[default]
account = 'my_organization-my_account'
user = 'test_user'
password = '******'
warehouse = 'testw'
database = 'test_db'
schema = 'test_odbc'
protocol = 'https'
port = '443'


[aws-oauth-file]
account = 'my_organization-my_account'
user = 'test_user'
password = '******'
warehouse = 'testw'
database = 'test_db'
schema = 'test_odbc'
protocol = 'https'
port = '443'
authenticator = 'oauth'
token_file_path = '/Users/test/.snowflake/token'

接続文字列のパラメーター指定¶

接続パラメーター は、接続文字列の名前と値のペアとして指定できます。各パラメーターと値の間には等号 (=) を使用し、パラメーター間にはセミコロン (;) を使用します。例:

driver={SnowflakeDSIIDriver};server=myorganization-myaccount.snowflakecomputing.com;uid=myloginname;pwd=mypassword;database=mydatabase;schema=myschema;warehouse=mywarehouse;role=myrole;...

Snowsight で基本接続文字列を生成できます。詳細については、 Snowflakeに接続するためのクライアント、ドライバー、ライブラリ、またはサードパーティアプリケーションの構成 をご参照ください。

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

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

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

プロキシサーバー経由での接続¶

プロキシサーバー接続を構成する手順は、オペレーティングシステムとドライバーのバージョンによって異なります。

認証でのシングルサインオン（SSO）の使用¶

シングルサインオン（SSO）を使用するようにSnowflakeを構成 している場合、認証に SSO を使用するようにクライアントアプリケーションを構成できます。詳細については Snowflakeに接続するクライアントアプリケーションでの SSO の使用 をご参照ください。

多要素認証の使用¶

Snowflakeは、 MFA トークンキャッシングと SSO の組み合わせを含む、 MFA トークンのキャッシングをサポートしています。

詳細については、 MFA トークンキャッシングを使用して認証中のプロンプトの数を最小限に抑える --- オプション をご参照ください。

キーペア認証の使用¶

ODBC ドライバーは、キーペア認証とキーローテーションをサポートします。

1. 開始するには、 キーペア認証とキーペアローテーション に示すように、キーペア認証の初期構成を完了します。

2. ドライバーのデータソース名（DSN）エントリを変更します。DSN エントリの詳細については、ご使用のオペレーティングシステムに該当するトピックをご参照ください。

   • Linux用 ODBC ドライバーのインストールおよび構成

   • Windows用 ODBC ドライバーのインストールおよび構成

   次の（大文字と小文字を区別する）パラメーターを追加します。

   AUTHENTICATOR = SNOWFLAKE_JWT

   JSON Webトークン（JWT）でのキーペア認証を使用してSnowflake接続を認証するように指定します。

   JWT_TIME_OUT = integer

   オプション。Snowflakeがタイムアウトになるまで JWT の受信を待機する時間の長さ（秒単位）を指定します。その場合、認証は失敗し、ドライバーは Invalid JWT token エラーを返します。エラーの繰り返し発生を解決するには、パラメーター値を増やします。デフォルト: 30

   PRIV_KEY_FILE = path/rsa_key.p8

   作成した秘密キーファイル（つまり、 rsa_key.p8）へのローカルパスを指定します。

   DSN に設定された値は、 SQLSetConnectAttr() 関数を呼び出すことで上書きできます。詳細については、 Snowflake固有のSQLSetConnectAttr関数の動作 をご参照ください。

   PRIV_KEY_FILE_PWD = <password>

   秘密キーファイルをデコードするパスコードを指定します。

   このパラメーターは、パラメーター PRIV_KEY_FILE も設定されている場合にのみ設定する必要があります。

   DSN に設定された値は、 SQLSetConnectAttr() 関数を呼び出すことで上書きできます。詳細については、 Snowflake固有のSQLSetConnectAttr関数の動作 をご参照ください。

3. 設定を保存します。

OAuth 2.0 認証コードフローの使用¶

OAuth 2.0認証コードフローは、ユーザーの認証情報を公開することなく、クライアントアプリケーションがユーザーに代わって認証サーバーからアクセストークンを取得するための安全な方法です。

OAuth 2.0 認証コードフローを有効にするには：

1. authenticator 接続パラメーターを oauth_authorization_code に設定します。

2. 以下の OAuth 接続パラメーターをセットします。

   • OAUTH_CLIENT_ID: IDプロバイダーがSnowflake統合用に提供する client id の値（Snowflakeセキュリティ統合メタデータ）。

   • OAUTH_CLIENT_SECRET: IDプロバイダーがSnowflake統合用に提供する client secret の値（Snowflake セキュリティ統合メタデータ）。

   • OAUTH_AUTHORIZATION_URL: 認証コードをドライバーに供給するIDプロバイダーのエンドポイント。SnowflakeをIDプロバイダーとして使用する場合、この値は server または account パラメーターから取得されます。

   • OAUTH_TOKEN_REQUEST_URL: ドライバーにアクセストークンを供給するIDプロバイダーエンドポイント。SnowflakeをIDプロバイダーとして使用する場合、この値は server または account パラメーターから取得されます。

   • OAUTH_SCOPE: IDプロバイダーの認可リクエストで要求されたスコープ。デフォルトでは、ロールから派生します。複数のスコープが必要な場合、値はスペースで区切られた複数のスコープのリストでなければなりません。

   • OAUTH_REDIRECT_URI： URI 認証コードリダイレクトに使用します（Snowflakeセキュリティ統合メタデータ）。デフォルト： http://127.0.0.1:{randomAvailablePort}。

OAuth 2.0 クライアント認証フローの使用¶

OAuth 2.0クライアント認証情報フローは、Python用Snowflake Connectorがバックエンドサービスに接続するような、マシン間（M2M）認証のためのセキュアな方法を提供します。OAuth 2.0認証コードフローとは異なり、このメソッドはユーザー固有のデータに依存しません。

OAuth 2.0 クライアント認証フローを有効にするには：

1. codenowrap:authenticator 接続パラメーターを oauth_client_credentials に設定します。

2. 以下の OAuth 接続パラメーターをセットします。

   • OAUTH_CLIENT_ID: IDプロバイダーがSnowflake統合用に提供する client id の値（Snowflakeセキュリティ統合メタデータ）。

   • OAUTH_CLIENT_SECRET: IDプロバイダーがSnowflake統合用に提供する client secret の値（Snowflakeセキュリティ統合メタデータ）

   • OAUTH_TOKEN_REQUEST_URL: ドライバーにアクセストークンを供給するIDプロバイダーエンドポイント。SnowflakeをIDプロバイダーとして使用する場合、この値は server または account パラメーターから取得されます。

   • OAUTH_SCOPE: IDプロバイダーの認可リクエストで要求されたスコープ。デフォルトでは、ロールから派生します。複数のスコープが必要な場合、値はスペースで区切られた複数のスコープのリストでなければなりません。

プログラムアクセストークンによる認証コード (PAT)¶

プログラムアクセストークン（PAT）は、Snowflake固有の認証方法です。この機能は使用前にアカウントで有効にする必要があります（詳細は 前提条件 を参照してください）。PAT での認証コードには、人とのやりとりは一切ありません。

ワークロードIDフェデレーション（WIF）による認証¶

ワークロードIDフェデレーション は、Snowflakeのサービス間の認証方法を提供します。この方法により、アプリケーション、サービス、コンテナは、 AWSIAM、Microsoft Entra ID またはGoogle CloudサービスアカウントのようなクラウドプロバイダーのネイティブIDシステムを活用して、Snowflakeで認証することができます。このアプローチでは、長期間有効な認証情報を管理する必要がなくなり、外部 OAuth のような他の方法と比較して、認証情報の取得が簡素化されます。Snowflakeコネクタは、プラットフォームのIDプロバイダーから有効期間が短い認証情報を自動的に取得するように設計されています。

ワークロードIDフェデレーション認証コードを有効にするには、以下を実行します。

1. authenticator 接続パラメーターを WORKLOAD_IDENTITY に設定します。

2. プラットフォームに応じて、workload_identity_provider 接続パラメーターを:codenowrap:AWS、 AZURE、 :codenowrap:`GCP`または:codenowrap:`OIDC`に設定します。

3. OpenID 接続（OIDC）の場合、token 接続パラメーターを指定します。

ログファイルの管理¶

発生する可能性のある問題を追跡するために、 ODBC ドライバーへのログインを有効にすることができます。ODBC ドライバーは、ログの設定とログファイルの管理に使用できる次の構成オプションを提供します。

• EnablePidLogFileNames: プロセス ID をログファイルの名前に追加します。

• LogFileCount: 保存するログファイルの最大数を設定します。

• LogFileSize: ログファイルの最大サイズを指定します。

• LogLevel: ログに記録する情報のタイプを指定します。

• LogPath: ログファイルの場所を設定します。

これらのパラメーターを使用して、ログファイルの名前付け、格納、およびローテーションの方法を管理できます。新しく作成されたログファイルに置き換える前に、保持するログファイルのサイズと数を指定できます。次の例では、プロセス ID をファイル名に追加して一意性を確保し、最大ファイルサイズを 30MB に設定し、100個の最新のログファイルを保持します。

EnablePidLogFileNames = true  # Appends the process ID to each log file
LogFileSize = 30,145,728      # Sets log files size to 30MB
LogFileCount = 100            # Saves the 100 most recent log files

{
  "common": {
    "log_level": "DEBUG",
    "log_path": "/home/user/logs"
  }
}

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

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

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

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 サーバーから検証ステータスを直接取得しようとします。