メニュー
Amazon Redshift
管理ガイド (API Version 2012年12月1日)

JDBC ドライバー設定オプション

Amazon Redshift JDBC ドライバーの動作を制御するには、次の表で説明する設定オプションを JDBC URL に付加します。たとえば、以下の JDBC URL は、Secure Socket Layer (SSL)、ユーザー (UID)、パスワード (PWD) を使用してクラスターに接続します。

Copy
jdbc:redshift://examplecluster.abc123xyz789.us-west-2.redshift.amazonaws.com:5439/dev?ssl=true&UID=your_username&PWD=your_password

SSL オプションの詳細については、「SSL を使用して接続する」を参照してください。

JDBC オプション 一致する PostgreSQL オプションの有無 デフォルト値 説明
AccessKeyID いいえ null IAM データベース認証用に設定された IAM ロールまたは IAM ユーザーのアクセスキー ID。AccessKeyID オプションは、IAM データベース認証を設定するために使用される一連のオプションの一部です。詳細については、「IAM 認証情報を提供するための JDBC および ODBC のオプション」を参照してください。AccessKeyID および SecretAccessKey は一緒に指定する必要があります。
AuthMech いいえ DISABLE

廃止. デフォルトでは、Amazon Redshift ドライバーは SSL を使用します。または、ssl と sslmode を使用します。

AutoCreate いいえ false DbUser に指定した名前でデータベースユーザーを作成するには (存在しない場合)、true を指定します。AutoCreate オプションは、IAM データベース認証を設定するために使用される一連のオプションの一部です。詳細については、「データベースユーザー認証情報を作成するための JDBC および ODBC のオプション」を参照してください。
BlockingRowsMode いいえ 0 メモリに保持する行数。1 つの行が破棄されると、その代わりとして別の行がロードされます。
DbGroups いいえ null データベースユーザーが現在のセッションで参加する既存のデータベースグループの名前のカンマ区切りリスト。DbGroups オプションは、IAM データベース認証を設定するために使用される一連のオプションの一部です。詳細については、「データベースユーザー認証情報を作成するための JDBC および ODBC のオプション」を参照してください。
DbUser いいえ null データベースユーザーの名前。DbUser オプションは、IAM データベース認証を設定するために使用される一連のオプションの一部です。詳細については、「データベースユーザー認証情報を作成するための JDBC および ODBC のオプション」を参照してください。
DisableIsValidQuery いいえ false

デフォルトでは、DisableIsValidQuery は False に設定されます。これにより、データベース接続が予期せずに終了した場合でも、どの時点で JDBC ドライバーの有効なデータベース接続が失われたかを java Connection.isValid () メソッドで検出できます。バージョン 1.2.1 より前の Amazon Redshift JDBC ドライバーでは、どの時点で有効な接続が失われたかを確実に検出しませんでした。以前のドライバーで確認された動作を復元するには、DisableIsValidQuery を true に設定します。

DSILogLevel いいえ 0

ログ記録を有効にし、ログファイルに含まれる詳細量を指定します。次の表に、ログ記録の詳細レベルを示します。

  • 0 – すべてのログ記録を無効にします。

  • 1 – ドライバーの中止につながる重大なエラーイベントを記録します。

  • 2 – ドライバの実行の続行を許可する可能性があるエラーイベントを記録します。

  • 3 – 有害な可能性がある状況を記録します。

  • 4 – ドライバの進行状況を示す全般的な情報を記録します。

  • 5 – ドライバのデバッグに役立つ詳細な情報を記録します。

  • 6 – すべてのドライバアクティビティを記録します。

FilterLevel いいえ NOTICE

クライアントが処理するメッセージの最小重要度。以下の値を指定できます (重要度が最も低い値から最も高い値の順)。

  • DEBUG

  • INFO

  • NOTICE

  • WARNING

  • LOG

  • ERROR

loginTimeout はい 0

サーバーに接続するときにタイムアウトするまで待つ秒数。接続を確立するときにこのしきい値よりも時間がかかると、接続は中止されます。

このプロパティがデフォルト値の 0 に設定されていると、接続はタイムアウトしません。

loglevel はい null

ドライバーによって出力されるログ情報の量。デフォルトでは、ログ記録は行われません。情報はドライバーマネージャーの LogStream または LogValue オプションで指定されている場所に出力されます。以下の値を指定できます。

  • 2 (DEBUG) — 多くの詳細な情報をログに記録します。

  • 1 (INFO) — より少ない詳細をログに記録します。

