Tosca Data Integrityを利用してみる（準備編: SAP接続・ODBC接続）

背景

ToscaではDataIntegrityと呼ばれるデータ整合性のチェックをテストする機能が提供されています。
この機能の紹介を「準備編」と「実践編」に分けて紹介します。

Data Integrityを触り始めると、最初に詰まりやすいのが「接続準備」です。

• ODBCはどこで作るのか
• DI connectionとテストケースの接続指定はどう違うのか
• SAPデータを読むには何を先に入れるべきか

この記事では、Data Integrityの準備編として、実際に比較テストへ進む前に必要な設定を整理します。
本記事でご紹介する対象は ODBC接続設定 と SAP Custom Data Reader設定 です。

この記事でやること

1. Data Integrityの前提条件（ライセンス・権限・実行基盤）を確認
2. ODBC接続を作成し、DI connectionとしてTosca Cloudに登録
3. SAP Custom Data Readerの準備とテストケース設定を実施

前提（Pre-Requisite）

Data Integrityの接続作業に入る前に、以下を確認します。

1. ライセンス

Data Integrity関連機能は、有効なData Integrityライセンスがないと利用できません。Tosca Cloudとは個別の追加ライセンスが必要になります。

2. 権限

• DI connectionの作成・編集ができること
• SAP用ライブラリのアップロードを行う場合は、Tosca CloudのAdmin権限が必要

3. 実行環境

• ODBC DSNは 実行環境（Personal Agent Machine,Team Agent Machine） 側で作成する
• SAP接続では、SAP側アドオンと.NET Connector関連DLLを事前準備しておく（要S-ID)

🔌 Step 1: ODBC接続を準備する

1-1. AgentマシンでODBC DSNを作成

Windowsの ODBC Data Source Administrator でSystem DSNを作成します。

1. Control Panel > Administrative Tools > ODBC Data Sources
2. System DSN タブで Add
3. DB種別に合うODBCドライバを選択
4. ドライバ設定で接続先DBを指定して保存

• Data IntegrityのODBC接続は、ODBCドライバ依存です
• 使うDBベンダーのODBC制約および接続情報を事前に確認しておくとスムーズです

1-2. Tosca CloudでDI connectionを作成

Configurations > DI connections > Create connection から作成します。
接続タイプは次の3つです。

1. ODBC data source
ODBC Data Source Administrator に作ったDSN名を使う方式

2. Connection string
   ODBC connection stringを直接指定する方式

3. SQLite

4. SQLite DatabaseへのConnection Stringを指定する方法

設定時の主項目:

• Connection name（テストで参照する名前）
• ODBC data source または Connection string
• Credentials > User ID / Password
• Timeout > Connection / Command

[接続情報設定画面]

1-3. テストケースでConnectionを利用

DataIntegiry の関連モジュールで接続情報のconnection名を指定します。
（実際のテストケースの設定は後続の記事で紹介します）

[テストケースでの設定画面例]

• Connection を使うと、DSN / UserID / Password / Connection String の個別指定は置き換えられます
• Connection 属性はバッファやパラメータで動的上書きできません

Step 2: SAP Custom Data Readerを準備する

2-1. インフラ準備

SAP Reader利用前に、以下を準備します。

1. SAP Support Portalから SAP Connector for Microsoft .NET (NCo 3.1, 64bit) を取得
2. Tricentis Support Hubから Tosca_DI_SAPCustomDataReader_ABAP_Addon を取得してSAPに導入
3. Tosca Cloudで
   Configurations > Uploads > Custom Data Readers > Upload file
   から SAP を選び、必要DLLをアップロード

アップロード対象（公式記載）:

• cpc4n.dll
• ijwhost.dll
• Microsoft.Win32.Registry.dll
• sapnco.dll
• sapnco_utils.dll
• System.Configuration.ConfigurationManager.dll

[Upload後画面]

ここでアップロードしたファイルはテナント内で共通して利用可能になります。

2-2. テストケースでSapReaderを設定

DataIntegirty関連モジュールのLoad Data into Caching Database系モジュールにて
Custom Data Reader を設定します。

• Class Attribute Name : SapReader

Parameters には以下を設定します。

Parameter	内容	必須
SystemNumber	ABAPアプリケーションサーバーのインスタンス番号（0-99）	必須
ApplicationServer	SAPサーバーのDNS名またはIP	必須
Client	SAP Client ID	必須
Language	ログイン言語（例: EN）	必須
Username	SAP接続ユーザー	必須
Password	SAP接続パスワード	必須
Tablename	参照するSAPテーブル名（大文字小文字を区別）	必須
DataProvisioningTimeout	SAPからのデータ取得待機秒（既定300秒）	任意
RowFilters	行抽出条件（F[],O[],L[],H[],S[]）	任意
ColumnFilters	列抽出条件（F[]）	任意

RowFilters例:

F[OrderID],O[BT],L[1000],H[2000],S[I];F[Status],O[EQ],L[Canceled],S[E]

意味:

• OrderID が1000〜2000の行を含める
• Status = Canceled の行は除外する

ColumnFilters例:

F[OrderID];F[Status];F[OrderDate];F[DeliveryDate]

[SAPテーブル接続情報例]

トラブルシュート例

DI connectionが一覧に出ない

• Data Integrityライセンスが有効か確認
• ワークスペース権限を確認

ODBC接続で失敗する

• DSNがAgentマシン側に存在するか確認
• DSN名のスペル（大文字小文字、空白）を再確認
• ドライバ側制約（SQL対応）を確認

SAP Readerで接続できない

• SapReader の綴りを確認
• 必須パラメータ（SystemNumber/ApplicationServer/Client/Language/Username/Password/Tablename）を再確認
• SAP用DLLがCustom Data Readers > SAPに正しくアップロードされているか確認

まとめ

準備編で押さえるべきポイントは次の3つです。

1. Data Integrityの表示可否はライセンスで決まる
2. ODBCは「Agent側DSN作成」と「Cloud側DI connection登録」の2段階
3. SAPは「インフラ準備（NCo/Addon/DLL）」と「SapReaderパラメータ設定」の両方が必要

次回は、この接続設定を使って Complete Row by Row Comparison を実際に動かし、比較結果の見方を紹介します。

参考リンク（公式ドキュメント）

• Validate your data integrity
• Run tests with SAP databases
• Complete Row by Row Comparison module
• Work with Data Integrity connections
• Set up your Data Integrity connection details
• Create an ODBC connection to a database

---

本記事は 2026-02-20 時点の公開ドキュメントをもとに作成しています。