4.1 アップグレードガイド...dataspider servista 4.1 upgrade guide copyright© 2018 appresso...

4.1 アップグレードガイド

(DataSpider Servista 4.1 Upgrade Guide)

ドキュメント・リリース日:2018 年 3 月 30 日 (第 2 版)

Copyright© 2018 APPRESSO K.K. All rights reserved.

DataSpider Servista 4.1 Upgrade Guide


2

目次

1. はじめに ................................................................................................................. 8

1.1. 注意事項 ........................................................................................................... 9

1.1.1. お客様へのお願い .......................................................................................... 9

1.1.2. 商標について ................................................................................................ 9

1.2. 表記について.................................................................................................... 10

1.3. マークについて ................................................................................................. 10

2. 販売およびサポートの終了について ............................................................................ 11

2.1. サポートプラットフォーム .................................................................................. 11

2.2. リポジトリ DB .................................................................................................. 12

2.3. アダプタ ......................................................................................................... 14

3. DataSpider Servista のバージョンアップ .................................................................... 17

3.1. バージョンアップの対象バージョン ....................................................................... 17

3.2. バージョンアップする際の注意事項 ....................................................................... 18

3.2.1. サーバとクライアントのバージョンについて ..................................................... 18

3.2.2. バージョン間の互換について .......................................................................... 18

3.2.3. 言語の互換について ..................................................................................... 18

3.2.4. Windows - Linux 間のバージョンアップについて............................................... 19

3.2.5. バージョンごとの修正内容や仕様変更について .................................................. 20

3.2.6. アダプタのサポートプラットフォームについて .................................................. 20

3.2.7. サーバ移行機能で移行できる機能について ........................................................ 21

3.2.8. 移行できない設定について ............................................................................ 22



3

3.2.9. サポート終了プラットフォーム・リポジトリ DB・アダプタについて ....................... 23

3.2.10. マイプロジェクトのプロジェクトダウンロード・アップロード機能について .......... 23

3.2.11. ライセンスファイルの再発行について ........................................................... 24

3.3. バージョンアップの流れ ..................................................................................... 25

3.4. リポジトリ DB 有り環境のバージョンアップ(同一リポジトリ) ..................................... 26

3.4.1. 旧バージョンの DataSpider Servista でトリガーを無効にする .............................. 26

3.4.2. 旧バージョンの DataSpiderServer および DataSpider Studio の停止..................... 26

3.4.3. 旧バージョンの DataSpider Servista のバックアップ ......................................... 26

3.4.4. リポジトリ DB のバックアップ ....................................................................... 27

3.4.5. 旧バージョンの DataSpider Servista のアンインストール .................................... 27

3.4.6. 新バージョンの DataSpider Servista のインストール ......................................... 27

3.4.7. ライセンスファイルの適用 ............................................................................ 28

3.4.8. ライブラリのインストール ............................................................................ 28

3.4.9. 各種設定および各種データの移行 .................................................................... 29

3.4.10. その他設定の移行 ..................................................................................... 30

3.4.11. バージョンアップに伴う特別な設定 .............................................................. 30

3.4.12. 各種ツールのバージョンアップ .................................................................... 30

3.4.13. 新バージョンの DataSpiderServer および DataSpider Studio の起動 .................. 31

3.4.14. 新バージョンの DataSpider Studio for Web の起動 ........................................ 31

3.5. リポジトリ DB 有り環境のバージョンアップ(別リポジトリ)........................................ 32

3.5.1. トリガーの停止ができる場合(平行運用を行わないケース) .................................... 32

3.5.2. トリガーの停止ができない場合(平行運用を行うケース) ....................................... 33

3.6. リポジトリ DB 無し環境のバージョンアップ ........................................................... 34

3.6.1. 旧バージョンの DataSpider Servista で DataSpiderServer 設定のエクスポートを行う



4

34

3.6.2. 旧バージョンの DataSpiderServer および DataSpider Studio の停止..................... 34

3.6.3. 旧バージョンの DataSpider Servista のバックアップ ......................................... 34

3.6.4. 旧バージョンの DataSpider Servista のアンインストール .................................... 35

3.6.5. 新バージョンの DataSpider Servista のインストール ......................................... 35

3.6.6. ライセンスファイルの適用 ............................................................................ 35

3.6.7. ライブラリのインストール ............................................................................ 36

3.6.8. 各種設定および各種データの移行 .................................................................... 36

3.6.9. その他設定の移行 ........................................................................................ 37

3.6.10. バージョンアップに伴う特別な設定 .............................................................. 37

3.6.11. 各種ツールのバージョンアップ .................................................................... 38

3.6.12. 新バージョンの DataSpiderServer および DataSpider Studio の起動 .................. 38

3.6.13. 新バージョンの DataSpider Servista で DataSpiderServer 設定のインポートを行う

38

3.6.14. 新バージョンの DataSpider Studio for Web の起動 ........................................ 38

3.7. バージョンアップと同時にリポジトリ DB 無しからリポジトリ DB 有りに変更する場合 ..... 39

3.8. バージョンアップと同時にプラットフォームの移行を行う場合 .................................... 39

4. サポート終了プラットフォーム、リポジトリ DB、アダプタのバージョンアップ方法 .............. 40

4.1. プラットフォームの移行 ..................................................................................... 40

4.2. リポジトリ DB の移行 ........................................................................................ 40

4.3. アダプタの移行 ................................................................................................. 41

5. バージョンアップに伴う特別な設定 ............................................................................ 43

5.1. アダプタの互換性プロパティ ............................................................................... 43

5.1.1. DataSpider Servista 3.0 の互換性プロパティ ................................................... 44



5

5.1.2. DataSpider Servista 2.3.0 の互換性プロパティ ................................................ 49


5.2. Mapper の互換性プロパティ ................................................................................ 57




5.3. Mapper の新アーキテクチャへの変換 .................................................................... 64

5.3.1. 既存の Mapper の新アーキテクチャへの反映方法 ............................................... 64

5.4. カレンダーの設定 .............................................................................................. 65

5.4.1. 基準カレンダーの変更反映方法 ....................................................................... 65

5.4.2. 定期的な休日の設定の修正反映方法 ................................................................. 66

5.5. 日付/時間型のスクリプト変数を文字列に展開する際にフォーマット ............................. 67

5.6. スクリプト全般 ................................................................................................. 69

5.6.1. UTF-8 のバックスラッシュを設定するとコンパイルエラーが発生する問題の修正反映方法

69

5.6.2. トランザクション処理、またはグループ処理に関する問題の修正反映方法 ................ 70

5.6.3. サービス実行に関する問題の修正反映方法 ........................................................ 71

5.7. Mapper .......................................................................................................... 72

5.7.1. ユーザ定義ロジックに関する問題の修正反映方法 (1) .......................................... 72

5.7.2. ユーザ定義ロジックに関する問題の修正反映方法 (2) .......................................... 73

5.7.3. 単純な繰り返しロジックに関する問題の修正反映方法 .......................................... 74

5.7.4. Mapper ロジックに半角カンマを含む環境変数を設定した場合に発生する問題の修正反映

方法 75

5.7.5. 「文字列ごとに置換」ロジックの[マッチング方法]に関する問題の対処方法 ............. 76

5.8. データベースアダプタ全般 .................................................................................. 77



6

5.9. Access アダプタ、SQL Server ODBC アダプタ、 ODBC アダプタ .............................. 78

5.10. Oracle 11gR2 アダプタ ...................................................................................... 80

5.10.1. ライブラリ(JDBC ドライバ)の変更 ............................................................... 80

5.11. Oracle OCI アダプタ ......................................................................................... 82

5.11.1. [8i に接続]プロパティ項目にチェックありグローバルリソースの移行方法 ................ 82

5.12. SQL Server 2014 / 2012 / 2008 R2 / 2008 アダプタ ............................................. 83


5.13. SAP テーブルクエリアダプタ ............................................................................... 85

5.13.1. SAP テーブルクエリアダプタのバージョンアップ手順 ...................................... 85

5.13.2. クォート処理設定の反映 ............................................................................ 86

5.14. List Creator アダプタ ........................................................................................ 87

5.14.1. ライブラリのパスの区切り文字の変更 ........................................................... 87

5.15. FTP アダプタ ................................................................................................... 88

5.15.1. グローバルリソースの[エンコード]の設定 ...................................................... 88

5.16. Web アダプタ .................................................................................................. 89

5.16.1. 「localhost」および「127.0.0.1」に対するプロキシサーバ接続の設定 ................ 89

5.17. Web サービスアダプタ ....................................................................................... 90

5.17.1. NamespaceDefinitionsGenerator の設定 ...................................................... 90

5.18. Amazon RDS for SQL Server 2012 アダプタ ........................................................ 92


5.19. Amazon Redshift アダプタ ................................................................................. 94


5.20. Azure SQL データベースアダプタ ......................................................................... 96




7

5.21. ScriptRunner ................................................................................................... 97

5.21.1. scriptrunner.bat の配置 ............................................................................. 97

5.22. ScriptRunnerProxy ........................................................................................... 98

5.22.1. dssrconnection.jar の更新 ......................................................................... 98

5.23. DataSpiderServer ............................................................................................ 99

5.23.1. Windows x64 版の「lax.nl.java.option.additional」設定について ..................... 99

5.24. スマートコンパイラ ..........................................................................................100

5.24.1. バージョンアップしたスクリプトへの PSP の適用 ...........................................100

5.25. HULFT DataSpider 接続アダプタ ........................................................................103

5.25.1. HULFT DataSpider 接続アダプタの設定情報の移行方法 ..................................103

6. 補足事項 ..............................................................................................................104

6.1. スキーマ読み込みの仕様変更について ...................................................................104

6.1.1. 「2.1」ツールチップが表示されるドキュメント Mapper/変数 Mapper について ......104

7. トラブルシューティング ..........................................................................................105

7.1. DataSpider Servista 2.1.1 以前からバージョンアップ後、検索系 SQL 実行処理で

「ClassCastException」が発生する ................................................................................105



8

1. はじめに

本ドキュメントは、既存の DataSpider Servista を新しいバージョンにバージョンアップする手順を記載

しています。

バージョンアップを行う場合には、必ず本ドキュメントに記載の手順に従うようにしてください。

バージョンアップではなく、新規にインストールする場合には、「DataSpider Servista インストールガイ

ド」を参照してください。



9

1.1. 注意事項

1.1.1. お客様へのお願い

本ソフトウェアの著作権は株式会社アプレッソまたはそのライセンサーが所有しています。

本ソフトウェアおよび本ドキュメントを無断で複製、転載することを禁止します。

本ドキュメントは万全を期して作成されていますが、万一不明な点や誤り、記載もれなど、お気づき

の点がございましたら弊社までご連絡ください。

本ソフトウェアは使用者の責任でご使用ください。ご使用の結果、万一トラブルおよび訴訟などが発

生しましても、あらゆる直接、または間接の損害および損失につきまして、弊社は一切責任を負わな

いものとします。あらかじめご了承ください。

本ソフトウェアの仕様や本ドキュメントに記載されている内容は、改善のため予告なしに変更される

ことがあります。

本ソフトウェアの使用には、ソフトウェアライセンス契約が必要で、株式会社アプレッソまたはその

ライセンサーの重要な業務機密と独自の情報が含まれており、日本国政府の著作権法で保護されてい

ます。株式会社アプレッソまたはそのライセンサーのソフトウェアと本ドキュメントの無断使用は、

損害賠償、刑事訴訟の対象となります。

1.1.2. 商標について

APPRESSO、APPRESSO ロゴ、アプレッソ、DataSpider、DataSpider マーク、データスパイダー、

Servista、Servista ロゴ、サービスタは、株式会社アプレッソの商標または登録商標です。

APPRESSO、APPRESSO ロゴ、アプレッソ、DataSpider、DataSpider マーク、データスパイダー、

Servista、Servista ロゴ、サービスタ以外の会社名、製品名、サービス名などは、各社の登録商標ま

たは商標です。

個々のページに表示・記載されたこれら商標などの複製・転用を禁止致します。



10

1.2. 表記について

本ドキュメント内の表記は、次の規則に沿って行われています。

DataSpider Servista の画面に表示されるメニュー名・タブ名・プロパティ項目名および値・ボタン

名は[]で囲んで太字で表します。また、それ以外の機能名や画面のタイトル、名称のないものは「」

で囲んで前者と区別しています。

「$DATASPIDER_HOME」は DataSpider Servista をインストールしたディレクトリを表します。

デフォルトでは、Windows 版の場合は「C:\Program Files\DataSpiderServista」、UNIX/Linux 版

の場合は「<ユーザのホームディレクトリ>/DataSpiderServista」となります。

x86 版とは、32bit OS を表します。

x64 版とは、64bit(Intel 64/AMD64) OS を表します。

<と>で囲まれた名称は、可変であることを表します。

