DataGrip 2018.2ヘルプ

SQL文の作成と実行

デフォルトのスキーマまたはデータベースの選択

ツールバーのright-hand部分のリストを使用して、デフォルトのスキーマまたはデータベースを選択できます。そうした場合、ステートメント内のそのスキーマまたはデータベースの名前を省略することができます。

DBConsoleSchemaSelector

PostgreSQLとRedshiftのスキーマ検索パスの制御も参照してください。

PostgreSQLとRedshiftのスキーマ検索パスの制御

PostgreSQLまたはRedshiftデータソースを使用する場合、別の検索パスを指定しない限り、デフォルトの検索パス(データベース内に設定されているもの)が使用されます。

検索パスを制御するには、ツールバーのright-handのポップアップを使用します。ポップアップを使用すると、データベースを切り替えることもできます。

DBConsoleSchemaSearchPath

データベースを選択するか、デフォルトの検索パスを設定するには、データベースをクリックするか、 Enterを押します。

現在のデータベースの検索パスを変更するには、スキーマリストを開きます。

検索パスに1つのスキーマのみを含める必要がある場合は、必要なスキーマをクリックします。同様に、スキーマをsingle-schema検索パス内の別のスキーマと置き換えることができます。

2つ以上のスキーマを含む検索パスを作成するには、次のようにします。

  • Space を使用して、強調表示されたスキーマを検索パスに追加し、検索パスからスキーマを削除することもできます。
  • Alt+Up および Alt+Down を使用して、検索パス内のスキーマを並べ替えます。
  • [OK]を使用して変更を適用します。

より多くの指示と使用方法のヒントは、ポップアップですぐに利用できます。

SQL文の作成

SQL文を作成するときは、次のようにします。

  • 定義済みパターン(Ctrl+J またはコード | ライブ・テンプレートの挿入)。
    sqlConsoleLiveTemplates
  • SQLキーワード、テーブル名、カラム名の自動補完と強調表示。
    sqlConsoleAutocompletion
  • データ型は列(Ctrl+P または表示 | パラメーター情報)のプロンプトを表示します。
    sqlConsoleParameterInfoTooltip
  • 高度な検索および置換機能(Ctrl+F または編集 | 検索 | 検索、および Ctrl+R または編集 | 検索 | 置換)。
    sqlConsoleFindAndReplace
  • クイック評価(Ctrl+Alt+F8)。テーブル名と列名、およびSQLキーワードに使用でき、ステートメントの作成時にデータと潜在的な結果についてのヒントを提供します。
    DBQuickEvaluation
  • コンソール履歴(icons vcs history または Ctrl+Alt+E)。 自動記憶されたステートメントの実行を参照してください。
    sqlConsoleHistory

データベースツールウィンドウのテーブルまたは列ビューへの移動も参照してください。

表形式のINSERT文のデータの編集

  1. 目的の INSERT ステートメントを選択します。
  2. コンテキストメニューからテーブルとして編集を選択します。
    sqlConsoleTableEditorForInsert
  3. コンテキストメニューコマンドと関連するショートカットを使用してデータを操作します。

ステートメントを作成するときには、テーブルの構造を調べたり、テーブルのコンテキスト内のカラム(フィールド)に関する情報を参照することが役立つことがあります。このような目的のために、DataGripには、入力ペインのテーブルまたは列の名前から、データベースツールウィンドウのビューに切り替える機能があります。

この機能を使用するには、次の方法があります。

  • 関心のある表または列の名前の中にカーソルを置きます。その後、Ctrl+Bを使用します。 (または、メインメニューのナビゲート | 宣言またはコンテキストメニューのジャンプ | 宣言を使用することもできます)。
  • Ctrl キーを押したまま、目的の名前をポイントします。テキストがハイパーリンクに変わったら、ハイパーリンクをクリックします。
    sqlConsole1

実行コマンドの設定

文の実行には、実行コマンド(ツールバーのicons toolwindows toolWindowRun svg 、コンテキストメニューの Ctrl+Enter または実行)が使用されます。

DataGripには、カーソル位置と選択の有無に応じて、Executeコマンドの多くのオプションが用意されています。

