DataGrip 2018.3ヘルプ

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文の実行

SQL文を実行する

  1. ステートメント内にカーソルを置きます。

  2. Ctrl+Enterを押します。または、ツールバーの実行アイコン The Execute icon をクリックします。

  3. 複数のステートメントがある場合は、すべてのステートメントを実行するか、単一のステートメントを実行するかを選択します。提案リストには、常にすべてのステートメントを実行するための項目が含まれています。

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

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

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

    (値の編集を開始するには、対応するテーブルセルに切り替えて入力を開始します。値の編集が終了したことを示すには、 Enter を押すか別のセルに切り替えます。編集モードを終了して初期値に戻すには、Escapeを押します。)

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

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

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

文のグループの実行

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

Ctrl+Enterを押します。または、ツールバーの実行アイコン The Execute icon をクリックします。

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

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

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

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

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

  • パラメーター付きのステートメントは実行されません。

  • SELECT ステートメントの取得データは表示されません。

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

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

Ctrl+Enterを押します。または、ツールバーの実行アイコン The Execute icon をクリックします。

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

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

コンソールで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 <CURRENT_STATEMENT> などの文が実行されます。)

OracleのDBMS_OUTPUTを表示します。

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

DBConsoleDBMSOutput
最終更新日: 2019年2月6日