例:$DATASPIDER_HOME/server/logs/<日付ディレクトリ>

本ドキュメント内に表記されているウェブサイトの URL は 2017 年 4 月現在のものです。ウェブサイ

トの都合などにより、予告なしに URL が変更になる場合があります。

「Studio」とは「DataSpider Studio」を、「Studio for Web」とは「DataSpider Studio for Web」

を指します。

DataSpiderServer についての記述は Windows 版・UNIX/Linux 版共通になっています。

オペレーティングシステムに依存する内容(パス区切り文字など)は適宜読み替えてご使用ください。

「DSS-」で始まる番号は、各問題の管理用の一意な ID となります。

1.3. マークについて

本ドキュメント内で使用しているマークについての説明は以下の通りです。

マーク説明

操作や設定に関するヒントであることを表します。

操作や設定に関する注意事項や制限事項であることを表します。

詳細な説明が別の項目に記載されていることを表します。



11

2. 販売およびサポートの終了について

2018 年 1 月 18 日現在、以下のサポートプラットフォーム、リポジトリ DB、アダプタは販売、およびサ

ポートを終了しています。

最新の情報については、https://www.appresso.com/servista/eol/を参照してください。

これらを使用している場合のバージョンアップについては「サポート終了プラットフォーム、リポジ

トリ DB、アダプタのバージョンアップ方法」を参照してください。

2.1. サポートプラットフォーム

OS サポート終了日

Red Hat Enterprise Linux 2.1 2009/12/29

Solaris 8 2009/12/29

Windows 2000 2010/7/31

Red Hat Enterprise Linux 3 2012/1/31

AIX 5L V5.3 2013/10/31

Windows XP 2014/5/31

Windows Server 2003 2015/7/31

Windows Server 2003 R2 2015/7/31

Windows 8 2016/8/31

Red Hat Enterprise Linux 4 2017/3/31

Windows Vista 2017/4/30

CentOS 5 2017/4/30

https://www.appresso.com/servista/eol/



12

2.2. リポジトリ DB

リポジトリ DB バージョンサポート終了日

DB2 UDB V7.2 2010/7/31

UDB V8.2 2012/1/31

V9.1 2013/7/31

V9.5 2015/4/30

V9.7 2017/9/30

V10.1 2017/9/30

MySQL 5.0 2012/1/31

5.1 2015/10/31

Oracle 8.1.7 2010/7/31

9.0.1 2010/7/31

9.2.0 2012/1/31

10g R1 2013/5/31

10g R2 2013/7/31

11g 2015/10/31

PostgreSQL 8.0 2010/7/31

8.1 2012/1/31

8.2 2013/7/31

8.3 2013/5/31

8.4 2014/7/31



13

リポジトリ DB バージョンサポート終了日


9.1 2016/10/31

9.2 2017/9/30

SQL Server 2000 2013/5/31

2005 2016/4/30

Amazon RDS for MySQL 5.1 2016/8/31



14

2.3. アダプタ

アダプタバージョンサポート終了日

Access 2000 2012/1/31

2002 2012/1/31

2003 2014/5/31

DB2 UDB V7.2 2009/12/29

UDB V8.2 2012/1/31

V9.1 2013/7/31

V9.5 2015/4/30

V9.7 2017/9/30

V10.1 2017/9/30

DB2 for i 5.1 2009/12/29

5.2 2010/7/31

5.3 2012/1/31

5.4 2013/10/31

6.1 2016/2/29

MySQL 5.0 2012/1/31

5.1 2015/10/31

Oracle 8.1.6 2010/7/31

8.1.7 2012/1/31

9.0.1 2012/1/31



15


Oracle 9.2.0 2012/1/31

10g R1 2013/7/31

10g R2 2013/7/31

11g 2015/10/31


8.1 2012/1/31

8.2 2013/7/31

8.3 2013/5/31

8.4 2014/7/31

9.0 2015/9/30

9.1 2016/10/31

9.2 2017/9/30

SQL Server 2000 2013/5/31

2005 2016/4/30

Amazon RDS for MySQL 5.1 2016/8/31

Excel 97 2009/12/29

2000 2012/1/31

XP 2012/1/31

2003 2014/5/31

2007 2017/10/31

Calc 2015/12/31



16


Dr.Sum EA 2.2 a 2009/12/29

2.4 2012/1/31

2.5 2013/10/31

IBM Domino 5.0 2010/7/31

6.0 2012/1/31

6.5 2012/1/31

7.0 2012/1/31

8.0 2015/5/31

IBM Notes 4.6 2012/1/31

5.0 2012/1/31

6.0 2012/1/31

6.5 2012/1/31

7.0 2012/1/31

8.0 2015/5/31

SAP 3.1H～4.7 2016/12/31

SAP BC 4.6 2016/10/31

SAP テーブルクエリ R/3 4.6C、4.7 2016/12/31

Universal Connect/X 5.3 2015/7/31

Active Directory 2000 2012/1/31

2003 2015/7/31

BIGLOBE クラウドホスティング 2016/3/31



17

3. DataSpider Servista のバージョンアップ

本項では、既存の DataSpider Servista を新しいバージョンである DataSpider Servista 4.1 へバージョ

ンアップする手順を説明します。

これ以降、現在使用している DataSpider Servista を「旧バージョン」、DataSpider Servista 4.1 を

「新バージョン」と表します。

3.1. バージョンアップの対象バージョン

DataSpider Servista 4.1 へバージョンアップを行う場合、対象となるバージョンは以下の通りです。

DataSpider Servista 2.1.0 以降 (日本語版)

2.0.2.3 以前を使用している場合は、弊社サポートセンターまで問い合わせてください。

DataSpider Servista 3.0 SP2 (英語版)



18

3.2. バージョンアップする際の注意事項

3.2.1. サーバとクライアントのバージョンについて

前提として、DataSpider Servista のサーバとクライアントは同一のバージョンである必要があります。

そのため、サーバとクライアントは同時にバージョンアップしてください。

DataSpider Studio を異なるバージョンの DataSpiderServer に接続した場合、モジュールの不整合

が発生し、再インストールが必要になるため、注意してください。

3.2.2. バージョン間の互換について

DataSpider Servista では、上位バージョンへのバージョンアップのみをサポートしています。下位バー

ジョンへのバージョンダウンはサポートしておりません。

また、リポジトリ DB も同様となります。上位バージョンで使用したリポジトリ DB を、下位バージョン

で使用することはできません。

3.2.3. 言語の互換について

旧バージョンの言語と新バージョンのサーバ言語との組み合わせにより、サポート有無が異なります。旧

バージョンの言語に合わせて、新バージョンのサーバの言語を設定してください。

新バージョン(DataSpider Servista 4.1)のサーバ言語

日本語英語

旧バージョンの

言語

日本語版 ○ ✕

英語版 ✕ ○

上記表において「○」はサポート対象内、「×」はサポート対象外になります。

サーバの言語が上記条件を満たしている場合、クライアントの言語は日本語/英語の双方がサポート対

象となります。



19

3.2.4. Windows - Linux 間のバージョンアップについて

Windows - Linux 間でバージョンアップする際には、通常のバージョンアップとは異なる確認が必要にな

ります。以下に、主に注意すべき項目をまとめました。バージョンアップ前に確認してください。

項目説明

バッチファイル/シェルファイル環境に応じて、バッチファイル/シェルファイルの再作成が必要

です。

DataSpiderServer 起動方法 Windows はサービス登録ができますが、Linux ではできません。

マウント設定 WindowsとLinuxではパスやネットワークドライブの参照方法

が異なるため、再設定が必要です。

アプリケーションログ出力先設定 NT イベントログは Windows でのみ使用できます。Linux では

Syslog に変更してください。

外部アプリケーション実行処理の起動

コマンド

環境に依存する実行形式のファイルを指定している場合、移行

先の環境に合わせたファイルを設定します。

アダプタのサポートプラットフォームアダプタによって、サポートするプラットフォームが異なる場

合があります。使用しているアダプタが移行先のプラット

フォームをサポートしているかを確認してください。

ファイルアダプタの改行コード Windows と Linux では改行コードが異なります。そのため、

「AUTO」を指定していた場合、結果も異なります。また、「CRLF」

や「CR」などの改行コードを指定した場合、必要に応じて修正

が必要です。

DataSpiderServer 設定のインポート設定名にマルチバイト文字が含まれている場合、インポート後

に文字化けが発生します。移行先でエクスポートファイルを展

開後、ZIP 圧縮のうえ、インポートしてください。

ODBC 接続 Linux で ODBC 接続するためには、JDBC Proxy Server を使用

する必要があります。



20

3.2.5. バージョンごとの修正内容や仕様変更について

バージョンごとの修正内容や仕様変更については、バージョンごとのリリースノートに記載されています。

バージョンアップの際には必ずご一読ください。

3.2.6. アダプタのサポートプラットフォームについて

アダプタによって、サポートするプラットフォームが異なる場合があります。バージョンアップ時に

DataSpider Servista のプラットフォームの変更を行う場合には、使用しているアダプタが移行先のプラッ

トフォームをサポートしているかを、DataSpider Servista ヘルプの対象アダプタの「稼働環境」ページ

で確認してください。



21

3.2.7. サーバ移行機能で移行できる機能について

DataSpider Servista 4.1 から、バージョンアップ時にサーバ移行機能を使用できるようになりました。

サーバ移行機能で移行できる機能は以下の通りです。

設定名備考

ユーザアカウント/グループ

ユーザアカウント/ユーザ

サービス

グローバルリソース新バージョンでサポート終了になったアダプタのグロー

バルリソースはエクスポート対象から外してください。

環境変数

トリガートリガーの状態を「無効」にしてエクスポートすること

を推奨します。

休日設定カレンダー

プロジェクトファイルサーバに保存されたプロジェクトが対象となります。

アプリケーションログ出力設定

マウント設定インポートする際に以下の点を確認してください。

マウント元・マウント先がインポート先に存在する

マウント元が参照可能になっている

グローバルスキーマ DataSpider Servista 4.0 からの新機能です。

グローバルユーザ定義ロジック DataSpider Servista 4.1 からの新機能です。

サーバ移行は、本ドキュメントの手順でのバージョンアップ用途以外の場合、バージョン・サービス

パック・単体パッチ適用のすべてが同一の DataSpiderServer 間でのみ使用することができます。

サーバ移行機能の詳細については、DataSpider Servista ヘルプの「DataSpiderServer の設定」ペー

ジを参照してください。



22

3.2.8. 移行できない設定について

以下の設定は、バージョンアップ時に移行できません。新バージョンの DataSpider Servista で新しく設

定してください。

設定名設定場所備考

ローカル保存されたプロジェクトバージョンアップ前に必ずサーバに

コミットするようにしてください。

検索条件マイログリポジトリ DB ありの場合は移行で

きます。

DataSpider ログ設定(圧縮設定・

削除設定)

コントロールパネル

ScriptRunner for Amazon SQS

設定

コントロールパネル

HTTPS の設定コントロールパネル

チーム開発機能の設定コントロールパネル

最大同時実行数コントロールパネル

FTP サーバの設定コントロールパネル

cacerts ファイル

lax ファイル内の設定項目 lax ファイル

アダプタやトリガーのプロパティファ

イルの設定項目

アダプタやトリガーのプロパ

ティファイル

DataSpider Studio の接続先一覧 Studio のログイン画面

DataSpider Studio の背景色 Studio デスクトップ

デザイナのレイアウトデザイナ

バージョンアップに伴う特別な

設定

詳細については、「バージョンアップ

に伴う特別な設定」項を参照してくださ

い。



23

3.2.9. サポート終了プラットフォーム・リポジトリ DB・アダプタについて

サポートを終了しているサポートプラットフォーム、リポジトリ DB、アダプタをご使用の場合には、

DataSpider Servista 4.1 でそのままご使用にはなれません。サポート対象となるサポートプラットフォー

ム、リポジトリ DB、アダプタに移行する必要があります。

詳細については、「サポート終了プラットフォーム、リポジトリ DB、アダプタのバージョンアップ方

法」を参照してください。

3.2.10. マイプロジェクトのプロジェクトダウンロード・アップロード機能に

ついて

マイプロジェクトのプロジェクトダウンロード・アップロード機能は、現在使用している本体バージョン

よりも一つ前の本体バージョン(マイナーバージョンを含む)でダウンロードしたプロジェクトのアップ

ロードのみをサポートします。

たとえば、DataSpider Servista 4.1 では、DataSpider Servista 4.0 でダウンロードしたプロジェクトの

みをアップロードできます。

二つ以上離れたバージョン間のバージョンアップ時には、マイプロジェクトのダウンロード・アップロー

ド機能は使用できませんので、注意してください。



24

3.2.11. ライセンスファイルの再発行について

以下のいずれかに当てはまる場合、DataSpider Servista 4.1 にバージョンアップする際にライセンスファ

