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

データベースツールウィンドウからこのダイアログにアクセスするには: ツールバーのまたは

概要

データ・ソースおよびドライバーダイアログでは、データソースとデータベースドライバを管理できます。

データ・ソースおよびドライバー

データソースとドライバのリストから項目を選択すると、その項目の設定がダイアログの右側に表示されます。

ツールバー

項目	ショートカット	説明
	`Alt+Insert`	データソースまたはドライバを作成します。 AndroidデバイスまたはエミュレータにあるSQLiteデータベースのデータソースを作成するためのAndroid SQLite。AndroidアプリケーションモジュールとAndroid SDKは必須であり、PyCharmで定義する必要があります。を参照してください。
	`Delete`	選択したアイテムをリストから削除します。
	`Ctrl+D`	選択したデータソースまたはドライバのコピーを作成してください。
	`Ctrl+B`	選択したデータソースに関連付けられているドライバ設定に移動します。
		選択したデータソースをグローバルまたはプロジェクトレベルに移動します。グローバルレベルとプロジェクトレベルの詳細については、データソースの管理を参照してください。

コンテキスト・メニュー

項目	ショートカット	説明
追加	`Alt+Insert`	データソースまたはドライバを作成します。
削除	`Delete`	選択したアイテムをリストから削除します。
重複	`Ctrl+D`	選択したデータソースまたはドライバのコピーを作成してください。
ドライバーにジャンプ	`Ctrl+B`	選択したデータソースに関連付けられているドライバ設定に移動します。
グローバル化またはプロジェクトへの移行		選択したデータソースをグローバルまたはプロジェクトレベルに移動します。グローバルレベルとプロジェクトレベルの詳細については、データソースの管理を参照してください。
ドライバの変更		データソースをドライバに関連付けます。
変更のリセット	`Ctrl+Alt+Z`	選択した項目の変更を元に戻します。
負荷源		選択したカテゴリのスキーマに対するデータベースオブジェクトのソースコードをロードします。
ドライバの使用状況を表示する	`Alt+F7`	選択したドライバを使用するデータソースを表示します。
		最近使用したアイテムを切り替えます。

データソース設定

データソースの設定ペインには、一般、オプション、SSH/SSL、スキーマ、詳細のタブがあります。

一般

一般タブには、データベース接続に指定する必要がある設定が含まれています。

タブのフィールドとコントロールのセットは、接続タイプリストで選択されているオプションによって異なります。

項目	説明
接続タイプ	データベース接続に使用する接続タイプ。 URLのみこのオプションは、通常、データベース接続URLを直接編集するためのオプションです。このオプションを選択すると、ユーザー、パスワード、URLのどのフィールドしか使用できません。 URLをフィールドの中で正しく編集するべきです。ユーザー名とパスワードは、必要に応じて、対応するフィールド、または使用しているJDBCドライバーに適した形式のURL内に指定されています。他のオプション（DBMS固有のオプション）を使用すると、PyCharmはURLフィールドの上にあるフィールドの情報を使用して自動的にデータベース接続URLを作成します。このような場合は、通常、URLを編集する必要はありません（必要に応じて変更できます）。
ドライバー	接続に使用するドライバーリストのドライバ。
ファイル	データベースファイルへのパス。既存のデータベースファイルを選択するには、開くアイコン（）を使用します。保存アイコン（）は、データベースファイルのコピーを作成し、そのコピー先へのパスを変更します。
パス	データベースファイルまたはフォルダーへのパス。既存のデータベースファイルまたはフォルダーを選択するには、開くアイコン（）を使用します。
ホスト	データベースが配置されているコンピューターのホスト名（ドメイン名）またはIPアドレス。データベースがローカルコンピューターにある場合は、localhost または 127.0.0.1を指定します。 SSHを使用している場合は、SSHプロキシが実行されているコンピューターから、指定されたドメイン名またはIPアドレスでデータベースホストにアクセスできる必要があります。SSH / SSLタブを参照してください。
ポート	データベースのポート番号。
データベース	ターゲットデータベースまたはスキーマの名前。
ユーザー	データベースユーザーアカウントの名前。
パスワード	データベースユーザーのパスワード。
保存	パスワードフィールドの設定を保存します。パスワードを保存するために次のオプションを選択できます。なし : データベースとの接続を確立するたびにパスワードが求められます。再起動するまで : パスワードは現在のPyCharm実行に対してのみ保存されます。PyCharmを終了して再度開く場合は、パスワードをもう一度入力する必要があります。セッション用 : パスワードは、データベースとの現在の接続セッションの間だけ保存されます（データベースから切断するまで）。切断アイコン（）または `Ctrl+F2`を押すと、接続を終了できます。永遠に : パスワードはPyCharmストレージに保存されます。次回PyCharmを開くときにパスワードを入力する必要はありません。
データベースを作成	データベースを作成するためにURLに引数を追加します。このオプションは、一部のデータベース管理システム（Apache Derby (埋め込み)など）でのみ使用可能です。
URL	PyCharmがデータベースに接続するために使用するURL。URLを指定するためのユーザーインターフェースは、接続タイプリストで選択されているオプションによって異なります。
接続のテスト	データベース接続設定が正しく、PyCharmがデータベースと通信できることを確認します。通信情報をコピーするには、クリップボードへコピーアイコンをクリックします。