オプションは、設定/環境設定ダイアログ(WindowsおよびLinuxではファイル | 設定 | データベース | 一般、macOSではDataGrip | 環境設定 | データベース | 一般)のデータベース | 一般ページで指定します。詳細については、コンソールで実行を参照してください。

SQL文の実行

  1. ステートメント内にカーソルを置きます。
  2. 以下のいずれか 1 つを実行します
    • ツールバーの icons toolwindows toolWindowRun svg をクリックします。
    • Ctrl+Enterを押します。
    • コンテキストメニューから実行を選択します。
  3. 実行するステートメントを選択します。 (提案リストには常にすべてのステートメントを実行するための項目が含まれています)。
DBSelectStatementToExecute

コンソールで実行も参照してください。

パラメータ化された文の実行

ステートメントにパラメーターを含めることができますが、ステートメントを実行するまでにパラメーターの値を指定する必要があります。パラメータ値を指定する方法は次のとおりです。

  • ツールバーの icons toolwindows toolWindowRun svg をクリックするか、 Ctrl+Enter を押して文を実行してください。開いたダイアログで、パラメータ値を指定して[OK]をクリックします。
    sqlConsoleParamsDBE

    (値の編集を開始するには、対応する表のセルに切り替えて入力を開始します。値の編集が終了したことを示すには、 Enter を押すか、別のセルに切り替えます。 )

  • または、データベース・コンソールツールウィンドウ(ツールバーの property yellow )でパラメーターペインを開き、そこに対応する値を指定することもできます。 (値は、対応するダイアログと同様に編集されます。)次に、ステートメント(ツールバーまたは Ctrl+Enter上の icons toolwindows toolWindowRun svg )を実行します。
    sqlConsoleParamsPane

    詳細は、パラメータペインを参照してください。

ユーザー・パラメーターおよび実行前に常にパラメーターを確認するも参照してください。

文のグループの実行

コンソール内で連続する一連のステートメントを実行するには、ステートメントを選択(強調表示)して(すべてのステートメントを選択し、 Ctrl+Aを使用)、次のいずれかを実行します。

  • ツールバーの icons toolwindows toolWindowRun svg をクリックします。
  • Ctrl+Enterを押します。
  • コンテキストメニューから実行を選択します。

エラー通知バーの使用およびコンソールで実行も参照してください。

すべてのステートメントの実行

コンソールに含まれるすべてのステートメントを実行するには、実行コマンドの代わりにconsole.sqlを実行するコマンドを使用します。

このコマンドは、コンテキストメニューで使用でき、キーボードの対応は Ctrl+Shift+F10です。

一般に、console.sqlを実行するコマンドは高速に実行されますが、

  • パラメーター付きのステートメントは実行されません。
  • SELECT ステートメントの取得データは表示されません。

ステートメントの一部(サブクエリなど)を実行する

ステートメントの一部(サブクエリなど)を実行するには、実行するフラグメントを選択(強調表示)し、次のいずれかの操作を行います。

  • ツールバーの icons toolwindows toolWindowRun svg をクリックします。
  • Ctrl+Enterを押します。
  • コンテキストメニューから実行を選択します。

コンソールで実行も参照してください。

自動記憶されたステートメントの実行

コンソールでSQL文を実行すると、DataGripはそれらを記憶します。したがって、後で実行したステートメントを表示し、必要に応じて再度実行することができます。

auto-memorizedステートメントが表示されているダイアログ(ヒストリーダイアログ)を開くには、次のいずれかの操作を行います。

  • ツールバーの icons vcs history をクリックします。
  • Ctrl+Alt+Eを押します。

ヒストリーダイアログには2つのペインがあります。 left-handペインには、実行したステートメントのリストが表示されます。 "長い"ステートメントの場合、最初のステートメントのみが表示されます。このペインで文を選択すると、全体の文が右側のペインに表示されます。

情報をフィルタリングすることができます:入力を開始するだけです。結果として、入力されたテキストを含むステートメントだけが表示されます。

ステートメントをヒストリーダイアログからコンソールの入力ペインにコピーすることができます。ステートメントをコピーするには、次のいずれかの操作を行います。

  • コピーするステートメントをダブルクリックします。
  • 関心のある文を選択し、Enterを押します。
  • ステートメントを選択し、[OK]をクリックします。

