接続 URL の構築 - Amazon Redshift

接続 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 を使用しません。詳細については、「クライアント接続にカスタムドメイン名を使用する」を参照してください。