PyCharm 2024.3 ヘルプ

クエリ実行

このトピックでは、クエリの実行に使用できる設定について説明します。PyCharm でのクエリの実行と結果の表示の詳細については、次のトピックを参照してください。

  • クエリの実行の詳細については、クエリを実行するトピックを参照してください。

    Run a query
  • 照会結果トピックでクエリ結果を表示する方法を学習します。

    The results of the SELECT statements in the tabs of Services tool window

項目

説明

ステートメント内のキャレット実行時

キャレットがステートメント内にある場合は、次のアクションを実行します。

  • 実行する内容を確認する : 1 つまたは複数のステートメントのどの部分を実行するかを選択できるポップアップを表示します。

    Ask what to execute
  • 最小のサブクエリまたはステートメント : スクリプトから最小のサブクエリまたはステートメントを実行します。例: キャレットがサブクエリ内にある場合、サブクエリを含むステートメント全体が実行されます。

    Execute the smallest subquery or statement
  • 最小のステートメント : スクリプトから最小のステートメントを実行します。例: キャレットがサブクエリ内にある場合、サブクエリが実行されます。

    Execute the smallest statement
  • 最大のステートメント : スクリプトから最大のステートメントを実行します。例: キャレットがサブクエリ内にある場合、外側のステートメントが実行されます。

    Execute the largest statement
  • 最大のステートメントまたはバッチ : スクリプトから最大のステートメントまたはステートメントのバッチを実行します。Transact-SQL(SQL Server および Sybase)の場合、現在のステートメントのバッチが実行されます。他のすべてのダイアレクトについては、前のオプションと同じです。

  • スクリプト全体 : スクリプト全体を実行します。

    Execute the whole script
  • キャレットからすべて : キャレットのすべてを実行します。

    Execute everything below the caret

ステートメントの外側のキャレット実行時

キャレットがステートメントの外側にある場合 (空白行やコメント内など)、次のいずれかのアクションを実行します。

  • なし : 実行の停止。

    Nothing is executed
  • スクリプト全体 : スクリプト全体を実行します。

    The whole script is executed
  • キャレットから下全部 : キャレットのすべてを実行します。

    Everything below the caret is executed

選択実行

コードが選択されている(ハイライトされている)場合、次のいずれかのオプションを実行します。

  • 単一ステートメントとして実行 : 単一のステートメントとして選択されたものを正確に実行します。

    例: 次のコードスニペットを検討してください:

    BEGIN; UPDATE actor SET first_name='John' WHERE actor_id=100; UPDATE actor SET last_name='Doe' WHERE actor_id=100; COMMIT;

    このコードスニペットを 1 つのステートメントとして実行すると、両方の UPDATE コマンドが同じトランザクションの一部として同時に成功または失敗することが保証されます。異なるステートメントに分割すると、一方が成功し、もう一方が失敗することがあり、データの整合性が損なわれます。

  • 別々のステートメントとして実行 : 選択したものを正確に実行します。選択に複数のステートメントが含まれている場合、ステートメントは個別のステートメントとして実行されます。

    たとえば、複数の SQL コマンドを一度に実行したいが、必ずしもそれらすべてが同時に成功または失敗する必要がない場合などです。

  • スクリプトにスマート展開して実行 : 選択範囲を展開して、一連の有効なステートメントを形成します。例: 選択範囲内に少なくとも 1 つのステートメント境界がある場合、選択範囲が展開されて一連の有効なステートメントが形成されます。次に、このシーケンスが実行されます。それ以外の場合は、選択した内容を実行します。

新規タブで開く

クエリ結果を個別のタブで表示するか、1 つの同じタブで表示するかを選択できます。単一のタブの場合、タブはクエリごとに更新されます。

  • SELECT クエリを実行するたびにクエリ結果を含む新しいタブを作成するには、チェックボックスを選択します。このアプローチを使用すると、実行したすべてのクエリの結果を保持できます。

  • チェックボックスがオフの場合、同じタブを使用してクエリ結果が表示されます。タブの情報が更新され、結果が表示されます。

    この場合、保持したい結果が得られたら、ヘッダーを右クリックしてコンテキストメニューでタブをピン留めを選択し、タブを固定できます。

