JDBC ドライバーの接続パラメーター参照¶

アカウント名にアンダースコアを許可するかどうかを指定します。JDBC ドライバーは、アカウント名を含む URLs のアンダースコアをサポートしていないため、 JDBC ドライバーはアンダースコアをハイフンに自動的に変換します。デフォルト値は false です。

ユーザーログイン認証情報の検証に使用する認証方式を指定します。これは、次のいずれかの値に設定できます。

• 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_jwt の認証。キーペア認証の詳細については、 キーペア認証とキーローテーションの使用 をご参照ください。

• username_password_mfa は MFA トークンキャッシングで認証します。詳細については、 多要素認証の使用 をご参照ください

接続文字列がキーペアを指定する場合は、 authenticator パラメーターが設定されていない場合や、「snowflake」に設定されている場合でも、キーペア認証が使用されます。

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

多要素認証に使用するパスコードを指定します。

多要素認証の詳細については、 多要素認証（MFA） をご参照ください。

指定したユーザーのパスワードを指定します。

パスワードを指定するには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);
  

  Copy

• 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);
  

  Copy

認証に使用する OAuth トークンを指定します。 <文字列> はトークンです。このパラメーターは、以下のノートにある場合を除き、 authenticator パラメーターを oauth に設定する場合にのみ必要です。

たとえば、 token 構成パラメーター設定する代わりに、次のように getConnection() メソッドプロパティでパスワードとしてトークンを渡すことができます。

Properties props = new Properties();
props.put("user", "myusername");
props.put("authenticator", "oauth");
props.put("role", "myrole");
props.put("password", "xxxxxxxxxxxxx"); // where xxxxxxxxxxxxx is the token string
Connection myconnection = DriverManager.getConnection(url, props);

接続後に使用するデフォルトのデータベースを指定するか、空の文字列を指定します。指定されたデータベースは、指定された既定のロールが権限を持つ、既存のデータベースである必要があります。

接続後に別のデータベースを使用する必要がある場合は、 USE DATABASE コマンドを実行します。

ドライバーによって開始されたSnowflakeセッションで使用する、デフォルトのアクセス制御ロールを指定します。指定されたロールは、ドライバーのために指定されたユーザーに既に割り当てられている既存のロールでなければなりません。指定されたロールがユーザーにまだ割り当てられていない場合、ドライバーによってセッションが開始されるときにロールは使用されません。

接続後に別のロールを使用する必要がある場合は、 USE ROLE コマンドを実行します。

ロールとアクセス制御の詳細については、 アクセス制御の概要 をご参照ください。

接続後に指定されたデータベースに使用するデフォルトのスキーマを指定するか、空の文字列を指定します。指定されたスキーマは、指定された既定のロールが権限を持つ、既存のスキーマでなければなりません。

接続後に別のスキーマを使用する必要がある場合は、 USE SCHEMA コマンドを実行します。

接続後に使用する仮想ウェアハウスを指定するか、空の文字列を指定します。指定されたウェアハウスは、指定された既定のロールが権限を持つ、既存のウェアハウスでなければなりません。

接続後に別のウェアハウスを使用する必要がある場合は、 USE WAREHOUSE コマンドを実行して、セッションに別のウェアハウスを設定できます。

ドライバーが、Javaシステムオプションで指定された SOCKS プロキシ構成を無視するかどうかを指定します。

• on （または true）は、プロキシを無視することを指定します。

• off （または false）またはその他の値は、プロキシの使用を指定します。

ドライバーが、プロキシを使用するかどうかを指定します。

• on （または true）は、ドライバーがプロキシを使用する必要があることを指定します。

• off （または false）またはその他の値は、ドライバーがプロキシを使用しないことを指定します。

詳細については JDBC 接続文字列によるプロキシサーバーの指定 をご参照ください。