注記

パフォーマンスに影響を与える可能性があるため、ドライバの問題をトラブルシューティングする場合にのみ、このプロパティを使用してください。

OpenSourceSubProtocolOverride いいえ false

有効になっている場合、この設定は、Amazon Redshift JDBC ドライバと PostgreSQL JDBC ドライバとの間に発生する可能性のある競合を防ぎます。場合によっては、アプリケーションは PostgreSQL JDBC ドライバを使用して Amazon Redshift JDBC ドライバおよびその他のデータソースに同時に接続することがあります。この場合、PostgreSQL データソースに接続するために使用するこの接続属性を、JDBC URL に追加します。以下の値を指定できます。

  • true—OpenSourceSubProtocolOverride を有効にします。

  • false—OpenSourceSubProtocolOverride を無効にします。

Plugin_Name いいえ null 認証情報プロバイダを実装する完全修飾クラス名。Plugin_Name オプションは、IAM データベース認証を設定するために使用される一連のオプションの一部です。詳細については、「認証情報プロバイダプラグインの使用」を参照してください。
プロフィール いいえ null JDBC 接続オプションの値を含む AWS 認証情報または設定ファイルのプロファイル名。Plugin_Name オプションは、IAM データベース認証を設定するために使用される一連のオプションの一部です。詳細については、「設定プロファイルを使用する」を参照してください。
PWD はい null Amazon Redshift サーバーに接続するために使用するパスワード。
SecretAccessKey いいえ null IAM データベース認証用に設定された IAM ロールまたは IAM ユーザーのシークレットアクセスキー。SecretAccessKey オプションは、IAM データベース認証を設定するために使用される一連のオプションの一部です。詳細については、「IAM 認証情報を提供するための JDBC および ODBC のオプション」を参照してください。AccessKeyID および SecretAccessKey は一緒に指定する必要があります。
SessionToken いいえ null IAM データベース認証用に設定された IAM ロールの一時セッショントークン。SessionToken は、IAM データベース認証が IAM ユーザーに対して設定されている場合は必要ありません。SessionToken オプションは、IAM データベース認証を設定するために使用される一連のオプションの一部です。詳細については、「IAM 認証情報を提供するための JDBC および ODBC のオプション」を参照してください。SessionToken を使用する場合、AccessKeyID および SecretAccessKey も指定する必要があります。
socketTimeout はい 0

タイムアウトする前にソケット読み込みオペレーションを待つ秒数。このオペレーションにこのしきい値よりも時間がかかると、接続は閉じます。

このプロパティがデフォルト値の 0 に設定されていると、接続はタイムアウトしません。

ssl はい true

SSL 接続を使用するかどうかを決定する値。以下の値を指定できます。

  • true — SSL を使用します。

  • false — SSL を使用しません。

ドライバーは、デフォルトで ssl を true に設定します。ssl が IAM 認証で false に明示的に設定されている場合、接続の試行は失敗します。

sslMode はい null

サーバー証明書の確認方法を決定する設定。以下の値を指定できます。

  • verify-ca—SSL を使用する必要があり、サーバー証明書を検証する必要があります。

  • verify-full—SSL を使用する必要があります。サーバー証明書を検証し、サーバーのホスト名が証明書上のホスト名属性と一致する必要があります。

sslMode が指定されていない場合、サーバー証明書は必要ありません。

sslMode オプションの詳細については、「Java で SSL をサーバー証明書を使用する」を参照してください。

重要

Amazon Redshift の SSL 証明書の管理方法が変わりました。1.2.8.1005 より前のバージョンのドライバーを使用する場合は、現在の信頼ルート CA 証明書を更新して、引き続き SSL でクラスターに接続する必要があります。詳細については、「SSL 接続用 ACM 証明書への移行」を参照してください。

sslRootCert いいえ null

SSL を使用する場合の Amazon Redshift サーバー証明書確認用の信頼ルート認証機関 (CA) の証明書バンドルを含む .pem または .crt ファイルの完全パス。

tcpKeepAlive はい true

TCP キープアライブを有効にするかどうかを決定する値。以下の値を指定できます。

  • true — TCP キープアライブを有効にします。

  • false — TCP キープアライブを無効にします。

TCPKeepAliveMinutes いいえ 5

TCP キープアライブの送信を開始する前にアイドル状態である時間のしきい値 (分単位)。

UID はい null Amazon Redshift サーバーに接続するために使うユーザー名。