データソースおよびドライバーダイアログ
データソースおよびドライバー ダイアログにアクセスするには、次のいずれかのアクションを実行します。
データベースエクスプローラー で、 データソースのプロパティ ボタン
をクリックします。データベースエクスプローラー で、 追加 ボタン
をクリックし、 に移動します。に移動します。
概要
データソースおよびドライバー ダイアログでは、 データソースとデータベースドライバを管理できます。
左ペインのコントロール
データソースとドライバーのリストから項目を選択すると、その項目の設定がダイアログの右側に表示されます。
ツールバー
項目 | ショートカット | 説明 |
|---|---|---|
| Alt+Insert | データソースまたはドライバを作成します。 |
| Delete | 選択したアイテムをリストから削除します。 |
| Ctrl+D | 選択したデータソースまたはドライバのコピーを作成します。 |
| Ctrl+B | 選択したデータソースに関連付けられているドライバ設定に移動します。 |
| 選択したデータソースをグローバルレベルまたはプロジェクトレベルに移動します。 グローバルレベルとプロジェクトレベルの詳細については、 データソース を参照してください。 | |
| 最近使用したアイテムを切り替えます。 |
コンテキストメニュー
項目 | ショートカット | 説明 |
|---|---|---|
| Alt+Insert | データソースまたはドライバを作成します。 |
| Delete | 選択したアイテムをリストから削除します。 |
| Ctrl+D | 選択したデータソースまたはドライバのコピーを作成します。 |
| Ctrl+B | 選択したデータソースに関連付けられているドライバ設定に移動します。 |
| 選択したデータソースをグローバルレベルまたはプロジェクトレベルに移動します。 グローバルレベルとプロジェクトレベルの詳細については、以下を参照してください | |
ドライバーの変更 | データソースをドライバに関連付けます。 | |
| Ctrl+Alt+Z | 選択した項目の変更を元に戻します。 |
ソースのロード | 選択したカテゴリのスキーマのデータベースオブジェクトのソースコードをロードします。 | |
| Alt+F7 | 選択したドライバを使用するデータソースを表示します。 |
リセットの変更
ドライバーの使用箇所を表示データソース
データソース セクションには、通常のデータソースと DDL データソースの設定が含まれます。
標準
通常のデータソースの設定ペインには、 一般、 オプション、 SSH/SSL、 スキーマ、 拡張 のタブが含まれます。
通常のデータソースの管理および作成の詳細については、 データソース を参照してください。 特定のデータベースの接続設定の詳細については、専用のトピックを参照してください。
- 異なるデータベースのデータソースの作成と設定
一般
一般 タブには、データベース接続のために指定する必要がある設定が含まれています。
タブ上のフィールドとコントロールのセットは、 接続タイプ リストで選択されたオプションによって異なります。
項目 | 説明 |
|---|---|
接続タイプ | データベース接続に使用する接続タイプ。
|
ドライバー | 接続に使用するドライバーを ドライバー リストから指定します。 |
ファイル | データベースファイルへのパス。 開く アイコン（ 保存 アイコン（ |
パス | データベースファイルまたはフォルダーへのパス。 開く アイコン（ |
ホスト | データベースが配置されているコンピューターのホスト名 (ドメイン名) または IP アドレス (IPv4 または IPv6)。 データベースがローカルコンピューター上にある場合は、 localhost または 127.0.0.1 を指定します。 SSH を使用している場合は、SSH プロキシが実行されているコンピューターから、指定されたドメイン名または IP アドレスでデータベースホストにアクセスできる必要があります。 SSH/SSL タブを参照してください。 |
ポート | データベースのポート番号。 |
データベース | ターゲットデータベースまたはスキーマの名前。 |
ユーザー | データベースユーザーアカウントの名前。 |
パスワード | データベースユーザーのパスワード。 |
保存 | パスワードフィールドの設定を保存します。 パスワードを保存するために次のオプションを選択できます。
|
データベースの作成 | URL に引数を追加してデータベースを作成します。 このオプションは、一部のデータベース管理システム（Apache Derby (埋め込み) など）でのみ使用可能です。 |
URL | DataGrip がデータベースに接続するために使用する URL。 URL を指定するためのユーザーインターフェースは、 接続タイプ リストで選択されているオプションによって異なります。 |
接続のテスト | データベース接続設定が正しく、DataGrip がデータベースと通信できることを確認します。 通信情報をコピーするには、 Copy をクリックします。 |
）を使用して、既存のデータベースファイルを選択します。
）または Ctrl+F2 を押すと、接続を終了できます。オプション
オプション タブには、データベース接続の設定が含まれています。
タブ上のフィールドとコントロールのセットは、 接続タイプ リストで選択されたオプションによって異なります。
項目 | 説明 |
|---|---|
接続 | |
読み取り専用 | 読み取り専用ステータスを設定します。 データソースを偶発的なデータ変更から保護するには、このチェックボックスをオンにします。 チェックボックスが選択されていると、 データエディターのデータを変更することはできません。 ドライバーが読み取り専用ステータスをサポートしていない場合、 クエリコンソール でデータの変更が可能になる場合があります。 |
トランザクション制御 | データベーストランザクションの 分離レベル(英語)と、トランザクションのコミット方法のモードを設定します。 トランザクションモード:
利用可能なトランザクション分離レベルのリストは、DBMS によって異なります。 |
スキーマの切り替え | DataGrip がスキーマを切り替える際に使用するモードを定義します。
|
タイムゾーン | データソースで使用するタイムゾーンを選択します。 例: データソースが接続されているホストのタイムゾーンを選択します。 |
単一セッションモード | 単一セッションモード を有効にします。 単一セッションモードは、データソースとすべてのクエリコンソールsが同じセッションを使用することを意味します。 このモードでは、データベースツリー内の一時オブジェクトを確認したり、異なる クエリコンソールs で同じトランザクションを使用したりできます。 クエリコンソールs の詳細については、 クエリコンソール を参照してください。 |
キープアライブクエリの実行間隔 | 接続を維持するためにキープアライブクエリを実行します。 サポートされていないデータベースのドライバ設定でカスタムクエリを定義できます。 |
次の時間が経過したら自動切断 | 指定された秒数後にデータベースから切断します。 |
単一データベースモード | データベースツリービューで、接続設定に指定したデータベースのみを表示かつ有効にします。 データソースに接続すると、DataGrip はデータソースが持つ全データベースを取得し表示できます。 ただし、場合によっては（たとえば、PgBouncer の特定の設定を使用して）、特定のデータベースでのみ操作できるか、許可されています。 単一データベースモード が有効になっているデータベースツリービューには、接続設定で指定したデータベースのみが表示されます。 PostgreSQL、Azure SQL Database、Greenplum、Amazon Redshift でこの設定の使用を検討してください。 |
スタートアップスクリプト | 接続を確立するたびに SQL クエリを実行します。 起動スクリプトで 組み込み IDE マクロを使用するには、 マクロの挿入 をクリックします。 メモ： 単一セッションモード チェックボックスをオフにすると、新しい クエリコンソール ごとに新規接続が作成されます。 |
イントロスペクション | |
自動同期 | データベースの実際の状態を自動的に同期します。 データベースの状態とは、 データベースエクスプローラー に表示されるデータベースツリービューを意味します。 自動同期 チェックボックスが選択されている場合、データソースのビューは自動的に更新されます。
自動同期 チェックボックスがオフの場合、 データベースエクスプローラー のデータソースのビューは、ツールバーの リフレッシュ ボタン ( |
ソースのロード | 選択したスキーマのカテゴリのビュー、プロシージャ、パッケージ、その他のデータベースオブジェクトのソースコードを読み込みます: すべてのスキーマ（すべてのスキーマ ）、システムスキーマを除くすべてのスキーマ（すべての除外対象システムスキーマ ）、または機能を無効にします（なし）。 複数のデータソースのこの設定を同時に変更するには、対応するデータソースを選択します。 選択を右クリックして ソースのロードに移動してオプションを選択します。 |
デフォルトレベル | データベースオブジェクトのデフォルトのイントロスペクションレベル。 イントロスペクションレベルの詳細については、 イントロスペクションレベル トピックを参照してください。 |
セッションテンプレートを使用する | セッションに使用する テンプレートを選択します。 |
古い DDL の編集時に警告する | キャッシュされた DDL がデータベース内の実際の DDL と異なる場合は通知を表示します。 ソースコードを開くたび、DataGrip はインデックス作成時に読み込まれたバージョンを表示します。 ただし、別のワークステーションからソースコードが変更されると、インデックスされたバージョンは古くなります。 自分のバージョンがデータベース内のバージョンより古い場合、次の通知が表示されます： |
データベース / スキーマの作成と削除を追跡する | スキーマを作成・削除・名前変更した場合、DataGrip はイントロスペクションスコープウィンドウ内の利用可能なスキーマリストを更新します。 イントロスペクションスコープを表示するには、 データベースエクスプローラー のデータソース名の近くにあるボタンをクリックします。  |
イントロスペクトされていないシステムカタログに事前イントロスペクト済みのオブジェクトを使用する | システムカタログ用に事前イントロスペクト済みオブジェクトの利用を切り替えます。 イントロスペクションとシステムカタログの詳細については、 システムカタログから事前にイントロスペクトされたオブジェクト を参照してください。 |
自動イントロスペクション間隔 N 分 | 指定された分数に 1 回、データソースのイントロスペクションを実行します。 |
仮想オブジェクトと属性 | 仮想外部キーの関係、仮想列の式、仮想ビューのステートメントを格納する external-data.xml へのパスを定義します。 仮想データベースオブジェクトの詳細については、 仮想オブジェクトセクションのトピックを参照してください。 |
その他 | |
コードスタイル | スキーマに使用するコードスタイルを選択します。 コードスタイルのカスタマイズの詳細については、「SQL のコードスタイル 」を参照してください。 |
接続前 | 最初の接続前（JDBC ドライバーが動作するプロセス開始時）に DataGrip が実施するタスクを選択します。 タスクは順番に実行されます。 |
セッションテンプレート | セッションのテンプレートを作成します。 テンプレート設定は、データソースの一般的な接続設定を上書きします。 テンプレートでは、次のオプションを設定できます: 認証、 読み取り専用、 スタートアップスクリプト、 ドライバー。 |
) をクリックするか、 Ctrl+F5 を押した場合にのみ、データベースの実際の状態と同期されます。SSH/SSL
SSH/SSL タブには、 SSH または SSL 接続の設定が含まれています。
SSH
項目 | 説明 |
|---|---|
SSH トンネルを使用 | SSH 経由の接続を有効にするには、このチェックボックスをオンにします。 次に、リストから作成された SSH 構成の 1 つを選択するか、 |
SSH 構成 | 接続で使用する SSH 構成を選択します。 新しい SSH 構成を作成するには、 SSH 構成を追加する ボタン ( 既存の SSH 構成をコピーするには、 Copy ボタン ( |
ローカルポート | 接続の転送元となるローカルポート番号を指定します。 デフォルト値はなく、DataGrip がポート番号を動的に選択します。 |
SSL
項目 | 説明 |
|---|---|
SSL トンネルを使用 | SSL 接続を設定するための設定を有効にします。 |
コピー | 既存のデータソースから SSH 設定をコピーします。 リンクをクリックして該当するデータソースを選択してください。 |
CA ファイル | SSL 認証局（CA）証明書ファイルへのパスを指定してください。 証明書ファイルは、サーバーで使用されているものと同じ証明書でなければなりません。 |
トラストストアを使用する | トラストストアに含まれる証明書を利用するためのトラストストアを選択します。
JAVA および システム 証明書は更新が必要な場合があります。 |
クライアント証明書ファイル | （クライアント）公開鍵証明書ファイルへのパスを指定してください。 |
クライアントキーファイル | （クライアント）秘密鍵ファイルへのパスを指定します。 |
スキーマ
データベースエクスプローラー に表示するデータベースと スキーマを選択(英語)します。
項目 | 説明 |
|---|---|
| データベースとスキーマのリストをリフレッシュします。 |
| すべてのツリーのすべてのノードを展開します。 |
| すべてのツリーのすべてのノードを折りたたみます。 |
| ツリー内のコンテンツをフィルタリングします。 指定されたテキストが名前に含まれるデータベースとスキーマのみが表示されます。 |
スキーマパターン | 必要なデータベースとスキーマを選択するパターンを定義します。 使用する構文に関する情報を取得するには、フィールドにキャレットを置き、 Ctrl+Q を押します。
次の例を参照してください：
|
オブジェクトフィルター | 各データソースの データベースエクスプローラー に表示されるテーブルおよびその他のデータベースオブジェクトのセットを制限します。 例: 解決範囲を 他のすべてのテーブルは範囲外になります。 DataGrip は データベースエクスプローラー に表示されないオブジェクトは解決しません。  オブジェクトフィルター フィールドの式を作成するときは、次のパターンを使用してください。
|
内部システムスキーマの表示 | 内部システムスキーマ（たとえば、 |
テンプレートデータベースの表示 | テンプレートデータベース（たとえば、 |
拡張
拡張 タブには、JVM データベースドライバの接続プロパティ、オプション、環境変数が含まれます。
拡張 タブのテーブルには、キーと値のペアでデータベースドライバに渡される接続オプションが表示されます。
名前 列のセルを選択すると、対応するオプションの説明が表に表示されます。
行を追加するには、<user defined> と <value> が表示されている最後の行の値の編集を始めます。 新しい行がテーブルに自動的に追加されます。
項目 | 説明 |
|---|---|
VM オプション | データベースドライバの JVM オプション。 特定の Oracle データベースバージョン（たとえば、Oracle バージョン 9）では、あなたのデータベースサーバーが異なるタイムゾーンにあるときに接続問題があるかもしれません。 VM オプション フィールドでタイムゾーンのタイムオフセットを指定できます（たとえば、 |
VM 環境 | データベースドライバ JVM の環境変数。 例: Oracle データベースのエンコード関連の問題は、 |
作業ディレクトリ | データソースの操作を処理するプロセスの作業ディレクトリ。 また、すべての相対パスは、このディレクトリを基準にして解決されます（たとえば、ドライバープロパティのパス）。 例: SQLite のようなファイルベースのデータベースを作成する際、SQLITE ファイルのパスを設定しなければファイルはこの作業ディレクトリに作成されます。 |
詳細については、DBMS のドキュメントを参照してください。
DDL データソース
DDL データソースはその名前で定義され、DDL ファイルや別のデータソース（親データソース）を参照できます。
項目 | 説明 |
|---|---|
名前 | データソース名 |
ソース | 必要な DDL 定義を含むファイルのリスト。
|
拡張 | 必要に応じて、 拡張 リストで別のデータソースを親として選択することもできます。 その結果、編集しているデータソースは、その親からすべての DDL 定義を継承します。 親データソースを使用しない場合は、 <なし> を選択します。 |
（Alt+Up）。 選択したファイルをリスト内で上に移動します。
（Alt+Down）。 選択したファイルをリスト内で下に移動します。データソーステンプレート
データソース テンプレートは、 JetBrains Accountに保存されます。
- 名前
テンプレートの名前。
- データソースの作成
テンプレートを使用して新しいデータソースを作成します。
一般
データソース セクションと同様ですが、 ユーザー および パスワード フィールドは除きます。
拡張
データソース のセクションと同じです。
クラウドたち
構成設定
接続設定はクラウドプロバイダーによって異なります。 設定の詳細については、 クラウドたち セクションのプロバイダーのトピックを参照してください。
項目 | 説明 |
|---|---|
接続のテスト | クラウドプロバイダーの接続設定が正しいこと、およびDataGripがそのアカウントへの接続を確立できることを確認します。 |
次へ: データベースを選択 | データベース タブに切り替えると、DataGrip はクラウドプロバイダーアカウントで利用可能なデータベースを表示します。 |
データベース
タブのデータベースペインに、DataGripはクラウドプロバイダーアカウントで使用可能なデータベースを表示します。
項目 | 説明 |
|---|---|
| データベースリストをフィルタリングします。 指定されたテキストが名前に含まれるデータベースとスキーマのみが表示されます。 |
| クラウドプロバイダーに保存されているデータベースのリストをリフレッシュします。 |
データソースの作成 | データベースペインで選択したデータベースのデータソースを作成し、接続設定を自動的に入力して作成します。 |
ドライバー
ドライバーの設定ペインには、 一般、 オプション、 拡張 のタブがあります。
一般
一般 タブには、ドライバファイル、URL テンプレート、ドライバクラスの設定が含まれています。
項目 | 説明 |
|---|---|
クラス | 使用するドライバクラスの完全修飾名。 |
ドライバーファイル | DataGrip は JDBC ドライバー を利用してデータベースとやり取りします。 DataGrip ドライバリポジトリからドライバをダウンロードして使うか、コンピュータに保存したドライバを指定できます。 最新のドライバーバージョンをダウンロードして使用するには、 バージョン N をダウンロード リンクです。 特定のバージョン番号のドライバを指定して使用することもできます。 ver. <version_number> リンクをクリックして、使用するドライバのバージョンを選択してください。 選択したバージョンが自動的にダウンロードされて適用されます。 コンピューターですでに利用可能なドライバーを使用できます。 その場合は、 追加 ボタン |
URL テンプレート | データベース URL を構築するために使用されるテンプレート。 巻き括弧のテキストは変数を表します。 次の例を参照してください：
オプションのフラグメントは角括弧で囲まれています (例: テンプレート名は、 URL オプションリストのオプションの名前に対応しています。 |
オプション
項目 | 説明 |
|---|---|
接続 | |
トランザクション制御 | データベーストランザクションの 分離レベル(英語)と、トランザクションのコミット方法のモードを設定します。
|
スキーマの切り替え | DataGrip がスキーマを切り替える際に使用するモードを定義します。
|
スタートアップスクリプト | 接続を確立するたびに実行される SQL クエリ。 メモ： 単一セッションモード チェックボックスをオフにすると、新しい クエリコンソール ごとに新規接続が作成されます。 |
Keep-alive クエリ | 接続を維持するために実行されるキープアライブクエリ。 |
イントロスペクション | |
自動同期 | 自動同期オプションのデフォルト設定。 |
ソースのロード | 選択したカテゴリのスキーマのデータベースオブジェクトのソースコードをロードします。 |
アプリケーション情報の送信 | このチェックボックスをオンにすると、データベースサーバーに接続時、DataGrip は自分に関する情報を送信します。 |
接続 | |
ダイアレクト | 対応するデータソースに関連付けられている SQL 言語。 |
コードスタイル | このドライバーを使用するデータソースに使用するコードスタイルを選択します。 コードスタイルのカスタマイズの詳細については、「SQL のコードスタイル 」を参照してください。 |
同期後のソースを整形 | 同期後、データベースオブジェクトのソースコードにコードスタイルを適用します。 |
拡張
拡張 タブには、JVM オプション・環境変数、およびキーと値のペアとしてデータベースドライバへ渡せるオプションが含まれます。
テーブル内の値の編集を開始するには、対応する 値 フィールドをダブルクリックします。
行を追加するには、最後の行にある「<user defined>」と「<value>」の値を編集してください。 新しい行が自動的にテーブルに追加されます。
項目 | 説明 |
|---|---|
VM オプション | データベースドライバが実行される JVM のデフォルトオプション。 ドライバは JVM 内の独立したプロセスとして起動されます。 |
VM 環境 | データベースドライバ JVM の環境変数。 例: Oracle データベースのエンコード関連の問題は、 |
高度なオプション
項目 | 説明 |
|---|---|
インクリメンタルのイントロスペクションを無効化 | 増分イントロスペクションを実行しないでください。 このオプションは Oracle、Microsoft SQL Server 、PostgreSQL などのデータベースで利用できます。 インクリメンタルイントロスペクションでは、イントロスペクターは、前回のイントロスペクション後にデータベースで変更されたオブジェクトを検出し、これらのオブジェクトのみをロードします。 このオプションを有効にすると、イントロスペクターは常にすべてのオブジェクトをロードします。 イントロスペクション時間が大幅に増える可能性があります。 |
pgdatabase へのクエリで xmin を使用しないでください |
|
JDBC メタデータを使用してイントロスペクションする | JDBC ベースのイントロスペクターに切り替えます。 すべてのデータベースで利用できます。 データベースオブジェクト（DB メタデータ）情報を取得するため、DataGrip は以下のイントロスペクターを使用します：
ネイティブイントロスペクターが失敗したり利用できない場合は、JDBC ベースのイントロスペクターもご検討ください。 データベースサーバーのバージョンが DataGrip でサポートされる最小バージョンより古い場合は、ネイティブイントロスペクターが失敗することがあります。 JDBC ベースのイントロスペクターに切り替えて、データベースからデータベース構造情報を取得する際の問題を解決してみることができます。 例: データベースに存在するスキーマ、またはスキーマレベルのデータベースオブジェクトが データベースエクスプローラー に表示されない場合。 |
クラスパスの分離 | JDBC ドライバーにより使用されるクラスパスの分離。 |
IDE のプロキシ設定を利用する | IDE のプロキシ設定を JDBC プロセスに渡します。 |
Kubernetes
DataGrip を利用して、Kubernetes クラスター内で動作するデータベースに接続できます。
Kubernetes タブは、専用ポートを持たない組み込みデータベース (SQLite、Apache Derby、または HSQLDB など) では利用できません。
項目 | 説明 |
|---|---|
Kubernetes ポート転送を使用 | ポート転送を有効にします。 |
クラスター | 使用する Kubernetes クラスターを選択します。 |
名前空間 | 使用可能なリソースのセットを決定する名前空間を選択します。 |
リソースタイプ | リソースのタイプを選択します。 |
リソース | 接続するリソースを選択します。 |
ホストポート | データを送受信するローカルポートを入力します。 |
コンテナーポート | クラスターリソースのリモートポートを入力します。 |
DDL マッピング
項目 | 説明 |
|---|---|
名前 | DDL マッピング名。 |
データソース | 通常のデータソースを設定します。 |
DDL データソース | DDL データソースを設定します。 |
スコープ | DDL データソース SQL ファイルにマップされる通常のデータソースデータベースオブジェクトのスコープを設定します。 |
問題
データソースおよびドライバー ダイアログで、データソースに潜在的な問題が検出されると、 問題 メニューオプションの横に番号が表示されます。 問題 をクリックすると、問題のリストと、解決するためのオプションが表示されます。
