DataGrip 2024.1 ヘルプ

utPLSQL テストを実行する

utPLSQL は、Oracle データベースのテストフレームワークです。utPLSQL を使用して、PL/SQL で使用できるパッケージ、関数、プロシージャ、トリガー、ビュー、その他のオブジェクトをテストできます。

utPLSQL を使用するには、フレームワークを Oracle データベースにインストールします。公式の utPLSQL ドキュメント(英語)のインストール手順を参照してください。

utPLSQL の簡単な概要と例については、utplsql.org で TDD と utPLSQL 入門(英語)を参照してください。

ステップ 1. utPLSQL スキーマを有効にする

テストで utPLSQL オブジェクトを使用するには、DataGrip で utPLSQL スキーマを有効にします。

  1. データソース名の近くにある N の N リンクをクリックします。スキーマ選択ウィンドウで、utPLSQL スキーマ(UT3 など)を選択します。

  2. Enter を押します。

    Enable the utPLSQL schema

ステップ 2. テストする関数を作成する

  1. データベースエクスプローラー (View | ツールウィンドウ | データベースエクスプローラー ) で、Oracle データソースを右クリックし、クエリコンソールを開くを選択します。

  2. テストする関数のコードを記述します。次の例について考えてみます。

    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; /
  3. 実行ボタン(the Execute button)をクリックするか、Ctrl+Enter を押します。

    Create a function to be tested

ステップ 3. テストパッケージを作成する

  1. データベースエクスプローラー (View | ツールウィンドウ | データベースエクスプローラー ) で、Oracle データソースを右クリックし、クエリコンソールを開くを選択します。

  2. エディターで、すべてのテストをリストするパッケージのコードを入力します。次の例について考えてみます。

    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; /
  3. 実行ボタン(the Execute button)をクリックするか、Ctrl+Enter を押します。

    Create a testing package

ステップ 4. テストパッケージにテスト手順を作成する

  1. データベースエクスプローラー (View | ツールウィンドウ | データベースエクスプローラー ) で、Oracle データソースを右クリックし、クエリコンソールを開くを選択します。

  2. エディターで、テスト手順のコードを入力します。次の例について考えてみます。

    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; /
  3. 実行ボタン(the Execute button)をクリックするか、Ctrl+Enter を押します。

    Create test procedures in the testing package

ステップ 5. 実行構成を使用して utPLSQL テストを実行する

  1. 以下のいずれかの方法で実行 / デバッグ構成ダイアログを開きます。

    • メインメニューから実行 | 実行構成の編集を選択します。

    • ナビゲーションバーが表示された状態(表示 | 外観 | ナビゲーションバー)で、実行 / デバッグ構成セレクターから実行構成の編集を選択します。

    • Alt+Shift+F10 を押してから、0 を押します。

  2. 実行 / デバッグ構成ダイアログで、新規構成の追加アイコン(the Add New Configuration icon)をクリックし、utPLSQL テストを選択します。

    • データソース : データソースの名前。utPLSQL は Oracle をサポートしています。

    • パス : テストパッケージへの修飾パス(GUEST.EXAMPLE_PACKAGE など)。

    • タグ : 実行するテストのタグ。セミコロン(;)を区切り記号として使用します(たとえば、basic;with_zero)。

    utPLSQL Test 構成タイプの設定の詳細については、「utPLSQL Test」を参照してください。

  3. 構成をすぐに実行することも、構成を保存して後で実行することもできます。

    • OK をクリックして、後で使用するために実行構成を保存し、ダイアログを閉じます。

    • 構成をすぐに実行するには、「実行」をクリックします。

Run files by using run/debug configurations

生産性のヒント

エディターからテストを実行する

  1. データベースエクスプローラー (View | ツールウィンドウ | データベースエクスプローラー ) で、テストをダブルクリックします。

  2. エディターで、ガターの実行アイコン the Run icon をクリックし、<procedure_name> を実行しますを選択します。

    Run tests from the editor

失敗したテストの再実行

  • 実行ツールウィンドウで、失敗したテストの再実行ボタンをクリックします。

関連ページ:

ユーザーインターフェース

DataGrip で新しいプロジェクトを開くと、IDE に基本的な要素といくつかの便利なショートカットが表示されます。DataGrip の主なユーザーインターフェース要素は次のとおりです。ツールバー。データベースエクスプローラー (ツールウィンドウ)。ファイルツールウィンドウ。クエリコンソール。データエディターとビューアー。ポップアップメニュー、コンテキストメニュー。サービスツールウィンドウ。クエリ結果タブ。ナビゲーションバー。ステータスバー。

utPLSQL テスト

作成:utPLSQL テスト構成を使用すると、PL/SQL (Oracle) で使用できるパッケージ、関数、プロシージャ、トリガー、ビュー、その他のオブジェクトをテストできます。utPLSQL テストの実行に関するチュートリアルについては、utPLSQL テストを実行するを参照してください。データソース tSQLt テストを実行する Microsoft SQL Server データソースを指定します。パステストパッケージへの修飾パスを入力します。タグ実行するテストのタグを入力します。区切り文字とし...

tSQLt テストの実行

tSQLt は Microsoft SQL Server のユニットテスト用のフレームワークです: これを使用して、データベースのストアドプロシージャ、関数、ビュー、トリガーをテストできます。インストール後、tSQLt スクリプトは、フレームワークの関数とプロシージャを格納するスキーマを作成します。一部のプロシージャにはプレフィックスがあり、フレームワークでのみ使用できます。ステップ 1. テストするオブジェクトを作成する説明のために、tsqlt.org の tSQLt チュートリアルからスキー...

テスト

テストはあなたのコードの振る舞いが正しいことと期待されることを保証します。よく書かれたテストでは、自分のコードが機能し、既存のコードが破損することはないという自信を持って開発することができます。DataGrip には、テストの実行に使用できるいくつかのフレームワークが含まれています。utPLSQLOracle データベースで PL/SQL コードをテストするためのフレームワーク。の詳細については、utplsql.org にある公式ドキュメントを参照してください。tSQLtMicrosoft SQL...