Amazon Redshift

公式ドキュメント

Amazon Redshift の詳細については、公式ドキュメント(英語)を参照してください。
Amazon Redshift JDBC ドライバーのその他のバージョンについては、公式 JDBC ドライバーのダウンロード(英語)を参照してください。

始める前に

このトピックでは、WebStorm の Amazon Redshift データベースへの接続用のデータソースを作成し、テスト接続を実行する一般的な手順について説明します。必要な接続詳細がすでに用意されており、データベースが稼働していることを前提としています。

DBMS ソフトウェアの詳細については、公式ドキュメントを参照してください。

ローカルマシンからプライベート Amazon Redshift クラスターにアクセスする場合は、Amazon Elastic Compute Cloud (Amazon EC2) インスタンスを使用し、WebStorm からこのインスタンスへの SSH トンネルを作成することを検討してください。Amazon EC2 の構成の詳細については、「このチュートリアルは aws.amazon.com にあります(英語)」を参照してください。

WebStorm では、共有データベースを操作できます。

共有データベース、およびこれらのデータベースが作成されるデータ共有は、データベースツールウィンドウでイントロスペクトし、表示できます。
データ共有と共有データベースの両方を変更できます。これを行うには、データベースツールウィンドウで対応するオブジェクトを右クリックし、変更 <object> を選択します。あるいは、オブジェクトを選択して Ctrl+F6 を押します。
コードエディターは、関連するすべてのステートメントをサポートします。

前提条件

Amazon Redshift ダッシュボードには Amazon Redshift クラスターが必要です。Amazon Redshift クラスターの詳細については、「Amazon Redshift 入門(英語)」を参照してください。

Amazon Redshift データベースに接続する

データベースに接続するには、接続の詳細を保存するデータソースを作成します。

作成したいデータソースを選択します。以下のいずれかの方法で選択できます。
- メインメニューで、ファイル | 新規 | データソースに移動し、Amazon Redshift を選択します。
- データベースツールウィンドウで、ツールバーの新規をクリックします。データソースに移動し、Amazon Redshift を選択します。
データソースおよびドライバーダイアログの右ペインの一般タブで、ドライバーと接続タイプを指定します。
1. 接続に別のドライバーが必要でない限り、ドライバーリストではデフォルトのドライバーオプションのままにしておきます。
2. 接続タイプリストから、接続の詳細に応じて接続タイプを選択します。
  - デフォルト : ホスト、ポート、データベース、URL を使用して接続します。
  - IAM クラスター / リージョン : データベース、地域、クラスタ、URL を使用して接続します。
  - URL のみ : URL のみを使用して接続します。
  URL のみ接続タイプの場合、入力した JDBC URL がそのまま使用され、データベース資格情報も含まれています。
  URL のみ接続タイプの場合、JDBC URL はプレーンテキストでそのまま保存され、IDE ログファイルおよびデータソース情報でも使用できます。
  他の接続タイプの場合、JDBC URL は接続の詳細に分割されます。個別に指定して自動生成された URL を使用することも、対応するフィールドに URL を直接入力することもできます。
接続設定領域の下部に「不足しているドライバーファイルをダウンロード」リンクがあるかどうかを確認します。このリンクをクリックして、データベースと対話するために必要なドライバーをダウンロードします。直接ダウンロードリンクについては、JetBrains JDBC ドライバーページを参照してください。
ダウンロードされた JDBC ドライバーの場所は WebStorm 構成ディレクトリです。
提供されているドライバーの代わりにデータベース用のドライバーを使用することもできます。ドライバーを使用したデータベースへの接続の詳細については、「既存の接続にユーザードライバーを追加する」を参照してください。
不足しているドライバーファイルをダウンロードリンクがない場合は、必要なドライバーがすでに存在します。
データベース接続の詳細を指定します。あるいは、JDBC URL を URL フィールドに貼り付けます。
1. ホストフィールドに、サーバーのアドレスを入力します。
2. 「ポート」フィールドに、Amazon Redshift のポートを入力します。デフォルトのポートは 5439 です。
  実際のポート番号はシステムによって異なる場合があります。データベース管理者、サーバー設定、ホスティングプロバイダーに正しいポート番号を使用していることを確認してください。