オプション

オプションタブには、データベース接続の設定が含まれています。

タブのフィールドとコントロールのセットは、接続タイプリストで選択されているオプションによって異なります。

項目	説明
読み取り専用	読み取り専用ステータスを設定します。データソースを偶発的なデータ変更から保護するには、このチェックボックスをオンにします。チェックボックスが選択されていると、データ・エディターのデータを変更することはできません。ドライバが読み取り専用ステータスをサポートしていない場合、コンソールでデータの変更が可能になることがあります。
トランザクション制御	データベーストランザクションの分離レベル(英語)とトランザクションのコミット方法のモードを設定します。自動現在のトランザクションは、ローカル変更をデータベース・サーバーにサブミットすると自動的にコミットされます。マニュアルデータベースサーバーに送信された変更は、コミットまたはロールバックできるトランザクションに蓄積されます。
スキーマの切り替え	PyCharmがスキーマを切り替えるために使用するモードを定義します。自動 : スキーマを自動的または手動で切り替える。マニュアル : 手動でのみスキーマを切り替えます。無効：スキーマを切り替えません。
シングル接続モード	シングル接続モードを有効にします。シングル接続モードは、データソースとすべてのコンソールが1つの同じ接続を使用することを意味します。このモードでは、データベースツリー内の一時オブジェクトを確認したり、異なるコンソールで同じトランザクションを使用したりできます。コンソールについて詳しくは、データベース・コンソールを参照してください。
N秒ごとにキープアライブクエリを実行する	接続を維持するためにキープアライブクエリを実行します。サポートされていないデータベースのドライバ設定でカスタムクエリを定義できます。
N秒後に自動切断	指定された秒数後にデータベースから切断します。
シングルデータベースモード	データベースツリービューで、接続設定で指定したデータベースのみを表示して有効にします。データソースに接続すると、PyCharmはそのデータソースが持つすべてのデータベースを取得して表示することができます。しかし、場合によっては（たとえば、PgBouncerの特定の設定で）、特定のデータベースでしか作業できない、または許可されている場合もあります。シングルデータベースモードを有効にすると、データベースツリービューには、接続設定で指定したデータベースのみが表示されます。 PostgreSQL、Azure SQL Database、Greenplum、Amazon Redshiftの場合は、この設定の使用を検討してください。
スタートアップ・スクリプト	接続を確立するたびにSQLクエリを実行します。注：シングル接続モードチェックボックスをオフにすると、新しいコンソールごとに新しい接続が作成されます。
自動同期	データベースの実際の状態を自動的に同期します。自動同期チェックボックスがオフの場合、データベースツールウィンドウのデータソースのビューは、同期化アイコンをクリックするか、`Ctrl+Alt+Y`を押したときにのみ、データベースの実際の状態と同期されます。このオプションをオンにすると、データソースのビューが自動的に更新されます。データ・ソースおよびドライバーダイアログでOKをクリックしたとき。データソースに関連付けられたデータベースコンソールでDDL SQL文を実行するとき。注：自動同期はデータベース全体に対して実行されます。この操作は時間がかかる場合があります。小規模なデータベースに対してこのオプションを有効にすることを検討してください。大規模データベースの場合は、状態を手動で同期することを検討してください。独立したテーブルなど、適切なデータベース部分についてのみにしてください。
ソースのロード	選択したカテゴリのスキーマに対するデータベースオブジェクトのソースコードをロードします。複数のデータソースのこの設定を同時に変更するには、対応するデータソースを選択します。選択を右クリックして負荷源にナビゲートしてオプションを選択します。
古い DDL の編集時に警告する	キャッシュされたDDLがデータベース内の実際のDDLと異なる場合は通知を表示します。ソースコードを開くたびに、PyCharmはインデックス作成プロセス中に読み込まれたバージョンを表示します。しかし、誰かが他のワークステーションからソースコードを変更すると、インデックス付きのバージョンは古くなります。ご使用のバージョンがデータベース内のバージョンよりも古い場合は、次の通知が表示されます。`Cached object differs from the object in the database`。
JDBC メタデータを使用して内部検査する	JDBCベースのイントロスペクターに切り替えます。データベースオブジェクトに関する情報（DBメタデータ）を取得するために、PyCharmは以下のイントロスペクターを使用します。ネイティブのイントロスペクター（特定のDBMSでは使用できない可能性があります）。ネイティブイントロスペクターはDBMS固有のテーブルとビューをメタデータのソースとして使用します。DBMS固有の詳細を取得し、データベースオブジェクトのより正確な図を作成できます。 JDBCベースのイントロスペクター（すべてのDBMSで使用可能） JDBCベースのイントロスペクターは、JDBCドライバーによって提供されるメタデータを使用します。データベースオブジェクトとそのプロパティーに関する標準的な情報のみを取得できます。ネイティブのイントロスペクターが失敗した場合や使用できない場合は、JDBCベースのインタースペクターを使用することを検討してください。データベースサーバーのバージョンがPyCharmでサポートされている最小バージョンよりも古い場合、ネイティブイントロスペクターは失敗する可能性があります。データベースからデータベース構造情報を取得する際の問題を解決するために、JDBCベースのイントロスペクターに切り替えてみることができます。例：データベース内に存在するスキーマ、またはスキーマレベルより下のデータベースオブジェクトがデータベースツールウィンドウに表示されない場合。
コード・スタイル	スキーマに使用するコード・スタイルを選択します。コードスタイルのカスタマイズの詳細については、SQLのコードスタイルを参照してください。

