PyCharm 2026.1 Help

Oracle​

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

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

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

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

サポートされている DBMS バージョン: 9.0 – 12.0。

始める前に

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

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

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

Oracle データベースに接続する

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

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

    • メインメニューで、 File | New | Data Source に移動し、 Oracle​ を選択します。

    • データベース ツールウィンドウで、ツールバーの 新しいアイコン新規 をクリックします。 データソース に移動し、 Oracle​ を選択します。

    新しいデータソースを作成する

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

    1. ドライバー リストから、接続用の JDBC ドライバーを選択します。

      Oracle​ の場合、サポートされているドライバーは Oracle​ と 9.X、10.X、11.1 用 Oracle​ です。 ドライバーの種類について詳しくは、 Oracle​ JDBC FAQ を参照してください。

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

      • SID​: Oracle​ インスタンス（ワークステーション上で実行されるプロセス）の固有の名前を使用します。

      • サービス名: Oracle​ インスタンス（または複数のインスタンス）へのエイリアスを使用します。

      • TNS​: tnsnames.ora 構成ファイルを使用します。

      • Long​: 高度なパラメーターを備えた拡張 JDBC URL 形式を使用します。

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

      URL のみ 接続タイプの場合、データベース資格情報を含め、入力した JDBC URL がそのまま使用されます。

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

    データソースとドライバーの全般タブダイアログ

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

    不足しているドライバーファイルのダウンロードリンク

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

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

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

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

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

    2. ポート フィールドに Oracle​ のポートを入力します。 デフォルトのポートは 1521 です。

    3. SID​ フィールドに Oracle​ インスタンス（ワークステーション上で実行されるプロセス）の一意の名前を指定します。

      詳細については、 DBMS 固有の「全般」タブのリファレンスを参照してください。

    4. ドライバー リストから、接続で使用する Oracle​ JDBC ドライバーモードを選択してください：

      • シン: ドライバーはサーバーに直接接続します。

      • OCI および OCI8: ドライバーはネイティブライブラリを使用してサーバーに接続します。

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

      • User & Password: ログインとパスワードを使用。

      • Kerberos: 認証に Kerberos を使用します。 Kerberos サーバーと kinit による認証が必要です。

      • SYSDBA: SYSDBA として接続します。

      • SYSOPER: SYSOPER として接続します。

      • No auth: 認証は必要ありません。

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

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

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

      「空に設定」コンテキストメニューアクション

    7. URL​ フィールドで、PyCharm は他の接続設定の値を使って JDBC URL を自動生成します。

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

      • フォーマット: jdbc:oracle:thin:@<host_address>:<port_number>:<instance_name>

      • サンプル: jdbc:oracle:thin:@127.0.0.1:1521:XE

      URL 形式について詳しくは、 Oracle​ 公式ドキュメント を参照してください。

    データベース接続の詳細

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

    2. ポート フィールドに Oracle​ のポートを入力します。 デフォルトのポートは 1521 です。

    3. サービス フィールドに、使用する Oracle​ インスタンスへのエイリアスを入力します。

    4. ドライバー リストから、接続で使用する Oracle​ JDBC ドライバーモードを選択してください：

      • シン: ドライバーはサーバーに直接接続します。

      • OCI および OCI8: ドライバーはネイティブライブラリを使用してサーバーに接続します。

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

      • User & Password: ログインとパスワードを使用。

      • Kerberos: 認証に Kerberos を使用します。 Kerberos サーバーと kinit による認証が必要です。

      • SYSDBA: SYSDBA として接続します。

      • SYSOPER: SYSOPER として接続します。

      • No auth: 認証は必要ありません。

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

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

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

      「空に設定」コンテキストメニューアクション

    7. URL​ フィールドで、PyCharm は他の接続設定の値を使って JDBC URL を自動生成します。

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

      • フォーマット: jdbc:oracle:thin:@//<host_address>:<port_number>/<instance_alias>

      • サンプル: jdbc:oracle:thin:@//127.0.0.1:1521/XE

      URL 形式について詳しくは、 Oracle​ 公式ドキュメント を参照してください。

    データベース接続の詳細

    1. TNSADMIN フィールドに、 tnsnames.ora を使用してフォルダーへのパスを指定します。 または、 オープン アイコン（Open ボタン ）をクリックして移動してください。

      詳細については、 接続設定と DBMS 固有のプロパティ を参照してください。

    2. TNS name フィールドに、複数のサービスがある場合に使用するサービス名を指定します。

      詳細については、 DBMS 固有の「全般」タブのリファレンスを参照してください。

    3. ドライバー リストから、接続で使用する Oracle​ JDBC ドライバーモードを選択してください：

      • シン: ドライバーはサーバーに直接接続します。

      • OCI および OCI8: ドライバーはネイティブライブラリを使用してサーバーに接続します。

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

      • User & Password: ログインとパスワードを使用。

      • Kerberos: 認証に Kerberos を使用します。 Kerberos サーバーと kinit による認証が必要です。

      • SYSDBA: SYSDBA として接続します。

      • SYSOPER: SYSOPER として接続します。

      • No auth: 認証は必要ありません。

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

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

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

      「空に設定」コンテキストメニューアクション

    6. URL​ フィールドで、PyCharm は他の接続設定の値を使って JDBC URL を自動生成します。

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

      • フォーマット: jdbc:oracle:thin:@<service_name>

      • サンプル: jdbc:oracle:thin:@myServiceName

      URL 形式について詳しくは、 Oracle​ 公式ドキュメント を参照してください。

    データベース接続の詳細

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

    2. ポート フィールドに Oracle​ のポートを入力します。 デフォルトのポートは 1521 です。

    3. サービス フィールドに、使用する Oracle​ インスタンスへのエイリアスを入力します。

    4. ドライバー リストから、接続で使用する Oracle​ JDBC ドライバーモードを選択してください：

      • シン: ドライバーはサーバーに直接接続します。

      • OCI および OCI8: ドライバーはネイティブライブラリを使用してサーバーに接続します。

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

      • User & Password: ログインとパスワードを使用。

      • Kerberos: 認証に Kerberos を使用します。 Kerberos サーバーと kinit による認証が必要です。

      • SYSDBA: SYSDBA として接続します。

      • SYSOPER: SYSOPER として接続します。

      • No auth: 認証は必要ありません。

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

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

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

      「空に設定」コンテキストメニューアクション

    7. 「URL​ 」フィールドに、接続に必要なパラメーターを含む拡張形式の JDBC URL を貼り付けます。

      URL 形式について詳しくは、 Oracle​ 公式ドキュメント を参照してください。

    データベース接続の詳細

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

      • User & Password: ログインとパスワードを使用。

      • Kerberos: 認証に Kerberos を使用します。 Kerberos サーバーと kinit による認証が必要です。

      • SYSDBA: SYSDBA として接続します。

      • SYSOPER: SYSOPER として接続します。

      • No auth: 認証は必要ありません。

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

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

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

      「空に設定」コンテキストメニューアクション

    3. URL​ フィールドで、PyCharm は他の接続設定の値を使って JDBC URL を自動生成します。

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

      URL 形式について詳しくは、 Oracle​ 公式ドキュメント を参照してください。

    データベース接続の詳細

    一般 および データソースおよびドライバー ダイアログ (Shift+Enter) の他のタブの接続設定とプロパティに関する参考情報については、 接続設定と DBMS 固有のプロパティ を参照してください。

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

    テスト接続リンク

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

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

    データソースとドライバーの「スキーマ」タブダイアログ

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

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

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

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

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

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

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

接続設定

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

DBMS 固有のプロパティ

一般タブ

項目

説明

接続タイプ

ドライバー

Oracle​ JDBC ドライバーモードのリスト。

  • SID​

  • サービス名

  • TNS​

  • Long​

SID​

Oracle​ インスタンス（ワークステーション上で実行されるプロセス）の一意の名前。 正しい値については、サーバーホストの環境変数 ORACLE_SID を確認するか、データベース管理者に問い合わせてください。 一般的に使用される値は XE または ORCL です。

SID​

サービス

Oracle​ インスタンス（または複数のインスタンス）へのエイリアス。

サービス名

TNSADMIN

tnsnames.ora 構成ファイルが含まれるフォルダーへのパス。 tnsnames.ora の詳細については、「tnsnames.ora ファイルのローカル命名パラメーター(英語) 」を参照してください。

TNS​

TNS name

複数のサービスがある場合に接続で使用するサービス名。 サービス名を見つけるには、 tnsnames.ora の net_service_name の値を参照してください。

2026 年 6 月 1 日
MySQL 5.1 に接続できませんOCI を使用して Oracle データソースを作成する