# PostgreSQL

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/ja-jp/help/clion/llms.txt).

Procedure: データベースツールおよび SQL プラグインを有効化

この機能は、CLion にデフォルトでバンドルされ有効化されている データベースツールおよび SQL プラグインに依存しています。 関連機能が利用できない場合は、プラグインを無効化していないことを確認してください。

1. `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) を押して設定を開き、  `プラグイン`  を選択します。

2. データベースツールおよび SQL  プラグインを見つけて   有効化   をクリックします。

Procedure: 公式ドキュメントとソフトウェア

* PostgreSQL の詳細については、 [公式ドキュメント](https://www.postgresql.org/docs/current/)を参照してください。

* PostgreSQL データベースソフトウェアをダウンロードするには、 [公式ソフトウェアダウンロード](https://www.postgresql.org/download/)を参照してください。

対応する DBMS バージョン：9.1–18。

### 始める前に

このトピックでは、CLion で PostgreSQL データベースへの [接続](connecting-to-a-database.html)用のデータソースを作成し、テスト接続を実行するための一般的なプロシージャを説明します。 必要な接続の詳細がすでに用意されており、データベースが稼働していることを前提としています。

たとえば、マシン上でデータベースを実行し、そのデータベースに接続する場合は、まず対応する DBMS ソフトウェアをマシンにインストールする必要があります。

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

Procedure: PostgreSQL データベースに接続する

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

1. 作成したいデータソースを選択します。 以下のいずれかの方法で選択できます。

* メインメニューで、 `ファイル | 新規 | データソース` に移動し、 PostgreSQL を選択します。

* データベース ツールウィンドウで、ツールバーの ![新しいアイコン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) 新規 をクリックします。 データソース に移動し、 PostgreSQL を選択します。

![新しいデータソースを作成する](https://resources.jetbrains.com/help/img/idea/2026.3/create_new_data_source.png)

2. データソースおよびドライバー   ダイアログの右ペインの   一般   タブで、ドライバーと接続タイプを指定します。

1.

接続に別のドライバーが必要でない限り、   ドライバー   リストではデフォルトのドライバーオプションのままにしておきます。

2.

接続タイプ   リストから、接続の詳細に応じて接続タイプを選択します。

* デフォルト : ホスト 、 ポート 、 データベース 、 URL を使用して接続します。

* URL のみ : URL のみを使用して接続します。

URL のみ   [接続タイプ](data-sources-and-drivers-dialog.html#connection_type)の場合、データベース資格情報を含め、入力した JDBC URL がそのまま使用されます。

> **Note:**
> URL のみ   接続タイプの場合、JDBC URL はプレーンテキストでそのまま保存され、 [IDE ログファイル](troubleshooting-materials.html#locate-ide-log)および [データソース情報](managing-data-sources.html#share-data-sources-between-different-ide-instances)でも使用できます。

他の接続タイプの場合、JDBC URL は接続の詳細に分割されます。 個別に指定して自動生成された URL を使用することも、対応するフィールドに URL を直接入力することもできます。

![データソースとドライバーの全般タブダイアログ](https://resources.jetbrains.com/help/img/idea/2026.3/db_connection_general_tab.png)

3. 接続設定エリアの下部に「   不足しているドライバーファイルをダウンロード   」リンクがあるかどうかを確認してください。 このリンクをクリックすると、データベースとのやり取りに必要なドライバーをダウンロードできます。 直接ダウンロードリンクについては、 [JetBrains JDBC ドライバー](https://www.jetbrains.com/ja-jp/datagrip/jdbc-drivers/)ページを参照してください。

![不足しているドライバーファイルのダウンロードリンク](https://resources.jetbrains.com/help/img/idea/2026.3/db_connection_download_missing_drivers_link.png)

ダウンロードされた JDBC ドライバーの場所は [CLion 構成ディレクトリ](directories-used-by-the-ide-to-store-settings-caches-plugins-and-logs.html#config-directory)です。

提供されているドライバーの代わりにデータベース用のドライバーを使用することもできます。 ドライバーを使用したデータベースへの接続の詳細については、「 [既存の接続にユーザードライバーを追加する](jdbc-drivers.html#configure_a_jdbc_driver_for_an_existing_data_source)」を参照してください。

不足しているドライバーファイルをダウンロード   リンクがない場合は、必要なドライバーがすでに存在します。

4. データベース接続の詳細を指定します。 あるいは、JDBC URL を   URL   フィールドに貼り付けます。

デフォルト:

1.    ホスト   フィールドに、サーバーのアドレスを入力します。

2.

ポート   フィールドに、PostgreSQL のポートを入力します。 デフォルトのポートは 5432 です。

> **Note:**
> 実際のポート番号はシステムによって異なる場合があります。 データベース管理者、サーバー設定、ホスティングプロバイダーに正しいポート番号を使用していることを確認してください。

3.

認証   ドロップダウンから、接続の認証に使用する認証方法を選択します。 次のオプションを使用できます：

* pgpass : pgpass ファイルを使用します。 このファイルはユーザーのホームディレクトリに保存できます。 パスワードファイルとその場所の詳細については、 [postgresql.org のパスワードファイル(英語)](https://www.postgresql.org/docs/current/libpq-pgpass.html)を参照してください。

* ユーザーパスワード : ログインとパスワードを使用。

* 認証なし : 認証は必要ありません。

4.

ユーザー   フィールドと   パスワード   フィールドにユーザー資格情報を入力します。

パスワードを使用しない場合は、   パスワード   フィールドを空のままにします。

一度入力したパスワードを削除するには、「   パスワード   」フィールドを右クリックし、「   空にする   」を選択します。

![「空に設定」コンテキストメニューアクション](https://resources.jetbrains.com/help/img/idea/2026.3/db_connection_password_set_empty.png)

5.    データベース   フィールドに、接続先のデータベース名を入力します。

6.

URL   フィールドでは、CLion は他の接続設定の値を使用して JDBC URL を自動的に生成する。

特定の追加設定を含む JDBC URL を使用する必要がある場合は、それを   URL   フィールドに貼り付けます。 一般的な URL は次のとおりです。

* フォーマット: `jdbc:postgresql://<host_address>:<port_number>/<database_name>`