SSH/SSL

SSH/SSLタブには、SSHまたはSSL接続の設定が含まれています。

SSH

項目	説明
SSH トンネルを使用する	SSH接続を設定するための設定を有効にします。
次からコピー	既存のデータソースからSSH設定をコピーします。リンクをクリックして対応するデータソースを選択します。
プロキシー・ホスト	SSHプロキシサーバーのホスト名（ドメイン名）またはIPアドレス。SSHプロキシサーバーホストは、ローカルコンピューターから指定されたホスト名またはIPアドレスでアクセスできる必要があります。
プロキシー・ポート	SSH接続を受け入れるSSHプロキシサーバーのポート。
ローカル・ポート	SSH接続用のローカルポート。デフォルト値は<動的>です。
プロキシー・ユーザー	SSHプロキシユーザーの名前。
認証タイプ	SSHプロキシによって使用されるユーザー認証タイプ。パスワード : パスワードでホストにアクセスします。キー・ペア (OpenSSH または PuTTY) : 鍵ペアと一緒にSSH認証(英語)を使用します。この認証方法を適用するには、クライアントマシンにプライベートキー、リモートサーバーにパブリックキーが必要です。PyCharmは、OpenSSH(英語)ユーティリティで生成された秘密鍵をサポートしています。秘密鍵が格納されているファイルへのパスを指定し、対応するフィールドにパスフレーズ（存在する場合）を入力します。PyCharmにパスフレーズを記憶させるには、パスフレーズを保存チェックボックスを選択します。 OpenSSHの設定と認証エージェント : 認証情報ヘルパーアプリケーションによって管理されているSSH鍵を使用します（たとえば、Windowsの場合はPageant(英語)、MacおよびLinuxの場合はssh-agent(英語)）。
プロキシー・パスワード	SSHプロキシユーザーのパスワード。パスワードを記憶するも参照してください。
秘密鍵ファイル	秘密鍵ファイルへのパス。
パスフレーズ	鍵がパスフレーズでロックされている場合は、秘密鍵のパスフレーズ。
パスワードを記憶する	PyCharmにパスワードまたはパスフレーズを記憶させたい場合は、このチェックボックスを選択します。パスワードを保存するために次のオプションを選択できます。なし : データベースとの接続を確立するたびにパスワードが求められます。再起動するまで : パスワードは現在のPyCharm実行に対してのみ保存されます。PyCharmを終了して再度開く場合は、パスワードをもう一度入力する必要があります。セッション用 : パスワードは、データベースとの現在の接続セッションの間だけ保存されます（データベースから切断するまで）。切断アイコン（）または `Ctrl+F2`を押すと、接続を終了できます。永遠に : パスワードはPyCharmストレージに保存されます。次回PyCharmを開くときにパスワードを入力する必要はありません。

