接続 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];

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