接続 URL の構築
接続 URL を使用して、アクセスしているデータストアに接続情報を指定します。以下は、Amazon Redshift JDBC ドライバーバージョン 2.1 で使用する接続 URL の形式です。ここで、[Host] は Amazon Redshift サーバーのエンドポイントであり、[Port] は、サーバーがクライアントリクエストをリッスンするために使用する Transmission Control Protocol (TCP) のポート番号です。
jdbc:redshift://[Host]:[Port]
以下は、いくつかのオプション設定を指定する接続 URL の形式です。
jdbc:redshift://[Host]:[Port]/[database];[Property1]=[Value]; [Property2]=[Value];
URL 値に次の URI 予約文字のいずれかが含まれている場合、値は URL エンコードされている必要があります。
-
;
-
+
-
{
-
}
-
[
-
]
-
&
-
=
-
?
-
空のスペース
例えば、PWD
値が password:password
の場合、その値を使用する接続 URL は次のようになります。
jdbc:redshift://redshift.company.us-west-1.redshift.amazonaws.com:9000/dev;UID=amazon;PWD=password%3Apassword
例えば、AWSの米国西部 (北カリフォルニア) リージョンにある、Amazon Redshift クラスターのポート 9000 に接続するとします。また、dev
という名前のデータベースにアクセスし、データベースのユーザー名とパスワードを使用して接続を認証することもできます。この場合、次の接続 URL を使用します。
jdbc:redshift://redshift.company.us-west-1.redshift.amazonaws.com:9000/dev;UID=amazon;PWD=amazon
次の文字を使用して、残りの URL 文字列内の設定オプションを区切ることができます。
-
;
-
?
例えば、以下の URL 文字列はお互いに等価です。
jdbc:redshift://my_host:5439/dev;ssl=false;defaultRowFetchSize=100
jdbc:redshift://my_host:5439/dev?ssl=false;defaultRowFetchSize=100
次の文字を使用して、URL 文字列内で互いに設定オプションを区切ることができます。
-
;
-
&
例えば、以下の URL 文字列はお互いに等価です。
jdbc:redshift://my_host:5439/dev;ssl=false;defaultRowFetchSize=100
jdbc:redshift://my_host:5439/dev;ssl=false&defaultRowFetchSize=100
次の URL の例では、ログレベル 6 とログのためのパスを指定しています。
jdbc:redshift://redshift.amazonaws.com:5439/dev;DSILogLevel=6;LogPath=/home/user/logs;
接続 URL ではプロパティを複製しないでください。
指定できる構成オプションの完全なリストについては、「JDBC ドライバーバージョン 2.1 の設定オプション」を参照してください。
注記
接続するときは、クラスターノードの IP アドレスや VPC エンドポイントの IP アドレスを使用しないでください。不必要な停止を避けるため、必ず Redshift エンドポイントを使用してください。例外として、カスタムドメイン名を使用する場合に限り、エンドポイント URL を使用しません。詳細については、「クライアント接続にカスタムドメイン名を使用する」を参照してください。