(ステートメントが入力ペインに表示されたら、すぐに実行できます)。

不要なメモを削除することができます。文を削除するには、ヒストリーダイアログで文を選択し、Deleteを押します。

SELECTステートメントの結果をファイルに出力する

データベース・コンソールツールウィンドウの結果ペインの代わりに、 SELECT ステートメントの結果をファイルに出力することができます。

  1. 目的の SELECT ステートメントを右クリックします。
  2. ファイルへ実行をポイントし、出力形式を選択します。
  3. 出力ファイルの場所と名前を指定します。

エラー通知バーの使用

文を実行しているときにエラーが発生すると、入力ペインの下部にエラー通知バーが表示されます。

このバーは、一連のステートメント(文のグループの実行を参照)を実行するときに特に役立ちます。そのような場合、反応する方法を選択できるからです。

DBConsoleErrorNotificationBar

オプションは次のとおりです。

  • 再試行エラーの原因となったものから始まる一連のステートメントを実行します。
  • 無視誤った文をスキップし、次の文から順に実行してください。別のエラーが発生すると、エラー通知バーが再度表示されます。
  • すべて無視誤った文をスキップし、次の文から順に実行してください。他のエラーが発生した場合、すべての誤ったステートメントはスキップされ、これらのステートメントのエラー通知バーは表示されません。
  • 停止シーケンスの実行を停止します。

入力ペインにエラー通知バーが表示されるのは、設定ダイアログ(データベース | 一般ページ エディターにエラー通知を表示するチェックボックス)で有効または無効です。

実行中のステートメントのキャンセル

現在の1つまたは複数のステートメントの実行を終了するには、次のいずれかを実行します。

  • 入力ペインのツールバーまたはDababaseコンソールツールウィンドウのツールバーで icons actions suspend svg をクリックします。
  • Ctrl+F2を押します。

データベーストランザクションの管理

自動または手動でトランザクションをコミットするように選択できます。コミットモードを変更するには、ツールバーのTxスイッチ buttonTransactionControlDB を使用します。

TransactionControlDB

コミット・モードが自動に設定されている場合、各SQLステートメントは、暗黙的にコミットされた独自のトランザクションで実行されます。したがって、このモードで実行されるSQL文はロールバックできません。

コミットモードがマニュアルに設定されている場合、トランザクションはツールバーの iconDBCommitTransaction または iconDBRollbackTransaction を使用して明示的にコミットまたはロールバックされます。

Txスイッチを使用して、トランザクションの分離レベル(英語)を選択することもできます。

マイグレーションの実行

プロシージャ、関数、ビュー、マテリアライズドビュー、ルール(PostgreSQL)、イベント(MySQL)、スクリプト(Exasol)、トリガ(PostgreSQLを除く)のようなSQLオブジェクトの移行ツールを使用できます。

  1. データベースオブジェクトをダブルクリックします。
  2. オブジェクトのソースコードを変更します。 DataGripはガターのすべての変更をハイライト表示します。
  3. コミットアイコン(icons actions commit dark svg)をクリックします。
  4. オブジェクトの移行ウィンドウで、変更内容を確認し、[OK]をクリックします。

ストアドプロシージャを実行する

  1. 実行するストアドファンクションを右クリックします。
  2. 実行ルーチンウィンドウで、必要なすべてのパラメータ値を入力し、[OK]をクリックします。
db run stored functions

実行計画の表示

次のコンテキストメニューコマンドを使用すると、ステートメントの実行計画(英語)(別名. explain plan)を表示できます。

  • 計画の表示結果は、専用のプランタブでツリー/テーブルの混合形式で表示されます。
  • 計画の説明(生)。結果を表形式で示します。 (技術的には、 EXPLAIN <CURRENT_STATEMENT> などの文が実行されます。)

OracleのDBMS_OUTPUTを表示します。

Oracleでは、出力ペインでDBMS_OUTPUTバッファの内容の表示を有効または無効にすることができます。これを行うには、データベース・コンソールツールウィンドウ(Ctrl+F8)のツールバーで DBConsoleEnableDBMSOutputIcon を使用します。

DBConsoleDBMSOutput
最終変更日: 2018年8月17日