DataGrip 2024.1 ヘルプ

Oracle

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

このトピックでは、DataGrip で Oracle データベースに接続するためのデータソースを作成し、テスト接続を実行する方法に関する一般的な手順を説明します。必要な前提条件がすでに満たされており、データベースが稼働していることを前提としています。例: マシン上でデータベースを実行し、そのデータベースに接続する場合は、対応する DBMS ソフトウェアを最初にマシンにインストールする必要があります。

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

  1. データベースに接続するには、接続の詳細を保存するデータソースを作成します。これは、次のいずれかの方法で実行できます。

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

    • データベースエクスプローラー ( 表示 | ツールウィンドウ | データベースエクスプローラー ) で、ツールバーの新規アイコン (the New icon) をクリックします。データソースに移動し、Oracle を選択します。

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

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

      Oracle の場合、サポートされているドライバーは Oracle および Oracle 9.X、10.X、11.1 用です。ドライバーの種類の詳細については、「Oracle JDBC の FAQ(英語)」を参照してください。

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

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

      • サービス名 : Oracle インスタンス(または多数のインスタンス)への別名を使用します。

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

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

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

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

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

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

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

    The Download missing driver files link

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

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

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

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

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

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

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

    4. ドライバーリストから、接続で使用する Oracle JDBC ドライバーモードを選択します。

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

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

    5. 認証リストから、接続の認証に使用する認証方法を選択します。次のオプションが利用可能です。

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

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

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

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

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

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

      the Set Empty context menu action
    7. URL フィールドでは、DataGrip は他の接続設定の値を使用して 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 公式ドキュメント(英語)」を参照してください。

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

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

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

    4. ドライバーリストから、接続で使用する Oracle JDBC ドライバーモードを選択します。

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

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

    5. 認証リストから、接続の認証に使用する認証方法を選択します。次のオプションが利用可能です。

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

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

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

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

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

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

      the Set Empty context menu action
    7. URL フィールドでは、DataGrip は他の接続設定の値を使用して 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 公式ドキュメント(英語)」を参照してください。

    Database connection details
    1. TNSADMIN フィールドに、tnsnames.ora を使用してフォルダーへのパスを指定します。または、開くアイコン (the Open button) をクリックしてそこに移動します。

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

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

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

    3. ドライバーリストから、接続で使用する Oracle JDBC ドライバーモードを選択します。

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

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

    4. 認証リストから、接続の認証に使用する認証方法を選択します。次のオプションが利用可能です。

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

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

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

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

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

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

      the Set Empty context menu action
    6. URL フィールドでは、DataGrip は他の接続設定の値を使用して JDBC URL を自動的に生成します。

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

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

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

      URL 形式の詳細については、「Oracle 公式ドキュメント(英語)」を参照してください。

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

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

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

    4. ドライバーリストから、接続で使用する Oracle JDBC ドライバーモードを選択します。

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

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

    5. 認証リストから、接続の認証に使用する認証方法を選択します。次のオプションが利用可能です。

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

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

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

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

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

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

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

      URL 形式の詳細については、「Oracle 公式ドキュメント(英語)」を参照してください。

    Database connection details
    1. 認証リストから、接続の認証に使用する認証方法を選択します。次のオプションが利用可能です。

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

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

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

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

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

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

      the Set Empty context menu action
    3. URL フィールドでは、DataGrip は他の接続設定の値を使用して JDBC URL を自動的に生成します。

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

      URL 形式の詳細については、「Oracle 公式ドキュメント(英語)」を参照してください。

    Database connection details

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

  5. 提供された詳細を使用してデータベースへの接続を確立できることを確認します。これを行うには、接続の詳細領域の下部にある接続のテストリンクをクリックします。

    Test Connection link

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

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

    Schemas tab of the Data Sources and Drivers dialog
  7. OK をクリックして、データソースを作成します。

  8. データベースエクスプローラー ( ⌘ 1) で新しいデータソースを見つけます。

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

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

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

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

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

接続設定

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

DBMS 固有のプロパティ

一般タブ

項目

説明

接続タイプ

ドライバー

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

  • SID

  • サービス名

  • TNS

  • Long

SID

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

SID

サービス

Oracle インスタンス (または複数のインスタンス) のエイリアス。

サービス名

TNSADMIN

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

TNS

TNS 名

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

オプションタブ

項目

説明

DBMS_OUTPUT の有効化

データベースの DBMS_OUTPUT を有効にします。

関連ページ:

DataGrip のクイックスタート

このクイックスタートガイドでは、主要な概念を紹介し、DataGrip での最初のステップを支援します。また、IDE に関するすべての主要なトピック(データソースの追加、接続オプションの構成、エディターでの作業、プラグインのインストール)をカバーする紹介ビデオを確認できます。前提条件:このクイックスタートガイドを完了するには、次のソフトウェアがインストールされていることを確認してください。DataGrip 2021.3 以降 -https://www.jetbrains.com/datagrip...

データベースへの接続

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

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

データソースおよびドライバーダイアログにアクセスするには、次のいずれかのアクションを実行します。データベースエクスプローラー (表示 | ツールウィンドウ | データベースエクスプローラー) で、データソースのプロパティボタンをクリックします。データベースエクスプローラー (表示 | ツールウィンドウ | データベースエクスプローラー) で、追加ボタンをクリックし、に移動します。に移動します。概要:データソースおよびドライバーダイアログでは、データソースとデータベースドライバを管理できます。左ペイン...

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

より正確で素早い回答のためにトラブルシューティング資料をアタッチすることを検討してください。ログファイル、スクリーンショット、アニメーション、ビデオ、データベースダンプなどの資料が調査に役立ちます。DataGrip バージョンとシステム情報をコピーする以下のアクションを使用して、製品およびシステム情報を取得できます。製品のヘルプメニューを使用します。macOS の場合は、をクリックします。、をクリックし、と入力して、を押します。、コピーアイコンをクリックして、Youtrack チケット、メール...

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

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

JDBC ドライバー

DataGrip には、インストールパッケージのサイズを小さくし、IDE バージョンごとにドライバーのバージョンを最新に保つために、バンドルされたドライバーは含まれていません。JDBC ドライバーは、IDE 経由または手動でダウンロードできます。データソースおよびドライバーダイアログ () でデータベース接続用の新しいデータソースを作成すると、不足しているドライバーをダウンロードするためのリンクが DataGrip によって提供されます。直接ダウンロードリンクについては、JetBrains JD...