PyCharm 2026.1 Help

データソース

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

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

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

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

データソースは接続構成です。 データベースへの接続を確立するために使用される接続の詳細のリストが保存されます。 例: ホスト、ポート、データベース名、ドライバー、SSH および SSL 構成設定など。 データソース設定では、 イントロスペクション用のデータベースとスキーマを選択して、 データベース ツールウィンドウに表示したり、接続用のドライバーを変更したりすることもできます。

データソースは データソースおよびドライバー ダイアログ(Shift+Enter )で設定できます。 このダイアログにアクセスするには、 データベース ツールウィンドウ(表示 | ツールウィンドウ | データベース )のツールバーで データソースプロパティボタンデータソース をクリックします。

PostgreSQL データベースの接続詳細を含むデータソース

作成されたデータソースのリストは、 データベース ツールウィンドウ (表示 | ツールウィンドウ | データベース) で表示および調査できます。

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

PyCharm プロジェクトでは、すべてのデータソースの設定は、プロジェクトディレクトリ内の .idea サブディレクトリにある dataSources.xml ファイルに保存されます。

PyCharm では、次のデータソースを作成できます:

  • データベースのデータソース: データを含む運用データベースの接続構成。

    さまざまなデータベースに対して、PyCharm では完全サポートと基本サポートを提供しています。 データベースの完全サポートには、強化されたコード補完やデータベースオブジェクト(イントロスペクション)の検索強化などの機能が含まれます。 また、すべてのインスペクション、クイックフィックス、その他のコーディング支援機能も利用できますが、基本サポートでは利用できる機能が制限されます。

    サポートタイプの詳細については、 その他のデータベーストピックを参照してください。

  • データ定義言語 (DDL) データソース: データ定義言語ステートメントを含む SQL ファイル (DDL データソース を参照)。

データソースを作成する

データベースに接続して作業を始めるには、接続詳細を含むデータソースを作成し、その詳細を接続先データベースに指定してください。

サポートされているデータベース

PyCharm は、ローカルまたはリモートで動作するデータベースに、ホストサーバーまたはクラウドプラットフォームを問わず接続できます。

データソースを作成し、データベースへのテスト接続を実行するには、専用のトピックに記載されている手順に従ってください。

完全サポート

IDE は次のデータベースを完全にサポートします。

基本サポート

下記のデータベースに対しては、 基本的なサポートが提供されます。

  • 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

DDL データソース

DDL データソースを作成するには、 DDL データソース トピックの手順に従ってください。

クラウドデータベース

PyCharm は次のクラウドデータベースもサポートしています:

データソースのコピー

データソースを複製すると、パスワードを含むすべての接続設定が保持されます。 データソースは単一のプロジェクト内でのみ複製できます。

  1. データベース ツールウィンドウまたは データソースおよびドライバー のいずれかで接続構成を複製できます。

    • データベース ツールウィンドウで、複製するデータソースを選択し、右クリックして コピーペースト | 複製 を選択します。

      データベースツールウィンドウでデータソースを複製する
    • データソースおよびドライバー ダイアログ (Shift+Enter) の左側の領域で、複製するデータソースを選択し、ツールバーの 複製アイコン複製 をクリックします。

      データソースとドライバーダイアログでデータソースを複製

    または、データソースを選択して Ctrl+D を押します。

    PyCharm は、パスワードを含む同じ設定で新しいデータソースを作成します。

  2. OK をクリックして新しいデータソースを保存し、ダイアログを閉じます。

データソースとドライバーダイアログで重複したデータソース

データソースを削除する

次のいずれかの方法でデータソースを削除できます:

  • コンテキストメニューを使用してデータソースを削除するには、 データベース ツールウィンドウ (表示 | ツールウィンドウ | データベース) で、削除するデータソースを右クリックし、 データソースを除去する を選択します。

  • データソースおよびドライバー ダイアログでデータソースを削除するには、次の手順に従います。

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

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

      • Shift+Enter を押します。

      データソースとドライバーを開くダイアログ
    2. ダイアログの左側のペインで、削除するデータソースを選択し、ツールバーの 削除 をクリックします。

  • データソースおよびドライバー ダイアログのコンテキストメニューからデータソースを削除するには、ダイアログの左側のペインで、削除するデータソースを右クリックし、 削除 を選択します。

データソースの表示オプションを構成する

データベース ツールウィンドウ (表示 | ツールウィンドウ | データベース) で、オブジェクトをグループ化したり、色を割り当てたり、フィルター処理したりできます。

