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 Test 構成タイプの設定の詳細については、「utPLSQL Test」を参照してください。
構成をすぐに実行することも、構成を保存して後で実行することもできます。
OK をクリックして、後で使用するために実行構成を保存し、ダイアログを閉じます。
構成をすぐに実行するには、「実行」をクリックします。
![Run files by using run/debug configurations](https://resources.jetbrains.com/help/img/idea/2024.1/db_run_utplsql_tests.png)
生産性のヒント
エディターからテストを実行する
データベースエクスプローラー ( ) で、テストをダブルクリックします。
エディターで、ガターの実行アイコン
をクリックし、<procedure_name> を実行しますを選択します。
失敗したテストの再実行
実行ツールウィンドウで、失敗したテストの再実行ボタンをクリックします。
関連ページ:
![](https://resources.jetbrains.com/help/img/idea/2024.1/db_ui_main_elements.png)
ユーザーインターフェース
DataGrip で新しいプロジェクトを開くと、IDE に基本的な要素といくつかの便利なショートカットが表示されます。DataGrip の主なユーザーインターフェース要素は次のとおりです。ツールバー。データベースエクスプローラー (ツールウィンドウ)。ファイルツールウィンドウ。クエリコンソール。データエディターとビューアー。ポップアップメニュー、コンテキストメニュー。サービスツールウィンドウ。クエリ結果タブ。ナビゲーションバー。ステータスバー。
![](https://resources.jetbrains.com/help/img/idea/2024.1/db_run_configuration_utPLSQL_test.png)
utPLSQL テスト
作成:utPLSQL テスト構成を使用すると、PL/SQL (Oracle) で使用できるパッケージ、関数、プロシージャ、トリガー、ビュー、その他のオブジェクトをテストできます。utPLSQL テストの実行に関するチュートリアルについては、utPLSQL テストを実行するを参照してください。データソース tSQLt テストを実行する Microsoft SQL Server データソースを指定します。パステストパッケージへの修飾パスを入力します。タグ実行するテストのタグを入力します。区切り文字とし...
![](https://resources.jetbrains.com/help/img/idea/2024.1/db_tsqlt_create_new_class.png)
tSQLt テストの実行
tSQLt は Microsoft SQL Server のユニットテスト用のフレームワークです: これを使用して、データベースのストアドプロシージャ、関数、ビュー、トリガーをテストできます。インストール後、tSQLt スクリプトは、フレームワークの関数とプロシージャを格納するスキーマを作成します。一部のプロシージャにはプレフィックスがあり、フレームワークでのみ使用できます。ステップ 1. テストするオブジェクトを作成する説明のために、tsqlt.org の tSQLt チュートリアルからスキー...
![](https://resources.jetbrains.com/help/img/idea/2024.1/db_testing_with_tsqlt.png)
テスト
テストはあなたのコードの振る舞いが正しいことと期待されることを保証します。よく書かれたテストでは、自分のコードが機能し、既存のコードが破損することはないという自信を持って開発することができます。DataGrip には、テストの実行に使用できるいくつかのフレームワークが含まれています。utPLSQLOracle データベースで PL/SQL コードをテストするためのフレームワーク。の詳細については、utplsql.org にある公式ドキュメントを参照してください。tSQLtMicrosoft SQL...