イルの再発行が必要となります。

Amazon Web Services アダプタを使用して、4.0 以降でライセンスの新規発行または再発行をして

いない場合

Select で Excel アダプタを使用していて、3.2 SP4 以降でライセンスの新規発行または再発行をして

いない場合

Universal Connect/X アダプタを使用していて、3.2 SP1 以降でライセンスの新規発行または再発行

をしていない場合

2010 年 8 月 31 日以前に発行されている開発用サーバライセンスを使用している場合

初回出荷時点のバージョンが 2.4.4 以前の場合に該当します。

ライセンス再発行の詳細については、DataSpider Servista の販売元に問い合わせてください。



25

3.3. バージョンアップの流れ

DataSpider Servista 4.1 へのバージョンアップは、新バージョンの DataSpider Servista を新規にセッ

トアップして、旧バージョンの DataSpider Servista から設定を移行します。

バージョンアップの主な流れは以下の通りです。

1. 旧バージョンの DataSpiderServer および DataSpider Studio を停止する

2. 旧バージョンの DataSpider Servista のバックアップを行う

3. 旧バージョンの DataSpider Servista のアンインストールを行う

4. 新バージョンの DataSpider Servista をインストールする

5. 新バージョンの DataSpider Servista にライセンスファイルの適用を行う

6. 新バージョンの DataSpider Servista にライブラリのインストールを行う

7. 新バージョンの DataSpider Servista に各種設定および各種データの移行を行う

8. 新バージョンの DataSpider Servista にその他設定ファイルの移行を行う(省略可)

9. 新バージョンの DataSpider Servista にバージョンアップに伴う特別な設定を行う(省略可)

10. 各種ツールのバージョンアップを行う(省略可)

11. 新バージョンの DataSpiderServer および DataSpider Studio を起動する

バージョンアップ前に作成したプロジェクトやスクリプト、ユーザアカウントなどの各種設定情報は、バー

ジョンアップ後もそのまま使用することができます。

バージョンアップの詳細手順は、リポジトリ DB 有り/無しによって変わります。以下の一覧から、使用し

ている環境にあった項目を選択してください。

リポジトリ DB 有り環境のバージョンアップ(同一リポジトリ)

リポジトリ DB 有り環境のバージョンアップ(別リポジトリ)

リポジトリ DB 無し環境のバージョンアップ

バージョンアップと同時にリポジトリ DB 無しからリポジトリ DB 有りに変更する場合

バージョンアップと同時にプラットフォームの移行を行う場合



26

3.4. リポジトリDB有り環境のバージョンアップ(同一リポジトリ)

リポジトリ DB 有りで、旧バージョンと新バージョンの DataSpider Servista で同じリポジトリ DB を使

用する場合のバージョンアップは、以下の手順で行ってください。

3.4.1. 旧バージョンの DataSpider Servista でトリガーを無効にする

旧バージョンの DataSpider Servista で、トリガーを無効にします。マイトリガーでトリガーを全選択し、

右クリックメニューの[トリガーを無効にする]から一括で無効にできます。

3.4.2. 旧バージョンの DataSpiderServer および DataSpider Studio の

停止

旧バージョンの DataSpiderServer または DataSpider Studio が起動中の場合、停止処理を行ってくださ

い。

DataSpiderServer および DataSpider Studio の停止処理については、旧バージョンに同梱されてい

る「DataSpider Servista インストールガイド」を参照してください。

3.4.3. 旧バージョンの DataSpider Servista のバックアップ

旧バージョンの DataSpider Servista のバックアップを行います。OS のコピー機能を使用して、退避ディ

レクトリに移動します。

1. 任意の場所に退避ディレクトリを作成します。

2. 旧バージョンの DataSpider Servista をインストールディレクトリごとコピーします。

3. 退避ディレクトリに貼り付けます。



27

3.4.4. リポジトリ DB のバックアップ

リポジトリ DB のバックアップを行います。

バックアップ方法は各データベースにより異なります。各データベースが推奨するバックアップ手順

にしたがって実施してください。

3.4.5. 旧バージョンの DataSpider Servista のアンインストール

旧バージョンの DataSpider Servista のアンインストールを行います。アンインストールは、旧バージョ

ンの DataSpider Servista に付随のアンインストーラを使用します。

アンインストールの詳細については、旧バージョンに同梱されている「DataSpider Servista インス

トールガイド」を参照してください。

3.4.6. 新バージョンの DataSpider Servista のインストール

新バージョンの DataSpider Servista のインストールを行います。インストール時に、以下の項目は旧バー

ジョンの DataSpider Servista と同じ設定にしてください。

インストール対象の選択

クライアント環境の選択

管理者パスワード

リポジトリ DB の有無および設定

Windows サービス登録および Windows サービス名

DataSpiderServer 情報の設定(ホスト名/IP アドレス、ポート番号)

インストール先の設定



28

3.4.7. ライセンスファイルの適用

新バージョンの DataSpider Servista にライセンスファイルを適用します。

$DATASPIDER_HOME/server/lic 下にライセンスファイル(license.lic)を配置してください。

インストール時に「ライセンスファイルの選択」でライセンスファイルを設定している場合には必要

ありません。

ライセンスファイルの再発行が必要になる場合があります。詳細については、「ライセンスファイルの

再発行について」を参照してください。

3.4.8. ライブラリのインストール

新バージョンの DataSpider Servista に各種アダプタで使用するライブラリをインストールします。

詳細については、新バージョンに同梱されている「DataSpider Servista インストールガイド」を参

照してください。



29

3.4.9. 各種設定および各種データの移行

旧バージョンの DataSpider Servista の設定を、新バージョンの DataSpider Servista に移行します。

退避ディレクトリにある旧バージョンの DataSpider Servista から、以下のファイルの設定を新バージョ

ンの DataSpider Servista の同階層ディレクトリ下にある同名ファイルに設定してください。

移行対象となるファイルは「システム設定ファイル」と「ユーザデータファイル」の 2 種類が存在します。

これらのファイルの設定がデフォルトのままである場合は、本項の設定は必要ありません。

1). システム設定ファイル

DataSpider Servista のシステム側で用意しているファイルです。これらファイルの設定をデフォルトか

ら変更している場合は、その設定項目を新バージョンの DataSpider Servista の同名ファイルに追加して

ください。

/conf 下のシステム設定ファイルの上書きコピーは行わないでください。

ディレクトリパスファイル名説明

$DATASPIDER_HOME/server/conf

dslog.properties DataSpiderServer のログファイルの設定が

保存されています。

system.properties DataSpiderServer のシステム関連の設定が


$DATASPIDER_HOME/client/conf

dslog.properties DataSpiderClient のログファイルの設定が


system.properties DataSpiderClient のシステム関連の設定が


2). ユーザデータファイル

ユーザが任意で配置したファイルです。必要に応じて、移行してください。



30

3.4.10. その他設定の移行

必要に応じて、以下の設定を行ってください。


旧バージョンの DataSpider Servista の JRE に証明書のインポートを行っている場合は、退避ディレ

クトリの cacerts を新バージョンの DataSpider Servista に上書きコピーしてください。

lax ファイル内の設定項目

各種ツールの起動設定ファイル(*.lax)で、メモリ割当値(ヒープサイズ)や標準出力の変更を行ってい

た場合は、その変更値を新バージョンの DataSpider Servista の同名ファイルに反映してください。

バージョンによって設定方法が異なる場合があります。設定値の反映方法については、新バー

ジョンの DataSpider Servista ヘルプの「プロパティリファレンス」ページを参照してください。

lax ファイルの上書きコピーは行わないでください。

アダプタやトリガーのプロパティファイルの設定項目

DataSpider Servista ヘルプに記載されているプロパティファイルの設定を行っている場合は、その

設定値を新バージョンの DataSpider Servista の同名ファイルに反映してください。

設定値の反映方法については、新バージョンの DataSpider Servista ヘルプを参照してください。

「移行できない設定について」に記載の各種設定

3.4.11. バージョンアップに伴う特別な設定

コンポーネントやリポジトリ DB の接続先によっては、バージョンアップ時に特別な設定が必要となる場

合があります。詳細については、本ドキュメントの「バージョンアップに伴う特別な設定」項を参照して

ください。

3.4.12. 各種ツールのバージョンアップ

SAP EICS や SAP テーブルクエリアダプタのコンフィギュレーションツールなど、DataSpider Servista

のインストールディレクトリにインストールするツールのバージョンアップ(再インストール)を行います。

再インストールは、必ず新バージョンの DataSpider Servista に同梱されている新しいインストーラで

行ってください。



31

また、JDBC Proxy Server など DataSpider Servista とはインストールディレクトリが異なるツールも、

DataSpider Servista のバージョンアップに合わせて新しいインストーラで再インストールしてください。

3.4.13. 新バージョンの DataSpiderServer および DataSpider Studio の

起動

新バージョンの DataSpiderServer および DataSpider Studio を起動します。

DataSpiderServer および DataSpider Studio の起動処理については、新バージョンに同梱されてい

る「DataSpider Servista インストールガイド」を参照してください。設定やデータが正しく移行されて

いるかどうかを確認してください。また、サービスパックがリリースされている場合、そちらも併せて適

用することを推奨します。

3.4.14. 新バージョンの DataSpider Studio for Web の起動

旧バージョンで DataSpider Studio for Web を使用している場合は、バージョンアップ後にウェブブラウ

ザのキャッシュ(インターネット一時ファイル)を削除してから DataSpider Studio for Web を起動します。



32

3.5. リポジトリ DB 有り環境のバージョンアップ(別リポジトリ)

リポジトリ DB 有りで、旧バージョンと新バージョンの DataSpider Servista で別のリポジトリ DB を使

用する場合のバージョンアップは、以下の手順で行ってください。

3.5.1. トリガーの停止ができる場合(平行運用を行わないケース)

1. 旧バージョンの DataSpider Servista でトリガーを無効にします。

2. 旧バージョンの DataSpiderServer および各種クライアントアプリケーションを停止します。

3. 移行先リポジトリ DB に DataSpider Servista のリポジトリ DB 用ユーザを作成します。

ユーザ権限は移行元リポジトリ DB と同等に設定します。

各データベースで必要な権限については「DataSpider Servista インストールガイド」を参照し

てください。

4. DataSpider Servista が使用しているデータベースインスタンスのテーブルを、移行元リポジトリ DB

から移行先リポジトリ DB に移行します。

移行方法は各データベースにより異なります。各データベースが推奨する移行手順にしたがって

実施してください。

移行先データベースにあらかじめテーブルを作成しておく必要がある場合は、移行先データベー

スを新バージョンの DataSpider Servista のリポジトリ DB として設定し、DataSpiderServer

の起動を行ってください。リポジトリ DB 用テーブルの作成は DataSpiderServer の起動時に行わ

れます。

5. DataSpider Servista のバージョンアップを行います。

以降のバージョンアップ手順については、「リポジトリ DB 有り環境のバージョンアップ(同一リポジ

トリ)」の「旧バージョンの DataSpider Servista のバックアップ」項以下を参照してください。

「新バージョンの DataSpider Servista のインストール」項では、リポジトリ DB の設定を移行先リ

ポジトリ DB にしてください。



33

3.5.2. トリガーの停止ができない場合(平行運用を行うケース)

旧バージョンの DataSpider Servista と新バージョンの DataSpider Servista で平行運用を行う(ライセン

スが複数必要になります。)などでトリガーの停止ができない場合、リポジトリ DB 有り環境でサーバ移行

機能を使用してバージョンアップします。基本的な手順は、「リポジトリDB無し環境のバージョンアップ」

と同じになります。

「新バージョンの DataSpider Servista のインストール」項では、リポジトリ DB の設定を移行先リ

ポジトリ DB にしてください。

サーバ移行機能でエクスポートする機能以外は、アクセス権限などのメタ情報が初期化されます。



34

3.6. リポジトリ DB 無し環境のバージョンアップ

リポジトリ DB 無し環境の場合のバージョンアップは、以下の手順で行ってください。

3.6.1. 旧バージョンの DataSpider Servista で DataSpiderServer 設定

のエクスポートを行う

旧バージョンのDataSpider Servista で、サーバ移行機能を使用してDataSpiderServer設定のエクスポー

トを行います。

「エクスポートのオプション指定」画面で、[トリガーを次の状態としてエクスポート]と[無効]にチェッ

クを入れ、トリガーの状態を無効にしてエクスポートしてください。

サーバ移行を実行する前には、スクリプトが実行されていないこと、ほかのユーザが

DataSpiderServer を使用していないことを確認してください。

エクスポート対象の量が多い、または規模が大きいと、エクスポートが完了するまで時間がかかる場

合があります。エクスポート項目を絞って数回に分けてエクスポートするなどしてください。

3.6.2. 旧バージョンの DataSpiderServer および DataSpider Studio の

停止