データソースをフォルダーにグループ化する

PyCharm では、データソースを新しいフォルダーまたは既存のフォルダーに移動できます。

  • データソースを新しいフォルダーに移動するには、次の手順を実行します。

    1. 項目を右クリックして「移動 | フォルダー へ」を選択します。 または、 F6 を押します。

    2. 既存のフォルダーがない場合、PyCharm は 新規フォルダー ダイアログを表示します。 すでにフォルダーがある場合は、 フォルダーに移動 ポップアップが表示されます。 ポップアップで 新規フォルダー を選択してください。

    3. 新規フォルダー ダイアログでフォルダー名を入力します。 スラッシュ(/ )を使用してネストを定義できます。 例: QA/Quick という名前は、 QA フォルダー内に Quick フォルダーを作成します。

    データソースをグループ化するための新しいフォルダーを作成する
  • データソースを既存のフォルダーに移動するには、次の手順を実行します。

    1. 項目を右クリックして「移動 | フォルダー へ」を選択します。 または、 F6 を押します。

    2. フォルダーに移動 ポップアップから、ターゲットフォルダーを選択します。

    アイテムをフォルダーに移動する

操作を元に戻すには、 Ctrl+Z を押します。

データソースに色を割り当てる

  1. データソースおよびドライバー ダイアログ (Shift+Enter) で、色を割り当てるデータソースを選択します。

  2. 名前 フィールドの円をクリックして、色を選択します。

  3. 変更を適用して、ダイアログを閉じます。

データベースツリー内のデータソースおよびデータベースオブジェクトに色を割り当てる方法の詳細については、 データソースとデータベースオブジェクトに色を割り当てる を参照してください。

データソースに色を割り当てる

データソースのフルネームを使用する

デフォルトでは、 Shorten Tab Titles オプションは有効になっています。 タブタイトルのデータソース名は 36 文字に短縮されています。

  • クエリコンソール のタブを右クリックし、 Shorten Tab Titles を選択します。

データソースを共有する

PyCharm では、単一の IDE インスタンス内の異なるプロジェクト間や、異なる IDE インスタンス間でデータソースを共有できます。 プロジェクト間でデータソースを共有するには、アクセスレベルを変更する必要があります。 IDE 間でデータソースを共有するには、コピーして貼り付けるか、IDE 設定のエクスポート/インポート機能を使用する必要があります。

プロジェクト間でデータソースを共有する

PyCharm のデータソースは、プロジェクトレベルとグローバルレベルの二つのレベルで利用できます。 プロジェクトレベルとは、このデータソースが最初に作成されたプロジェクトからのみデータソースにアクセスできることを意味します。 グローバルレベルでは、他のプロジェクトでもデータソースを利用できます。 デフォルトでは、プロジェクトレベルでデータソースを利用できます。

IDE 内の異なるプロジェクト間でデータソースを共有するには、データソースをグローバルレベルに移動する必要があります。

  1. データベース ツールウィンドウで、ツールバーの データソースプロパティボタンData Source Properties をクリックします。

  2. 開いた データソースおよびドライバー ダイアログ (Shift+Enter) で、グローバルにするデータソースを選択し、右クリックして グローバル化アイコングローバルにする を選択します。

    または、ツールバーの グローバル化アイコングローバルにする をクリックします。

    データソースとドライバーダイアログでデータソースをグローバルにする
  3. OK をクリックして変更を保存し、ダイアログを閉じます。

データソースを再びローカルにするには、データソースの グローバル化アイコングローバルにする を置き換える プロジェクトへ移動アイコンプロジェクトに移動 をクリックします。

データソースとドライバーダイアログにおけるグローバルおよびプロジェクトレベルのデータソース

IDE インスタンス間でデータソースを共有する

PyCharm では、データソースの設定をクリップボードにコピーするか、すべてのプロジェクトデータソースの設定が含まれる XML ファイルを利用してデータソースを共有できます。 また、IDE の設定エクスポート / インポート機能を使用して、ファイルをエクスポート / インポートすることも可能です。

これは、PyCharm に独自のパスワードストアがないためです。 ネイティブのパスワード管理システムか KeePass を使用します。 IDE でのパスワード保存方法を変更するには、IDE 設定 Ctrl+Alt+S外観 & 振る舞い | システム設定 | パスワード に移動してください。 PyCharm でのパスワード保存について詳しくは、 パスワード トピックを参照してください。

データソースをクリップボードにコピー

