PyCharm 2026.1 Help

ユーザーパラメーター

ユーザーパラメーターの操作の詳細については、 「クエリの実行」トピックの対応する章を参照してください。

項目

説明

Enable in query consoles and SQL files

SQL ファイルおよび クエリコンソールs 内の SQL にパラメーターパターンを適用します。 個々のパターンレベルで使用スコープを制限できます。

このチェックボックスをオフにすると、個々のパターンに指定された使用スコープに関係なく、パターンは SQL ファイルおよび クエリコンソールs で使用されません。

Enable in string literals with SQL injection

SQL で 挿入された文字列リテラルにパラメーターパターンを適用します。 必要に応じて、 個々のパターンのレベルで使用スコープを制限できます。

このチェックボックスをオフにすると、個々のパターンに指定されている使用スコープに関係なく、パターンは文字列リテラルで使用されません。

Substitute inside SQL strings

SQL コードの文字列リテラルにパラメーターパターンを適用します。

例: 次のコードを検討してください。

SELECT ${column_name} FROM actor WHERE actor_id='${actor_id}'

チェックボックスがオフの場合、PyCharm は column_name パラメーターのみを検出します。 actor_id パラメーターは文字列として扱われます。

ただし、 Substitute inside SQL strings オプションを選択すると、 actor_id パラメーターはユーザーパラメーターとして扱われます。

SQL 文字列内の置換設定が無効になっています
SQL 文字列内の置換設定が有効になっています

パラメーターパターン

パラメーターパターンとその使用スコープのリスト。

パターンは正規表現を用いて指定します。 括弧 () で囲まれた値はパラメーター名として扱われます。 使用可能なパターンは、初期状態では以下の意味を持ちます。

  • \?(\d+) - クエスチョンマークの後に 1 桁以上の数字が続きます。例えば、 ?69 の場合、 69 がパラメーター名になります。

  • %\w+ - % の後に 1 つ以上の単語文字が続きます(例: %xyz)。

  • \$\{([^$\{\}]*)\} - $ 、次に { 、次に ${} を除く任意の文字を 0 回以上、次に } 、たとえば ${}${value}

  • \$\(([^\)]+)\) - $ 、次に ( 、次に ) 以外の任意の文字が 1 回以上続き、次に ) 、例えば $(x)。

  • \$(\w+)\$ - $ 、次に 1 つ以上の単語文字、次に $ 、たとえば $x1$

  • \#(\w+)\# - # 、次に 1 つ以上の単語文字、次に # 、たとえば #field_3#

パラメーターの命名動作の詳細については、 命名行動 を参照してください。

追加ボタン Alt+Insert削除ボタン Alt+Deletethe Previous Occurrence button Alt+Upthe Next Occurrence button Alt+Down を使用して、パターンを追加、削除、並べ替えます。

パターンまたはその使用スコープを編集するには、パターンをクリックして次のコントロールを使用します:

  • In scripts: パターンを SQL ファイルや クエリコンソールs で使用しない場合は、このチェックボックスをオフにします。

  • In literals: SQL でインジェクションされた文字列リテラルでパターンを使用してはならない場合、このチェックボックスをオフにします。

  • All languages: リンクをクリックして、パターンを使用しない言語のチェックボックスをオフにします。

2026 年 6 月 1 日