旧バージョンの DataSpiderServer または DataSpider Studio が起動中の場合、停止処理を行ってくださ

い。

DataSpiderServer および DataSpider Studio の停止処理については、旧バージョンに同梱されてい


3.6.3. 旧バージョンの DataSpider Servista のバックアップ

旧バージョンの DataSpider Servista のバックアップを行います。OS のコピー機能を使用して、退避ディ

レクトリに移動します。

1. 任意の場所に退避ディレクトリを作成します。

2. 旧バージョンの DataSpider Servista をインストールディレクトリごとコピーします。

3. 退避ディレクトリに貼り付けます。



35

3.6.4. 旧バージョンの DataSpider Servista のアンインストール

旧バージョンの DataSpider Servista のアンインストールを行います。アンインストールは、旧バージョ

ンの DataSpider Servista に付随のアンインストーラを使用します。

アンインストールの詳細については、旧バージョンに同梱されている「DataSpider Servista インス

トールガイド」を参照してください。

3.6.5. 新バージョンの DataSpider Servista のインストール

新バージョンの DataSpider Servista のインストールを行います。インストール時に、以下の項目は旧バー

ジョンの DataSpider Servista と同じ設定にしてください。

インストール対象の選択

クライアント環境の選択

管理者パスワード

リポジトリ DB の有無

Windows サービス登録および、Windows サービス名

DataSpiderServer 情報の設定(ホスト名/IP アドレス、ポート番号)

インストール先の設定

3.6.6. ライセンスファイルの適用

新バージョンの DataSpider Servista にライセンスファイルを適用します。

$DATASPIDER_HOME/server/lic 下にライセンスファイル(license.lic)を配置してください。

インストール時に「ライセンスファイルの選択」でライセンスファイルを設定している場合には必要

ありません。

ライセンスファイルの再発行が必要になる場合があります。詳細については、「ライセンスファイルの

再発行について」を参照してください。



36

3.6.7. ライブラリのインストール

新バージョンの DataSpider Servista に各種アダプタで使用するライブラリをインストールします。

詳細については、新バージョンに同梱されている「DataSpider Servista インストールガイド」を参


3.6.8. 各種設定および各種データの移行

旧バージョンの DataSpider Servista の設定を、新バージョンの DataSpider Servista に移行します。

退避ディレクトリにある旧バージョンの DataSpider Servista から、以下のファイルの設定を新バージョ

ンの DataSpider Servista の同階層ディレクトリ下にある同名ファイルに設定してください。

移行対象となるファイルは「システム設定ファイル」と「ユーザデータファイル」の 2 種類が存在します。

これらのファイルの設定がデフォルトのままである場合は、本項の設定は必要ありません。

1). システム設定ファイル(/conf)

DataSpider Servista システム側で用意しているファイルです。これらファイルの設定をデフォルトから

変更している場合は、その設定項目を新バージョンの DataSpider Servista の同名ファイルに追加してく

ださい。

/conf 下のシステム設定ファイルの上書きコピーは行わないでください。

ディレクトリパスファイル名説明


dslog.properties DataSpiderServer のログファイルの設定

が保存されています。

system.properties DataSpiderServer のシステム関連の設定

が保存されています。

$DATASPIDER_HOME/client/conf dslog.properties DataSpiderClient のログファイルの設定が


$DATASPIDER_HOME/client/conf system.properties DataSpiderClient のシステム関連の設定が




37

2). ユーザデータファイル

ユーザが任意で配置したファイルです。必要に応じて、移行してください。

3.6.9. その他設定の移行

必要に応じて、以下の設定を行ってください。


旧バージョンの DataSpider Servista の JRE に証明書のインポートを行っている場合は、退避ディレ

クトリの cacerts を新バージョンの DataSpider Servista に上書きコピーしてください。

lax ファイル内の設定項目

各種ツールの起動設定ファイル(*.lax)で、メモリ割当値(ヒープサイズ)や標準出力の変更を行ってい

た場合は、その変更値を新バージョンの DataSpider Servista の同名ファイルに反映してください。

バージョンによって設定方法が異なる場合があります。設定値の反映方法については、新バー

ジョンの DataSpider Servista ヘルプの「プロパティリファレンス」ページを参照してください。

lax ファイルの上書きコピーは行わないでください。

アダプタやトリガーのプロパティファイルの設定項目

DataSpider Servista ヘルプに記載されているプロパティファイルの設定を行っている場合は、その

設定値を新バージョンの DataSpider Servista の同名ファイルに反映してください。

設定値の反映方法については、新バージョンの DataSpider Servista ヘルプを参照してください。

「移行できない設定について」に記載の各種設定

3.6.10. バージョンアップに伴う特別な設定

コンポーネントやリポジトリ DB の接続先によっては、バージョンアップ時に特別な設定が必要となる場

合があります。詳細については、本ドキュメントの「バージョンアップに伴う特別な設定」項を参照して

ください。



38

3.6.11. 各種ツールのバージョンアップ

SAP EICS や SAP テーブルクエリアダプタのコンフィギュレーションツールなど、DataSpider Servista

のインストールディレクトリにインストールするツールのバージョンアップ(再インストール)を行います。

再インストールは、必ず新バージョンの DataSpider Servista に同梱されている新しいインストーラで

行ってください。

また、JDBC Proxy Server など DataSpider Servista とはインストールディレクトリが異なるツールも、

DataSpider Servista のバージョンアップに合わせて新しいインストーラで再インストールしてください。

3.6.12. 新バージョンの DataSpiderServer および DataSpider Studio の

起動

新バージョンの DataSpiderServer および DataSpider Studio を起動します。

DataSpiderServer および DataSpider Studio の起動処理については、新バージョンに同梱されてい


3.6.13. 新バージョンの DataSpider Servista で DataSpiderServer 設定

のインポートを行う

新バージョンの DataSpider Servista で、サーバ移行機能を使用して DataSpiderServer 設定のインポー

トを行います。

インポート後は必ず DataSpiderServer の再起動を行ってください。

再起動後、設定やデータが正しく移行されているかどうかを確認してください。また、サービスパックが

リリースされている場合、そちらも併せて適用することを推奨します。

3.6.14. 新バージョンの DataSpider Studio for Web の起動

旧バージョンで DataSpider Studio for Web を使用している場合は、バージョンアップ後にウェブブラウ

ザのキャッシュ(インターネット一時ファイル)を削除してから DataSpider Studio for Web を起動します。



39

3.7. バージョンアップと同時にリポジトリDB無しからリポジトリ

DB 有りに変更する場合

DataSpider Servista のバージョンアップと、リポジトリ DB 無しからリポジトリ DB 有りへの変更を同時

に行う場合の手順は、基本的に「リポジトリ DB 無し環境のバージョンアップ」の手順と同じになります。

「新バージョンの DataSpider Servista のインストール」項では、リポジトリ DB を「有り」で設定して

インストールするようにしてください。

リポジトリ DB 有りの環境をリポジトリ DB 無しの環境に移行することはできません。

3.8. バージョンアップと同時にプラットフォームの移行を行う場

合

DataSpider Servista のバージョンアップと、プラットフォームの変更を同時に行う場合の手順は、基本

的にバージョンアップ手順と同じになります。

リポジトリ DB 有りの場合の手順については、「リポジトリ DB 有り環境のバージョンアップ(同一リ

ポジトリ)」または「リポジトリ DB 有り環境のバージョンアップ(別リポジトリ)」を、リポジトリ DB 無

しの場合の手順については、「リポジトリ DB 無し環境のバージョンアップ」を参照してください。

移行先に、マウント設定のマウント元を用意するようにしてください。移行元とパスが異なる場合は、

マウントポイントを再作成する必要があります。

Windows-Linux 間の移行に関する注意事項については、「Windows-Linux 間のバージョンアップに

ついて」を参照してください。

アダプタによって、サポートするプラットフォームが異なる場合があります。詳細については、「アダ

プタのサポートプラットフォームについて」を参照してください。



40

4. サポート終了プラットフォーム、リポジトリ DB、アダ

プタのバージョンアップ方法

以下のウェブサイトにて、サポート終了となったサポートプラットフォーム、リポジトリ DB、アダプタを

公開しています。


サポートを終了しているこれらのサポートプラットフォーム、リポジトリ DB、アダプタを使用している場

合には、DataSpider Servista 4.1 でそのまま使用できません。サポート対象となるサポートプラット

フォーム、リポジトリ DB、アダプタに移行する必要があります。次項にて、移行方法を説明します。

4.1. プラットフォームの移行

プラットフォームの移行の手順は、「バージョンアップとプラットフォームの移行を同時に行う場合」を参


4.2. リポジトリ DB の移行

リポジトリ DB の移行の手順については、「リポジトリ DB 有り環境のバージョンアップ(別リポジトリ)」

を参照してください。




41

4.3. アダプタの移行

アダプタの移行は、スクリプトの変更を行わず、グローバルリソースの変更のみで行うことができます。

移行の手順は以下の通りです。

(ここでは、現在ご使用中の DataSpider Servista を「旧バージョンの DataSpider Servista」、DataSpider

Servista 4.1 を「新バージョンの DataSpider Servista」、サポート終了になった接続先アプリケーション

を「サポート終了接続先」、サポート対象内の接続先アプリケーションを「サポート内接続先」と表します。)

1. サポート終了接続先をサポート内接続先にアップグレード、もしくは新規に構築します。

2. DataSpider Servista のバージョンアップを行います。

リポジトリ DB 有り環境のバージョンアップ(同一リポジトリ)の場合

バージョンアップの手順については、「リポジトリ DB 有り環境のバージョンアップ(同一リ

ポジトリ)」を参照してください。

旧バージョンの DataSpider Servista をアンインストールする前に、「グローバルリソース

の設定」でサポート終了接続先のグローバルリソースを削除します。また、削除する際には、サ

ポート終了接続先のグローバルリソース名を控えておいてください。

リポジトリ DB 有り環境のバージョンアップ(別リポジトリ)の場合

バージョンアップの手順については、「リポジトリ DB 有り環境のバージョンアップ(別リポ

ジトリ)」を参照してください。

旧バージョンの DataSpider Servista をアンインストールする前に、サポート終了接続先

のグローバルリソース名を控えておいてください。

リポジトリ DB 無し環境のバージョンアップの場合

バージョンアップの手順については、「リポジトリ DB 無し環境のバージョンアップ」を参


旧バージョンの DataSpider Servista で DataSpiderServer 設定のエクスポートをする際

に、サポート終了接続先のグローバルリソースはエクスポート対象外としてください。また、サ

ポート終了接続先のグローバルリソース名を控えておいてください。



42

3. サポート内接続先の接続情報を確認します。

例: Oracle 10g アダプタから Oracle 12c アダプタに移行する場合は、Oracle 12c の「ホスト

名」「ポート番号」「SID」「ユーザ名」「パスワード」を確認します。

各データソースの接続に必要な情報の詳細については、DataSpider Servista ヘルプの｢グローバ

ルリソースのプロパティ｣ページを参照してください。

4. サポート内接続先用のアダプタが使用できる状態になっているかどうか確認します。

例: サポート内接続先として Oracle 12c を使う場合

コントロールパネルの[グローバルリソースの設定]-[新しいグローバルリソースの追加]-[リ

ソースの種類の選択]で、Oracle 12c アダプタのリソースアイコンが表示されているかどうかを

確認します。一覧に現れない場合は、Oracle 12c アダプタのライブラリが配置されているかど

うかを確認してください。

ライブラリの配置方法については、「DataSpider Servista インストールガイド」または

DataSpider Servista ヘルプの「ライブラリのインストール」ページを参照してください。

ライブラリを配置した場合は必ず DataSpiderServer を再起動してください。

5. サポート内接続先のグローバルリソースを作成します。グローバルリソース名は 2.で控えておいた名

前にしてください。

各コンポーネントでは、接続先に設定されたグローバルリソースの接続情報の取得を「グローバ

ルリソース名」で行います。そのため、サポート内接続先のグローバルリソースをサポート終了接続

先のグローバルリソースの元の名前と同じにすることにより、スクリプトの変更をせずに、移行を行

うことができます。

6. テストを実施します。

既存のスクリプトが正常に動作することを確認してください。



43

5. バージョンアップに伴う特別な設定

バージョンアップ元となる DataSpider Servista のバージョンによっては、バージョンアップ後に特別な

設定が必要となる場合があります。それらの設定は必要に応じて、新バージョンの DataSpider Servista

に行ってください。

5.1. アダプタの互換性プロパティ

DataSpider Servista では、仕様の変更や不具合の修正などにより、以前のバージョンと動作の互換性が

取れなくなる場合があります。その場合に、特定のプロパティを設定することにより、以前のバージョン

の動作に戻し、互換性を保つようにすることができます。そのようなプロパティ設定を「互換性プロパティ」

と呼びます。