3. 認証ドロップダウンから、接続の認証に使用する認証方法を選択します。以下のオプションから選択できます。
  - pgpass: pgpass ファイルを使用します。このファイルはユーザーのホームディレクトリに保存できます。パスワードファイルとその場所の詳細については、postgresql.org のパスワードファイル(英語)を参照してください。
  - ユーザーパスワード : ログインとパスワードを使用。
  - AWS プロファイル : プロファイルフィールドで AWS 名前付きプロファイルを使用します。
    AWS 名前付きプロファイルの詳細については、DBMS 固有のプロパティの章を参照してください。
  - 認証なし : 認証は必要ありません。
4. データベースフィールドに、接続するデータベース名を入力します。
5. Amazon Redshift クラスターの設定で、JDBC URL をコピーします。
6. URL フィールドでは、WebStorm は他の接続設定の値を使用して JDBC URL を自動的に生成します。
  Redshift クラスター設定の JDBC URL を WebStorm の URL フィールドに貼り付けます。
  特定の追加設定を含む JDBC URL を使用する必要がある場合は、それを URL フィールドに貼り付けます。使用する一般的な URL は次のとおりです。
  - フォーマット: jdbc:redshift://<connection_url><port_number>/<database_name>
  - サンプル: jdbc:redshift://server.redshift.amazonaws.com:5439/myDatabase
  URL 形式の詳細については、「Amazon Redshift 公式ドキュメント(英語)」を参照してください。
1. 認証ドロップダウンから、接続の認証に使用する認証方法を選択します。以下のオプションから選択できます。
  - pgpass: pgpass ファイルを使用します。このファイルはユーザーのホームディレクトリに保存できます。パスワードファイルとその場所の詳細については、postgresql.org のパスワードファイル(英語)を参照してください。
  - ユーザーパスワード : ログインとパスワードを使用。
  - AWS プロファイル : プロファイルフィールドで AWS 名前付きプロファイルを使用します。
    AWS 名前付きプロファイルの詳細については、DBMS 固有のプロパティの章を参照してください。
  - 認証なし : 認証は必要ありません。
2. データベースフィールドに、接続するデータベース名を入力します。
3. 地域フィールドに、接続先のデータベースの AWS リージョンを入力します。
4. 「クラスタ」フィールドに、データベースを含む Amazon Redshift クラスターの名前を入力します。
5. Amazon Redshift クラスターの設定で、JDBC URL をコピーします。
6. URL フィールドでは、WebStorm は他の接続設定の値を使用して JDBC URL を自動的に生成します。
  Redshift クラスター設定の JDBC URL を WebStorm の URL フィールドに貼り付けます。
  特定の追加設定を含む JDBC URL を使用する必要がある場合は、それを URL フィールドに貼り付けます。使用する一般的な URL は次のとおりです。
  - フォーマット: jdbc:redshift:iam://<cluster_name>:<region>/<database_name>
  - サンプル: jdbc:redshift:iam://democluster:eu-south-2/demodb
  URL 形式の詳細については、「Amazon Redshift 公式ドキュメント(英語)」を参照してください。
1. 認証ドロップダウンから、接続の認証に使用する認証方法を選択します。以下のオプションから選択できます。
  - pgpass: pgpass ファイルを使用します。このファイルはユーザーのホームディレクトリに保存できます。パスワードファイルとその場所の詳細については、postgresql.org のパスワードファイル(英語)を参照してください。
  - ユーザーパスワード : ログインとパスワードを使用。
  - AWS プロファイル : プロファイルフィールドで AWS 名前付きプロファイルを使用します。
    AWS 名前付きプロファイルの詳細については、DBMS 固有のプロパティの章を参照してください。
  - 認証なし : 認証は必要ありません。
2. Amazon Redshift クラスターの設定で、JDBC URL をコピーします。
3. URL フィールドでは、WebStorm は他の接続設定の値を使用して JDBC URL を自動的に生成します。
  Redshift クラスター設定の JDBC URL を WebStorm の URL フィールドに貼り付けます。
  特定の追加設定を含む JDBC URL を使用する必要がある場合は、それを URL フィールドに貼り付けます。使用する一般的な URL は次のとおりです。
  - フォーマット: jdbc:redshift://<connection_url><port_number>/<database_name>
  - サンプル: jdbc:redshift://server.redshift.amazonaws.com:5439
  URL 形式の詳細については、「Amazon Redshift 公式ドキュメント(英語)」を参照してください。
  URL のみ接続タイプの場合、URL フィールドの内容はプレーンテキストで保存され、IDE ログファイルおよびデータソース設定ファイルでも使用できます。
  機密性の高い接続の詳細を URL フィールドに入力するのではなく、指定されたフィールドを使用して入力します。