PyCharm では、データソースをクリップボードにコピーできます。 これを行うと、IDE は接続設定を XML スニペットとしてコピーします。 このスニペットを別の IDE に貼り付けることで、元のデータソースのコピーを作成できます。

  1. データベース ツールウィンドウで、コピーするデータソースを選択します。

  2. 選択したデータソースを右クリックし、 コピーペースト | データソースのコピー に移動してデータソースをクリップボードにコピーします。 または、 Ctrl+C を押します。

    PyCharm は接続設定を含む XML スニペットをコピーします。

  3. ターゲット IDE に切り替えるか、データソースを別のユーザーに送信します。

  4. ターゲット IDE で、 データベース ツールウィンドウを開きます。

  5. データベース ツールウィンドウで、 新しいアイコン新規 をクリックし、 Import from Clipboard を選択します。 または、 データベース ツールウィンドウを右クリックし、 Copy/Paste | Paste Data Source を選択します(または Ctrl+V を押します)。

  6. 開いた データソースおよびドライバー ダイアログ (Shift+Enter) ダイアログで、このデータソースを使用して接続するデータベースまたはスキーマのパスワードを入力します。

  7. OK をクリックして新しいデータソースを保存し、ダイアログを閉じます。

すべての PyCharm プロジェクトには、プロジェクトで使用するすべてのデータソースの設定を保存する dataSources.xml ファイルがあります。 このファイルをコピーすることで、他の IDE インスタンスとデータソースを共有できます。 また、VCS に保存することで、変更を追跡し、複数のユーザー間でデータソースリストを同期することもできます。

dataSources.xml ファイルは、 IDE プロジェクトディレクトリ内の専用プロジェクト設定ディレクトリの .idea サブディレクトリに保存されます。

dataSources.xml ファイルを見つける

  1. Project ツールウィンドウで、プロジェクトディレクトリと .idea ディレクトリノードを展開し、 dataSources.xml ファイルを見つけます。

  2. dataSources.xml ファイルを右クリックして、 開く | <ファイル browser> を選択します。

dataSources.xml ファイルを見つける

IDE 設定のエクスポート/インポート機能と settings.zip ファイルを使用して、データソース設定ファイルをエクスポート/インポートすることもできます。 settings.zip ファイルには、グローバルレベルで利用可能なデータソースのみが含まれています。 レベルの変更の詳細については、 プロジェクトレベルをグローバルに変更するを参照してください。

グローバルデータソース設定を ZIP アーカイブにエクスポートする

  1. メインメニューから ファイル | IDE 設定の管理 | 設定のエクスポート を選択します。

  2. Export Settings… ウィンドウで、 Select None をクリックします。

  3. Export Settings… ウィンドウで、 Database: global data sources を選択します。

  4. Export settings to フィールドで、 settings.zip ファイルを保存するディレクトリへのパスを指定します。

alt_export_sata_sources_settings_zip

ZIP アーカイブからグローバルデータソース設定をインポートする

  1. メインメニューから File | Manage IDE Settings | Import Settings… を選択します。

  2. ファイルブラウザーウィンドウで、エクスポートした settings.zip ファイルを見つけて選択します。

  3. インポートするコンポーネントの選択 ウィンドウで、 データベース: グローバルソース を選択します。

  4. OK をクリックしてください。

  5. Restart Needed ウィンドウで、 OK をクリックして IDE を再起動します。

  6. データソースおよびドライバー ダイアログ(Shift+Enter )を開き、データソースのプロパティに必要な接続資格情報を入力します。 データソースがローカルドライブまたはネットワークドライブ上にある場合は、そのデータソースへのパスが正しいことを確認してください。

  7. データソースへの接続が正常に行われるようにするには、 接続のテスト をクリックします。

alt_import_sata_sources_settings_zip

ヒントとトリック

すべての接続をパスワードで共有する

  1. Ctrl+Alt+S を押して設定を開き、 外観 & 振る舞い | システム設定 | パスワード に移動します。

  2. KeePass を使用する オプションを選択してください。

  3. データベース フィールドに、プロジェクトを保存するディレクトリ内の KDBX ファイルのパスを指定します。

  4. プロジェクトを含むディレクトリ全体を別のコンピューターにコピーします。

  5. 別のコンピューターで、 Ctrl+Alt+S を押して設定を開き、 外観 & 振る舞い | システム設定 | パスワード に移動します。

  6. データベース フィールドに、コピーした KDBX ファイルへのパスを入力します。

  7. File | Open… をクリックして、コピーされたプロジェクトファイルのあるディレクトリに移動します。

2026 年 6 月 1 日