PyCharm 2020.1ヘルプ

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

データ・ソースおよびドライバーダイアログ（Shift+Enter）にアクセスするには、次のいずれかのアクションを実行します。

  • データベースツールウィンドウ（表示 | ツール・ウィンドウ | データベース）で、データ・ソースのプロパティボタン the Data Source Properties buttonをクリックします。

  • データベースツールウィンドウ（表示 | ツール・ウィンドウ | データベース）で、追加ボタン the Add button をクリックし、データ・ソース | <data_source_vendor>に移動します。

概要

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

the Data Sources and Drivers dialog

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

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

ツールバー

項目

ショートカット

説明

the Add buttonAlt+Insert

データソースまたはドライバを作成します。

AndroidデバイスまたはエミュレータにあるSQLiteデータベースのデータソースを作成するためのAndroid SQLite。AndroidアプリケーションモジュールとAndroid SDKは必須であり、PyCharmで定義する必要があります。

を参照してください。

the Remove iconDelete

選択したアイテムをリストから削除します。

the Duplicate iconCtrl+D

選択したデータソースまたはドライバのコピーを作成します。

the Go to Driver iconCtrl+B

選択したデータソースに関連付けられているドライバ設定に移動します。

import

選択したデータソースをグローバルまたはプロジェクトレベルに移動します。グローバルレベルとプロジェクトレベルの詳細については、データ・ソースの管理を参照してください。

コンテキスト・メニュー

項目

ショートカット

説明

the Add button 追加

Alt+Insert