* サンプル: `jdbc:postgresql://127.0.0.1:5432/myDatabase`

URL フォーマットの詳細については、 [PostgreSQL 公式ドキュメント](https://jdbc.postgresql.org/documentation/use/#connecting-to-the-database)を参照してください。

![データベース接続の詳細](https://resources.jetbrains.com/help/img/idea/2026.3/db_connection_details_postgresql_default.png)

URL のみ:

1.

認証   ドロップダウンから、接続の認証に使用する認証方法を選択します。 次のオプションを使用できます：

* ユーザーパスワード : ログインとパスワードを使用。

* 認証なし : 認証は必要ありません。

2.

ユーザー   フィールドと   パスワード   フィールドにユーザー資格情報を入力します。

パスワードを使用しない場合は、   パスワード   フィールドを空のままにします。

一度入力したパスワードを削除するには、「   パスワード   」フィールドを右クリックし、「   空にする   」を選択します。

![「空に設定」コンテキストメニューアクション](https://resources.jetbrains.com/help/img/idea/2026.3/db_connection_password_set_empty.png)

3.

URL   フィールドでは、CLion は他の接続設定の値を使用して JDBC URL を自動的に生成する。

特定の追加設定を含む JDBC URL を使用する必要がある場合は、それを   URL   フィールドに貼り付けます。

URL フォーマットの詳細については、 [PostgreSQL 公式ドキュメント](https://jdbc.postgresql.org/documentation/use/#connecting-to-the-database)を参照してください。

> **Warning:**
> URL のみ   接続タイプの場合、   URL   フィールドの内容はプレーンテキストで保存され、 [IDE ログファイル](troubleshooting-materials.html#locate-ide-log)および [データソース設定ファイル](managing-data-sources.html#locate_the_datasources_xml_file)でも使用できます。
>
>
>
> 機密性の高い接続の詳細を   URL   フィールドに入力するのではなく、指定されたフィールドを使用して入力します。

![データベース接続の詳細](https://resources.jetbrains.com/help/img/idea/2026.3/db_connection_details_postgresql_urlonly.png)

一般   および   データソースおよびドライバー   ダイアログ ( `Shift+Enter` (Windows), `⌘ I` (macOS), `⇧ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Shift+Enter` (Sublime Text), `⌘ I` (Sublime Text (macOS)), `⌘ I` (Xcode), `Shift+Enter` (Visual Studio), `⌘ I` (Visual Studio (macOS)), `Shift+Enter` (ReSharper), `⌘ I` (ReSharper (macOS)), `Shift+Enter` (QtCreator), `Shift+Enter` (QtCreator (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⌘ I` (Eclipse (macOS)) ) の他のタブの接続設定とプロパティに関する参考情報については、 [接続設定と DBMS 固有のプロパティ](#reference)を参照してください。

5. 提供された詳細情報を使用してデータベース接続を確立できることを確認してください。 これを行うには、接続詳細セクションの下部にある   接続のテスト   リンクをクリックしてください。

![テスト接続リンク](https://resources.jetbrains.com/help/img/idea/2026.3/db_test_connection_link.png)

接続の問題が発生した場合は、 [データベースに接続できません](connectivity-problems.html)ページを参照してください。

6. (オプション) デフォルトでは、デフォルトのデータベースとスキーマのみがイントロスペクトされ、使用可能になります。 他のデータベースやスキーマも操作したい場合は、「   スキーマ   」タブで、イントロスペクション用に選択します。

![データソースとドライバーの「スキーマ」タブダイアログ](https://resources.jetbrains.com/help/img/idea/2026.3/db_connection_schemas_tab.png)

7. OK   をクリックして、データソースを作成します。

8. データベース   ツールウィンドウで新しいデータソースを見つけます。

* データベース ツールウィンドウの詳細については、対応する [リファレンストピック](database-tool-window.html)を参照してください。 > **Tip:** > 新しいデータソースノードにさらにデータベースとスキーマを表示するには、 N/M ボタンをクリックして、必要なデータベースとスキーマを選択します。 CLion はそれらをイントロスペクトして表示します。 > > > > ![イントロスペクトしてデータベースツールウィンドウに表示するデータベースとスキーマを選択する](https://resources.jetbrains.com/help/img/idea/2026.3/connection_flow_show_databases_and_schemas.png)

* CLion でのデータベースオブジェクトの操作の詳細については、 [データベースオブジェクト](database-objects.html)を参照してください。

* クエリを作成して実行するには、データソースをクリックして `F4` (Windows), `⌘ ↓` (macOS), `F4` (IntelliJ IDEA Classic (macOS)), `F4` (macOS System Shortcuts), `F4` (XWin), `F4` (GNOME), `F4` (KDE), `F4` (Emacs), `F4` (Sublime Text), `F4` (Sublime Text (macOS)), `⌘ ↓` (Xcode), `F4` (Visual Studio), `⌘ ↓` (Visual Studio (macOS)), `F4` (ReSharper), `⌘ ↓` (ReSharper (macOS)), `F4` (QtCreator), `F4` (QtCreator (macOS)), `F4` (NetBeans), `F12` (Eclipse), `F3` (Eclipse (macOS)) を押し、デフォルトの [クエリコンソール](query-consoles.html)を開きます。

* データベースオブジェクトのデータを表示および編集するには、オブジェクトを double クリックして [データエディターダイアログ](data-editor-and-viewer.html)を開きます。

## Kerberos 認証

Kerberos 認証を使用して PostgreSQL データベースへの接続を確立する前に、コマンドプロンプトまたは [ターミナル](terminal-emulator.html)で Kerberos コマンドを実行して、認証チケットがあることを確認してください。

Procedure:

* マシンにチケットキャッシュファイルがあり、 `useTicketCache` が `true` に設定されている場合は、 `klist` コマンドを実行してください。 キャッシュされたチケットの中に、あなたのチケットが含まれていることを確認してください。

* マシン上でチケットキャッシュが有効になっていない場合は、次の手順を実行します。 1. `klist` コマンドを実行し、チケットがリストされていることを確認します。 2. 認証チケットがリストにない場合は、ユーザー名を指定して `kinit` コマンドを実行し、サーバー `kinit <username>` からチケットを取得してください。 プロンプトが表示されたら、パスワードを入力してください。

Kerberos チケットの詳細については、 [Kerberos Web サイト(英語)](https://web.mit.edu/kerberos/krb5-devel/doc/user/tkt_mgmt.html)を参照してください。

Windows の場合、データソースを構成する前に、OS に  `krb5.ini`  [Kerberos 構成ファイル(英語)](https://www.ibm.com/docs/en/was/8.5.5?topic=scripting-kerberos-configuration-file)があるかどうかも確認し、それに応じてデータソースの構成を続行します。

Kerberos 認証用に PostgreSQL データソースを構成するには、次の手順を実行します:

任意の OS で、krb5.ini ファイルあり:

Procedure:

1. 次の  `/etc/jaas.conf`  構成ファイルを作成します。

```
pgjdbc {
com.sun.security.auth.module.Krb5LoginModule required
useTicketCache=true
debug=true
renewTGT=true
doNotPrompt=true;
};

```

2. データソースおよびドライバー   ダイアログ（ `Shift+Enter` (Windows), `⌘ I` (macOS), `⇧ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Shift+Enter` (Sublime Text), `⌘ I` (Sublime Text (macOS)), `⌘ I` (Xcode), `Shift+Enter` (Visual Studio), `⌘ I` (Visual Studio (macOS)), `Shift+Enter` (ReSharper), `⌘ I` (ReSharper (macOS)), `Shift+Enter` (QtCreator), `Shift+Enter` (QtCreator (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⌘ I` (Eclipse (macOS))）を開き、データソースを選択し、   拡張   タブに移動します。

3. VM オプション   フィールドに以下を入力します。

`-Djava.security.auth.login.config=/etc/jaas.conf`

![PostgreSQL データソースプロパティでの VM オプションの設定](https://resources.jetbrains.com/help/img/idea/2026.3/db_troubleshooting_postgresql_kerberos_vmoptions.png)

4. OK   をクリックして変更を保存し、ダイアログを閉じます。

Windows OS で、krb5.ini ファイルなし:

Procedure:

1. データソースおよびドライバー   ダイアログ（ `Shift+Enter` (Windows), `⌘ I` (macOS), `⇧ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Shift+Enter` (Sublime Text), `⌘ I` (Sublime Text (macOS)), `⌘ I` (Xcode), `Shift+Enter` (Visual Studio), `⌘ I` (Visual Studio (macOS)), `Shift+Enter` (ReSharper), `⌘ I` (ReSharper (macOS)), `Shift+Enter` (QtCreator), `Shift+Enter` (QtCreator (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⌘ I` (Eclipse (macOS))）を開き、データソースを選択し、   拡張   タブに移動します。

2. プロパティテーブルで、最後の行までスクロールし、  `gsslib`  を   命名方法名   として、  `sspi`  を   値   として入力します。

または、   一般   タブで、   URL   フィールドのデータベース JDBC URL に  `gsslib=sspi`  を追加します。

接続の問題が発生した場合は、次の手順に従ってください。

1.    拡張   タブの   VM オプション   フィールドに  `-Dsun.security.krb5.debug=true`  を追加して、デバッグログを有効化します。

2.    接続のテスト   をクリックします。

3.  [idea.log

ファイルを見つける](troubleshooting-materials.html#locate-ide-log)と入力し、 [サポートリクエスト](null)に添付してください。

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

### 接続設定

一般   および   データソースおよびドライバー   ダイアログ ( `Shift+Enter` (Windows), `⌘ I` (macOS), `⇧ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Shift+Enter` (Sublime Text), `⌘ I` (Sublime Text (macOS)), `⌘ I` (Xcode), `Shift+Enter` (Visual Studio), `⌘ I` (Visual Studio (macOS)), `Shift+Enter` (ReSharper), `⌘ I` (ReSharper (macOS)), `Shift+Enter` (QtCreator), `Shift+Enter` (QtCreator (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⌘ I` (Eclipse (macOS)) ) の他のタブの接続設定 (   ホスト   、   ポート   など) に関する参考情報については、「 [データソース](data-sources-and-drivers-dialog.html#db)」を参照してください。

### DBMS 固有のプロパティ

#### 「スキーマ」タブ

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

## See also

### リファレンス

[データソースとその要素](database-tool-window.html#icons-for-data-sources-and-their-elements) [データソースおよびドライバーダイアログ](data-sources-and-drivers-dialog.html)

### ツールウィンドウ

[データベースツールウィンドウ](database-tool-window.html)