SSL

項目	説明
SSLトンネルを使用	SSL接続を設定するための設定を有効にします。
次からコピー	既存のデータソースからSSH設定をコピーします。リンクをクリックして対応するデータソースを選択します。
CA ファイル	SSL認証局（CA）証明書ファイルへのパスを指定してください。証明書ファイルは、サーバーで使用されているものと同じ証明書でなければなりません。
クライアント証明書ファイル	（クライアント）公開鍵証明書ファイルへのパスを指定してください。
クライアント・キー・ファイル	（クライアント）秘密鍵ファイルへのパスを指定します。

スキーマ

データベースツールウィンドウに表示するデータベースとスキーマ(英語)を選択します。

項目	説明
	データベースとスキーマのリストを更新します。
	すべてのツリーのすべてのノードを展開します。
	すべてのツリーのすべてのノードを折りたたみます。
	ツリー内のコンテンツをフィルタリングします。指定されたテキストを名前に含むデータベースとスキーマのみが表示されます。
パターン	必要なデータベースとスキーマを選択するためのパターンを定義します。使用される構文に関する情報を入手するには、カーソルをフィールドに置き、`Ctrl+Q`を押します。 `@` : 現在のデータベースまたはスキーマ `` : すべてのデータベースまたはスキーマ `:`の後にスキーマをリストすることができます。次の例を考えてみましょう。 `:` : すべてのデータベース内のすべてのスキーマ `@:` : 現在のデータベースからのすべてのスキーマ `@:@` : 現在のスキーマのみ `:dbo\|@:@\|db1:s1,s2,s3` : すべてのデータベースの `dbo` スキーマ、現在のスキーマ、`db1` データベースのスキーマ `s1,s2,s3`
オブジェクト・フィルター	各データソースのデータベースツールウィンドウに表示されるテーブルとその他のデータベースオブジェクトのセットを制限します。オブジェクト・フィルターフィールドの式を作成するときは、次のパターンを使用してください。 `<type>:[-]<pattern>`、ここ `<type>` は、集計、照合、イベント、fdw、ftable、mview、演算子、パッケージ、ロール、ルーチン、シーケンス、シノニム、表、ユーザー、ビュー、vtableのいずれかです。 `<pattern>` は正規表現です。アイテムを除外するには、`-` （マイナス）を先頭に付けます。正規表現の詳細については、Java 2プラットフォーム標準版5.0 API仕様のクラス・パターン(英語)を参照してください。フィルタの構文を示す次の例を検討してください。 `f.` 名前が `f`で始まるオブジェクトのみを表示します。 `table:[gh].` 名前が `g` または `h`で始まる表、およびその他すべてのオブジェクト型を表示します。 `view:new_.\|\|routine:-[ps].` 名前が `new_`で始まるビュー、名前が `p` または `s`以外の文字で始まるルーチン、およびその他すべてのオブジェクト型を表示します。

拡張

詳細設定タブには、JVMデータベースドライバのデータベース接続プロパティー、オプション、および環境変数が含まれています。

詳細設定タブのテーブルには、キーと値のペアとしてデータベースドライバに渡される一連の接続オプションが表示されます。

名前列のセルを選択すると、対応するオプションの説明が表に表示されます。

行を追加するには、<user defined>と<value>が表示されている最後の行の値の編集を始めます。新しい行がテーブルに自動的に追加されます。

