データソースおよびドライバーダイアログ
データベースツールおよび SQL プラグインを有効にする
この機能は PyCharm にデフォルトでバンドルされ有効になっている データベースツールおよび SQL プラグインに依存しています。 関連機能が利用できない場合は、プラグインが無効になっていないことを確認してください。
Ctrl+Alt+S を押して設定を開き、 を選択します。
インストール済み タブを開き、 データベースツールおよび SQL プラグインを見つけて、プラグイン名の横にあるチェックボックスを選択します。
データソースおよびドライバー ダイアログにアクセスするには、次のいずれかのアクションを実行します。
データベース ツールウィンドウで、 Data Source Properties ボタン
をクリックします。データベース ツールウィンドウで、 追加 ボタン
をクリックし、 に移動します。
概要
データソースおよびドライバー ダイアログでは、 データソースとデータベースドライバを管理できます。
左ペインのコントロール
データソースとドライバーのリストから項目を選択すると、その項目の設定がダイアログの右側に表示されます。
ツールバー
項目 | ショートカット | 説明 |
|---|---|---|
| Alt+Insert | データソースまたはドライバーを作成します。 |
| Delete | 選択したアイテムをリストから削除します。 |
| Ctrl+D | 選択したデータソースまたはドライバのコピーを作成します。 |
| Ctrl+B | 選択したデータソースに関連付けられているドライバ設定に移動します。 |
| 選択したデータソースをグローバルレベルまたはプロジェクトレベルに移動します。 グローバルレベルとプロジェクトレベルの詳細については、 データソース を参照してください。 | |
| 最近使用したアイテムを切り替えます。 |
コンテキストメニュー
項目 | ショートカット | 説明 |
|---|---|---|
| Alt+Insert | データソースまたはドライバーを作成します。 |
| Delete | 選択したアイテムをリストから削除します。 |
| Ctrl+D | 選択したデータソースまたはドライバのコピーを作成します。 |
| Ctrl+B | 選択したデータソースに関連付けられているドライバ設定に移動します。 |
| 選択したデータソースをグローバルレベルまたはプロジェクトレベルに移動します。 グローバルレベルとプロジェクトレベルの詳細については、以下を参照してください | |
Change Driver | データソースをドライバに関連付けます。 | |
| Ctrl+Alt+Z | 選択した項目の変更を元に戻します。 |
Load Sources | 選択したカテゴリのスキーマに対するデータベースオブジェクトのソースコードをロードします。 | |
| Alt+F7 | 選択したドライバを使用するデータソースを表示します。 |
Reset Changes
Show Driver Usagesデータソース
データソース セクションには、通常のデータソースと DDL データソースの設定が含まれます。
標準
通常のデータソースの設定ペインには、 一般、 オプション、 SSH/SSL、 スキーマ、 拡張生 advanced のタブが含まれます。
通常のデータソースの管理と作成の詳細については、 データソース を参照してください。 特定のデータベースの接続設定の詳細については、専用のトピックを参照してください。
- 異なるデータベースのデータソースの作成と設定
一般
一般 タブには、データベース接続のために指定する必要がある設定が含まれています。
タブ上のフィールドとコントロールのセットは、 接続タイプ リストで選択されたオプションによって異なります。
項目 | 説明 |
|---|---|
接続タイプ | データベース接続に使用する接続タイプ。
|
ドライバー | 接続に使用するドライバーを ドライバー リストから指定します。 |
ファイル | データベースファイルへのパス。 オープン アイコン（ 保存 アイコン（ |
パス | データベースファイルまたはフォルダーへのパス。 オープン アイコン（ |
ホスト | データベースが配置されているコンピューターのホスト名 (ドメイン名) または IP アドレス (IPv4 または IPv6)。 データベースがローカルコンピューター上にある場合は、 localhost または 127.0.0.1 を指定します。 SSH を使用している場合は、SSH プロキシが実行されているコンピューターから、指定されたドメイン名または IP アドレスでデータベースホストにアクセスできる必要があります。 SSH/SSL タブを参照してください。 |
ポート | データベースのポート番号。 |
データベース | ターゲットデータベースまたはスキーマの名前。 |
ユーザー | データベースユーザーアカウントの名前。 |
パスワード | データベースユーザーのパスワード。 |
保存 | パスワードフィールドの設定を保存します。 パスワードを保存するために次のオプションを選択できます。
|
データベースの作成 | URL に引数を追加してデータベースを作成します。 このオプションは、一部のデータベース管理システム（Apache Derby (埋め込み) など）でのみ使用可能です。 |
URL | PyCharm がデータベースに接続する際に使用する URL。 URL を指定するためのユーザーインターフェースは、 接続タイプ リストで選択されているオプションによって異なります。 |
接続のテスト | データベース接続設定が正しく、PyCharm がデータベースと通信できることを確認します。 通信情報をコピーするには、 コピー をクリックします。 |
）を使用して、既存のデータベースファイルを選択します。
）または Ctrl+F2 を押すと、接続を終了できます。オプション
オプション タブには、データベース接続の設定が含まれています。
タブ上のフィールドとコントロールのセットは、 接続タイプ リストで選択されたオプションによって異なります。
項目 | 説明 |
|---|---|
接続 | |
読み取り専用 | 読み取り専用ステータスを設定します。 データソースを偶発的なデータ変更から保護するには、このチェックボックスをオンにします。 チェックボックスが選択されていると、 データエディターのデータを変更することはできません。 ドライバーが読み取り専用ステータスをサポートしていない場合、 クエリコンソール でデータの変更が可能になる場合があります。 |
Transaction control | データベーストランザクションの 分離レベル(英語)と、トランザクションのコミット方法のモードを設定します。 Transaction modes:
The list of available transaction isolation levels depends on the DBMS. |
Switch schema | PyCharm がスキーマを切り替えるために使用するモードを定義します。
|
タイムゾーン | データソースで使用するタイムゾーンを選択します。 例: データソースが接続されているホストのタイムゾーンを選択します。 |
単一セッションモード | 単一セッションモード を有効にします。 単一セッションモード とは、データソースとすべての クエリコンソールs が同じセッションを使用することを意味します。 このモードでは、データベースツリー内の一時オブジェクトを確認したり、異なる クエリコンソール で同じトランザクションを使用したりできます。 クエリコンソール の詳細については、 クエリコンソール を参照してください。 |
Run keep-alive query each | 接続を維持するためにキープアライブクエリを実行します。 サポートされていないデータベースのドライバ設定でカスタムクエリを定義できます。 |
自動切断するまでの時間 | 指定された秒数後にデータベースから切断します。 |
単一データベースモード | データベースツリービューで、接続設定で指定したデータベースのみを表示して有効にします。 データソースに接続すると、PyCharm はそのデータソースが持つすべてのデータベースを取得して表示できます。 ただし、場合によっては（たとえば、PgBouncer の特定の設定を使用して）、特定のデータベースでのみ操作できるか、許可されています。 単一データベースモード が有効になっているデータベースツリービューには、接続設定で指定したデータベースのみが表示されます。 PostgreSQL、Azure SQL Database、Greenplum、Amazon Redshift にはこの設定を使用することを検討してください。 |
スタートアップスクリプト | 接続を確立するたびに SQL クエリを実行します。 起動スクリプトで 組み込み IDE マクロを使用するには、 マクロを挿入 をクリックします。 メモ: 単一セッションモード チェックボックスがオフの場合、新しい クエリコンソール ごとに新しい接続が作成されます。 |
イントロスペクション | |
自動同期 | データベースの実際の状態を自動的に同期します。 データベースの状態とは、 データベース ツールウィンドウに表示されるデータベースツリービューを意味します。 自動同期 チェックボックスが選択されている場合、データソースのビューは自動的に更新されます。
自動同期 チェックボックスがオフの場合、ツールバーの 再読み込み ボタン |
ソースのロード | 選択したスキーマのカテゴリのビュー、プロシージャ、パッケージ、その他のデータベースオブジェクトのソースコードを読み込みます: すべてのスキーマ（すべてのスキーマ ）、システムスキーマを除くすべてのスキーマ（All excl. system schemas ）、または機能を無効にします（なし）。 複数のデータソースのこの設定を同時に変更するには、対応するデータソースを選択します。 選択を右クリックして ソースのロードに移動してオプションを選択します。 |
デフォルトレベル | データベースオブジェクトのデフォルトのイントロスペクションレベル。 |
セッションテンプレートを使用する | セッションに使用する テンプレートを選択します。 |
Warn when editing outdated DDL | キャッシュされた DDL がデータベース内の実際の DDL と異なる場合は通知を表示します。 ソースコードを開くたびに、PyCharm はインデックス作成中に読み込まれたバージョンを表示します。 ただし、別のワークステーションからソースコードが変更されると、インデックスされたバージョンは古くなります。 バージョンがデータベース内のものより古い場合、次の通知が表示されます: |
Track databases/schemas creation and deletion | スキーマを作成・削除・名前変更すると、PyCharm はイントロスペクションスコープウィンドウで利用可能なスキーマ一覧を更新します。 イントロスペクションスコープを表示するには、 データベース ツールウィンドウのデータソース名の近くにあるボタンをクリックします。  |
Use pre-introspected objects for system catalogs that are not introspected | システムカタログの事前イントロスペクトされたオブジェクトの使用を切り替えます。 イントロスペクションとシステムカタログの詳細については、 システムカタログから事前にイントロスペクトされたオブジェクト を参照してください。 |
自動イントロスペクション間隔 N 分 | 指定された分数に 1 回、データソースのイントロスペクションを実行します。 |
Virtual objects and attributes | 仮想外部キーの関係、仮想列の式、仮想ビューのステートメントを格納する external-data.xml へのパスを定義します。 仮想データベースオブジェクトの詳細については、 仮想オブジェクトセクションのトピックを参照してください。 |
その他 | |
コードスタイル | スキーマに使用するコードスタイルを選択します。 コードスタイルのカスタマイズの詳細については、「SQL のコードスタイル 」を参照してください。 |
Before connection | 最初の接続前（JDBC ドライバーが動作するプロセス開始時）に PyCharm が実行するタスクを選択します。 タスクは順番に実行されます。 |
セッションテンプレート | セッションのテンプレートを作成します。 テンプレート設定は、データソースの一般的な接続設定を上書きします。 テンプレートでは、次のオプションを設定できます: 認証、 読み取り専用、 スタートアップスクリプト、 ドライバー。 |
をクリックするか、 Ctrl+F5 を押した場合にのみ、 SSH/SSL
SSH/SSL タブには、 SSH または SSL 接続の設定が含まれています。
SSH
項目 | 説明 |
|---|---|
SSH トンネルを使用する | SSH 経由の接続を有効にするには、このチェックボックスをオンにします。 次に、リストから作成された SSH 構成の 1 つを選択するか、 |
SSH 構成 | 接続に使用する SSH 構成を選択します。 新しい SSH 構成を作成するには、 SSH 構成を追加する ボタン ( 既存の SSH 構成をコピーするには、 コピー ボタン ( |
SSL
項目 | 説明 |
|---|---|
SSL トンネルを使用 | SSL 接続を設定するための設定を有効にします。 |
コピー元 | 既存のデータソースから SSH 設定をコピーします。 リンクをクリックして対応するデータソースを選択します。 |
CA file | SSL 認証局（CA）証明書ファイルへのパスを指定してください。 証明書ファイルは、サーバーで使用されているものと同じ証明書でなければなりません。 |
トラストストアを使用する | トラストストアに含まれる証明書を使用するトラストストアを選択します。
JAVA および システム 証明書は更新が必要な場合があります。 |
Client certificate file | （クライアント）公開鍵証明書ファイルへのパスを指定してください。 |
クライアントキーファイル | （クライアント）秘密鍵ファイルへのパスを指定します。 |
スキーマ
データベースと スキーマを データベース ツールウィンドウに表示するよう選択してください。
項目 | 説明 |
|---|---|
| データベースとスキーマのリストをリフレッシュします。 |
| すべてのツリーのすべてのノードを展開します。 |
| すべてのツリーのすべてのノードを折りたたみます。 |
| ツリー内のコンテンツをフィルタリングします。 指定されたテキストが名前に含まれるデータベースとスキーマのみが表示されます。 |
Schema pattern | 必要なデータベースとスキーマを選択するパターンを定義します。 使用する構文に関する情報を取得するには、フィールドにキャレットを置き、 Ctrl+Q を押します。
次の例を参照してください：
|
オブジェクトフィルター | 各データソースの データベース ツールウィンドウに表示されるテーブルとその他のデータベースオブジェクトのセットを制限します。 たとえば、解決範囲を 他のすべてのテーブルは範囲外になります。 PyCharm は、 データベース ツールウィンドウに表示されていないオブジェクトを解決しません。  オブジェクトフィルター フィールドの式を作成するときは、次のパターンを使用してください。
|
Show internal system schemas | 内部システムスキーマ（たとえば、 |
Show template databases | テンプレートデータベース（たとえば、 |
拡張生 advanced
拡張生 advanced タブには、JVM データベースドライバーのデータベース接続プロパティ、オプション、環境変数が含まれています。
拡張生 advanced タブのテーブルには、キーと値のペアとしてデータベースドライバに渡される一連の接続オプションが表示されます。
名前 列のセルを選択すると、対応するオプションの説明が表に表示されます。
行を追加するには、<user defined> と <value> が表示されている最後の行の値の編集を始めます。 新しい行がテーブルに自動的に追加されます。
項目 | 説明 |
|---|---|
VM オプション | データベースドライバの JVM オプション。 特定の Oracle データベースバージョン（たとえば、Oracle バージョン 9）では、あなたのデータベースサーバーが異なるタイムゾーンにあるときに接続問題があるかもしれません。 VM オプション フィールドでタイムゾーンのタイムオフセットを指定できます（たとえば、 |
VM 環境 | データベースドライバ JVM の環境変数。 例: Oracle データベースのエンコード関連の問題は、 |
作業ディレクトリ | データソースの操作を処理するプロセスの作業ディレクトリ。 また、すべての相対パスは、このディレクトリを基準にして解決されます（たとえば、ドライバープロパティのパス）。 例: SQLite のようなファイルベースのデータベースを作成し、SQLITE ファイルのパスを設定しない場合、ファイルはこの作業ディレクトリに作成されます。 |
詳細については、DBMS のドキュメントを参照してください。
DDL データソース
DDL データソースはその名前で定義され、1つ以上の DDL ファイルおよび他のデータソース（親データソース）を参照できます。
項目 | 説明 |
|---|---|
名前 | データソース名 |
ソースア | 必要な DDL 定義を含むファイルのリスト。
|
拡張 | 必要に応じて、 拡張 リストで別のデータソースを親として選択することもできます。 その結果、編集しているデータソースは、その親からすべての DDL 定義を継承します。 親データソースを使用しない場合は、 <なし> を選択します。 |
（Alt+Up）。 選択したファイルをリスト内で上に移動します。
（Alt+Down）。 選択したファイルをリスト内で下に移動します。データソース テンプレート
データソーステンプレートは JetBrains Accountに保存されます。
- 名前
テンプレート名。
- データソースの作成
テンプレートを使用して新しいデータソースを作成します。
一般
データソース セクションと同様ですが、 ユーザー および パスワード フィールドは除きます。
拡張生 advanced
データソース のセクションと同じです。
クラウド
構成
接続設定はクラウドプロバイダーによって異なります。 設定の詳細については、 クラウド セクションのプロバイダーのトピックを参照してください。
項目 | 説明 |
|---|---|
接続のテスト | クラウドプロバイダーの接続設定が正しく、PyCharm がそのアカウントへ接続できることを確認します。 |
次へ: データベースを選択 | データベース タブに切り替えると、PyCharm がクラウドプロバイダーアカウントで利用可能なデータベースを表示します。 |
データベース
タブのデータベースペインに、PyCharm はクラウドプロバイダーアカウントで利用可能なデータベースを表示します。
項目 | 説明 |
|---|---|
| データベースリストをフィルタリングします。 指定されたテキストが名前に含まれるデータベースとスキーマのみが表示されます。 |
| クラウドプロバイダーに保存されているデータベースのリストをリフレッシュします。 |
データソースの作成 | データベースペインで選択したデータベースのデータソースを作成し、接続設定を自動的に入力して作成します。 |
ドライバー
ドライバーの設定ペインには、 一般、 オプション、 拡張生 advanced のタブがあります。
一般
一般 タブには、ドライバファイル、URL テンプレート、ドライバクラスの設定が含まれています。
項目 | 説明 |
|---|---|
クラス | 使用するドライバクラスの完全修飾名。 |
ドライバーファイル | PyCharm は JDBC ドライバーを使用してデータベースとやり取りします。 PyCharm ドライバリポジトリからドライバをダウンロードして使うことも、コンピューターに保存したドライバを指定することもできます。 最新のドライバーバージョンをダウンロードして使用するには、 ver. N をダウンロード リンクです。 特定のバージョン番号のドライバを指定して使用することもできます。 ver. <version_number> リンクをクリックして、使用するドライバのバージョンを選択してください。 選択したバージョンが自動的にダウンロードされて適用されます。 コンピューターですでに利用可能なドライバーを使用できます。 その場合は、 追加 ボタン |
URL templates | データベース URL を構築するために使用されるテンプレート。 巻き括弧のテキストは変数を表します。 次の例を参照してください：
オプションのフラグメントは角括弧で囲まれています (例: テンプレート名は、 URL オプションリストのオプションの名前に対応しています。 |
オプション
項目 | 説明 |
|---|---|
接続 | |
Transaction control | データベーストランザクションの 分離レベル(英語)と、トランザクションのコミット方法のモードを設定します。
|
Switch schema | PyCharm がスキーマを切り替えるために使用するモードを定義します。
|
スタートアップスクリプト | 接続を確立するたびに実行される SQL クエリ。 メモ: 単一セッションモード チェックボックスがオフの場合、新しい クエリコンソール ごとに新しい接続が作成されます。 |
Keep-alive query | 接続を維持するために実行されるキープアライブクエリ。 |
イントロスペクション | |
自動同期 | 自動同期オプションのデフォルト設定。 |
ソースのロード | 選択したカテゴリのスキーマに対するデータベースオブジェクトのソースコードをロードします。 |
Send application info | このチェックボックスを選択すると、PyCharm はデータベースサーバーへ接続する際に自分に関する情報を送信します。 |
接続 | |
ダイアレクト | 対応するデータソースに関連付けられている SQL 言語。 |
コードスタイル | このドライバーを使用するデータソースに使用するコードスタイルを選択します。 コードスタイルのカスタマイズの詳細については、「SQL のコードスタイル 」を参照してください。 |
Format synced sources | 同期後、データベースオブジェクトのソースコードにコードスタイルを適用します。 |
拡張生 advanced
拡張生 advanced タブには、JVM オプション、環境変数、キーと値のペアとしてデータベースドライバに渡すことができるオプションが含まれています。
テーブル内の値の編集を開始するには、対応する 値 フィールドをダブルクリックします。
行を追加するには、<user defined> と <value> が表示されている最後の行の値の編集を開始します。 新しい行がテーブルに自動的に追加されます。
項目 | 説明 |
|---|---|
VM オプション | データベースドライバが実行される JVM のデフォルトオプション。 ドライバは JVM 内の独立したプロセスとして起動されます。 |
VM 環境 | データベースドライバ JVM の環境変数。 例: Oracle データベースのエンコード関連の問題は、 |
高度なオプション
項目 | 説明 |
|---|---|
Disable incremental introspection | 増分イントロスペクションを実行しないでください。 このオプションは Oracle、Microsoft SQL Server 、PostgreSQL などのデータベースで利用できます。 インクリメンタルイントロスペクションでは、イントロスペクターは、前回のイントロスペクション後にデータベースで変更されたオブジェクトを検出し、これらのオブジェクトのみをロードします。 このオプションを有効にすると、イントロスペクターは常にすべてのオブジェクトをロードします。 イントロスペクション時間が大幅に増える可能性があります。 |
Do not use xmin in queries to pgdatabase |
|
Introspect using JDBC metadata | JDBC ベースのイントロスペクターに切り替えます。 すべてのデータベースで利用できます。 データベースオブジェクト（DB メタデータ）に関する情報を取得するために、PyCharm は以下のイントロスペクターを使用します：
ネイティブイントロスペクターが失敗するか使用できない場合は、JDBC ベースのイントロスペクターの使用を検討してください。 データベースサーバーのバージョンが PyCharm でサポートされている最小バージョンより古い場合、ネイティブイントロスペクターは失敗する可能性があります。 JDBC ベースのイントロスペクターに切り替えて、データベースからデータベース構造情報を取得する際の問題を修正することができます。 例: データベースまたはスキーマレベルより下のデータベースオブジェクトに存在するスキーマが データベース ツールウィンドウに表示されない場合。 |
クラスパスの分離 | JDBC ドライバーにより使用されるクラスパスの分離。 |
IDE のプロキシ設定を使用する | IDE のプロキシ設定を JDBC プロセスに渡します。 |
Kubernetes
PyCharm を使用すると、Kubernetes クラスターで実行されているデータベースに接続できます。
Kubernetes タブは、専用ポートを持たない埋め込みデータベース (SQLite、Apache Derby、HSQLDB など) では使用できません。
項目 | 説明 |
|---|---|
Use Kubernetes port forwarding | ポート転送を有効にします。 |
クラスタ | 使用する Kubernetes クラスターを選択します。 |
名前空間 | 使用可能なリソースのセットを決定する名前空間を選択します。 |
Resource type | リソースのタイプを選択します。 |
Resource | 接続するリソースを選択します。 |
ホストポート | データを送受信するローカルポートを入力します。 |
コンテナーポート | クラスターリソースのリモートポートを入力します。 |
DDL マッピング
項目 | 説明 |
|---|---|
名前 | DDL マッピングの名前。 |
データソース | 通常のデータソースを設定します。 |
DDL データソース | DDL データソースを設定します。 |
スコープ | DDL データソース SQL ファイルにマップされる通常のデータソースデータベースオブジェクトのスコープを設定します。 |
問題
データソースおよびドライバー ダイアログで、データソースに潜在的な問題が検出されると、 問題 メニューオプションの横に番号が表示されます。 問題 をクリックすると、問題のリストと、解決するためのオプションが表示されます。
