PyCharm 2025.3 ヘルプ

基本的なサポートを備えたデータベース

データベースツールと SQL プラグインを有効にする

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

  1. Ctrl+Alt+S を押して設定を開き、プラグインを選択します。

  2. インストール済みタブを開き、データベースツールおよび SQL プラグインを見つけて、プラグイン名の横にあるチェックボックスを選択します。

データソースを作成するには、JDBC ドライバーが必要です。PyCharm には、完全サポート基本サポートの 2 種類のドライバーがあります。データソースおよびドライバーダイアログのドライバータブで、完全で基本的なサポートを提供しているデータベースベンダーのリストを確認できます。また、ユーザーが作成したドライバーは基本的なサポートを備えたドライバーと見なされることに注意してください。

  • 完全サポートには、強化されたコード補完やデータベースオブジェクトの検索(イントロスペクション)の改善などの機能が含まれています。たとえば、完全サポートでは、対応するデータベースで以下のオブジェクトが表示されます: Apache Cassandra のユーザー定義型、Apache Hive のマクロ、PostgreSQL の拡張機能。また、完全サポートのデータベースでは、すべてのインスペクション、クイックフィックス、その他のコーディング支援機能も利用できます。

  • 基本サポートはコードのハイライトを提供し、JDBC ドライバーによって取得されたオブジェクトも表示します。PyCharm は、データベースイントロスペクションに JDBC メタデータを使用し、コードのハイライトに SQL 2016 ダイアレクトを使用します。エラーは検出されず、ハイライトされません。

    JDBC メタデータのイントロスペクションは、一部の特定のデータベースオブジェクトがデータベースツリービューに表示されないことを意味します。コード補完には、イントロスペクション中に取得されなかったオブジェクトは含まれません。

Drivers with complete and basic support

次のデータベースベンダーに対して基本サポートが提供されます。

  • Amazon Athena

  • Apache Ignite

  • Apache Phoenix

  • Apache Spark

  • Databricks

  • Denodo

  • DuckDB

  • Elasticsearch

  • Firebird

  • Google Cloud Spanner

  • IBM Informix

  • InterSystems IRIS

  • Mimer SQL

  • OpenEdge

  • Presto

  • SAP HANA

  • SingleStore

  • Tarantool

  • Teradata ヴァンテージ

  • TiDB

  • TmaxTibero

  • Trino

  • YugabyteDB

基本的なサポートを備えたドライバーからのデータソースの作成

基本的なサポートを備えたドライバーからデータソースを作成するには、2 つの方法があります。

  • その他サブメニューの使用

  • ユーザードライバーファイルの使用

その他のサブメニューの使用

  1. 次のいずれかの方法でデータソースのプロパティを開きます。

    • データベースツールウィンドウのツールバーで、The Data Sources icon データソースをクリックします。

    • Shift+Enter を押します。

    Open the Data Source and Drivers dialog
  2. データソースおよびドライバーダイアログでは、データソースタブとドライバータブを使用してデータソースを作成できます。

    • データソース : 追加アイコン(The Add icon)をクリックして、その他に移動します。このサブメニューで、データソースの作成に使用するドライバーを選択します。

    • ドライバー : ドライバータブをクリックして、必要なドライバーを選択します。このドライバーの設定で、データソースの作成をクリックします。

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

    パスワードを削除するには、パスワードフィールドを右クリックして、空にするを選択します。

    General tab of the Data Sources and Drivers dialog

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

  4. 接続設定領域の下部に「不足しているドライバーファイルをダウンロード」リンクがあるかどうかを確認します。このリンクをクリックして、データベースと対話するために必要なドライバーをダウンロードします。直接ダウンロードリンクについては、JetBrains JDBC ドライバーページを参照してください。

    The Download missing driver files link

    ダウンロードされた JDBC ドライバーの場所は PyCharm 構成ディレクトリです。

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

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

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

    Test Connection link

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

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

Drivers that have basic support

ユーザードライバーファイルの使用

  1. 次のいずれかの方法でデータソースのプロパティを開きます。

    • データベースツールウィンドウのツールバーで、The Data Sources icon データソースをクリックします。

    • Shift+Enter を押します。

    Open the Data Source and Drivers dialog
  2. データソースおよびドライバーダイアログで、ドライバータブが表示されていることを確認します。

  3. データソースおよびドライバーダイアログで、追加アイコン(The Add icon)をクリックします。

  4. 名前フィールドに、ドライバーの名前を入力します。

  5. ドライバーファイルペインで、追加アイコン(The Add icon)をクリックし、カスタム JAR を選択します。

  6. JDBC ドライバの JAR ファイルに移動して選択し、OK をクリックします。

  7. クラスフィールドで、ドライバーに使用したい値を指定します。

  8. 適用をクリックします。

  9. ドライバのダイアログからデータソースを作成するには、データソースの作成をクリックします。