Generic および ANSISQL ダイアレクトで実行するためにスクリプトを分割する

SQL:2016 または汎用ダイアレクトを使用するサポートされていないデータベースのクエリ解析を設定します。汎用ダイアレクトは、エラーのハイライトが SQL:2016 と異なります。ジェネリクスダイアレクトでは、見つかったすべてのエラーがハイライトされていません。

  • 有効な ANSI SQL ステートメントに分割、または区切り文字で分割 : PyCharm はスクリプトを分析し、有効なステートメントまたは区切り文字で分割します。この設定はデフォルトです。

  • ANSI SQL ステートメントに分割 : SQL:2016 の文法に従ってスクリプトを分割します。

  • ステートメントの区切り文字 : ステートメントを区切り文字で抽出して実行します。一般的なダイアレクトの場合、区切り文字はセミコロンです。

実行前にパラメーターを確認する

パラメーターを使用してステートメントを実行すると、PyCharm はパラメーター値をメモリに保存します。このチェックボックスを選択すると、次回ステートメントを実行するときに、PyCharm は最後に使用されたパラメーター値を表示します。ステートメントを実行する前に変更できます。

このチェックボックスをオフにすると、PyCharm はパラメーター値を表示せずにすぐにステートメントを実行します。

潜在的に危険なクエリを実行する前に警告を表示する

安全でない可能性のあるクエリに対して警告を表示する場合に選択します。

DELETE および UPDATE ステートメントに WHERE 句または WHERE TRUE 句を入れ忘れた場合、PyCharm はそれを思い出す通知を表示します。

Notification when you type DELETE and UPDATE without WHERE

ステートメントを実行すると、PyCharm によって警告が表示されます。WHERE 句または WHERE TRUE 句を意図的に省略した場合は、警告内の実行をクリックすることで、現在のステートメントを計画どおりに実行できます。

Warning when you run DELETE and UPDATE without WHERE

関連ページ:

クエリを実行する

データベースツールと SQL プラグインを有効にするこの機能は、PyCharm にデフォルトでバンドルされ有効になっているデータベースツールと SQL プラグインに依存しています。関連する機能が利用できない場合は、プラグインを無効にしていないことを確認してください。を押して設定を開き、を選択します。インストール済みタブを開き、データベースツールおよび SQL プラグインを見つけて、プラグイン名の横にあるチェックボックスを選択します。ショートカット、ツールバーボタンとアイコン、コンテキストメニュー、...

照会結果

通常、クエリを実行すると、結果が表形式で返されます。PyCharm は結果をデータエディターに表示します。ステートメントごとに、結果を含むデータエディターがサービスツールウィンドウの別のタブに表示されます。例: クエリコンソールで 3 つのステートメントを実行すると、ツールウィンドウに 3 つのタブが表示されます。データエディターとビューアー、またはデータエディターは、データを操作するためのユーザーインターフェースを提供します。データエディターでは、データの並べ替え、フィルター、追加、編集、削除...

データベース

PyCharm Professional でのみ利用可能: 下へロードしてエディションを試したり比較したりできますデータベースセクションには、データベースと SQL の設定が含まれています。クエリ実行: クエリ実行の設定。出力と結果: クエリ結果の設定は、サービスツールウィンドウの出力および結果タブとクエリコンソールに表示されます。ユーザーパラメーター: ユーザーパラメーター設定。、データエディターとビューアー: データエディターでのテーブルデータの表示と管理に関する設定。CSV フォーマット: テ...

出力と結果

このページの設定は、サービスツールウィンドウの出力および結果タブ、およびクエリコンソールにクエリ結果がどのように表示されるかを定義します。クエリ結果の表示の詳細については、「照会結果」を参照してください。出力:クエリ出力のタイムスタンプを表示するサービスツールウィンドウの出力タブにクエリ出力のタイムスタンプを表示します。デフォルトでは、タイムスタンプは非表示になっています。タブとそのコントロールの詳細については、出力タブおよびタブ参照情報を参照してください。結果:結果をエディターで表示サービ