項目	説明
VM オプション	データベースドライバのJVMオプション。特定のOracleデータベースバージョン（たとえば、Oracleバージョン9）では、あなたのデータベースサーバーが異なるタイムゾーンにあるときに接続問題があるかもしれません。VMオプションフィールドでタイムゾーンのタイムオフセットを指定できます（たとえば、`-Duser.timezone=UTC+03:00`）。あるいは、「詳細設定」タブの表で、変数 `oracle.jdbc.timezoneAsRegion` を `false` に設定します。
VM 環境	データベースドライバJVMの環境変数。例：Oracleデータベースのエンコーディング関連の課題は、`NLS_LANG` 変数を設定することで解決できます（ `NLS_LANG=Russian_CIS.CL8MSWIN1251`のように）。詳しくは、Oracle NLS_LANG FAQ(英語)を参照してください。

項目

説明

VM オプション

データベースドライバのJVMオプション。

特定のOracleデータベースバージョン（たとえば、Oracleバージョン9）では、あなたのデータベースサーバーが異なるタイムゾーンにあるときに接続問題があるかもしれません。VMオプションフィールドでタイムゾーンのタイムオフセットを指定できます（たとえば、-Duser.timezone=UTC+03:00）。あるいは、「詳細設定」タブの表で、変数 oracle.jdbc.timezoneAsRegion を false に設定します。

VM 環境

データベースドライバJVMの環境変数。

例：Oracleデータベースのエンコーディング関連の課題は、NLS_LANG 変数を設定することで解決できます（ NLS_LANG=Russian_CIS.CL8MSWIN1251のように）。詳しくは、Oracle NLS_LANG FAQ(英語)を参照してください。

追加情報については、DBMSのマニュアルを参照してください。

DDLデータソース設定

DDLデータソースはその名前で定義され、1つ以上のDDLファイルと別のデータソース（親データソース）を参照できます。

項目	説明
名前	データソース名
DDLファイル	必要なDDL定義を含むファイルのリスト。 `Alt+Insert`。DDL SQLファイルをデータソース定義に追加します。開いたダイアログで、必要なファイルを選択します。（`Alt+Delete`）選択したファイルをリストから削除します。（`Alt+Up`）選択したファイルをリストの1行上に移動します。（`Alt+Down`）選択したファイルをリストの1行下に移動します。
拡張	必要に応じて、拡張リストで別のデータソースを親として選択することもできます。その結果、編集しているデータソースは、その親からすべてのDDL定義を継承します。親データソースを使用しない場合は、<なし>を選択します。

項目

説明

名前

データソース名

DDLファイル

必要なDDL定義を含むファイルのリスト。

Alt+Insert。DDL SQLファイルをデータソース定義に追加します。開いたダイアログで、必要なファイルを選択します。
（Alt+Delete）選択したファイルをリストから削除します。
（Alt+Up）選択したファイルをリストの1行上に移動します。
（Alt+Down）選択したファイルをリストの1行下に移動します。

拡張

必要に応じて、拡張リストで別のデータソースを親として選択することもできます。その結果、編集しているデータソースは、その親からすべてのDDL定義を継承します。

親データソースを使用しない場合は、<なし>を選択します。

ドライバー設定

ドライバの設定ペインには、一般、オプション、詳細のタブがあります。

設定

一般タブには、ドライバファイル、URLテンプレート、およびドライバクラスの設定が含まれています。

項目	説明
クラス	使用するドライバクラスの完全修飾名。
JDBC ドライバー	PyCharmはJDBC ドライバー(英語)を使用してデータベースと対話します。PyCharmドライバリポジトリからドライバをダウンロードして使用することも、コンピューターに保存するドライバを指定することもできます。最新のドライババージョンをダウンロードして使用するには、verをダウンロードします: Nリンクをクリックしてください。特定のバージョン番号のドライバを指定して使用することもできます。ver: <version_number>リンクをクリックして、使用するドライバのバージョンを選択してください。選択したバージョンが自動的にダウンロードされて適用されます。コンピューターで既に利用可能なドライバーを使用できます。その場合は、追加ボタンをクリックして、ドライバーファイル（JAR拡張子付き）を選択します。
URL テンプレート	データベースURLを構築するために使用されるテンプレート。巻き括弧のテキストは変数を表します。次の例を参照してください。 `{host}` : データベースホストのドメイン名またはIPアドレス。 `{port}` : データベースのポート番号 `{database}` : データベースまたはスキーマの名前。オプションのフラグメントは角括弧で囲まれています（例：:{port}）。テンプレート名は、URLオプションリストのオプションの名前に対応しています。

