JDBC ドライバーを構成する¶
このトピックでは、ドライバーを使用してSnowflakeに接続する方法など、 JDBC ドライバーを構成する方法について説明します。
このトピックの内容：
JDBC ドライバークラス¶
JDBC アプリケーションでドライバークラスとして net.snowflake.client.jdbc.SnowflakeDriver を使用します。
注釈
アプリケーションコード内で他のSnowflakeクラスまたはメソッドを参照しないでください。将来、改善および修正を実装するために変更される可能性があります。
以前のドライバークラス
com.snowflake.client.jdbc.SnowflakeDriverは引き続きサポートされますが、非推奨です（つまり、将来の TBDリリースで削除されます）。そのため、以前のクラス名を参照するコードは引き続き機能しますが、変更が実装されているため、新しいクラス名を参照するように、コードを更新する必要があります。
JDBC ドライバー接続文字列¶
JDBC ドライバーを使用してSnowflakeに接続するには、次の構文の接続文字列が必要です。
構文¶
jdbc:snowflake://<account_name>.snowflakecomputing.com/?<connection_params>
接続パラメーター¶
<アカウント名>アカウントのフルネームを指定します（Snowflakeが提供）。完全なアカウント名には、アカウントがホストされている 地域 および クラウドプラットフォーム を識別する 追加 のセグメントが含まれている場合があります。
リージョン別のアカウント名の例
アカウントロケーターが
xy12345の場合:クラウドプラットフォーム / . リージョン
アカウントロケーター . （必要に応じて追加のセグメントを含む）
Amazon Web Services（AWS）
US 西部（オレゴン）xy12345US 東部（オハイオ）xy12345.us-east-2.awsUS 東部（バージニア北部）xy12345.us-east-1US 東部（商業組織、バージニア政府北部）xy12345.us-east-1-gov.awsカナダ（中部）xy12345.ca-central-1.awsEU （アイルランド）xy12345.eu-west-1ヨーロッパ（ロンドン）xy12345.eu-west-2.awsEU （フランクフルト）xy12345.eu-central-1アジア太平洋（東京）xy12345.ap-northeast-1.awsアジア太平洋（ムンバイ）xy12345.ap-south-1.awsアジア太平洋（シンガポール）xy12345.ap-southeast-1アジア太平洋（シドニー）xy12345.ap-southeast-2Google Cloud Platform（GCP）
US 中央部1（アイオワ）xy12345.us-central1.gcpヨーロッパ西部2（ロンドン）xy12345.europe-west2.gcpヨーロッパ西部4（オランダ）xy12345.europe-west4.gcpMicrosoft Azure
西 US 2（ワシントン）xy12345.west-us-2.azure東 US 2（バージニア）xy12345.east-us-2.azureUS 政府バージニアxy12345.us-gov-virginia.azureカナダ中央部（トロント）xy12345.canada-central.azure西ヨーロッパ（オランダ）xy12345.west-europe.azureスイス北部（チューリッヒ）xy12345.switzerland-north.azure東南アジア（シンガポール）xy12345.southeast-asia.azureオーストラリア東部（ニューサウスウェールズ）xy12345.australia-east.azure重要
次のいずれかの条件に該当する場合、アカウントロケーターは、上記の例の構造とは異なります。
Snowflake Editionが VPS の場合、アカウントロケーターの詳細については Snowflakeサポート にお問い合わせください。
アカウントで AWS PrivateLink またはAzure Private Linkが有効になっており、プライベート接続を使用してSnowflakeに接続する場合は、 SYSTEM$GET_PRIVATELINK_CONFIG 関数を実行して、使用するプライベート接続 URL を決定します。
プライベート接続の詳細については、以下をご参照ください。
<地域ID>--- 廃止アカウントが存在する 地域 の ID を指定します。
必要に応じて地域情報が完全なアカウント名の一部として含まれるため、このパラメーターは使用されなくなりました。ここでは、下位互換性のためにのみ文書化されています。
<接続パラメーター>一連の1つ以上のパラメーターを
<パラメーター>=<値>の形式で指定します。各パラメーターはアンパサンド文字（&）で区切られ、接続文字列のどこにもスペースはありません。スペース、アンパサンド（
&）、等号（=）、またはその他の特殊文字を使用するパラメーター値を設定する必要がある場合は、 特殊文字を URL エンコード する必要があります。たとえば、スペース、アンパサンド、等号を含む値を指定する必要がある場合は、次のようになります。String connectionURL = "jdbc:snowflake://myaccount.snowflakecomputing.com/?query_tag='folder=folder1 folder2&'
スペースを
%20、アンパサンドを%26、等号を%3Dとしてエンコードします。String connectionURL = "jdbc:snowflake://myaccount.snowflakecomputing.com/?query_tag='folder%3Dfolder1%20folder2%26'
別の方法として、接続文字列でこれらのパラメーターを指定する代わりに、
DriverManager.getConnectionIOメソッドに渡すPropertiesオブジェクトでこれらのパラメーターを設定できます。Properties props = new Properties(); props.put("parameter1", parameter1Value); props.put("parameter2", parameter2Value); Connection con = DriverManager.getConnection("jdbc:snowflake://<account>.snowflakecomputing.com/", props);
接続文字列または
Propertiesオブジェクトに次のパラメータを設定できます。user=<ログイン名>接続のためのユーザーのログイン名を指定します。
password=<文字列>指定したユーザーのパスワードを指定します。
パスワードを指定するには2つの方法があります。
最初の方法は、ユーザー ID とパスワードを
getConnectionメソッドに直接渡すことです。String user = "<user>"; // replace "<user>" with your user name String password = "<password>"; // replace "<password>" with your password Connection con = DriverManager.getConnection("jdbc:snowflake://<account>.snowflakecomputing.com/", user, password);
2番目の方法は、
Propertiesオブジェクトを作成し、パスワードでオブジェクトを更新し、オブジェクトをgetConnectionメソッドに渡すことです。String user = "<user>"; // replace "<user>" with your user name String password = "<password>"; // replace "<password>" with your password Properties props = new Properties(); props.put("user", user); props.put("password", password); Connection con = DriverManager.getConnection("jdbc:snowflake://<account>.snowflakecomputing.com/", props);
注意
Snowflakeへの接続に文字列を使用するクライアントアプリケーションによってパスワードが誤って公開される可能性があるため、 JDBC 接続文字列にユーザーパスワードを直接 含めない ように強くお勧めします。代わりに、アプリケーションが提供するインターフェイスを使用してユーザーパスワードを指定します。
authenticator=<文字列>ユーザーのログイン認証情報の確認に使用する認証方式を指定します。
snowflakeは、内部Snowflake認証方式を使用します。externalbrowserから 自分のウェブブラウザーを使用 して、Okta、ADFS、またはアカウントに定義されている他のSAML 2.0準拠の識別プロバイダー（IdP）を認証します。https://<Oktaのアカウント名>.okta.com（つまり、ご使用のOktaのURLエンドポイント）から ネイティブOktaを介して認証 します（IdPがOktaの場合にのみサポート）。OAuthを使用して認証する
oauth。OAuth が認証コードとして指定されている場合は、 OAuth トークンを指定するためにtokenパラメーターも設定する必要があります（ 以下を参照）。キーペア認証を使用した
snowflake_jwtの認証。キーペア認証の詳細については、 キーペア認証の使用およびキーローテーション をご参照ください。username_password_mfaは MFA トークンキャッシングで認証します。詳細については、 多要素認証の使用 （このトピック内）をご参照ください。
デフォルトは
snowflakeです。接続文字列がキーペアを指定する場合、認証方式パラメーターが設定されていないか、「snowflake」に設定されている場合でも、キーペア認証が使用されます。
認証の詳細については、 フェデレーション認証の管理/使用 および OAuth のクライアント、ドライバー、およびコネクター をご参照ください。
token=<文字列>認証に使用する OAuth トークンを指定します。
<文字列>はトークンです。このパラメーターは、authenticator=oauthパラメーターが設定されている場合にのみ必要です。デフォルトはありません。
role=<名前>ドライバーによって開始されたSnowflakeセッションで使用する、デフォルトのアクセス制御ロールを指定します。指定されたロールは、ドライバーのために指定されたユーザーに既に割り当てられている既存のロールでなければなりません。指定されたロールがユーザーにまだ割り当てられていない場合、ドライバーによってセッションが開始されるときにロールは使用されません。
接続後、 USE ROLE コマンドを実行して、セッションに別のロールを設定できます。
ロールとアクセス制御の詳細については、 Snowflakeのアクセス制御 をご参照ください。
db=<名前>接続後に使用するデフォルトのデータベース、または空の文字列を指定します。指定されたデータベースは、指定された既定のロールが権限をもつ、既存のデータベースである必要があります。
接続後、 USE DATABASE コマンドを実行して、セッションに別のデータベースを設定できます。
schema=<名前>接続後に指定されたデータベースに使用するデフォルトのスキーマ、または空の文字列を指定します。指定されたスキーマは、指定された既定のロールが権限をもつ、既存のスキーマでなければなりません。
接続後、 USE SCHEMA コマンドを実行して、セッションに別のスキーマを設定できます。
warehouse=<名前>接続後に使用する仮想ウェアハウス、または空の文字列を指定します。指定されたウェアハウスは、指定された既定のロールが権限をもつ、既存のウェアハウスでなければなりません。
接続後、 USE WAREHOUSE コマンドを実行して、セッションに別のウェアハウスを設定できます。
tracing=<文字列>ドライバーのログレベルを指定します。ドライバーは、標準のJavaログユーティリティを使用します。ログレベルの有効な値は次のとおりです。
OFF、SEVERE、WARNING、INFO、CONFIG、FINE、FINER、FINEST、ALL.デフォルト値は
INFOです。passcode=<文字列>多要素認証に使用するパスコードを指定します。
多要素認証の詳細については、 多要素認証（MFA） をご参照ください。
passcodeInPassword=<文字列>多要素認証のパスコードをパスワードに追加するかどうかを指定します。
on（またはtrue）は、パスコードが追加されることを指定します。off（またはfalse）またはその他の値は、パスコードが追加されないことを指定します。
デフォルトは
offです。loginTimeoutログイン失敗エラーを返す前に、Snowflakeサービスに接続する際の応答を待機する時間を指定します。
デフォルトは60秒です。
networkTimeoutSnowflakeサービスと対話するときにエラーを返すまでの応答を待機する時間を指定します。ゼロ（0）は、ネットワークタイムアウトが設定されていないことを示します。
デフォルトは0秒です。
queryTimeout=<数値>エラーを返す前に、クエリが完了するまで待機する時間を指定します。ゼロ（0）は無期限に待機することを示します。
デフォルトは0秒です。
application=<文字列>Snowflakeパートナーによる使用のみ ： JDBC を介して接続するパートナーアプリケーションの名前を指定します。
disableSocksProxy=<文字列>Javaシステムオプション（指定されている場合）で指定された SOCKS プロキシ構成をドライバーが無視するかどうかを指定します。
on（またはtrue）は、プロキシを無視することを指定します。off（またはfalse）またはその他の値は、プロキシの使用を指定します。
デフォルトは
offです。注意 ：この接続パラメーターを設定すると、同じ JVM （Java仮想マシン）にあるすべての接続の動作が変更されます。
stringsQuotedForColumnDef=<ブール値>このパラメーターが
trueに設定されている場合は、 DatabaseMetaData .getColumns()および DatabaseMetaData.getProcedureColumns()が COLUMN_DEF 列にString型の値を返すとき、その値は一重引用符に埋め込まれます。（値のデータ型がStringではない場合、このパラメーターの設定に関係なく、値は引用符で囲まれません。）trueは、文字列値を一重引用符で埋め込むことを指定します（引用符は区切り文字ではなく文字列の一部）。これは JDBC 標準に準拠しています。falseは、文字列値が一重引用符で埋め込まれないことを指定します。
デフォルトは
falseです。
その他のパラメーター¶
任意のセッションパラメーターを接続文字列に含めることができます。例：
CLIENT_SESSION_KEEP_ALIVE=<ブール値>非アクティブな状態が一定時間続いた後、現在のセッションをアクティブのままにするか、ユーザーに再度ログインさせるかを指定します。値が
trueの場合、Snowflakeは、ユーザーからのアクティビティがない場合でも、セッションを無期限にアクティブに保ちます。値がfalseの場合、ユーザーは4時間の非アクティブ後に再度ログインする必要があります。デフォルトは
falseです。
すべてのセッションパラメーターの説明については、 パラメーター をご参照ください。
例¶
US 西にあるアカウント：
jdbc:snowflake://xy12345.snowflakecomputing.com/?user=peter&warehouse=mywh&db=mydb&schema=public
EU にあるアカウント（フランクフルト）：
jdbc:snowflake://xy12345.eu-central-1.snowflakecomputing.com/?user=peter&warehouse=mywh&db=mydb&schema=public
認証でのシングルサインオン（SSO）の使用¶
シングルサインオン（SSO）を使用するようにSnowflakeを構成 している場合、認証に SSO を使用するようにクライアントアプリケーションを構成できます。詳細については Snowflakeに接続するクライアントアプリケーションでの SSO の使用 をご参照ください。
多要素認証の使用¶
Snowflakeは、 MFA トークンキャッシングと SSO の組み合わせを含む、 MFA トークンのキャッシングをサポートしています。
詳細については、 MFA トークンキャッシングを使用して認証中のプロンプトの数を最小限に抑える --- オプション をご参照ください。
キーペア認証の使用およびキーローテーション¶
Snowflake JDBC ドライバーは、キーペア認証とキーローテーションをサポートしています。この認証方法には、2048ビット（最小）の RSA キーペアが必要です。
開始するには、 キーペア認証およびキーペアローテーション に示すように、キーペア認証の初期構成を完了します。
そして、次に挙げる3つのオプションのいずれかを選択して、 JDBC 接続プロパティまたは JDBC 接続文字列を構成します。
接続プロパティのprivateKeyプロパティを介して秘密キーを指定します。
接続プロパティで個別のプロパティとして、そのファイルの秘密キーファイル名とパスワードを指定します。
接続文字列の一部として、そのファイルの秘密キーファイル名とパスワードを指定します。
これらのオプションについては、次の3つのセクションで詳しく説明します。
接続プロパティの privateKey プロパティ¶
このセクションでは、 privateKey プロパティをファイルの秘密キーに設定する例を示します。
この例では、 Bouncy Castle暗号化 APIs を使用しています。この例をコンパイルして実行するには、クラスパスに次の JAR ファイルを含める必要があります。
プロバイダー JAR ファイル（
bcprov-jdkバージョン.jar）PKIX / CMS / EAC / PKCS / OCSP / TSP / OPENSSL JAR ファイル（
bcpkix-jdkバージョン.jar）
ここで、 バージョン は、 JAR ファイルがサポートする JDK のバージョンを指定します。
この例を使用するには、
以下のサンプルコード をコピーし、次のプレースホルダー値を置き換えます。
プレースホルダー
説明
パス/rsa_key.p8これを前に生成した秘密キーファイルのパスと名前に設定します。
秘密キーパスフレーズ暗号化されたキーを生成した場合は、
getPrivateKeyPassphrase()メソッドを実装して、そのキーを復号化するためのパスフレーズを返します。アカウントこれをアカウントの名前に設定します（Snowflakeが提供）。
ユーザーこれをSnowflakeのログイン名に設定します。
データベース名これを、使用するデータベースの名前に設定します。
スキーマ名これを、使用するスキーマの名前に設定します。
ウェアハウス名これを、使用するウェアハウスの名前に設定します。
ロールこれを、使用するロールの名前に設定します。
サンプルコードをコンパイルして実行します。クラスパスにBouncy Castle JAR ファイルを含めます。
たとえば、Linuxおよび macOS の場合、
javac -cp bcprov-jdk<versions>.jar:bcpkix-jdk<versions>.jar TestJdbc.java java -cp .:snowflake-jdbc-<ver>.jar:bcprov-jdk<versions>.jar:bcpkix-jdk<versions>.jar TestJdbc.java
Windowsの場合、
javac -cp bcprov-jdk<versions>.jar;bcpkix-jdk<versions>.jar TestJdbc.java java -cp .;snowflake-jdbc-<ver>.jar;bcprov-jdk<versions>.jar;bcpkix-jdk<versions>.jar TestJdbc.java
サンプルコード
import org.bouncycastle.asn1.pkcs.PrivateKeyInfo;
import org.bouncycastle.jce.provider.BouncyCastleProvider;
import org.bouncycastle.openssl.PEMParser;
import org.bouncycastle.openssl.jcajce.JcaPEMKeyConverter;
import org.bouncycastle.openssl.jcajce.JceOpenSSLPKCS8DecryptorProviderBuilder;
import org.bouncycastle.operator.InputDecryptorProvider;
import org.bouncycastle.operator.OperatorCreationException;
import org.bouncycastle.pkcs.PKCS8EncryptedPrivateKeyInfo;
import org.bouncycastle.pkcs.PKCSException;
import java.io.FileReader;
import java.io.IOException;
import java.nio.file.Paths;
import java.security.PrivateKey;
import java.security.Security;
import java.sql.Connection;
import java.sql.Statement;
import java.sql.ResultSet;
import java.sql.DriverManager;
import java.util.Properties;
public class TestJdbc
{
// Path to the private key file that you generated earlier.
private static final String PRIVATE_KEY_FILE = "/<path>/rsa_key.p8";
public static class PrivateKeyReader
{
// If you generated an encrypted private key, implement this method to return
// the passphrase for decrypting your private key.
private static String getPrivateKeyPassphrase() {
return "<private_key_passphrase>";
}
public static PrivateKey get(String filename)
throws Exception
{
PrivateKeyInfo privateKeyInfo = null;
Security.addProvider(new BouncyCastleProvider());
// Read an object from the private key file.
PEMParser pemParser = new PEMParser(new FileReader(Paths.get(filename).toFile()));
Object pemObject = pemParser.readObject();
if (pemObject instanceof PKCS8EncryptedPrivateKeyInfo) {
// Handle the case where the private key is encrypted.
PKCS8EncryptedPrivateKeyInfo encryptedPrivateKeyInfo = (PKCS8EncryptedPrivateKeyInfo) pemObject;
String passphrase = getPrivateKeyPassphrase();
InputDecryptorProvider pkcs8Prov = new JceOpenSSLPKCS8DecryptorProviderBuilder().build(passphrase.toCharArray());
privateKeyInfo = encryptedPrivateKeyInfo.decryptPrivateKeyInfo(pkcs8Prov);
} else if (pemObject instanceof PrivateKeyInfo) {
// Handle the case where the private key is unencrypted.
privateKeyInfo = (PrivateKeyInfo) pemObject;
}
pemParser.close();
JcaPEMKeyConverter converter = new JcaPEMKeyConverter().setProvider(BouncyCastleProvider.PROVIDER_NAME);
return converter.getPrivateKey(privateKeyInfo);
}
}
public static void main(String[] args)
throws Exception
{
String url = "jdbc:snowflake://<account>.snowflakecomputing.com";
Properties prop = new Properties();
prop.put("user", "<user>");
prop.put("privateKey", PrivateKeyReader.get(PRIVATE_KEY_FILE));
prop.put("db", "<database_name>");
prop.put("schema", "<schema_name>");
prop.put("warehouse", "<warehouse_name>");
prop.put("role", "<role_name>");
Connection conn = DriverManager.getConnection(url, prop);
Statement stat = conn.createStatement();
ResultSet res = stat.executeQuery("select 1");
res.next();
System.out.println(res.getString(1));
conn.close();
}
}
接続プロパティとしての秘密キーファイル名とパスワード¶
秘密キーファイル名とパスワードを個別の接続プロパティとして指定できます。次に例を示します。
Properties props = new Properties();
props.put("private_key_file", "/tmp/rsa_key.p8");
props.put("private_key_file_pwd", "dummyPassword");
Connection connection = DriverManager.getConnection("jdbc:snowflake://exampleaccount.snowflake.com", props);
private_key_file および private_key_file_pwd パラメーターを指定する場合、接続プロパティで privateKey パラメーターを指定しないでください。
接続文字列の秘密キーファイル名とパスワード¶
以下に示すように、接続文字列で秘密キーファイル名とパスワードを指定できます。
Connection connection = DriverManager.getConnection(
"jdbc:snowflake://exampleaccount.snowflake.com/?private_key_file=/tmp/rsa_key.p8&private_key_file_pwd=dummyPassword",
props);
接続文字列で秘密キーとパスワードを指定する場合は、接続プロパティでパラメーター private_key_file、 private_key_file_pwd、または privateKey を指定しないでください。
SnowCD を使用したSnowflakeへのネットワーク接続の検証¶
ドライバーを設定したら、 SnowCD を使用して、Snowflakeへのネットワーク接続を評価およびトラブルシューティングできます。
初期設定プロセス中にオンデマンドで SnowCD をいつでも使用して、Snowflakeへのネットワーク接続を評価およびトラブルシューティングできます。
プロキシサーバーを使用した接続¶
Snowflake JDBC ドライバーでプロキシサーバーを使用するには、2つの方法があります。
クライアントアプリケーションの JVM （Java仮想マシン）でプロキシ設定のシステムプロパティを設定する。
プロキシホストとポート情報を JDBC 接続文字列または
DriverManager.getConnection()メソッドに渡されるPropertiesに含めます。
両方の手法とも、以下で文書化されています。
注釈
接続文字列のプロキシ設定は、 JVM で設定されているプロキシシステムのプロパティを上書きします。
Javaシステムプロパティの設定による、プロキシサーバーの指定¶
プロキシサーバーを介して接続するために、 プロキシシステムのプロパティ を設定できます。これらをコードで設定するか、コマンドラインでクライアントアプリケーションの JVM （Java仮想マシン）に渡すことができます。
コードにシステムプロパティを設定するには、 System.setProperty を呼び出します。
System.setProperty("http.useProxy", "true"); System.setProperty("http.proxyHost", "proxyHost Value"); System.setProperty("http.proxyPort", "proxyPort Value"); System.setProperty("https.proxyHost", "proxyHost HTTPS Value"); System.setProperty("https.proxyPort", ""proxyPort HTTPS Value"")
コマンドラインのシステムプロパティを JVM に渡すには、 -D コマンドラインオプションを使用します。
-Dhttp.useProxy=true -Dhttps.proxyHost=<proxy_host> -Dhttp.proxyHost=<proxy_host> -Dhttps.proxyPort=<proxy_port> -Dhttp.proxyPort=<proxy_port>
1つ以上の IP アドレスまたはホストのプロキシをバイパスするには、 http.nonProxyHosts システムプロパティをこれらのホストのリストに設定します。
パイプ記号（
|）を使用してホスト名を区切ります。パターンに一致するホスト名を指定するには、ワイルドカード文字としてアスタリスク（
*）を使用します。
次の例は、コマンドラインでこのシステムプロパティを設定する方法を示しています。
-Dhttp.nonProxyHosts="*.my_company.com|localhost|xy12345.snowflakecomputing.com|192.168.91.*"
JDBC 接続文字列によるプロキシサーバーの指定¶
プロキシサーバーの IP アドレスとポート番号は、 JDBC 接続文字列で直接指定できます。
jdbc:snowflake://<アカウント>.<地域ID>.snowflakecomputing.com/?warehouse=<ウェアハウス名> &useProxy=true&proxyHost=<IPアドレス>&proxyPort=<ポート>&proxyUser=test&proxyPassword=test
例：
jdbc:snowflake://xy12345.us-east-1.snowflakecomputing.com/?warehouse=DemoWarehouse1 &useProxy=true&proxyHost=172.31.89.76&proxyPort=8888&proxyUser=test&proxyPassword=test
接続文字列で指定するプロキシ設定は、 JVM のプロキシシステムプロパティを上書きします。
プロキシサーバーが認証を必要としない場合は、 proxyUser および proxyPassword パラメーターを省略できます。
1つ以上のホストに接続するときにプロキシサーバーをバイパスする必要がある場合は、 nonProxyHosts パラメーターでホストのリストを指定します。
&nonProxyHosts=<bypass_proxy_for_these_hosts>
ホスト名は URL をエスケープしたパイプ記号（%7C）で区切ります。アスタリスク（*）をワイルドカードとして使用することもできます。例:
&nonProxyHosts=*.my_company.com%7Clocalhost%7Cxy12345.snowflakecomputing.com%7C192.168.91.*
注釈
上記の例には、読みやすいように空白が含まれています。これらの例をコピーして貼り付ける場合は、余分な空白を削除してください。
注釈
URL の一部としてプロキシ情報を指定すると、プロキシ情報を指定する他の方法よりも安全性が低くなります。
ちなみに
Snowflakeのセキュリティモデルは、Secure Sockets Layer（SSL）プロキシを許可しません（ HTTPS 証明書を使用）。プロキシサーバーは、公的に利用可能な認証機関（CA）を使用する必要があり、侵害されたプロキシを介した MITM （Man In The Middle）攻撃などの潜在的なセキュリティリスクを低減します。
SSL プロキシを使用する 必要がある 場合は、通信中に証明書が変更されないように、サーバーポリシーを更新してSnowflake証明書を渡すことを強くお勧めします。
別の方法として、接続文字列または Properties オブジェクトに nonProxyHosts パラメーターを設定して、特定の通信のプロキシをバイパスすることもできます。たとえば、 nonProxyHosts=".amazonaws.com" を指定すると、Amazon S3アクセスをバイパスできます。
OCSP¶
ドライバーが接続すると、Snowflakeは証明書を送信して、Snowflakeを偽装しているホストではなく、Snowflakeへの接続であることを確認します。ドライバーはその証明書を OCSP （オンライン証明書状態プロトコル）サーバーに送信し、証明書が失効していないことを確認します。
ドライバーが証明書を確認するために OCSP サーバーに到達できない場合、ドライバーは "fail open" or "fail closed" できます。
フェールオープンまたはフェールクローズモードの選択¶
JDBC 3.8.0より前のドライバーバージョンは、デフォルトでフェールクローズになります。バージョン3.8.0以降はデフォルトでフェールオープンになります。次のいずれかの方法でデフォルトの動作を上書きできます。
接続プロパティ
ocspFailOpenをtrueまたはfalseに設定します。例:Properties connection_properties = new Properties(); connection_properties.put("ocspFailOpen", "false"); ... connection = DriverManager.getConnection(connectionString, connection_properties);
システムプロパティ
net.snowflake.jdbc.ocspFailOpenをtrueまたはfalseに設定します。例:Properties p = new Properties(System.getProperties()); p.put("net.snowflake.jdbc.ocspFailOpen", "false"); System.setProperties(p);
OCSP 応答キャッシュサーバー¶
注釈
OCSP 応答キャッシュサーバーは現在、Snowflake JDBC ドライバー3.6.0以降でサポートされています。
Snowflakeクライアントは、実際にデータを転送する前に安全な接続を確立する「ハンドシェイク」を使用して、Snowflakeサービスエンドポイントへのすべての接続を開始します。ハンドシェイクの一部として、クライアントはサービスエンドポイントの TLS/SSL 証明書を認証します。証明書の失効ステータスは、 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 サーバーから検証ステータスを直接取得しようとします。
ファイルキャッシュ¶
使いやすさを向上させるために、ドライバーは認証と OCSP 応答にファイルキャッシュを使用します。デフォルトでは、これらのファイルは次のディレクトリに保存されます。
- Linux
~/.cache/snowflake- macOS
~/Library/Caches/Snowflake- Windows
%USERPROFILE%AppDataLocalSnowflakeCaches
JDBC アプリケーションユーザーのローカルオペレーティングシステムにユーザープロファイルがない場合、ドライバーはキャッシュファイルを一時ディレクトリに保存しようとします。次の環境変数を使用して、キャッシュファイルを別のディレクトリに書き込むようにドライバーを構成できます。
SF_TEMPORARY_CREDENTIAL_CACHE_DIR=文字列ローカルディレクトリ内の一時的な認証情報キャッシュファイルの場所を指定します。これは、起動時に JVM オプション
-Dnet.snowflake.jdbc.temporaryCredentialCacheDir=文字列で構成することもできます。SF_OCSP_RESPONSE_CACHE_DIR=文字列ローカルディレクトリ内の OCSP 応答キャッシュファイルの場所を指定します。これは、起動時に JVM オプション
-Dnet.snowflake.jdbc.ocspResponseCacheDir=文字列で構成することもできます。詳細については、このトピックの OCSP 応答キャッシュサーバー をご参照ください。
JVM オプションは、プログラムではなく（ System.setProperty() を介して）起動時に設定する必要があります。環境変数と JVM オプションの両方が提供されている場合、 JVM オプションが使用されます。
JDBC ログ記録の構成¶
バージョン3.0.4以降、 JDBC ドライバーは2つのログ記録フレームワークをサポートしています。
Javaコアログ記録機能
Simple Logging Facade for Java
Javaコアログ記録機能（java.util.logging）¶
このロガーを使用するには、 JVM に次のオプションを指定します。
-Dnet.snowflake.jdbc.loggerImpl=net.snowflake.client.log.JDK14Logger
次に、ロガーのアプリケーションプログラミングインターフェイス（API）を使用して、ログ記録の構成をカスタマイズできます。詳細については、 java.util.loggingパッケージのドキュメント をご参照ください。
たとえば、次の内容を含む logging.properties という名前のファイルを作成します。
########################################################### # Default Logging Configuration File # # You can use a different file by specifying a filename # with the java.util.logging.config.file system property. # For example java -Djava.util.logging.config.file=myfile ############################################################ ############################################################ # Global properties ############################################################ # "handlers" specifies a comma-separated list of log Handler # classes. These handlers will be installed during VM startup. # Note that these classes must be on the system classpath. # ConsoleHandler and FileHandler are configured here such that # the logs are dumped into both a standard error and a file. handlers = java.util.logging.ConsoleHandler, java.util.logging.FileHandler # Default global logging level. # This specifies which kinds of events are logged across # all loggers. For any given facility this global level # can be overriden by a facility specific level. # Note that the ConsoleHandler also has a separate level # setting to limit messages printed to the console. .level = INFO ############################################################ # Handler specific properties. # Describes specific configuration information for Handlers. ############################################################ # default file output is in the tmp dir java.util.logging.FileHandler.pattern = /tmp/snowflake_jdbc%u.log java.util.logging.FileHandler.limit = 5000000000000000 java.util.logging.FileHandler.count = 10 java.util.logging.FileHandler.level = INFO java.util.logging.FileHandler.formatter = net.snowflake.client.log.SFFormatter # Limit the messages that are printed on the console to INFO and above. java.util.logging.ConsoleHandler.level = INFO java.util.logging.ConsoleHandler.formatter = net.snowflake.client.log.SFFormatter # Example to customize the SimpleFormatter output format # to print one-line log message like this: # <level>: <log message> [<date/time>] # # java.util.logging.SimpleFormatter.format=%4$s: %5$s [%1$tc]%n ############################################################ # Facility specific properties. # Provides extra control for each logger. ############################################################ # Snowflake JDBC logging level. net.snowflake.level = INFO net.snowflake.handler = java.util.logging.FileHandler
コマンドラインで JVM パラメーターを指定します。
java -jar application.jar -Dnet.snowflake.jdbc.loggerImpl=net.snowflake.client.log.JDK14Logger -Djava.util.logging.config.file=logging.properties
application.jar は JDBC ドライバーのアプリケーションコードを参照します。ログファイルは /tmp/snowflake_jdbc* にあります。
Simple Logging Facade for Java（org.slf4j）¶
ロガー実装パッケージ（つまり、 org.sl4j:sl4j-jdk14 または org.sl4j:slf4j-log4j12）またはカスタムロガー（つまり独自の org.slf4j.impl.StaticLoggerBinder クラス）がクラスパスで定義されている場合、ドライバーはこのロガーを自動的に使用します。
次の JVM オプションを指定して、このロガーを使用することを明示的に選択することもできます。
-Dnet.snowflake.jdbc.loggerImpl=net.snowflake.client.log.SLF4JLogger
詳細については、 Simple Logging Facade for Java（SLF4J）のドキュメント をご参照ください。
注釈
上記の JVM オプションのいずれかを使用してドライバーのロガーを明示的に指定せず、クラスパスでカスタムロガーを定義していない場合（または3.0.4より前のドライバーバージョンを使用している場合）、ドライバーデフォルトで java.util.logging を使用します。ただし、次のデフォルトの動作が適用されます。
ログファイルの書き込まれる場所を指定することはできません。常に
java.io.tmpDirシステムプロパティで指定されたディレクトリに書き込まれます。Linuxおよび macOS 環境では、デフォルトのディレクトリは通常、
/tmpまたは/var/tmpのいずれかです。Windows環境では、デフォルトのディレクトリは通常、
C:\tempです。
ログレベルは、
tracing接続パラメーターによって決定されます（上記を参照）。
トラブルシューティングのヒント¶
プロパティが正しく設定されていることを確認してください¶
DriverManager.getConnection() メソッドは、特定の事前定義された名前（「password」、「account」など）に一致するプロパティパラメーターの値のみを読み取ります。プロパティ名のスペルを間違えたり、余分なプロパティを含めたりすると、ドライバーはエラーまたは警告メッセージを出さずにそれらのプロパティを無視します。これにより、小さなスペルミスの検出が困難になる場合があります。
接続文字列とアカウントに正しい値を使用する¶
接続の問題の一般的な原因は、アカウント、アカウント名、または接続文字列を求められたときに、提供する情報が多すぎるか少なすぎることです。
通常、アカウント情報は、アカウントがホストされている地域とクラウドプラットフォームに応じて、次の構造を持ちます。
アカウントアカウント.地域IDアカウント.地域ID.プラットフォーム
例：
xy12345xy12345.us-east-1xy12345.east-us-2.azure
通常、 JDBC 接続文字列は次のようになります。
jdbc:snowflake://xy12345.east-us-2.azure.snowflakecomputing.com
アカウント情報が予想されるときに接続文字列を使用（またはその逆）すると、デバッグが困難な問題が発生する可能性があります。
アカウントを求められたときに接続を確立できない場合は、最小形式（例： xy12345）、および完全なアカウント名（例： jdbc:snowflake://、ただし xy12345.east-us-2.azure を含まない）、の両方を試して、 .snowflakecomputing.com 文字列を 含めない ようにしてください。
JDBC 接続文字列を要求されたときに接続を確立できない場合は、上記の接続文字列の完全な形式を使用します。
アカウント名の詳細については、 接続パラメーター をご参照ください。