一般およびデータソースおよびドライバーダイアログ (Shift+Enter) の他のタブの接続設定とプロパティに関する参考情報については、接続設定と DBMS 固有のプロパティを参照してください。
ユーザーおよびパスワードフィールドに、Redshift 認証情報を指定します。
提供された詳細情報を使用してデータベース接続を確立できることを確認してください。これを行うには、接続詳細セクションの下部にある接続のテストリンクをクリックしてください。
接続の問題が発生した場合は、データベースに接続できませんページを参照してください。
(オプション) デフォルトでは、デフォルトのみがイントロスペクトされ、操作可能です。他のデータベース、スキーマ、共有データベースも操作する場合は、「スキーマ」タブで、イントロスペクションの対象として選択します。
OK をクリックして、データソースを作成します。
データベースツールウィンドウで新しいデータソースを見つけます。
- データベースツールウィンドウの詳細については、対応するリファレンストピックを参照してください。
  新しいデータソースノードにさらにデータベース、スキーマ、共有データベースを表示するには、N/M ボタンをクリックして必要なものを選択します。WebStorm はそれらをイントロスペクトして表示します。
- WebStorm でのデータベースオブジェクトの操作の詳細については、「データベースオブジェクト」を参照してください。
- クエリを作成して実行するには、データソースをクリックして F4 を押し、既定のクエリコンソールを開きます。
- データベースオブジェクトのデータを表示および編集するには、オブジェクトをダブルクリックしてデータエディターとビューアーを開きます。

接続設定と DBMS 固有のプロパティ

接続設定

一般およびデータソースおよびドライバーダイアログ (Shift+Enter) の他のタブの接続設定 ( ホスト、ポートなど) に関する参考情報については、「データソース」を参照してください。

DBMS 固有のプロパティ

一般タブ

項目	説明	接続タイプ
地域	Amazon Redshift で利用可能な AWS リージョン。	IAM クラスター / リージョン
クラスタ	Amazon Redshift クラスターは、コンピューティングリソースのグループです。詳細については、Amazon Redshift 公式ドキュメント(英語)を参照してください。
プロファイル	AWS の名前付きプロファイル。名前付きプロファイルは、認証に使用できる設定と認証情報のコレクションです。名前付きプロファイルは `credentials` ファイルに保存されます。これらのファイルのデフォルトのディレクトリは、~/.aws/credentials (Linux および macOS) と %USERPROFILE%\.aws\credentials (Windows) です。次の `credentials` ファイルの例を考えてみましょう。 [default] aws_access_key_id=ASIAIOSFODNN7EXAMPLE aws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY aws_session_token = IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZVERYLONGSTRINGEXAMPLE [user1] aws_access_key_id=ASIAI44QH8DHBEXAMPLE aws_secret_access_key=je7MtGbClwBF/2Zp9Utk/h3yCo8nvbEXAMPLEKEY aws_session_token = fcZib3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZVERYLONGSTRINGEXAMPLE `user1` プロファイルに保存されている資格情報を使用するには、プロファイルフィールドに `user1` と入力します。名前付きプロファイルの詳細については、Amazon AWS 公式ドキュメント(英語)を参照してください。	すべてのタイプ (AWS プロファイル認証方式)

項目

説明

接続タイプ

地域

Amazon Redshift で利用可能な AWS リージョン。

IAM クラスター / リージョン

クラスタ

Amazon Redshift クラスターは、コンピューティングリソースのグループです。詳細については、Amazon Redshift 公式ドキュメント(英語)を参照してください。

プロファイル

AWS の名前付きプロファイル。名前付きプロファイルは、認証に使用できる設定と認証情報のコレクションです。名前付きプロファイルは credentials ファイルに保存されます。これらのファイルのデフォルトのディレクトリは、~/.aws/credentials (Linux および macOS) と %USERPROFILE%\.aws\credentials (Windows) です。