項目

説明

クラス

使用するドライバクラスの完全修飾名。

JDBC ドライバー

PyCharmはJDBC ドライバー(英語)を使用してデータベースと対話します。PyCharmドライバリポジトリからドライバをダウンロードして使用することも、コンピューターに保存するドライバを指定することもできます。

最新のドライババージョンをダウンロードして使用するには、verをダウンロードします: Nリンクをクリックしてください。

特定のバージョン番号のドライバを指定して使用することもできます。ver: <version_number>リンクをクリックして、使用するドライバのバージョンを選択してください。選択したバージョンが自動的にダウンロードされて適用されます。

コンピューターで既に利用可能なドライバーを使用できます。その場合は、追加ボタンをクリックして、ドライバーファイル（JAR拡張子付き）を選択します。

URL テンプレート

データベースURLを構築するために使用されるテンプレート。巻き括弧のテキストは変数を表します。次の例を参照してください。

{host} : データベースホストのドメイン名またはIPアドレス。
{port} : データベースのポート番号
{database} : データベースまたはスキーマの名前。

オプションのフラグメントは角括弧で囲まれています（例：:{port}）。

テンプレート名は、URLオプションリストのオプションの名前に対応しています。

オプション

項目	説明
トランザクション制御	データベーストランザクションの分離レベル(英語)とトランザクションのコミット方法のモードを設定します。自動現在のトランザクションは、ローカル変更をデータベース・サーバーにサブミットすると自動的にコミットされます。マニュアルデータベースサーバーに送信された変更は、コミットまたはロールバックできるトランザクションに蓄積されます。
スキーマの切り替え	PyCharmがスキーマを切り替えるために使用するモードを定義します。自動 : スキーマを自動的または手動で切り替える。マニュアル : 手動でのみスキーマを切り替えます。無効：スキーマを切り替えません。
スタートアップ・スクリプト	接続を確立するたびに実行されるSQLクエリ。注：シングル接続モードチェックボックスをオフにすると、新しいコンソールごとに新しい接続が作成されます。
キープアライブクエリ	接続を維持するために実行されるキープアライブクエリ。
自動同期	自動同期オプションのデフォルト設定。
ソースのロード	選択したカテゴリのスキーマに対するデータベースオブジェクトのソースコードをロードします。
アプリケーション情報の送信	このチェックボックスをオンにすると、PyCharmはデータベースサーバーに接続するときに、自分自身に関する情報を送信します。
ダイアレクト	対応するデータソースに関連付けられているSQL言語。
コード・スタイル	このドライバを使用するデータソースに使用するコードスタイルを選択します。コードスタイルのカスタマイズの詳細については、SQLのコードスタイルを参照してください。
同期したソースをフォーマットする	同期後、データベースオブジェクトのソースコードにコードスタイルを適用します。

拡張

詳細設定タブには、JVMオプション、環境変数、およびキーと値のペアとしてデータベースドライバに渡すことができるオプションが含まれています。

テーブル内の値の編集を開始するには、対応する値フィールドをダブルクリックします。

行を追加するには、<user defined>と<value>が表示されている最後の行の値の編集を開始します。新しい行がテーブルに自動的に追加されます。

項目	説明
VM オプション	データベースドライバが実行されるJVMのデフォルトオプション。ドライバはJVM内の独立したプロセスとして起動されます。
VM 環境	データベースドライバJVMの環境変数。例：Oracleデータベースのエンコーディング関連の課題は、`NLS_LANG` 変数を設定することで解決できます（ `NLS_LANG=Russian_CIS.CL8MSWIN1251`のように）。詳しくは、Oracle NLS_LANG FAQ(英語)を参照してください。

項目

説明

VM オプション

データベースドライバが実行されるJVMのデフォルトオプション。ドライバはJVM内の独立したプロセスとして起動されます。

VM 環境

データベースドライバJVMの環境変数。