utPLSQL テストを実行する
utPLSQL は Oracle データベース用のテストフレームワークです。 utPLSQL を使用して、PL/SQL で使用できるパッケージ、関数、プロシージャ、トリガー、ビュー、その他のオブジェクトをテストできます。
utPLSQL を使用するには、フレームワークを Oracle データベースにインストールしてください。 公式の utPLSQL ドキュメント(英語)のインストール手順を参照してください。
utPLSQL の簡単な概要と例については、 utplsql.org で TDD と utPLSQL 入門(英語)を参照してください。
ステップ 1。 utPLSQL スキーマを有効にする
テストで utPLSQL オブジェクトを使用するには、DataGrip で utPLSQL スキーマを有効にしてください。
データソース名の近くにある N の N リンクをクリックします。 スキーマ選択ウィンドウで、utPLSQL スキーマ（
UT3など）を選択します。Enter を押す。
ステップ 2. テストする関数を作成する
データベースエクスプローラー で、Oracle データソースを右クリックし、 を選択してください。
テストする関数のコードを記述します。 次の例を考えてみましょう。
create or replace function sub_str( received_string varchar2, start_pos integer, end_pos integer ) return varchar2 is begin if start_pos = 0 then return substr( received_string, start_pos, end_pos - start_pos ); else return substr( received_string, start_pos, end_pos - start_pos + 1); end if; end; /実行 ボタン（
）をクリックするか、 Ctrl+Enter を押します。
ステップ 3. テストパッケージを作成する
データベースエクスプローラー で、Oracle データソースを右クリックし、 を選択してください。
エディターで、すべてのテストをリストするパッケージのコードを入力します。 次の例を考えてみましょう。
create or replace package example_package as --%suite(Checks a substring in a string) --%test(Returns a substring when the start position is not zero) --%tags(basic) procedure start_not_zero; --%test(Returns a substring when the start position is zero) --%tags(with_zero) procedure start_zero; end; /実行 ボタン（
）をクリックするか、 Ctrl+Enter を押します。
ステップ 4. テストパッケージにテスト手順を作成する
データベースエクスプローラー で、Oracle データソースを右クリックし、 を選択してください。
エディターで、テスト手順のコードを入力します。 次の例を考えてみましょう。
create or replace package body example_package as procedure start_not_zero is begin ut.expect( sub_str( '1234567', 2, 5 ) ).to_equal('2345'); end; procedure start_zero is begin ut.expect( sub_str( '1234567', 0, 5 ) ).to_equal('12345'); end; end; /実行 ボタン（
）をクリックするか、 Ctrl+Enter を押します。
ステップ 5. 実行構成を使用して utPLSQL テストを実行する
以下のいずれかの方法で 実行 / デバッグ構成 ダイアログを開きます。
メインメニューから を選択します。
ナビゲーションバーが表示されている場合（ ）、実行 / デバッグ構成セレクターから を選択します。
Alt+Shift+F10 を押してから、 0 を押します。
実行 / デバッグ構成 ダイアログで、 新しい構成の追加 アイコン（
）をクリックし、 utPLSQL テスト を選択します。データソース: データソースの名前。 utPLSQL は Oracle をサポートしています。
パス: テストパッケージへの修飾パス（
GUEST.EXAMPLE_PACKAGEなど）。タグ: 実行するテストのタグ。 セミコロン（
;）を区切り記号として使用します（たとえば、basic;with_zero）。
utPLSQL テスト 構成タイプの設定の詳細については、「utPLSQL テスト 」を参照してください。
構成をすぐに実行することも、構成を保存して後で実行することもできます。
実行構成を後で使用するために保存するには、 OK をクリックします。
構成をすぐに実行するには、「実行 」をクリックします。
生産性のヒント
エディターからテストを実行する
データベースエクスプローラー で、テストをダブルクリックします。
エディターで、ガターの 実行 アイコン
をクリックし、 <procedure_name> を実行する； を選択します。
失敗したテストの再実行
実行 ツールウィンドウで、 失敗したテストの再実行 ボタンをクリックします。