ユーザードライバーのライブラリパス

一部の JDBC ドライバーは、正しく機能するために、ドライバーと共にライブラリファイルへのパスを必要とします。

例: アプリケーションが Instant Client モードで動作するかどうかを判断するために、Oracle Instant Client(OCI) アプリケーションは、ランタイムライブラリ検索パス(Linux の場合は LD_LIBRARY_PATH、Windows の場合は PATH)でライブラリファイルを検索します。これらのパスはデータソースおよびドライバーダイアログで設定できます。

ライブラリパスの追加

  1. 次のいずれかの方法でデータソースのプロパティを開きます。

    • データベースツールウィンドウのツールバーで、The Data Sources icon データソースをクリックします。

    • Shift+Enter を押します。

    Open the Data Source and Drivers dialog
  2. データソースおよびドライバーダイアログで、ライブラリファイルへのパスを追加するドライバエントリをクリックします。

  3. (オプション) ライブラリファイルを追加するドライバーを追加します。既存のドライバーが要件を満たしていない場合は、既存のドライバーを置き換えます。既存のドライバーエントリを削除するには、ドライバーを選択して除去をクリックします。

    ドライバーの追加の詳細については、「JDBC ドライバーを使用したデータベースへの接続の作成」を参照してください。

  4. ドライバーファイルペインで、追加アイコン(The Add icon)をクリックし、ネイティブライブラリのパスを選択します。

  5. ライブラリファイルのあるフォルダーに移動します。ドライバのバージョンがこれらのライブラリファイルのバージョンに対応していることを確認してください。例: ドライバーバージョン 19.6 を使用する場合、添付ライブラリファイルにも 19.6 バージョンが必要です。

    Working with the Native Library Path

生産性のヒント

JDBC URL からデータソースを作成する

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

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

    • メインメニューで、ファイル | 新規 | URL からデータソースに移動します。

    • データベースツールウィンドウで、ツールバーの the New icon 新規をクリックします。URL からデータソースに移動します。

  2. URL フィールドに、JDBC URL を貼り付けます。

  3. ドライバーリストから、データソースに必要なドライバーを選択します。

    Create a data source from the JDBC URL
  4. データソースおよびドライバーダイアログで、資格情報を入力します。

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

    Test Connection link

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

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

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

    • データベースツールウィンドウの詳細については、対応するリファレンストピックを参照してください。

    • PyCharm でのデータベースオブジェクトの操作の詳細については、「データベースオブジェクト」を参照してください。

    • クエリを作成して実行するには、データソースをクリックして F4 を押し、既定のクエリコンソールを開きます。

    • データベースオブジェクトのデータを表示および編集するには、オブジェクトをダブルクリックしてデータエディターとビューアーを開きます。

2025 年 10 月 28 日

関連ページ:

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

データベースツールと SQL プラグインを有効にするこの機能は、PyCharm にデフォルトでバンドルされ有効になっているデータベースツールと SQL プラグインに依存しています。関連する機能が利用できない場合は、プラグインを無効にしていないことを確認してください。を押して設定を開き、を選択します。インストール済みタブを開き、データベースツールおよび SQL プラグインを見つけて、プラグイン名の横にあるチェックボックスを選択します。データソースおよびドライバーダイアログにアクセスするには、次のいず...

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

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

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

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

データベースツールウィンドウ

データベースツールと SQL プラグインを有効にするこの機能は、PyCharm にデフォルトでバンドルされ有効になっているデータベースツールと SQL プラグインに依存しています。関連する機能が利用できない場合は、プラグインを無効にしていないことを確認してください。を押して設定を開き、を選択します。インストール済みタブを開き、データベースツールおよび SQL プラグインを見つけて、プラグイン名の横にあるチェックボックスを選択します。概要:データベースツールウィンドウでは、データベースと DDL デ...

クエリコンソール

データベースツールと SQL プラグインを有効にするこの機能は、PyCharm にデフォルトでバンドルされ有効になっているデータベースツールと SQL プラグインに依存しています。関連する機能が利用できない場合は、プラグインを無効にしていないことを確認してください。を押して設定を開き、を選択します。インストール済みタブを開き、データベースツールおよび SQL プラグインを見つけて、プラグイン名の横にあるチェックボックスを選択します。概要:クエリコンソールは、データソースにアタッチされる SQL...

データエディターとビューアー

データベースツールと SQL プラグインを有効にするこの機能は、PyCharm にデフォルトでバンドルされ有効になっているデータベースツールと SQL プラグインに依存しています。関連する機能が利用できない場合は、プラグインを無効にしていないことを確認してください。を押して設定を開き、を選択します。インストール済みタブを開き、データベースツールおよび SQL プラグインを見つけて、プラグイン名の横にあるチェックボックスを選択します。概要:データエディターとビューアー、またはデータエディターは、デ...