各互換性プロパティの「対象バージョン」に記載のバージョンからバージョンアップを行う場合、仕様が

変更され、動作が変わります。修正前の動作を保つ必要がある場合には、互換性プロパティを設定するよ

うにしてください。

旧バージョンのDataSpider Servistaに互換性プロパティを設定している場合には、バージョンアッ

プ後に新バージョンの DataSpider Servista に新しく設定を行う必要があります。

互換性プロパティを追加した際には DataSpiderServerの再起動が必要になります。



44

5.1.1. DataSpider Servista 3.0 の互換性プロパティ

本項では、DataSpider Servista 3.0 から追加された互換性プロパティについて説明します。

対象バージョン

DataSpider Servista 2.4.x 以前

1). Excel アダプタ

empty.date.cell.not.null

本プロパティは、Excel 2007 ブック(.xlsx ファイル)に対しては適用されません。

修正内容

シートから読み取り処理、および定義済み範囲から読み取り処理で、値が空のセルを[列一覧]の[型]で「日

付」を指定して読み取った場合、「1970-01-01」として取得される問題を修正しました。

修正後は、「null」として取得されます。

以前の動作に変更したい場合には、以下の対象ファイルに互換性プロパティを設定してください。

対象ファイル

component.properties

配置場所

$DATASPIDER_HOME/server/plugin/data_processing/modules/excel_adapter/META_I

NF

キー

empty.date.cell.not.null

値の説明

true: 日付型のセルが空の場合「1970-01-01」で読み取ります。(2.1.1 以前、2.3.0 以降~2.4.x

以前の動作)

false: 日付型のセルが空の場合「null」で読み取ります。(2.2.0 以降~2.2.1.1 以前、3.0 以降

の動作)



45

デフォルト値

false

2). 可変長アダプタ

emptyfield.typecheck.enabled

修正内容

可変長ファイル読み取り処理で、数値型・日付型フィールドから読み取ったデータが空文字の場合、エラー

になる問題を修正しました。


対象ファイル

adapter.properties

配置場所

$DATASPIDER_HOME/server/plugin/data_processing/modules/variablelength_adapter

/META-INF

キー

emptyfield.typecheck.enabled

値の説明

true: 数値型・日付型フィールドで、読み取ったデータが空文字の場合、エラーとなります。

(2.4.x 以前の動作)

false: 数値型・日付型フィールドで、読み取ったデータが空文字の場合にもエラーとなりませ

ん。(3.0 以降の動作)

デフォルト値

false



46

3). Active Directory アダプタ

disable.accountexpires.adjustment

修正内容

ユーザ検索処理およびユーザメンバ検索処理で、取得するアカウント有効期限の日付と Active Directory

上で表示されている日付に 1 日の差異がある問題を修正しました。

1 件ユーザ登録処理および複数ユーザ登録/更新処理で、入力するアカウント有効期限の日付と Active

Directory 上で表示されている日付に 1 日の差異がある問題を修正しました。


対象ファイル

adapter.properties

配置場所

$DATASPIDER_HOME/server/plugin/data_processing/modules/activedirectory_adapter

/META-INF/

キー

disable.accountexpires.adjustment

値の説明

true: アカウント有効期限の日付はアカウントが無効となる最初の日付となります。(2.4.x 以

前の動作)

false: アカウント有効期限の日付はアカウントが有効である最後の日付となります。(3.0 以降

の動作)

デフォルト値

false



47

enable.emptyusernames.validation

修正内容

1 件ユーザ登録処理および複数ユーザ登録/更新処理で、[姓]、[名]および[表示名]の設定を省略できるよ

うにしました。

以下のオペレーションで、[姓]、[名]および[表示名]のいずれかが設定されていないアカウントも操作の対

象とできるよう変更しました。

複数ユーザ登録/更新処理

ユーザ削除処理

アカウント有効/無効処理

ユーザ移動処理


対象ファイル

adapter.properties

配置場所

$DATASPIDER_HOME/server/plugin/data_processing/modules/activedirectory_adapter

/META-INF

キー

enable.emptyusernames.validation

値の説明

true: 以下の動作となります。(2.4 以前の動作)

1 件ユーザ登録処理で、[姓]、[名]、[表示名]すべての入力が必須となります。

複数ユーザ登録/更新処理で、[姓]、[名]、[表示名]すべての入力が必須となります。

複数ユーザ登録/更新処理、アカウント有効/無効処理、ユーザ移動処理、ユーザ削除処理

で、[姓]、[名]、[表示名]のいずれかが未設定のアカウントは処理対象となりません。

false: 以下の動作となります。(3.0 以降の動作)



48

1 件ユーザ登録処理で、[姓]、[名]、[表示名]いずれかの入力が必須となります。

複数ユーザ登録/更新処理で、[エントリ名]、[姓]、[名]、[表示名]いずれかの入力が必須

となります。

複数ユーザ登録/更新処理、アカウント有効/無効処理、ユーザ移動処理、およびユーザ削

除処理で、[姓]、[名]、[表示名]が未設定のアカウントも処理対象となります。

デフォルト値

false



49

5.1.2. DataSpider Servista 2.3.0 の互換性プロパティ

本項では、DataSpider Servista 2.3.0 から追加された互換性プロパティについて説明します。


DataSpider Servista 2.2.1.1 以前

1). Excel アダプタ

get.sheet.end.condition.compat2211

修正内容

シートから読み取り処理で、[開始/終了条件]タブの[読み取り終了条件を指定]オプションを有効にして終

了条件を設定する際に、すべてのカラムに AND 演算子で条件を指定した場合、条件ごとに判定し、最後に

条件を満たした行を読み取り終了条件とする問題を修正しました。修正後は、すべての条件を満たす行を

読み取り終了条件とします。


( 本プロパティは、Excel 2007 ブック(.xlsx ファイル)に対しては適用されません。)

対象ファイル

component.properties

配置場所

$DATASPIDER_HOME/server/plugin/data_processing/modules/excel_adapter/META_I

NF

キー

get.sheet.end.condition.compat2211

値の説明

true: 条件ごとに判定し、最後に条件を満たした行を読み取り終了条件とします。(2.2.1.1 以

前の動作)

false: すべての条件を満たす行を読み取り終了条件とします。(2.3.0 以降の動作)

デフォルト値



50

false

2). ファイルシステムアダプタ

disable.check.target.directory

修正内容

ファイルシステム書き込み処理の動作を以下のように変更しました。


入力データの path(2 番目のカラムのデータ)が絶対パスの場合:

入力データの path に書き込み処理を行います。プロパティの[ディレクトリ]で指定したパスは

参照しません。

入力データの path が相対パスの場合:

ファイルチューザやディレクトリチューザ、エクスプローラなどで最後に選択したディレクトリ

をカレントディレクトリとし書き込み処理を行います。プロパティの[ディレクトリ]で指定した

パスは参照しません。

DataSpider Servista 2.3.0 以降

入力データの path が絶対パスの場合:

入力データの path に書き込み処理を行います。プロパティの[ディレクトリ]で指定したパスは

参照しません。

入力データの path が相対パスの場合:

プロパティの[ディレクトリ]で指定したパスをカレントディレクトリとして書き込み処理を行

います。

上記のように 2.2.1.1 以前では、[ディレクトリ]で指定したパスは参照していなかったため、相対パスの

指定ができました。しかし、2.3.0 以降では、入力データの path が相対パスで、プロパティの[ディレク

トリ]で相対パスを指定した場合、エラーが発生するようになります。(絶対パスのみ指定可)


対象ファイル

adapter.properties

配置場所

$DATASPIDER_HOME/server/plugin/data_processing/modules/filesystem_adapter/ME



51

TA-INF

キー

disable.check.target.directory

値の説明

true: 相対パスを許容し、例外が発生しません。(2.2.1.1 以前の動作)

false: 相対パスを許容せず、例外が発生します。(2.3.0 以降の動作)

デフォルト値

false

3). IBM Notes アダプタ

disable.column.type

修正内容

ビュー読み取り処理、ノーツ式読み取り処理および全文検索読み取り処理で、プロパティの[カラム定義]

で指定された[型]にデータを型変換して読み取る機能を追加しました。


対象ファイル

lotusnotescommon.properties

配置場所

$DATASPIDER_HOME/server/plugin/data_processing/share/classes

キー

disable.column.type

値の説明

true: 型変換を行いません。(2.2.1.1 以前の動作)

false: 型変換を行います。(2.3.0 以降の動作)

デフォルト値



52

false

notes.dateformat.compat.enabled

修正内容

ビュー読み取り処理で、カラムに「@Created」「@Modified」「@Accessed」が指定されているビューを

指定して実行した際に取得される日付データのフォーマットを、「EEE MMM dd hh:mm:ss z yyyy」から

「yyyy-MM-dd'T'HH:mm:ss.SSSZZ」に変更しました。


対象ファイル


配置場所


キー

notes.dateformat.compat.enabled

値の説明

true: 「EEE MMM dd hh:mm:ss z yyyy」フォーマットで値を取得します。(2.2.1.1 以前の

動作)

false: 「yyyy-MM-dd'T'HH:mm:ss.SSSZZ」フォーマットで値を取得します。(2.3.0 以降の

動作)

デフォルト値

false

error.searchfulltext.nomatch

修正内容

全文検索読み取り処理で、指定した[検索文字列]の検索結果が 0 件であった場合にエラーが発生する問題

を修正しました。修正後は処理が正常終了するようになります。(結果は「0」件)




53

対象ファイル


配置場所


キー

error.searchfulltext.nomatch

値の説明

true: 検索文字列にマッチしない場合、エラーになります。(2.2.1.1 以前の動作)

false: 検索文字列にマッチしなくてもエラーにはなりません。(2.3.0 以降の動作)

デフォルト値

false



54

4). FTPアダプタ

disable.support.schema

修正内容

各オペレーションを Mapper の入力元とした際に、Mapper の入力元スキーマにスキーマが自動で表示さ

れるようになりました。また、スキーマの編集も「不可」となります。


対象ファイル

adapter.properties

配置場所

$DATASPIDER_HOME/server/plugin/data_processing/modules/ftp_adapter/META-INF

キー

disable.support.schema

値の説明

true: Mapper でスキーマを手動でセットする必要があります。編集できます。(2.2.1.1 以前

の動作)

false: Mapper でスキーマが自動でセットされます。編集はできません。(2.3.0 以降の動作)

デフォルト値

false

disable.timeout.by.resource

修正内容

FTP サーバへのコネクションをプールできるようにしました。


対象ファイル

adapter.properties



55

配置場所

$DATASPIDER_HOME/server/plugin/data_processing/modules/ftp_adapter/META-INF

キー

disable.timeout.by.resource

値の説明

true: FTP アダプタの処理ごとに FTPClient のインスタンスを生成します。また、タイムアウト

設定は各オペレーションのプロパティで行います。(2.2.1.1 以前の動作)

false: FTP アダプタの 1 番目の処理で FTPClient のインスタンスが生成されログインを行い、

以降の処理ではログインセッションを使い回します。スクリプト終了時(グローバルリソースの

クリーンアップ)にセッションは破棄(ログアウト)されます。また、タイムアウト設定はグロー

バルリソースのプロパティで行います。(2.3.0 以降の動作)

デフォルト値

false



56





1). SQL Server アダプタ

sendStringParametersAsUnicode

修正内容

SQL Server アダプタの JDBC 接続において、以下のプロパティを設定することによって、非 Unicode の

文字データ(CHAR、VARCHAR など)のインデックス参照のパフォーマンスが向上するようになりました。

( JDBC 接続のみの対応となります。ODBC 接続には対応していません。)


対象ファイル

db_sqlserver.properties

配置場所


キー

sendStringParametersAsUnicode

値の説明

true: データを Unicode として送信します。(2.2.1 以降の動作)

false: データベースの既定の照合順序でサーバに送信されます。Unicode からの変換オーバー

ヘッドが発生しないので、パフォーマンスを向上させることができます。(2.2.0.1 以前の動作)

デフォルト値

true



57

5.2. Mapper の互換性プロパティ

DataSpider Servista では、仕様の変更や不具合の修正などにより、以前のバージョンと動作の互換性が

取れなくなる場合があります。その場合に、特定のプロパティを設定することにより、以前のバージョン

の動作に戻し、互換性を保つようにすることができます。そのようなプロパティを「互換性プロパティ」

と呼びます。

各互換性プロパティの「対象バージョン」に記載のバージョンからバージョンアップを行う場合、仕様が

変更され、動作が変わります。修正前の動作を保つ必要がある場合には、互換性プロパティを設定するよ

うにしてください。

旧バージョンのDataSpider Servistaに互換性プロパティを設定している場合には、バージョンアッ

プ後に新バージョンの DataSpider Servista に新しく設定を行う必要があります。

互換性プロパティを追加した際には DataSpiderServerの再起動が必要になります。