次の credentials ファイルの例を考えてみましょう。

                                        [default]
                                        aws_access_key_id=ASIAIOSFODNN7EXAMPLE
                                        aws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
                                        aws_session_token = IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZVERYLONGSTRINGEXAMPLE

                                        [user1]
                                        aws_access_key_id=ASIAI44QH8DHBEXAMPLE
                                        aws_secret_access_key=je7MtGbClwBF/2Zp9Utk/h3yCo8nvbEXAMPLEKEY
                                        aws_session_token = fcZib3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZVERYLONGSTRINGEXAMPLE
                                    

user1 プロファイルに保存されている資格情報を使用するには、プロファイルフィールドに user1 と入力します。

名前付きプロファイルの詳細については、Amazon AWS 公式ドキュメント(英語)を参照してください。

すべてのタイプ (AWS プロファイル認証方式)

「スキーマ」タブ

項目	説明
内部システムスキーマの表示	pg_temp や p_toast などの内部システムスキーマを表示します。
テンプレートデータベースの表示	テンプレートデータベースの表示。

最終更新日: 2025 年 4 月 23 日

関連ページ：

データベースへの接続

このトピックでは、WebStorm でのデータベースへの接続の仕組みの概要を説明します。機能と概念の詳細については、専用のトピックを参照してください。データソース：データベースに接続するには、WebStorm には接続の詳細 (ホスト、ポート、パスワード、SSH 構成設定など) が必要です。すべてのデータベースの接続の詳細は、専用の接続構成 (データソース) に保存されます。以下は、データソースおよびドライバーダイアログ () のデータソース設定の例です。ダイアログフィールドの詳細については、ダ...

SSH と SSL の構成

データベースへの接続をより安全にするために、一部のサービスでは SSH または SSL の使用が必要です。SSL：次の手順では、ほとんどのデータベースに適した SSL 構成について説明します。一部のデータベースでは、接続を成功させるために別のアプローチを使用する必要があります。DataGrip の資料で Cassandra および Heroku Postgres の構成例を見ることができます。SSL を使用してデータベースに接続する次のいずれかの方法でデータソースのプロパティを開きます。データベースツー...

データソースおよびドライバーダイアログ

データソースおよびドライバーダイアログにアクセスするには、次のいずれかのアクションを実行します。データベースツールウィンドウで、データソースのプロパティボタンをクリックします。データベースツールウィンドウで、追加ボタンをクリックし、に移動します。概要：データソースおよびドライバーダイアログでは、データソースとデータベースドライバを管理できます。左ペインのコントロールデータソースとドライバーのリストから項目を選択すると、その項目の設定がダイアログの右側に表示されます。ツールバー

トラブルシューティング資料

より正確で素早い回答のためにトラブルシューティング資料をアタッチすることを検討してください。ログファイル、スクリーンショット、アニメーション、ビデオ、データベースダンプなどの資料が調査に役立ちます。ログファイルを見つける：WebStorm ログを検索するをクリックします。idea.log ファイルには、IDE のパフォーマンスに関する最近のログ情報が含まれています。idea.log ファイルには、IDE パフォーマンスに関する最近のログ情報が含まれています。SQL ログの場所を変更する SQL ログ...

IDE で使用されるディレクトリ

デフォルトでは、WebStorm は、各 IDE インスタンスのユーザー固有のファイル（構成、キャッシュ、プラグイン、ログなど）をユーザーのホームディレクトリに保存します。ただし、必要に応じて、これらのファイルを保存する場所を変更できます。IDE ディレクトリの場所を変更するたとえば、ユーザープロファイルドライブの容量が不足している場合や低速ディスクにある場合、ホームディレクトリが暗号化されている（IDE の速度が低下している）場合、またはネットワークドライブにある場合は、デフォルトの IDE...

データベースに接続できません

ステップ 1. ネットワーク設定を確認する：データベースは、ローカル、サーバー、クラウドで動作できます。サーバーおよびクラウドデータベースの場合、ネットワーク接続が必要です。接続が利用可能かどうかを確認するには、ping コマンドと telnet コマンドを使用します。ping コマンドを使用すると、移行先コンピューターが移行元コンピューターから到達可能であることを確認できます。コマンドラインを開き、コマンドを入力します。は、アドレスをホスト名に解決するコマンドオプションです（可能な場合）。ping...