ワークシート・エディタでのSQL、PL/SQLおよびJavaScriptコードの実行

SQLワークシート・エディタで、SQL文、PL/SQLスクリプトおよびJavaScriptコードを実行できます。エディタには、状況に応じたコード補完、構文強調表示、エラーデバッグなどの機能があります。

ノート

PL/SQLおよびJavaScriptエディタ・モードは、MySQLデータベース・サービスでは使用できません。

SQL文またはPL/SQLコード・ブロックを入力して、表の作成、データの挿入、データの選択、表からのデータの削除などのアクションを指定できます。SQLキーワードは自動的に強調表示されます。複数の文の場合は、次の文を終了する必要があります。

  • PL/SQL以外の各文で、セミコロン(;)またはスラッシュ(/)を改行します。
  • 新しい行にスラッシュ(/)が付いた各PL/SQL文

ワークシートでサポートされているSQL*PlusおよびSQLcl文については、SQLワークシートでサポートされているSQL*PlusおよびSQLclコマンドを参照してください。

PL/SQLエディタ・モードは、ファンクション、プロシージャ、パッケージおよびタイプのオブジェクト・タイプを開くときにワークシートでトリガーされます。このエディタは、コンパイル中にPL/SQLコード内のエラーを検出するのに役立ちます。出力には、エラーが検出された特定の行や列などのエラーの詳細と、コード・ブロック内の関連する位置に移動するためのリンクが含まれます。

JavaScriptワークシート・モードでは、Oracle Databaseリリース21cで導入されたMultilingual Engine機能がサポートされています。詳細は、Multilingual Engineのサポートを参照してください。

コード・エディタの支援

Ctrl+Spaceを押すと、編集中のコードの自動補完に使用できる挿入ポイントで完了候補のリストがエディタに表示されます。このリストは、挿入ポイントのコード・コンテキストに基づいています。

この図は、コードの自動補完に使用できる完了候補のリストを示しています。

エディタには、コマンド・パレットから使用できるコマンドの包括的なリストも用意されています。コマンド・パレットを開くには、Ctrl+Shift+Pを押します。キーボードショートカットキーのリストについては、Keyboard Shortcutsを参照してください。

コードのエラーは、左側のガッターの赤いドットと、特定のテキストの下の2乗の線で示されます。マウスのポインタを重ねると、エラーを解決するための修正候補を示すポップアップが表示されます。

この図は、コード内のエラーがどのように識別されるかと、エラーの解決方法に関する提案のリストを示しています。

SQL文を自動的に生成するためのオブジェクトのドラッグ・アンド・ドロップ

ノート

この機能は、MySQLデータベース・サービスでは使用できません。

左ペインからオブジェクトをドラッグし、右ペインのワークシート・エディタにドロップできます。

  • 表またはビューをドラッグ・アンド・ドロップすると、挿入、更新、選択または削除のいずれかのSQL文を選択するように求められます。

    たとえば、「選択」を選択すると、SELECT文が表またはビューのすべての列で構成されます。次に、列リストの変更やWHERE句の追加など、文を編集できます。

    この図は、SELECT文が選択されたときにワークシート・エディタでオブジェクトに対して生成されるSQLコードを示しています。

    「オブジェクト名」を選択すると、スキーマ名の前に付いたオブジェクトの名前がワークシートに追加されます。

  • ファンクションまたはプロシージャをドラッグ・アンド・ドロップする場合、ワークシートにファンクションまたはプロシージャの名前またはPL/SQLコードを挿入することを選択できます。PL/SQLコードを選択した場合は、ワークシートにコードを挿入する前にパラメータを入力できます。

エディタの設定

コード・エディタのプリファレンスは、左側のサイドバーにある「プリファレンス」オプションを使用して設定できます。カスタマイズできるコード・エディタのオプションには、テーマ(ライト、ダークおよびハイ・コントラスト・ダーク)、フォント・サイズとファミリ、タブ・サイズ、ワード・ラップ、ルーラー、ライン番号などがあります。

ツールバーのアイコン

SQLワークシート・エディタのツールバーには、次の操作のアイコンが含まれています。

  • 「ワークシート」ドロップダウン・リスト

    • 開く: ブラウザ、デバイスまたはオブジェクト・ストレージからファイルを開きます。
    • 最近開いたファイルを開く: 最近アクセスしたファイルを表示します。最近のリストに5つ以上のファイルがある場合、追加ファイルを表示するための「詳細」リンクが表示されます。
    • 名前を付けて保存: ブラウザ、デバイスまたはオブジェクト・ストレージにファイルを保存します。
  • 新規ファイル
    • 「ワークシート」: 「ワークシートの作成」を選択します。
    • 「PL/SQL」: 「PL/SQLオブジェクト・タイプの作成」を選択します。エディタがPL/SQLモードに切り替わります。
  • 開く: ブラウザ、デバイスまたはオブジェクト・ストレージからファイルを開きます。デバイスからファイルを開くには、「ファイルを開く」スライダで「ファイルを開く」をクリックし、ファイルを参照して選択するか、ファイルをスライダにドラッグ・アンド・ドロップします。
  • 文の実行: ワークシート・エディタのマウス・ポインタで、選択した文または文を実行します。SQL文には、VARCHAR2タイプのバインド変数および置換変数を含めることができます。変数値を入力するためのダイアログ・ボックスが表示されます。

  • スクリプトの実行: スクリプト・ランナーを使用して、ワークシート・エディタのすべての文を実行します。SQL文には、VARCHAR2タイプのバインド変数(置換変数は含まない)を含めることができます。バインド変数値を入力するためのダイアログ・ボックスが表示されます。

  • コンパイル(PL/SQLツールバーの場合): サブプログラムのPL/SQLコンパイルを実行します。

    ノート

    「コンパイル」アイコンは、MySQLデータベース・サービスでは使用できません。
  • 実行計画: 文の実行計画を生成します。出力は、出力ペインの「実行計画」タブに表示されます。「実行計画ダイアグラムの使用」を参照してください。

    ノート

    「実行計画」アイコンは、MySQLデータベース・サービスでは使用できません。
  • 自動トレース: 文を実行し、SQL文の実行統計および実際の実行計画を表示します。出力は、出力ペインの「自動トレース」タブに表示されます。

    ノート

    「自動トレース」アイコンは、MySQLデータベース・サービスでは使用できません。
  • エディタ・コンテンツのダウンロード: ワークシートのコンテンツをSQLファイルとしてローカル・システムにダウンロードします。

  • 書式: 文、句、キーワードの名前の大文字化、改行とインデントの追加など、エディタでSQL文を書式設定します。

  • クリア: エディタから文を削除します。

  • 全画面表示で開く: エディタを全画面モードで開きます。

  • データのロード: データのロード・ウィザードを開きます。データのロードを参照してください。

    ノート

    「データ・ロード」アイコンは、MySQLデータベース・サービスでは使用できません。