1). Mapper共通

vp.logic.numeric.default.type.int

修正内容

数値データを特定の Mapper ロジックで扱う際の内部データ型を BigDecimal 型固定に変更しました。


対象ファイル

system.properties

配置場所




58

キー

vp.logic.numeric.default.type.int

値の説明

true: 入力データのより高い精度の内部データ型を使用します。入力データが文字列型の場合は、

int 型を使用します。(2.3.x 以前の動作)

false: 内部データ型の BigDecimal 型を使用します。(2.4.0 以降の動作)

デフォルト値

false

プロパティの詳細

本プロパティを設定すると、入力データのより高い精度の内部データ型が使用されます。

内部データ型範囲

byte 8 ビット整数

short 16 ビット整数

int 32 ビット整数

float 32 ビット浮動小数点数

double 64 ビット浮動小数点数

BigDecimal 実数

byte 型がもっとも精度が低く、BigDecimal 型がもっとも精度が高くなります。たとえば、int 型と

BigDecimal 型の演算では BigDecimal 型を使用します。

入力データが文字列型の場合、内部データ型は int 型を使用します。内部データ型が int 型の動作は、以下

の通りです。

小数点以下が切り捨てられる

内部データ型の int 型の範囲外の数値が int 型の範囲内に丸められ、データの精度が落ちる

( int 型の範囲は「2147483647」から「-2147483648」となります。)



59

( 通常(本プロパティ無効)時は BigDecimal を使用するため、小数点の切り捨てや、データの精度が落

ちることはありません。)

本プロパティが影響する Mapper ロジックは、以下の通りです。

[分岐]

条件判定による出力の切り替え

[条件]-[数値]

等しい、等しくない、未満、以下、より大きい、以上

[数値]-[演算]

足し算、引き算、掛け算、割り算、余り

[数値]-[集合]

合計値、平均値、ノードの最大値、ノードの最小値

本プロパティ有効/無効時の動作例は以下の通りです。

条件判定による出力の切り替えロジック

[判定対象]が数値型のスクリプト変数「1」、[判定方法]が[指定した値との比較]、[判定基準]が

[~以上]、[判定内容]が「1.5」の場合の動作は以下になります。

プロパティ有効時:「成立」

プロパティ無効時:「不成立」

等しいロジック

文字列型「1.5」と文字列型「1.4」を比較した結果データは以下になります。

プロパティ有効時:「true」

プロパティ無効時:「false」

足し算ロジック

文字列型「1.5」と文字列型「1.5」を足し算した結果データは以下になります。

プロパティ有効時:「2」

プロパティ無効時:「3.0」

割り算ロジック



60

文字列型「10.5」と文字列型「3」を割り算した結果データは以下になります。



合計値ロジック

文字列型「3.3」、文字列型「3.4」、文字列型「3.3」を合計した結果データは以下になります。



内部データ型が int 型の場合、小数点以下が切り捨てられるため、上記のような動作になります。



61

2). ドキュメントMapper

mapper.xml2table.disableNullOutput

修正内容

入力元コンポーネントのデータモデルが XML 型かつ出力先コンポーネントがテーブルモデル型の場合に、

文字列型の出力先データに null 値をマッピングすると、null 値として出力されるようにしました。


対象ファイル

system.properties

配置場所


キー

mapper.xml2table.disableNullOutput

値の説明

true: 空文字を出力します。(2.3.x 以前の動作)

false: null 値を出力します。(2.4.0 以降の動作)

デフォルト

false



62




DataSpider Servista 2.1.1 以前

1). マージMapper

merge.generate.empty.data

修正内容

マージ Mapper で、テーブルデータ型のデータをマージする際に、キーにマッチしなかった場合に空白行

が出力される問題を修正しました。


対象ファイル

system.properties

配置場所


キー

merge.generate.empty.data

値の説明

true: キーにマッチしなかった場合には空白行を出力します。(2.1.1 以前の動作)

false: キーにマッチしなかった場合には空白行を出力しません。(2.2.0 以降の動作)

デフォルト

false



63





1). マージMapper

merge.trim.result

修正内容

マージ Mapper で、結果文字列の前後のホワイトスペースのトリム(削除)の有効・無効を設定できる機能

を追加しました。


対象ファイル

system.properties

配置場所


キー

merge.trim.result

値の説明

true: トリムを行います。(2.1.0 以前の動作)

false: トリムを行いません。(2.1.1 以降の動作)

デフォルト

false



64

5.3. Mapper の新アーキテクチャへの変換

本項の手順は、バージョンアップ時に一度行っていれば、バージョンアップごとに行う必要はありま

せん。



概要

DataSpider Servista 2.2.0 よりドキュメント Mapper・変数 Mapper の内部アーキテクチャが新しくな

りました。

マッピングファイルのサイズを縮小し、開いていないマッピングをメモリ上に展開しないように変更しま

した。これにより、従来よりもプロジェクトのロード時間が短縮され、Mapper のメモリ使用量が縮小さ

れます。

5.3.1. 既存の Mapper の新アーキテクチャへの反映方法

新アーキテクチャを DataSpider Servista 2.1.1 以前で作成された Mapper に反映させるためには、

DataSpider Servista 2.1.1 以前で作成されたプロジェクトを DataSpider Servista 2.2.0 以降で開

き、保存後プロジェクトを閉じ、再度開いてください。初回読み込み時にマッピングファイルの新アーキ

テクチャへの変換が行われ、プロジェクトを閉じて開いたあとに有効になります。



65

5.4. カレンダーの設定


せん。

5.4.1. 基準カレンダーの変更反映方法


DataSpider Servista 4.0 以前

修正内容

休日設定で、[基準カレンダー]に 2030 年までのカレンダー「2006-2030 日本カレンダー (土

日・祝日あり)」を追加しました。

休日設定で、[基準カレンダー]の「2006-2020 日本カレンダー (土日・祝日あり)」に山の日

(8 月 11 日)を追加しました。

休日設定で、[基準カレンダー]の「2006-2020 日本カレンダー (土日・祝日あり)」に 2019 年

9 月 23 日(秋分の日)が祝日として設定されていない問題を修正しました。

既存のカレンダーで、[基準カレンダー]に「2006-2010 日本カレンダー (土日・祝日あり)」または

「2006-2020 日本カレンダー (土日・祝日あり)」を指定している場合、本修正を適用させるには、既

存のカレンダーの設定画面を開き、[基準カレンダー]で「土日・祝日なし」を選択後、「2006-2030 日

本カレンダー (土日・祝日あり)」を選択して[了解]ボタンを押下してください。

また、既存のカレンダーで、[基準カレンダー]に「2006-2010 日本カレンダー (土日・祝日あり)」ま

たは「2006-2020 日本カレンダー (土日・祝日あり)」を指定し、かつ土日・祝日を平日に設定してい

る場合、上記手順で本修正を反映させると設定が外れます。再度設定し直してください。



66

5.4.2. 定期的な休日の設定の修正反映方法



修正内容

カレンダー設定の[定期的な休日の設定]で、以下の設定を行っていた場合、定期的な休日が

12 月に存在しないと、翌年 1 月第 1 週の曜日が休日になり、1 月の第 5 週の曜日が休日になら

ない問題を修正しました。

作成済みのカレンダー設定に本修正を反映させるためには、バージョンアップ後、対象のカレンダー設定

の設定ダイアログを開き、[OK]ボタンを押下してください。

ただし、事象が発生して休日になった翌年 1 月第 1 週の曜日の休日設定はそのままになります。再度設定

し直してください。



67

5.5. 日付/時間型のスクリプト変数を文字列に展開する際にフォー

マット

system.properties に設定を行っている場合には、バージョンアップ後に新バージョンの

DataSpider Servista に新しく設定を行う必要があります。スクリプト変数の型を変更した場合は、バー

ジョンアップ時に一度行っていれば、バージョンアップごとに行う必要はありません。

system.properties を変更した際には DataSpiderServer の再起動が必要になります。



概要

日時データを文字列に変換する際の仕様を、ISO 8601 に準拠するフォーマット

(yyyy-MM-dd'T'HH:mm:ss.SSSZZ)に変更しました。

それに伴い、プロパティ項目の入力フィールドに設定されている日付/時間型のスクリプト変数を展開する

場合の日付フォーマットが以下のように変更になりました。

変更前:「yyyy-MM-dd HH:mm:ss.SSS」

変更後:「yyyy-MM-dd'T'HH:mm:ss.SSSZZ」

DataSpider Servista 2.3.x 以前の動作(「yyyy-MM-dd HH:mm:ss.SSS」のフォーマットで日付/時間型

スクリプト変数を展開する)に変更したい場合には、以下のいずれか設定を行ってください。

対処方法

1. スクリプト変数の型を「文字列型」に変更し、「日時フォーマッティング」ロジックを使用する

該当する日付/時間型スクリプト変数の型を文字列型に変更し、「日時フォーマッティング」ロジックで

フォーマッティングをしてください。

2. system.properties ファイルに日付フォーマットを指定する

「xmlfw.daterenderingformat」で指定したフォーマットは、日時データを文字列として出力する箇

所全般に適用されます。そのため、日時データをそのまま文字列として扱っている箇所では、書き込むデー

タの書式が「yyyy-MM-dd'T'HH:mm:ss.SSSZZ」から「yyyy-MM-dd HH:mm:ss.SSS」に変更になり

ます。



68

対象ファイル

system.properties

配置場所


キー

xmlfw.daterenderingformat

設定内容

コメントアウトを外して、以下の内容を記述してください。

xmlfw.daterenderingformat=yyyy-MM-dd HH:mm:ss.SSS



69

5.6. スクリプト全般

本項では、スクリプト全般に関する、バージョンアップに伴う特別な設定について説明します。


せん。

5.6.1. UTF-8 のバックスラッシュを設定するとコンパイルエラーが発生す

る問題の修正反映方法



概要

UTF-8 のバックスラッシュ(0xC2A5)がスクリプト上の設定値に存在した場合、コンパイルエラーが発生

する問題を修正しました。

本修正を反映させるためには、次項「対処方法」に記載の手順にしたがってください。

対処方法

バージョンアップ後に、コンパイルエラーが発生するスクリプトのビルドを行ってください。

スクリプトのビルドは、以下のいずれかの方法で行うことができます。

メニューの[テスト実行]-[ビルド]選択

ツールバーの[スクリプトのビルド]選択

F7 キー打鍵

ビルド後に、修正が適用されます。



70

5.6.2. トランザクション処理、またはグループ処理に関する問題の修正反映

方法



概要

トランザクション処理、またはグループ処理で、終了処理を通らないプロセスフローを経由してスクリプ

トが終了した場合に発生する以下の問題を修正しました。

グローバルリソースのコンポーネントプールが解放されない

ファイルトランザクションのテンポラリファイルが残る


対処方法

バージョンアップ後に、コンパイルエラーが発生するスクリプトのビルドを行ってください。

スクリプトのビルドは、以下のいずれかの方法で行うことができます。

メニューの[テスト実行]-[ビルド]選択

ツールバーの[スクリプトのビルド]選択

F7 キー打鍵

ビルド後に、修正が適用されます。



71

5.6.3. サービス実行に関する問題の修正反映方法



概要

プロジェクトを開いた直後にサービスとして登録すると、サービス内のマージ Mapper を含むスクリプト

の実行時に、「InputDataNotFoundException」エラーが発生する問題を修正しました。


対処方法

バージョンアップ後に、対象のプロジェクトを再度サービスとして登録してください。



72

5.7. Mapper

本項では、Mapper に関する、バージョンアップに伴う特別な設定について説明します。


せん。

5.7.1. ユーザ定義ロジックに関する問題の修正反映方法 (1)


DataSpider Servista 3.0 ~ 3.0 SP2

概要

以下の条件をすべて満たしたユーザ定義ロジックを使用しているスクリプトを実行すると、実行結果が不

正になる場合がある問題を修正しました。

DataSpider Servista 3.0 以降のバージョンで作成または編集している

一つの Mapper ロジックからほかの複数の Mapper ロジックにマッピングリンクを設定してい

る

Studio で、複数の Mapper で使用されている (※)

(※) Studio for Web では、単一の Mapper でも発生します。


対処方法

バージョンアップ後に、以下の手順を行ってください。

1. 事象が発生しているユーザ定義ロジックを開く。

2. Mapper ロジックの位置をずらすなどして Mapper を編集状態にする。

3. プロジェクトを保存する。



73

5.7.2. ユーザ定義ロジックに関する問題の修正反映方法 (2)



概要

ユーザ定義ロジック内にて、条件判定による出力の切り替えロジックを使用すると、エラーが発生するま

たは値が出力されない場合がある問題を修正しました。


対処方法


1. 事象が発生しているユーザ定義ロジックを開く。





74

5.7.3. 単純な繰り返しロジックに関する問題の修正反映方法



概要