データソースまたはドライバを作成します。

    the Remove icon 削除

    		Delete

    選択したアイテムをリストから削除します。

    the Duplicate icon 複製

    		Ctrl+D

    選択したデータソースまたはドライバのコピーを作成します。

    the Go to Driver icon ドライバーにジャンプ

    		Ctrl+B

    選択したデータソースに関連付けられているドライバ設定に移動します。

    the Make Global or Move to Project icon グローバル化またはプロジェクトへの移行

    選択したデータソースをグローバルまたはプロジェクトレベルに移動します。グローバルレベルとプロジェクトレベルの詳細については、データ・ソースの管理を参照してください。

    ドライバの変更

    データソースをドライバに関連付けます。

    変更のリセット

    		Ctrl+Alt+Z

    選択した項目の変更を元に戻します。

    負荷源

    選択したカテゴリのスキーマに対するデータベースオブジェクトのソースコードをロードします。

    ドライバの使用状況を表示する

    		Alt+F7

    選択したドライバを使用するデータソースを表示します。

    the Back icon the Forward icon

    最近使用したアイテムを切り替えます。

    データソース設定

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

    一般

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

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

    項目

    説明

    接続タイプ

    データベース接続に使用する接続タイプ。

    • URLのみこのオプションは、通常、データベース接続URLを直接編集するためのオプションです。

      このオプションを選択すると、ユーザー、パスワード、URLのどのフィールドしか使用できません。

      URLをフィールドの中で正しく編集するべきです。ユーザー名とパスワードは、必要に応じて、対応するフィールド、または使用しているJDBCドライバーに適した形式のURL内に指定されています。

    • 他のオプション（DBMS固有のオプション）を使用すると、PyCharmはURLフィールドの上にあるフィールドの情報を使用して自動的にデータベース接続URLを作成します。このような場合は、通常、URLを編集する必要はありません（必要に応じて変更できます）。

    ドライバー

    接続に使用するドライバーリストのドライバ。

    ファイル

    データベースファイルへのパス。

    既存のデータベースファイルを選択するには、開くアイコン（The Open icon）を使用します。

    保存アイコン（the Save button）は、データベースファイルのコピーを作成し、そのコピー先へのパスを変更します。

    パス

    データベースファイルまたはフォルダーへのパス。

    既存のデータベースファイルまたはフォルダーを選択するには、開くアイコン（The Open icon）を使用します。

    ホスト

    データベースが配置されているコンピューターのホスト名（ドメイン名）またはIPアドレス。データベースがローカルコンピューターにある場合は、localhost または 127.0.0.1を指定します。

    SSHを使用している場合は、SSHプロキシが実行されているコンピューターから、指定されたドメイン名またはIPアドレスでデータベースホストにアクセスできる必要があります。SSH / SSLタブを参照してください。

    ポート

    データベースのポート番号。

    データベース

    ターゲットデータベースまたはスキーマの名前。

    ユーザー

    データベースユーザーアカウントの名前。

    パスワード

    データベースユーザーのパスワード。

    保存

    パスワードフィールドの設定を保存します。パスワードを保存するために次のオプションを選択できます。

    • なし : データベースとの接続を確立するたびにパスワードが求められます。

    • 再起動するまで : パスワードは現在のPyCharm実行に対してのみ保存されます。PyCharmを終了して再度開く場合は、パスワードをもう一度入力する必要があります。

    • セッション用 : パスワードは、データベースとの現在の接続セッションの間だけ保存されます（データベースから切断するまで）。 切断アイコン（the Disconnect icon）または Ctrl+F2を押すと、接続を終了できます。

    • 永遠に : パスワードはPyCharmストレージに保存されます。次回PyCharmを開くときにパスワードを入力する必要はありません。

    データベースを作成

    データベースを作成するためにURLに引数を追加します。このオプションは、一部のデータベース管理システム（Apache Derby (埋め込み)など）でのみ使用可能です。

    URL

    PyCharmがデータベースに接続するために使用するURL。URLを指定するためのユーザーインターフェースは、接続タイプリストで選択されているオプションによって異なります。

    接続のテスト

    データベース接続設定が正しく、PyCharmがデータベースと通信できることを確認します。通信情報をコピーするには、クリップボードへコピーアイコン the Copy to Clipboard iconをクリックします。

    オプション

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

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

    項目

    説明

    読み取り専用

    読み取り専用ステータスを設定します。データソースを偶発的なデータ変更から保護するには、このチェックボックスをオンにします。

    チェックボックスが選択されていると、データ・エディターのデータを変更することはできません。

    ドライバーが読み取り専用ステータスをサポートしていない場合、クエリコンソールでデータの変更が可能になる場合があります。

    トランザクション制御

    データベーストランザクションの分離レベル(英語)とトランザクションのコミット方法のモードを設定します。

    • 自動 : データベースサーバーにローカルの変更を送信すると、現在のトランザクションが自動的にコミットされます。

    • マニュアル : データベースサーバーに送信された変更は、コミットまたはロールバックできるトランザクションに蓄積されます。

    スキーマの切り替え

    PyCharmがスキーマを切り替えるために使用するモードを定義します。

    • 自動 : スキーマを自動または手動で切り替えます。PostgreSQLおよびAmazon Redshiftの場合、このオプションを使用して、IDEの再起動の間に構成済みの検索パスを保存します。

    • マニュアル : 手動でのみスキーマを切り替えます。

    • 無効：スキーマを切り替えません。

    シングル接続モード

    シングル接続モードを有効にします。シングル接続モードは、データソースとすべてのコンソールが1つの同じ接続を使用することを意味します。このモードでは、データベースツリー内の一時オブジェクトを確認したり、異なるコンソールで同じトランザクションを使用したりできます。コンソールについて詳しくは、クエリコンソールを参照してください。

    N秒ごとにキープアライブクエリを実行する

    接続を維持するためにキープアライブクエリを実行します。サポートされていないデータベースのドライバ設定でカスタムクエリを定義できます。

    N秒後に自動切断

    指定された秒数後にデータベースから切断します。

    シングルデータベースモード

    データベースツリービューで、接続設定で指定したデータベースのみを表示して有効にします。

    データソースに接続すると、PyCharmはデータソースが持つすべてのデータベースを取得して表示できます。ただし、場合によっては（たとえば、PgBouncerの特定の設定を使用して）、特定のデータベースでのみ操作できるか、許可されています。シングルデータベースモードが有効になっているデータベースツリービューには、接続設定で指定したデータベースのみが表示されます。

    PostgreSQL、Azure SQL Database、Greenplum、Amazon Redshiftにこの設定を使用することを検討してください。

    スタートアップ・スクリプト

    接続を確立するたびにSQLクエリを実行します。

    注 ：シングル接続モードチェックボックスがオフの場合、新しいクエリコンソールごとに新しい接続が作成されます。

    自動同期

    データベースの実際の状態を自動的に同期します。データベースの状態とは、データベースツールウィンドウ（表示 | ツール・ウィンドウ | データベース）に表示されるデータベースツリービューを意味します。

    自動同期チェックボックスが選択されている場合、データソースのビューは自動的に更新されます。

    • データ・ソースおよびドライバーダイアログでOKをクリックしたとき。

    • データソースに関連付けられたデータベースコンソールでDDL SQLステートメントを実行するとき。

    自動同期チェックボックスがオフの場合、データベース ツールウィンドウのデータソースのビューは、リフレッシュボタン the Refresh button をクリックするか、Ctrl+F5を押したときにのみ、データベースの実際の状態と同期されます。

    ソースのロード

    選択したスキーマのカテゴリのビュー、プロシージャ、パッケージ、およびその他のデータベースオブジェクトのソースコードを読み込みます：すべてのスキーマ（すべてのスキーマ）、システムスキーマを除くすべてのスキーマ（すべて除くシステムスキーマ）、または機能を無効にします（なし）。

    複数のデータソースのこの設定を同時に変更するには、対応するデータソースを選択します。選択を右クリックして負荷源にナビゲートしてオプションを選択します。

    古い 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ベースのイントロスペクターに切り替えてみることができます。例：データベース内に存在するスキーマ、またはスキーマレベルより下のデータベースオブジェクトがデータベースツールウィンドウに表示されない場合。

    イントロスペクトされていないシステムカタログに事前イントロスペクトされたオブジェクトを使用する

    システムカタログの事前イントロスペクトオブジェクトの使用を切り替えます。イントロスペクションとシステムカタログの詳細については、システムカタログから事前にイントロスペクトされたオブジェクトを参照してください。

    外部モデルデータ

    仮想外部キーの関係を格納する external-data.xml へのパスを定義します。これらの関係は、自動補完リスト、データナビゲーション、およびダイアグラムで使用されます。仮想外部キーの詳細については、外部キーを参照してください。

    コード・スタイル

    スキーマに使用するコード・スタイルを選択します。コードスタイルのカスタマイズの詳細については、SQLのコードスタイルを参照してください。

    SSH/SSL

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

    SSH

    項目

    説明

    SSH トンネルを使用する

    SSH経由の接続を有効にするには、このチェックボックスを選択します。次に、作成されたSSH構成の1つを選択するか、または the Browse button をクリックして、SSH構成を作成する説明に従って新しい構成を作成します。

    SSL

    項目

    説明

    SSLトンネルを使用

    SSL接続を設定するための設定を有効にします。

    次からコピー

    既存のデータソースからSSH設定をコピーします。

    リンクをクリックして対応するデータソースを選択します。

    CA ファイル

    SSL認証局（CA）証明書ファイルへのパスを指定してください。証明書ファイルは、サーバーで使用されているものと同じ証明書でなければなりません。

    クライアント証明書ファイル

    （クライアント）公開鍵証明書ファイルへのパスを指定してください。

    クライアント・キー・ファイル

    （クライアント）秘密鍵ファイルへのパスを指定します。

    スキーマ

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

    項目

    説明

    the Refresh button

    データベースとスキーマのリストをリフレッシュします。

    the Expand All button

    すべてのツリーのすべてのノードを展開します。

    the Collapse All button

    すべてのツリーのすべてのノードを折りたたみます。

    the Filter field

    ツリー内のコンテンツをフィルタリングします。指定されたテキストを名前に含むデータベースとスキーマのみが表示されます。

    パターン

    必要なデータベースとスキーマを選択するためのパターンを定義します。使用される構文に関する情報を入手するには、カーソルをフィールドに置き、Ctrl+Qを押します。

    • @ : 現在のデータベースまたはスキーマ

    • * : すべてのデータベースまたはスキーマ *:の後にスキーマをリストすることができます。

    次の例を考えてみましょう。

    • *:* : すべてのデータベース内のすべてのスキーマ

    • @:* : 現在のデータベースからのすべてのスキーマ

    • @:@ : 現在のスキーマのみ

    • *:dbo|@:@|db1:s1,s2,s3 : すべてのデータベースの dbo スキーマ、現在のスキーマ、db1 データベースのスキーマ s1,s2,s3

    オブジェクト・フィルター

    各データソースのデータベース ツールウィンドウに表示されるテーブルおよびその他のデータベースオブジェクトのセットを制限します。例：解決範囲を table:actor.*に制限すると、actor テーブルのみがデータベースツールウィンドウ（表示 | ツール・ウィンドウ | データベース）でアクセス可能になります。

    Limit the resolve scope to the actor table

    他のすべてのテーブルは範囲外になります。PyCharmは、データベースツールウィンドウに表示されていないオブジェクトを解決しません。

    Object is not resolved

    オブジェクト・フィルターフィールドの式を作成するときは、次のパターンを使用してください。

    <type>:[-]<pattern>、ここ

    <type> は、集計、照合、イベント、fdw、ftable、mview、演算子、パッケージ、ロール、ルーチン、シーケンス、シノニム、表、ユーザー、ビュー、vtableのいずれかです。

    <pattern> は正規表現です。アイテムを除外するには、- （マイナス）を先頭に付けます。正規表現の詳細については、Java 2プラットフォーム標準版5.0 API仕様のクラス・パターン(英語)を参照してください。

    拡張

    詳細設定タブには、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(英語)を参照してください。

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

    DDLデータソース設定

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

    項目

    説明

    名前

    データソース名

    DDLファイル

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

    • the Add button Alt+Insert。DDL SQLファイルをデータソース定義に追加します。開いたダイアログで、必要なファイルを選択します。

    • the Remove button （Alt+Delete）選択したファイルをリストから削除します。

    • the Up button （Alt+Up）選択したファイルをリストの1行上に移動します。

    • the Down button （Alt+Down）選択したファイルをリストの1行下に移動します。

    拡張

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

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

    ドライバー設定

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

    設定

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

    項目

    説明

    クラス

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

    JDBC ドライバー

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

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

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

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

    URL テンプレート

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

    • {host} : データベースホストのドメイン名またはIPアドレス。

    • {port} : データベースのポート番号

    • {database} : データベースまたはスキーマの名前。

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

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

    オプション

    項目

    説明

    トランザクション制御

    データベーストランザクションの分離レベル(英語)とトランザクションのコミット方法のモードを設定します。

    • 自動現在のトランザクションは、ローカル変更をデータベース・サーバーにサブミットすると自動的にコミットされます。

    • マニュアルデータベースサーバーに送信された変更は、コミットまたはロールバックできるトランザクションに蓄積されます。

    スキーマの切り替え

    PyCharmがスキーマを切り替えるために使用するモードを定義します。

    • 自動 : スキーマを自動的または手動で切り替える。

    • マニュアル : 手動でのみスキーマを切り替えます。

    • 無効：スキーマを切り替えません。

    スタートアップ・スクリプト

    接続を確立するたびに実行されるSQLクエリ。

    注 ：シングル接続モードチェックボックスがオフの場合、新しいクエリコンソールごとに新しい接続が作成されます。

    Keep-alive クエリー

    接続を維持するために実行されるキープアライブクエリ。

    自動同期

    自動同期オプションのデフォルト設定。

    ソースのロード

    選択したカテゴリのスキーマに対するデータベースオブジェクトのソースコードをロードします。

    アプリケーション情報の送信

    このチェックボックスをオンにすると、PyCharmはデータベースサーバーに接続するときに、自分自身に関する情報を送信します。

    ダイアレクト

    対応するデータソースに関連付けられているSQL言語。

    コード・スタイル

    このドライバを使用するデータソースに使用するコードスタイルを選択します。コードスタイルのカスタマイズの詳細については、SQLのコードスタイルを参照してください。

    同期されたソースをフォーマットする

    同期後、データベースオブジェクトのソースコードにコードスタイルを適用します。

    拡張

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

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

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

    項目

    説明

    VM オプション

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

    VM 環境

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

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

    問題

    潜在的な問題が検出された場合は、問題の右側に番号があります。その場合、問題をクリックすると、問題のリストと修正するためのコントロールが表示されます。

    最終更新日: 2020年7月6日
    データ・エディターデータベースの色設定ダイアログ

    関連ページ：

    データ・ソースの管理

    以下は、データベース・ツールおよび SQLプラグインがインストールされ使用可能になっている場合にのみ有効です。データソースは、アプリケーションのデータの場所です。PyCharmでは、以下のデータソースを定義できます。データベースデータソース：データを含む運用データベース（データベース接続を参照）。デ...

    データ・エディター

    データベースツールウィンドウから（DBデータソース内の任意のテーブル用）：ツールバーの(ツールバーが現在非表示になっていない場合)、コンテキストメニューからエディターを開く、概要：データエディターは、テーブルデータを操作するためのユーザーインターフェースを提供します。データエディターでは、データの並...

    クエリコンソール

    概要：クエリコンソールは、データソースに関連付けられているSQLファイルです。例：MySQLのクエリコンソールを開くと、MySQLデータソースへの接続セッションが自動的に作成されます。ハードドライブからSQLファイルを開くときは、最初に接続セッションを指定する必要があります。次の例では、MySQLコ...

    スキーマ

    スキーマの作成データソースを右クリックし、に移動します。名前フィールドに、スキーマの名前を指定します。実行をクリックします。デフォルトのスキーマを選択ツールバーの右上にあるリストを使用して、デフォルトのスキーマまたはデータベースを選択できます。デフォルトのスキーマを選択する場合、ステートメントでその...

    外部キー

    以下は、データベース・ツールおよび SQLプラグインがインストールされ使用可能になっている場合にのみ有効です。外部キーの関係は、テーブルが相互にどのように関係するかを指定し、テーブル間の関係を示します。PyCharmは、データベーススキーマ内の外部キー関係を認識し、使用してJOIN句を構築します。こ...

    SQLコードスタイルを構成する

    コードスタイル設定を変更するSQLコードの整形ルールをカスタマイズする：整列、折り返し、字下げ。をクリックします。使用可能なタブで必要なコードスタイル設定をすべて選択します。適用をクリックします。ルールを適用すると、PyCharmはSQLコードを更新し、プレビューペインで変更されたすべてのパーツを強...