単純な繰り返しロジックの指定ノードと値を出力する要素が同一の場合、結果データにマッピングされた

値が出力されない問題を修正しました。


対処方法


1. 事象が発生している Mapper を開く。





75

5.7.4. Mapper ロジックに半角カンマを含む環境変数を設定した場合に発

生する問題の修正反映方法



概要

Mapper ロジックに「,」(半角カンマ)を値に含む環境変数を設定した場合、変数の展開時に「,」の手前ま

での値しか取得できない問題を修正しました。

※本現象を、「,」の前に文字エスケープ「\\」を記述して回避していた場合、本修正により「\\」がその

まま出力されるようになります。

例: 環境変数「test1」 (値は「aaa,bbb」)、「test2」 (値は「aaa\\,bbb」)

(修正前) %{test1} → 「aaa」、%{test2} → 「aaa,bbb」

(修正後) %{test1} → 「aaa,bbb」、%{test2} → 「aaa\\,bbb」


対処方法


1. 事象が発生している Mapper を開く。





76

5.7.5. 「文字列ごとに置換」ロジックの[マッチング方法]に関する問題の対

処方法



概要

DataSpider Servista 2.1.1 以前で作成した「文字列ごとに置換」ロジックを含む Mapper を、DataSpider

Servista 2.2.0 以降にバージョンアップしたあと、「文字列ごとに置換」ロジックを含む Mapper をビルド

すると「文字列ごとに置換」ロジックの[マッチング方法]の値が[完全一致]に変更されます。

これは、DataSpider Servista 2.2.0 で、「文字列ごとに置換」の[マッチング方法]に[完全一致]が追加さ

れました。2.2.0 以降では、[マッチング方法]のデフォルト値は[完全一致]であるため、バージョンアップ

後に[マッチング方法]の表示上の値が「完全一致」に設定されます。この時点では内部値は[部分一致]の

ままですが、ロジックが配置された Mapper をビルドすることで、表示上の値が内部値に設定され、ロジッ

クの動作が変わってしまいます。

対処方法

バージョンアップ後、「文字列ごとに置換」ロジックを開き、[マッチング方法]の値を[部分一致]に設定し

てください。

明示的に設定し直すことで、ビルド時に設定が変わらなくなります。



77

5.8. データベースアダプタ全般

本項では、データベース(RDB)アダプタ特有の、バージョンアップに伴う特別な設定について説明します。


せん。



概要

検索系 SQL 実行処理で SUM 関数を使用していて、かつ[スキーマ定義]に「NUMBER(int)」の型が存在す

る場合、2.2.0 以降にバージョンアップして実行すると実行時に「ClassCastException」エラーが発生し

ます。

対処方法

対象の検索系 SQL 実行処理のプロパティ設定ダイアログを開き、[SQL 文を実行してスキーマを設定]を実

行してスキーマ定義を更新してください。



78

5.9. Accessアダプタ、SQL Server ODBC アダプタ、

ODBC アダプタ

本項では、Access アダプタ、SQL Server ODBC アダプタ、ODBC アダプタ特有の、バージョンアップに

伴う特別な設定について説明します。


せん。



概要

DataSpider Servista 4.1 から、ODBC 接続は JDBC Proxy Server 経由のみをサポートします。そのため、

DataSpider Servista 3.2 以前で[ドライバタイプ]で[ODBC]を指定しているグローバルリソースは、

DataSpider Servista 4.1 へのバージョンアップ後、自動的に[ドライバタイプ]が[JDBC Proxy Server]

に切り替わります。[ドライバタイプ]で[JDBC Proxy Server]を指定しているグローバルリソースは、そ

のまま使用できます。

JDBC Proxy Server は、32bit の ODBC データソースのみをサポートします。DataSpider Servista

3.2 以前のバージョンで 64bit の ODBC データソースを使用している場合、DataSpider Servista 4.1 へ

のバージョンアップ後、32bit の ODBC データソースを作成してください。

詳細な動作と、対処方法を以下に記載します。

[ドライバタイプ]で[ODBC]を指定している場合の詳細な動作

DataSpider Servista 4.1 へのバージョンアップ後、自動的に[ドライバタイプ]が[JDBC Proxy

Server]に切り替わり、[Proxy サーバ]には「localhost」が、[Proxy ポート番号]には「4412」

(JDBC Proxy Server のデフォルトのポート番号)が設定されます。[ODBC データソース名]・

[ユーザ名]・[パスワード]は以前の設定を引き継ぎます。

対処方法

DataSpiderServer 稼働 OS 上に JDBC Proxy Server をデフォルトのポート番号でインストー

ルします。グローバルリソースの設定変更の必要なく接続可能になります。

DataSpider Servista 3.2 以前で[ドライバタイプ]で[ODBC]を指定しているグローバルリソースで



79

も、操作によっては[Proxy サーバ]・[Proxy ポート番号]の設定値が残っている場合があります。その場合、

DataSpider Servista 4.1 へのバージョンアップ後はその設定を引き継ぐため、インストールした JDBC

Proxy Server の設定に合わせてグローバルリソースの設定を変更してください。



80

5.10. Oracle 11gR2アダプタ

本項では、Oracle 11gR2 アダプタ特有の、バージョンアップに伴う特別な設定について説明します。

5.10.1. ライブラリ(JDBC ドライバ)の変更


せん。



概要

DataSpider Servista 3.1 から、Oracle 11gR2 アダプタで使用する JDBC ドライバのバージョンが変更に

なりました。そのため、バージョンアップ後に JDBC ドライバを変更する必要があります。

ドライババージョン

Oracle JDBC Driver 11.2.0

対象ライブラリ

ojdbc6.jar

Oracle ダウンロードサイトの「JDBC Drivers」のリンク先ページより 11.2 用の JDBC ドライバをダ

ウンロードしてください。

配置先

$DATASPIDER_HOME/server/plugin/data_processing/modules/oracle11gr2_adapter

$DATASPIDER_HOME/server/plugin/data_processing/modules/xa_oracle11gr2_adapte

r

変更手順

1. DataSpiderServer および各種クライアントアプリケーションを停止します。

2. 上記配置先にある旧バージョンで使用していた JDBC ドライバを削除します。

3. ダウンロードした JDBC ドライバを上記配置先にコピーします。

http://www.oracle.com/technetwork/indexes/downloads/index.html



81

4. DataSpiderServer および DataSpider Studio を起動します。



82

5.11. Oracle OCI アダプタ

本項では、Oracle OCI アダプタ特有の、バージョンアップに伴う特別な設定について説明します。

5.11.1. [8i に接続]プロパティ項目にチェックありグローバルリソースの移

行方法


せん。



概要

DataSpider Servista 4.1 から、Oracle OCI アダプタのグローバルリソースの[8i に接続]プロパティ項目

が廃止になりました。そのため、[8i に接続]プロパティ項目にチェックが入っている既存のグローバルリ

ソースを DataSpider Servista 4.1 にバージョンアップすると、正常に動作しません。

対処方法

1. バージョンアップ後に[8iに接続]プロパティ項目にチェックが入っている既存のグローバルリソース

を削除します。削除する際には、グローバルリソース名を控えておいてください。

2. Oracle OCI アダプタがサポートしているクライアントおよびデータベースに接続するグローバルリ

ソースを新規に作成します。グローバルリソース名は 1.で控えておいた名前にしてください。



83

5.12. SQL Server 2014 / 2012 / 2008 R2 / 2008 アダプタ

本項では、SQL Server 2014 / 2012 / 2008 R2 / 2008 アダプタ特有の、バージョンアップに伴う特別

な設定について説明します。



せん。



概要

DataSpider Servista 4.1 から、SQL Server 2014 / 2012 / 2008 R2 / 2008 アダプタで使用している

JDBC ドライバのバージョンが変更になりました。そのため、バージョンアップ後に JDBC ドライバを変

更する必要があります。


Microsoft JDBC Driver 6.0 for SQL Server


sqljdbc42.jar

sqljdbc_auth.dll (Windows 統合認証を使用する場合)

ドライバは Microsoft ダウンロードセンターから入手してください。

配置先

SQL Server 2014 アダプタ

$DATASPIDER_HOME/server/plugin/data_processing/modules/sqlserver2014_ad

apter



apter

https://www.microsoft.com/ja-jp/download/details.aspx?id=11774



84

SQL Server 2008 R2 アダプタ

$DATASPIDER_HOME/server/plugin/data_processing/modules/sqlserver2008r2_a

dapter



apter

変更手順







85

5.13. SAP テーブルクエリアダプタ

本項では、SAP テーブルクエリアダプタ特有の、バージョンアップに伴う特別な設定について説明します。

5.13.1. SAP テーブルクエリアダプタのバージョンアップ手順


すべてのバージョン (※新バージョンを除く)

概要

SAP テーブルクエリアダプタでは、バージョンアップ時に以下の手順で設定ファイルを移行する必要があ

ります。

バージョンアップ手順


「SAP テーブルクエリアダプタセットアップガイド」をもとに、新バージョンの DataSpider

Servista に SAP テーブルクエリアダプタをインストールし、ライセンスの登録までを行います。

2. 旧バージョンの DataSpider Servista から、以下のファイルをコピーします。

$DATASPIDER_HOME/SAPTableQueryAdapter/login.xml

$DATASPIDER_HOME/SAPTableQueryAdapter/etlsetting.xml

$DATASPIDER_HOME/SAPTableQueryAdapter/config/query/*

$DATASPIDER_HOME/SAPTableQueryAdapter/config/table/*


補足

旧バージョンと新バージョンで SAP テーブルクエリアダプタのインストールディレクトリパス

が同一である必要があります。

旧バージョンと新バージョンのインストールディレクトリパスが異なる場合には、上記ファイル

の login.xml 以外のファイル内に記述しているディレクトリパスを新バージョンのパスに変更


新バージョンで、各コンポーネントアイコンの[CONFIG ID]を設定し直す必要はありません。



86

5.13.2. クォート処理設定の反映


せん。



概要

DataSpider Servista 3.2において、SAPクエリデータの取得、およびSAPテーブルデータの取得で、クォー

ト処理の設定方法を変更しました。

3.1 以前と同じ動作(クォート処理を行う)にするためには、新バージョンにバージョンアップ後、コンフィ

グレーションツールで SAP クエリまたは SAP テーブルの定義を一度開き、設定を保存する必要がありま

す。

設定手順


2. コンフィグレーションツールを起動します。

3. SAP クエリまたは SAP テーブルの定義を開き、設定を保存します。




87

5.14. List Creator アダプタ

本項では、List Creator アダプタ特有の、バージョンアップに伴う特別な設定について説明します。

5.14.1. ライブラリのパスの区切り文字の変更


DataSpider Servista 2.4.x

概要

DataSpiderServer.lax ファイルに追加する List Creator アダプタのライブラリパスの区切り文字が「\」

の場合、「/」に変更してください。

対象ファイル

DataSpiderServer.lax

配置場所

$DATASPIDER_HOME/server/bin

変更手順


2. DataSpiderServer.lax ファイルを開きます。

3. キー「lax.class.path」に設定された List Creator アダプタの各ライブラリのパス区切り文字を「\」

から「/」に変更します。




88

5.15. FTPアダプタ

本項では、FTP アダプタ特有の、バージョンアップに伴う特別な設定について説明します。

5.15.1. グローバルリソースの[エンコード]の設定


せん。



概要

DataSpider Servista 3.0 以降から、FTP アダプタのグローバルリソースの[エンコード]に接続先 FTP サー

バのエンコードを必ず指定する必要があります。

新バージョンにバージョンアップ後に、接続先 FTP サーバのエンコードを指定するようにしてください。



89

5.16. Web アダプタ

本項では、Web アダプタ特有の、バージョンアップに伴う特別な設定について説明します。

5.16.1. 「localhost」および「127.0.0.1」に対するプロキシサーバ接続の

設定


せん。



概要

新バージョンにバージョンアップ後、プロキシサーバを使用する設定を行っていても、「localhost」およ

び「127.0.0.1」に対してプロキシサーバを経由せず接続するようになります。

バージョンアップ前の動作(「localhost」および「127.0.0.1」に対してもプロキシサーバを経由して接続

する)に変更したい場合には、system.properties にキー「http.nonProxyHosts」を追加し、値として空

文字を指定してください。

対象ファイル

system.properties

配置場所


変更手順


2. system.properties ファイルを開きます。

3. キー「l http.nonProxyHosts」を追加し、値に空文字を設定します。(例:「http.nonProxyHosts=」)




90

5.17. Web サービスアダプタ

本項では、Web サービスアダプタ特有の、バージョンアップに伴う特別な設定について説明します。

5.17.1. NamespaceDefinitionsGenerator の設定


DataSpider Servista 2.4.5 + パッチ「DSS245_110125_10」、

または DataSpider Servista 2.4.6

概要

対象バージョンの DataSpider Servista の Web サービスアダプタの Web サービス実行処理で、自動生成

された入出力スキーマに接頭辞が付与されている場合、バージョンアップ後、移行のためのツールを実行


設定手順


2. 以下の実行ファイルをエディタで開き、設定を行います。

Windows 版の場合

$DATASPIDER_HOME/server/lib/NamespaceDefinitionsGenerator.bat

Linux 版の場合

$DATASPIDER_HOME/server/lib/NamespaceDefinitionsGenerator.sh

設定が必要な箇所は以下の通りです。

DS_HOME

DataSpiderServer をインストールしたディレクトリを指定します。

DS_HOST

DataSpiderServer のホスト名または IP アドレスを指定します。

DS_PORT

DataSpiderServer のポート番号を指定します。



91

DS_USER

本ツールを実行する DataSpiderServer のユーザ名を指定します。(※管理者権限を持った

ユーザを指定してください。)

DS_PASS

本ツールを実行する DataSpiderServer ユーザのパスワードを指定します。

3. DataSpiderServer を起動します。

4. 設定を行ったファイルを実行します。実行したファイルと同じディレクトリ adapter.properties が作

成されます。

5. DataSpiderServer を停止します。

6. 4.で作成された adapter.properties の内容をコピーし、以下のファイルに追記します。

$DATASPIDER_HOME/server/plugin/data_processing/modules/webservices_adapter/

META-INF/adapter.properties


上記の手順で移行を行った場合、移行した Web サービスアダプタのグローバルリソース名は変更し

ないでください。



92

5.18. Amazon RDS for SQL Server 2012 アダプタ

本項では、Amazon RDS for SQL Server 2012 アダプタ特有の、バージョンアップに伴う特別な設定に

ついて説明します。



せん。



概要

DataSpider Servista 4.1 から、Amazon RDS for SQL Server 2012 アダプタで使用している JDBC ド

ライバのバージョンが変更になりました。そのため、バージョンアップ後に JDBC ドライバを変更する必

要があります。




sqljdbc42.jar


配置先

Amazon RDS for SQL Server 2012 アダプタ

$DATASPIDER_HOME/server/plugin/data_processing/modules/

amazon_rds_sqlserver2012_adapter

変更手順







93




94

5.19. Amazon Redshift アダプタ



せん。



概要

DataSpider Servista 4.1 から、Amazon Redshift アダプタで使用している JDBC ドライバが変更になり

ました。そのため、バージョンアップ後に JDBC ドライバや、グローバルリソースの[URL]の値を変更す

る必要があります。


Amazon Redshift JDBC Driver 1.1.<バージョン>(JDBC 4.2 互換ドライバ)


RedshiftJDBC42-1.1.<バージョン>.jar

ドライバは Amazon Redshift JDBC Driver ダウンロードサイトから入手してください。

配置先

Amazon Redshift アダプタ


amazon_redshift802_adapter

変更手順





http://docs.aws.amazon.com/ja_jp/redshift/latest/mgmt/configure-jdbc-connection.html



95

5. 旧バージョンで使用していた Amazon Redshift アダプタのグローバルリソースを開きます。

6. グローバルリソースの[URL]プロパティ項目に、Amazon Redshift のコンソール画面で表示されてい

る Cluster Database Properties-JDBC URL を指定します。



96

5.20. Azure SQL データベースアダプタ



せん。



概要

DataSpider Servista 4.1 から、Azure SQL データベースアダプタで使用している JDBC ドライバのバー

ジョンが変更になりました。そのため、バージョンアップ後に JDBC ドライバを変更する必要があります。




sqljdbc42.jar


配置先

Azure SQL データベースアダプタ


sqlazure_adapter

変更手順








97

5.21. ScriptRunner

本項では、ScriptRunner 特有の、バージョンアップに伴う特別な設定について説明します。

5.21.1. scriptrunner.bat の配置



概要

旧バージョンの DataSpider Servista で scriptrunner.bat を使用している場合、別途配置が必要となりま

す。

対象ファイル

scriptrunner.bat

配置場所

$DATASPIDER_HOME/server/lib/

変更手順


2. scriptrunner.bat ファイルを$DATASPIDER_HOME/<server|client>/bin 下に配置します。




98

5.22. ScriptRunnerProxy

本項では、ScriptRunnerProxy 特有の、バージョンアップに伴う特別な設定について説明します。

5.22.1. dssrconnection.jar の更新


すべてのバージョン (※新バージョンを除く)

概要

ScriptRunnerProxy では、Java プログラム実行環境の dssrconnection.jar と DataSpiderServer 内の

dssrconnection.jar が同一である必要があります。

そのため、Java プログラム実行環境に dssrconnection.jar をコピーして配置している場合には、必ず

DataSpider Servista 4.1に同梱されている最新のdssrconnection.jarに差し替えるようにしてください。

対象ファイル

dssrconnection.jar

配置場所

$DATASPIDER_HOME/<server|client>/system/common/lib/



99

5.23. DataSpiderServer

本項では、DataSpiderServer 特有の、バージョンアップに伴う特別な設定について説明します。

5.23.1. Windows x64 版の「lax.nl.java.option.additional」設定につい

て


せん。



概要

Windows x64 版の DataSpiderServer の設定ファイル(DataSpiderServer.lax)の

「lax.nl.java.option.additional」に以下のオプションを追加している場合、DataSpider Servista 4.1 に

バージョンアップする際には、オプションを移行しないでください。

配置場所

$DATASPIDER_HOME/server/bin/

DataSpiderServer.lax ファイル内の「lax.nl.java.option.additional」

対象オプション

-XXcompressedRefs=0

-XnoOpt

-XstrictFP

DataSpider Servista 4.1 では、上記オプションの設定は必要ありません。



100

5.24. スマートコンパイラ

本項では、スマートコンパイラ特有の、バージョンアップに伴う特別な設定について説明します。

5.24.1. バージョンアップしたスクリプトへの PSP の適用


せん。



概要

スマートコンパイラは、スクリプトの内容を解析し、理論上データ容量の制限がない PSP が使用可能な箇

所を自動で検出して適用する機構です。PSP を適用することにより、スクリプトのパフォーマンスを最大

限に発揮することができます。

PSP では、ブロック単位で分割したデータの読み取り・変換・書き込みといった一連の流れをマルチスレッ

ドで処理するため、大容量データを高速に処理することができます。ただし、PSP は機構の特性上すべて

の処理が対応しているわけではありません。PSP に対応しているコンポーネントは主にデータモデルが

テーブルモデル型のコンポーネントに限られます。

PSP に対応するコンポーネントについては、「パラレルストリーミング処理」のヘルプを参照してくだ

さい。

バージョンアップしたスクリプトは、自動では PSP が適用されません。PSP を適用したい場合は、明示的

にデータフローを PSP データフローに変更する必要があります。

PSP の適用方法は、以下の通りです。



101

1). データフローから個別変更

スクリプトキャンバスでは、データフロー単位で PSP データフローに変更することができます。

1. デザイナで、対象のスクリプトを開きます。

2. データフローの右クリックメニュー[PSP データフローを有効化/無効化]にチェックを入れます。

手順 2.でチェックを外すと、プロジェクト内のスクリプトの PSP データフローをすべて通常のデータ

フローに変更することができます。

2). プロジェクトエクスプローラから一括変更

プロジェクトエクスプローラでは、「プロジェクト単位」「フォルダ単位」「スクリプト単位」でそれぞれデー

タフローを PSP データフローに変更することができます。

1. デザイナで対象のプロジェクトを開きます。

2. プロジェクトエクスプローラで、プロジェクト/フォルダ/スクリプトの右クリックメニュー[PSP デー

タフローの操作]から[一括で有効にする]を選択します。

3. 「PSP データフローの操作」ダイアログの[OK]ボタンを押下します。

手順 2.で[一括で解除する]を選択すると、対象のスクリプトの PSP データフローをすべて通常のデー

タフローに変更することができます。



102

3). マイプロジェクトから一括変更

プロジェクト内のスクリプトのデータフローをすべて PSP データフローに変更します。

1. マイプロジェクトを開きます。

2. プロジェクトの一覧で、対象のプロジェクトの右クリックメニュー[PSP データフローの操作]から[一

括で有効にする]を選択します。

3. 「PSP データフローの操作」ダイアログの[OK]ボタンを押下します。

4. 「PSP データフローの一括設定変更」ダイアログの[OK]ボタンを押下します。

手順 2.で[一括で解除する]を選択すると、プロジェクト内のスクリプトの PSP データフローをすべて

通常のデータフローに変更することができます。



103

5.25. HULFT DataSpider 接続アダプタ

本項では、HULFT DataSpider アダプタ特有の、バージョンアップに伴う特別な設定について説明します。

5.25.1. HULFT DataSpider 接続アダプタの設定情報の移行方法


せん。



概要

新バージョンで、旧バージョンで使用していた HULFT DataSpider 接続アダプタの設定情報を移行する場

合の手順は、以下の通りです。

1). HULFT8に接続する場合 (HULFT8 アダプタを使用する)

新バージョンにバージョンアップ後、HULFT DataSpider 接続アダプタで使用していたグローバルリソー

スおよびプロジェクトを開き、接続先の HULFT8 に合わせて設定を変更します。

2). HULFT7に接続する場合 (HULFT7 アダプタを使用する)

1. 新バージョンにバージョンアップ後、「HULFT7 接続設定」のグローバルリソースを新規作成します。

作成するグローバルリソースの名前は、HULFT DataSpider 接続アダプタで使用していたグローバル

リソースと同名にします。

※移行した HULFT DataSpider 接続アダプタのグローバルリソースの名前を変更してから行ってく

ださい。同名にすることで、スクリプトの変更をせずに移行ができます。

2. HULFT DataSpider 接続アダプタのグローバルリソースの設定情報をもとに、1.で作成したグローバ

ルリソースを設定します。



104

6. 補足事項

6.1. スキーマ読み込みの仕様変更について

DataSpider Servista 2.2.0 ではスキーマ読み込みの仕様の変更を行いました。

DataSpider Servista 2.2.0 以降では、スキーマの読み込みが可能な入力元データを持つ場合、同一のコ

ンポーネントからデータフローを引かれたドキュメント Mapper/変数 Mapper が複数あった際に、一つの

ドキュメント Mapper/変数 Mapper で設定されたスキーマ構造をほかのドキュメント Mapper/変数

Mapper でも自動で表示することができるようになります。

6.1.1. 「2.1」ツールチップが表示されるドキュメント Mapper/変数

Mapper について

DataSpider Servista 2.1.1 以前のドキュメント Mapper/変数 Mapper を DataSpider Servista 2.2.0 以

降で読み込むと、アイコンに 2.1 ツールチップが表示される場合があります。

これは、DataSpider Servista 2.2.0 以降ではスキーマの読み込みの仕様が変更されたため、DataSpider

Servista 2.1.1 以前の仕様でのスキーマ読み込み処理が行われていることを明示的に示しています。

(2.1 ツールチップが表示されているドキュメント Mapper/変数 Mapper は、DataSpider Servista 2.1.1

以前のスキーマ読み込み処理を行います。)

ドキュメント Mapper に引かれているすべてのデータフローを削除すれば、2.1 ツールチップは非表示に

なります。

(それ以降にデータフローが引かれた場合、DataSpider Servista 2.2.0 のスキーマ読み込み処理となりま

す。)

変数 Mapper の場合は、一部例外を除き 2.1 ツールチップが非表示になることはありません。

「2.1」ツールチップが表示されている場合でも、内部アーキテクチャは DataSpider Servista 2.2.0

以降の新アーキテクチャとなります。



105

7. トラブルシューティング

7.1. DataSpider Servista 2.1.1 以前からバージョンアップ後、

検索系 SQL 実行処理で「ClassCastException」が発生する

事象

DataSpider Servista 2.1.1 以前の環境で、データベースアダプタの検索系 SQL 実行処理で SUM 関数を

使用していて、かつスキーマ定義に NUMBER(int)の型が存在する場合、DataSpider Servista 2.2.0 以降

にバージョンアップして実行すると「ClassCastException」エラーが発生する。(DSS-3877)

考えられる原因

DataSpider Servista 2.2.0 以降では、DataSpider Servista 内部で NUMBER 型を「BigDecimal」で扱

うようになったためです。

対応方法

エラーが発生するデータベースアダプタのプロパティ設定ダイアログを開き、[SQL 文を実行してスキーマ

を設定]プロパティアクションを実行して、スキーマ定義を更新してください。



106

DataSpider Servista 4.1 アップグレードガイド第 2 版 2018.3.30

株式会社アプレッソ

〒107-0052 東京都港区赤坂 1-8-1 赤坂インターシティ AIR 19F

TEL : 03-4321-1111

4.1 アップグレードガイド...dataspider servista 4.1 upgrade guide copyright© 2018 appresso...

Documents