Spectrum™ Technology Platform
バージョン 9.0 SP3
管理ガイド
目次
第 1 章 : はじめに..................................................................................................9
サーバーの起動および停止...................................................................................10
クライアント ツールのインストール....................................................................10
クライアント ツールの起動..................................................................................11
Management Console の概要.............................................................................12
新規システムの設定..............................................................................................13
デフォルトのネットワーク ポート.......................................................................14
第 2 章 : システムの保護.....................................................................................15
セキュリティ モデル.............................................................................................16
ユーザ....................................................................................................................17
ユーザの作成..............................................................................................17
ユーザの変更..............................................................................................18
ユーザ アカウントの無効化.......................................................................18
ユーザの削除..............................................................................................18
役割.......................................................................................................................19
役割の作成..................................................................................................20
セキュア エンティティ タイプ - プラットフォーム...................................21
セキュア エンティティ タイプ - Advanced Matching モジュール.............22
セキュア エンティティ タイプ - Business Steward モジュール................23
セキュア エンティティ タイプ - Data Hub モジュール.............................23
セキュア エンティティ タイプ - Data Normalization モジュール..............24
セキュア エンティティ タイプ - Enterprise Data Integration モジュー
ル................................................................................................................24
セキュア エンティティ タイプ - Location Intelligence モジュール............24
セキュア エンティティ タイプ - データベース リソース..........................24
セキュア エンティティ オーバーライド...............................................................25
セキュア エンティティ オーバーライドの作成..........................................25
セキュア エンティティ オーバーライドの表示..........................................26
Location Intelligence モジュールのセキュリティ..............................................27
例: 役割レベルでの権限のオーバーライド.................................................29
例: ユーザ レベルでの権限のオーバーライド............................................30
名前付きリソース管理者の作成.................................................................32
空間データフロー設計者の作成.................................................................32
サービスおよびリポジトリのセキュリティをオフにする.........................33
プラットフォーム セキュリティの無効化と空間セキュリティの無効化
....................................................................................................................33
ユーザ セキュリティの無効化...............................................................................34
サーバー ディレクトリ アクセスの制限...............................................................34
HTTPS 通信の設定................................................................................................36
WebFolders を使用してリポジトリ リソースにアクセスする...................38
第 3 章 : データへの接続.....................................................................................39
接続の概要............................................................................................................40
データベース.........................................................................................................40
データベース接続の追加または変更..........................................................40
データベース接続の削除............................................................................40
NoSQL データベース接続の追加または変更.............................................41
NoSQL データベース接続の削除...............................................................41
JDBC ドライバ...........................................................................................41
サポートされるデータベースのデータ タイプ...........................................43
ファイル サーバー.................................................................................................44
FTP ファイル サーバーへの接続................................................................44
Hadoop 分散ファイル システムへの接続...................................................45
Amazon クラウドへの接続.........................................................................47
ファイル サーバーの削除...........................................................................48
外部の Web サービス............................................................................................48
外部 SOAP Web サービスの追加...............................................................49
外部 REST Web サービスの追加...............................................................51
外部 Web サービスの名前の変更...............................................................53
外部 Web サービスの削除..........................................................................53
Windows でマッピングされたドライブの利用....................................................54
第 4 章 : データベース リソースの設定..............................................................57
データベース リソースの概要...............................................................................58
データベース リソースの追加...............................................................................58
Enterprise Geocoding モジュール グローバル データベース リソース
の追加.........................................................................................................58
Enterprise Geocoding モジュールの米国 データベース リソース.............60
Enterprise Geocoding モジュールのオーストラリア用データベース リ
ソースの追加..............................................................................................60
Enterprise Routing モジュールのデータベース リソースの追加...............62
Enterprise Tax モジュールのデータベース リソースの追加......................62
4
Spectrum™ Technology Platform 9.0 SP3
Location Intelligence モジュール Centrus データベース リソースの追
加................................................................................................................63
Location Intelligence モジュール データベースの名前付き接続の追加
....................................................................................................................64
Location Intelligence モジュールの名前付きテーブル リソースの追加
....................................................................................................................66
Universal Addressing モジュールのデータベース リソースの追加...........67
Universal Addressing モジュールのグローバル データベース リソース
の追加.........................................................................................................68
データベース リソースのプール サイズの設定....................................................70
データベース リソースの削除...............................................................................71
第 5 章 : 実行の管理............................................................................................73
ジョブとプロセス フロー......................................................................................74
ジョブまたはプロセス フローの手動実行..................................................74
コマンド ラインからのジョブの実行.........................................................74
コマンド ラインからのプロセス フローの実行..........................................81
ジョブとプロセス フローのスケジューリング...........................................84
ファイル モニターによるジョブまたはプロセス フローのトリガ.............86
ジョブの一時停止.......................................................................................88
ジョブまたはプロセス フローのキャンセル..............................................88
実行ステータスと履歴の表示.....................................................................88
形式に誤りのあるレコード数の最大値のデフォルトの設定......................90
デフォルト レポート オプションの設定....................................................90
サービス................................................................................................................91
デフォルト サービス オプションの指定....................................................91
サービスのプレビュー................................................................................91
サービス タイムアウトの設定....................................................................93
サービスの最適化.......................................................................................93
トランザクション履歴................................................................................94
リモート サーバー.................................................................................................94
リモート サーバーの追加...........................................................................95
リモート サーバーへのサービスのルーティング.......................................96
リモート サーバーの変更...........................................................................96
リモート サーバーの削除...........................................................................96
リモート サーバーのエラーのトラブルシューティング............................97
デフォルトのタイプ変換オプションの設定..........................................................98
日付および時間パターン............................................................................99
数字パターン............................................................................................101
第 6 章 : パフォーマンスの最適化....................................................................105
管理ガイド
5
パフォーマンス チューニングのチェックリスト................................................106
パフォーマンス最適化のための設計ガイドライン..................................106
データフロー プール サイズの設定..........................................................107
プール サイズと実行時インスタンス設定のチューニング......................108
リモート コンポーネントのオプションの設定........................................111
個々のステージの最適化..........................................................................112
JVM パフォーマンス チューニング..........................................................118
パフォーマンスのモニタリング..........................................................................118
管理ユーティリティによるパフォーマンスのモニタリング....................118
JMX コンソールによるパフォーマンスのモニタリング..........................120
第 7 章 : システムの監視...................................................................................123
通知.....................................................................................................................124
電子メール通知の設定..............................................................................124
有効期限通知を受信する項目の選択........................................................125
ログ.....................................................................................................................125
イベント ログの表示................................................................................125
トランザクション上限に関する警告...................................................................126
バージョン情報の表示........................................................................................127
ライセンス情報の表示とエクスポート...............................................................127
第 8 章 : バックアップと復元............................................................................129
バックアップのスケジュール化..........................................................................130
バックアップを手動で作成する..........................................................................131
サーバーの復元...................................................................................................131
第 9 章 : 管理ユーティリティの使用.................................................................133
管理ユーティリティを使用する前に...................................................................134
管理ユーティリティをスクリプトから使用する.................................................135
コマンド..............................................................................................................136
データベース............................................................................................136
データフロー............................................................................................144
マッチ ルール...........................................................................................147
Open Parser カルチャー..........................................................................149
Open Parser ドメイン..............................................................................150
通知..........................................................................................................151
パフォーマンス モニター.........................................................................154
プロセス フロー.......................................................................................157
サービス...................................................................................................161
システム...................................................................................................164
6
Spectrum™ Technology Platform 9.0 SP3
テーブル...................................................................................................171
ユーザ アカウント....................................................................................173
第 10 章 : クラスタの管理.................................................................................179
クラスタ アーキテクチャ....................................................................................180
クラスタでのクライアント ツールの使用...........................................................181
クラスタへのノードの追加.................................................................................181
クラスタからのノードの削除..............................................................................182
クラスタのシャットダウン.................................................................................182
Location Intelligence モジュール用のクラスタの管理.....................................183
システムの設定........................................................................................183
共通リポジトリの設定..............................................................................184
マップ イメージ ファイル共有のセットアップ.......................................187
共有される Spectrum ローカル データ....................................................188
第 11 章 : Spectrum Technology Platform について......................................189
Spectrum™ Technology Platform とは............................................................190
エンタープライズ データ管理アーキテクチャ...................................................191
Spectrum™ Technology Platform のアーキテクチャ......................................194
モジュールとコンポーネント..............................................................................197
Appendix..........................................................................................................201
付録 A : Country ISO Codes and Module Support..............................203
各国の ISO コードとモジュール サポート...............................................204
管理ガイド
7
はじめに
このセクションの構成
• サーバーの起動および停止 . . . . . . . . . . . . . . . . . . . . . . . . . .10
• クライアント ツールのインストール . . . . . . . . . . . . . . . . . .10
• クライアント ツールの起動 . . . . . . . . . . . . . . . . . . . . . . . . .11
• Management Console の概要 . . . . . . . . . . . . . . . . . . . . . . .12
• 新規システムの設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13
• デフォルトのネットワーク ポート . . . . . . . . . . . . . . . . . . . .14
1
サーバーの起動および停止
サーバーの起動および停止
検索テーブルのインストール、製品アップデートの適用などのメンテナンスを実行するために、
Spectrum™ Technology Platform サーバーの 停止と起動が必要になることがあります。
• Windows の場合、Spectrum™ Technology Platform は、Windows の起動時に自動的に起動するよう
に設定されます。Spectrum™ Technology Platform が起動したことを確認するには、Windows シス
テム トレイの Spectrum™ Technology Platform アイコンを右クリックします。[サーバーの開始] メ
ニュー項目は、グレー表示されているはずです。Spectrum™ Technology Platform を停止するには、
[サーバーの停止] を選択します。
• Unix または Linux 上のサーバーを起動または停止するには:
a) 作業ディレクトリを、bin のインストール場所の Spectrum™ Technology Platform ディレクトリ
に変更します。例を次に示します。
cd /usr/g1/tst/server/bin
b) セットアップ ファイルのソースを指定します。例を次に示します。
. ./setup
c) Spectrum™ Technology Platform を起動します。
• Spectrum™ Technology Platform をバックグラウンドで起動するには、次のコマンドを入力し
ます。
./server.start
• Spectrum™ Technology Platform をフォアグラウンドで起動するには、次のコマンドを入力し
ます。
./server.start console
注 : Spectrum™ Technology Platform を停止するには、次のコマンドを入力します。
./server.stop
注 : Java は、デフォルトで /var/tmp を一時ディレクトリとして使用します。このディレクトリに
十分な容量がない場合は、Spectrum™ Technology Platform サーバーが起動せず、Management
Console も起動できない可能性があります。
クライアント ツールのインストール
Spectrum™ Technology Platform クライアント ツールは、 サーバーの管理や、データフローとプロセ
ス フローの設計および実行に使用する Windows アプリケーションです。 クライアント ツールを イン
ストールする前に、Spectrum™ Technology Platform サーバーをインストールする必要があります 。
インストールする前に、リリース ノートに目を通してください。 リリース ノートには、互換性に関
する重要な情報やリリースに固有のインストール上の注意事項が記載されています。
この手順では、以下のクライアント ツールのインストール方法について説明します。
• Enterprise Designer — データフローの作成、変更、実行に使用します。
• Management Console — サービスのデフォルトの設定、ジョブのスケジューリング、ユーザとセ
キュリティの管理など、管理タスクの実行に使用します。
10
Spectrum™ Technology Platform 9.0 SP3
第 1 章 : はじめに
• Interactive Driver — 異なる処理設定をテストするために使用します。 Interactive Driver では、少
数のレコードに対してプロセスを実行して、結果をプレビューすることができます。
• Job Executor — コマンド ラインまたはスクリプトからジョブを実行できるコマンド ライン ツール
です。 ジョブは、Enterprise Designer を使用して、Spectrum™ Technology Platform で作成および
保存されたものである必要があります。
• Process Flow Executor — コマンド ラインまたはスクリプトからプロセス フローを実行すること
のできるコマンド ライン ツールです。 プロセス フローは、Enterprise Designer を使用して、
Spectrum™ Technology Platform で作成および保存されたものである必要があります。
• Administration Utility — 管理ユーティリティでは、いくつかの管理機能をコマンドラインから実行
できます。 この機能はスクリプトで利用できるため、特定の管理タスクを自動化できます。 対話式
の操作で機能を実行することもできます。
クライアント ツールをインストールするには、次の操作を行います。
1. Web ブラウザを起動し、次の Spectrum™ Technology Platform の Welcome ページを開きます。
http://<サーバー名>:<ポート>
例えば、Spectrum™ Technology Platform が "myspectrumplatform" という名前のコンピュータにイ
ンストールされており、デフォルトの HTTP ポート 8080 を使用している場合は、次のアドレスに
移動します。
http://myspectrumplatform:8080
2. [プラットフォーム クライアント ツール] をクリックします。
3. インストールするクライアント ツールをダウンロードします。
クライアント ツールの起動
クライアント ツール (Enterprise Designer、Management Console、または Interactive Driver) は、 [ス
タート] メニューから起動する Windows アプリケーションです。 簡単に起動できますが、 留意すべき
点がいくつかあります。
Spectrum™ Technology Platform クライアントを起動するには:
1. [スタート] > [プログラム] > [Pitney Bowes] > Spectrum™ Technology Platform > [クライアント
ツール] を選択します。
2. 起動するクライアント (Management Console、Enterprise Designer、または Interactive Driver) を
選択します。
3. サーバー名または IP アドレスを入力するか、ドロップダウン リストから選択します。 クラスタ内
で Spectrum™ Technology Platform を使用している場合は、クラスタのロード バランサーの名前
または IP アドレスを入力します。
注 : Management Console の複数のインスタンスが同じ Spectrum™ Technology Platform サーバー
にアクセスする場合は、あるユーザの行った変更が別のユーザによって上書きされる可能性
があります。 したがって、同じサーバーで Management Console の複数のインスタンスを実
行しないことを推奨します。
4. ユーザ名とパスワードを入力します。
5. [ポート] フィールドに、Spectrum™ Technology Platform 通信に使用するように設定されている
サーバーのネットワーク ポートを入力します。 デフォルトのポート番号は 8080 です。
6. クライアントとサーバーの間で HTTPS 接続を使用する場合は、[セキュアな接続を使用] をクリッ
クします。
注 : セキュアな接続は、サーバー上で HTTPS 通信が設定されている場合にのみ使用できます。
管理ガイド
11
Management Console の概要
7. [ログイン] をクリックします。
Management Console の概要
Management Console は、 Spectrum™ Technology Platform システムを管理するツールです。 このト
ピックでは、Management Console の概要について説明します。
Management Console を使用すると、次のようなタスクを実行できます。
• ユーザと他のセキュリティ オプションを管理する。
• データベースや Web サービスなどのデータソースへの接続を定義する。
• サービスのデフォルト設定を指定する。
• ジョブの実行をスケジューリングする。
• モジュール固有の操作によってデータを分析する。
次の図に Management Console を表示します。
図 1 : Management Console
左のウィンドウのノードは、Management Console 機能へのアクセスを提供します。 次のようなノー
ドがあります。
モジュール
12
このノードには、システムにインストールされているモジュールのうち、サービス
または管理ツールを備えているモジュールが一覧表示されます。 モジュールによっ
ては、サービスまたは管理ツールを備えていないものもあるので、Management
Console にすべてのモジュールが表示されるとは限りません。 サービスがあらか
じめ定義されているモジュールの場合は、ここで、サービスにデフォルトの処理オ
Spectrum™ Technology Platform 9.0 SP3
第 1 章 : はじめに
プションを設定できます。 また、該当する場合、郵便参照データや、ジオコーディ
ング参照データなど、モジュールで使用する参照データベースを定義することもで
きます。
実行
このノードには、バッチ ジョブ、ジョブ ログ、データ タイプ変換オプションのス
ケジューリングなど、データフローやサービスの実行を制御するオプションが含ま
れています。
リソース
このノードには、Spectrum™ Technology Platform を介して処理するデータへの接
続を定義するオプションが含まれます。 Dataflow Designer で、リソースに対して
読み込みまたは書き込みのいずれかを行うデータフローを作成できるようにするに
は、ここで、そのリソースを定義する必要があります。
システム
このノードには、電子メール通知オプション、ライセンス情報、リモート サーバー
の設定など、システムの管理を支援できるオプションが含まれています。
イベント ログ
このノードには、サービス エラーのログを記録するオプションが含まれています。
また、システム上のサービスのイベント ログも表示されます。
セキュリティ
このノードには、ユーザを管理するためのオプションが含まれています。
トランザクショ このノードには、使用率に関するレポート用のオプションが含まれています。
ン履歴
新規システムの設定
Spectrum™ Technology Platform を初めてインストールする際には、 システムの使用を開始する前に、
管理者としていくつかの作業を最初に行う必要があります。これは、 基本的なレベルのセキュリティ
や Spectrum™ Technology Platform によって処理するデータへのアクセス権をシステムで確保するた
めです。
1. admin ユーザのパスワードを変更します。
重要 : システムに対して不正な管理者アクセスが行われることを回避するために、Spectrum™
Technology Platform をインストールした後すぐに admin パスワードを変更してください。
a) [スタート] > [プログラム] > [Pitney Bowes] > Spectrum™ Technology Platform > [クライア
ント ツール] > [Management Console] を選択します。
b) [セキュリティ] ノードで、[ユーザ] をクリックします。
c) [admin] を選択し、[変更] をクリックします。
d) [パスワード] フィールドに、新しいパスワードを入力します。 [パスワードの確認] フィールド
に、同じパスワードを再度入力します。
e) [OK] をクリックします。
2. 必要に応じて、ユーザと役割を作成します。
詳細については、ユーザの作成（17ページ）を参照してください。
3. ユーザのアクセスを許可する Spectrum™ Technology Platform サーバー上のフォルダを指定しま
す。
詳細については、サーバー ディレクトリ アクセスの制限（34ページ）を参照してください。
4. 必要に応じて、データベース リソースを定義します。
データベース リソースを定義する必要があるかどうかを判断するには、[モジュール] ノードを展
開し、さらに各モジュールを展開します。 モジュールの下に、データベース リソース アイコン付
管理ガイド
13
デフォルトのネットワーク ポート
きの [ツール] ノードがある場合は、モジュール用のデータベース リソースを定義する必要があり
ます。
5. Spectrum™ Technology Platform からアクセスするデータベース、ファイル サーバー、および他の
データソースを定義します。
6. Spectrum™ Technology Platform サーバーのバックアップ スケジュールを構成して、深刻なシステ
ム障害や災害が発生した場合もサーバーを復旧できるようにします。 詳細については、バックアッ
プのスケジュール化（130ページ）を参照してください。
デフォルトのネットワーク ポート
Spectrum™ Technology Platform サーバーは、通信にいくつかのネットワーク ポートを使用します。
ネットワーク ポートに競合があると、モジュール コンポーネントが起動に失敗する恐れがあります。
コンポーネントが Management Console に表示されない場合は、コンポーネントが起動に失敗したこ
とを表しています。この問題をトラブルシューティングするには、Spectrum™ Technology Platform
ログ ファイルを確認してください。このログには、どのポートが問題を起こしているかが示されてい
ます。Spectrum™ Technology Platform ログ ファイルは、以下の場所にあります。
server\app\repository\logs\server.log
以下の表に、デフォルトのネットワーク ポートを示します。以下のファイルのプロパティを修正する
と、ポートを変更できます。
server\app\conf\spectrum-container.properties
注 : クラスタで使用するネットワーク ポートを変更する場合は、クラスタ内のすべてのノードで
spectrum-container.properties ファイルを修正する必要があります。
14
ポート
プロパティ
説明
2424-2430
spectrum.orientdb.binary.port このポートは、Spectrum™ Technology
Platform サーバーの内部設定データベー
スが使用します。
2434
spectrum.orientdb.hazelcast.port このポートは、Spectrum™ Technology
Platform サーバーの内部設定データベー
スが使用します。
2480-2486
spectrum.orientdb.http.port
このポートは、Spectrum™ Technology
Platform サーバーの内部設定データベー
スが使用します。
5701
spectrum.hazelcast.port
このポートは、クラスタ内の
Spectrum™ Technology Platform サー
バー間の分散処理を管理するために
Hazelcast が使用します。
8080
spectrum.http.port
サーバーと Enterprise Designer、
Management Console、および
Interactive Driver の間の通信に使用する
ポート。このポートは Web サービスも
使用します。
10119
spectrum.socketgateway.port
このポートは、サービスに対する API
呼び出しで使用されます。
Spectrum™ Technology Platform 9.0 SP3
システムの保護
このセクションの構成
• セキュリティ モデル . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16
• ユーザ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17
• 役割 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19
• セキュア エンティティ オーバーライド . . . . . . . . . . . . . . . .25
• Location Intelligence モジュールのセキュリティ . . . . . . .27
• ユーザ セキュリティの無効化 . . . . . . . . . . . . . . . . . . . . . . .34
• サーバー ディレクトリ アクセスの制限 . . . . . . . . . . . . . . . .34
• HTTPS 通信の設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .36
2
セキュリティ モデル
セキュリティ モデル
Spectrum™ Technology Platform は、役割ベースのセキュリティ モデルを使用して、システムへのア
クセスを制御します。 以下の図に、Spectrum™ Technology Platform セキュリティ モデルの重要な概
念を示します。
ユーザとは、各個人に割り当てられるアカウントのことで、Spectrum™ Technology Platform に対す
る認証、つまり Enterprise Designer や Management Console などのクライアント ツールに対する認
証、または API を介してサービスを呼び出すときの認証で使用されます。
ユーザには 1 つ以上の役割が割り当てられます。 役割とは、システムのさまざまな部分に対するアク
セスを付与または拒否する権限の集合です。 通常、役割は、特定のタイプのユーザがシステムとの間
で行う対話操作の種類を表します。 例えば、データフローの作成および変更アクセスを付与する、
データフロー設計者向けの役割や、既存のデータフローを利用したデータ処理のみを必要とするユー
ザ向けの役割があります。
役割は、セキュア エンティティ タイプに権限を付与します。 セキュア エンティティ タイプとは、ア
クセスを付与または拒否するアイテムのカテゴリです。 例えば、"データフロー" というセキュア エン
ティティ タイプは、システム上のすべてのデータフローに対するデフォルトの権限を制御します。
アクセスを調整する必要がある場合は、オプションで、セキュア エンティティ オーバーライドを指定
できます。 セキュア エンティティ オーバーライドは、システム上の特定のセキュア エンティティへ
のアクセスを制御します。 例えば、セキュア エンティティ タイプの "データフロー" は、システム上
のすべてのデータフローに対するデフォルトの権限を指定し、個々のデータフローはセキュア エン
ティティです。 特定のデータフローへのアクセスを付与または拒否する場合は、そのデータフローに
対してセキュア エンティティ オーバーライドを指定します。 ユーザにセキュア エンティティ オー
バーライドを指定すると、そのユーザの役割によって付与されている権限よりも優先できます。 ま
た、役割に対してセキュア エンティティ オーバーライドを指定して、その役割を持つすべてのユーザ
にオーバーライドを適用することもできます。 オーバーライドは、あらかじめ定義されている役割や
ユーザに対してではなく、自分が作成した役割やユーザに対してのみ適用できます。
関連リンク
16
Spectrum™ Technology Platform 9.0 SP3
第 2 章 : システムの保護
ユーザ セキュリティの無効化（34ページ）
ユーザの作成（17ページ）
役割の作成（20ページ）
セキュア エンティティ オーバーライドの作成（25ページ）
ユーザ
Spectrum™ Technology Platform ユーザ アカウントは、ユーザがシステムで実行できるアクションの
タイプを制御します。 以下のアクションを行うには、ユーザ アカウントが必要です。
• Management Console、Enterprise Designer、または Interactive Driver を使用する。
• ジョブをスケジュールどおりに実行する。
• ジョブをコマンド ラインから実行する。
• Web サービスまたは API を介してサービスにアクセスする。
admin という管理アカウントが付属しています。 このアカウントは、完全アクセスを持ちます。 初
期パスワードは "admin" です。
重要 : システムに対して不正な管理者アクセスが行われることを回避するために、Spectrum™
Technology Platform をインストールした後すぐに admin パスワードを変更してください。
これらのデフォルト アカウント以外にも、必要に応じて必要な数だけユーザ アカウントを作成できま
す。
関連リンク
セキュア エンティティ オーバーライドの作成（25ページ）
ユーザの作成
この手順では、Spectrum™ Technology Platform ユーザ アカウントを作成し、そのユーザ アカウント
に役割を割り当てる方法について説明します。
1. Management Console を開きます。
2. [セキュリティ] を展開し、[ユーザ] をクリックします。
3. [追加] をクリックします。
[新しいユーザ] ウィンドウが表示されます。
4. このユーザ アカウントを使用可能にする場合は、[ユーザを有効にする] ボックスをチェックした
ままにします。
5. [ユーザ名] フィールドにユーザ名を入力します。
注 : ユーザ名には ASCII 文字のみを使用できます。
6. [パスワード] フィールドにユーザのパスワードを入力します。
7. [パスワードの確認] フィールドにユーザのパスワードを再入力します。
8. [電子メール アドレス] フィールドにユーザの電子メール アドレスを入力します。
9. [説明] フィールドにユーザの説明を入力します。
10. このユーザに付与する役割を選択します。
11. [OK] をクリックします。
関連リンク
管理ガイド
17
ユーザ
セキュリティ モデル（16ページ）
ユーザの変更
この手順では、既存の Spectrum™ Technology Platform ユーザ アカウントを変更する方法について説
明します。
注 : ユーザ名以外のすべてのユーザ情報を変更できます。 ユーザ名を変更する必要がある場合は、最
初にそのユーザを削除し、新しいユーザ名でユーザを作成する必要があります。
1. Management Console を開きます。
2. [セキュリティ] を展開し、[ユーザ] をクリックします。
3. [変更] をクリックします。
[ユーザ プロパティ] ウィンドウが表示されます。
4. このユーザ アカウントを使用可能にする場合は、[ユーザを有効にする] ボックスをチェックした
ままにします。
5. パスワードを変更するには、[新しいパスワード] フィールドに新しいパスワードを入力し、[パス
ワードの確認] フィールドに同じパスワードを再度入力します。 パスワードを変更したくない場合
は、[新しいパスワード] フィールドと [パスワードの確認] フィールドを空白のままにします。
6. [電子メール アドレス] フィールドにユーザの電子メール アドレスを入力します。
7. [説明] フィールドにユーザの説明を入力します。
8. このユーザに付与する役割を選択します。
9. [OK] をクリックします。
ユーザ アカウントの無効化
ユーザ アカウントを無効にすると、そのユーザ アカウントを Spectrum™ Technology Platform へのア
クセスに使用できなくなります。 ユーザ アカウントを無効にすると、そのユーザ アカウントを
Management Console、Enterprise Designer、または Interactive Driver へのアクセスに使用できなくな
ります。 また、そのユーザ アカウントを使用して実行がスケジュールされているジョブもすべて実行
できなくなります。 そのユーザ アカウントを使用する API 呼び出しも機能しなくなります。
注 : "admin" ユーザ アカウントは無効にできません。
1. Management Console を開きます。
2. [セキュリティ] を展開し、[ユーザ] をクリックします。
3. 無効にするユーザ アカウントを選択し、[変更] をクリックします。
4. [ユーザを有効にする] チェック ボックスをオフにします。
これで、ユーザ アカウントが無効になり、Spectrum™ Technology Platform へのアクセスに使用でき
なくなります。
ユーザの削除
この手順では、Spectrum™ Technology Platform ユーザ アカウントを完全に削除する方法について説
明します。
ヒント : また、ユーザ アカウントは無効にすることもできます。ユーザ アカウントを無効にすると、
アカウントを削除しなくても、システムへのアクセスにそのアカウントを使用できなくなり
ます。
18
Spectrum™ Technology Platform 9.0 SP3
第 2 章 : システムの保護
1. Management Console を開きます。
2. [セキュリティ] を展開し、[ユーザ] をクリックします。
3. [ユーザ管理] 画面で、削除するユーザを選択して、[削除] をクリックします。
4. 削除するには [はい] を、キャンセルするには [いいえ] をクリックします。
注 : "admin" ユーザ アカウントは削除できません。
役割
役割とは、システムのさまざまな部分に対するアクセスを付与または拒否する権限の集合です。 通
常、役割は、特定のタイプのユーザがシステムとの間で行う対話操作の種類を表します。 例えば、
データフローの作成および変更アクセスを付与する、データフロー設計者向けの役割や、既存のデー
タフローを利用したデータ処理のみを必要とするユーザ向けの役割があります。
あらかじめ定義されている役割を以下に示します。
admin
この役割は、システムのすべての部分に対する完全アクセスを持ちます。
designer
この役割は、Enterprise Designer でデータフローとプロセス フローを作成するユーザ
を対象としています。 この役割では、データフローを設計および実行できます。
integrator
この役割は、Spectrum™ Technology Platform を介してデータを処理する必要がある
が、データフローを作成または変更する必要のないユーザを対象としています。 この
役割では、Web サービスと API を介してサービスにアクセスし、バッチ ジョブを実
行できます。
spatial-admin この役割は、Location Intelligence モジュールがインストールされている場合にのみ使
用できます。 空間サービスを使用している場合、この役割は、このモジュールの名前
付きリソースに対する完全アクセスを提供します (Management Console を使用して
空間リソースを管理するには、他にもアクセスが必要です。 詳細については、Location
Intelligence モジュールのセキュリティ（27ページ）を参照してください)。
spatial-user この役割は、Location Intelligence モジュールがインストールされている場合にのみ使
用できます。 空間サービスを使用している場合、この役割は、このモジュールの名前
付きリソースに対する読み込み専用アクセスを提供します (Management Console を
使用して空間リソースを表示するには、他にもアクセスが必要です。 詳細について
は、Location Intelligence モジュールのセキュリティ（27ページ）を参照してくださ
い)。
user
これはデフォルトの役割です。 この役割は、システムに対するアクセスを持ちませ
ん。 この役割を持つユーザは、セキュア エンティティ オーバーライドを介して権限
が付与された場合にのみシステムにアクセスできます。
これらの各役割に付与されている権限を表示するには、Management Console を開き、[セキュリティ]
に移動して [役割] をクリックします。 次に、表示する役割を選択し、[表示] をクリックします。
ヒント : あらかじめ定義されている役割は変更できません。 ただし、あらかじめ定義されている役割
を基に新しい役割をできます。
関連リンク
セキュア エンティティ オーバーライドの作成（25ページ）
管理ガイド
19
役割
役割の作成
役割とは、ユーザに割り当てる権限の集合です。 Spectrum™ Technology Platform にあらかじめ定義
されている役割が組織のニーズに合わない場合は、独自の役割を作成できます。
1. Management Console で、[セキュリティ] を参照し、[役割] を展開します。
2. [追加] をクリックします。
3. [役割] フィールドに、この役割に付与する名前を入力します。 任意の名前にすることができます。
4. あらかじめ定義されている役割のいずれかを基に新しい役割を作成する場合は、[コピー元] ボック
スをオンにし、基にする役割を選択します。 あらかじめ定義されている役割の権限が選択されま
す。
5. オプション: セキュア エンティティ タイプの一覧は長くなることがあり、その場合は、セキュア
エンティティ タイプの特定のグループのみを表示することもできます。 同じ権限をグループ内の
すべてのエンティティに適用する場合は、その特定のグループのみを表示すると便利です。 例え
ば、すべてのデータベース リソースから変更権限を削除する場合は、フィルタリングしてデータ
ベース リソース グループのみを表示できます。 1 つのグループのみを表示して変更するには:
a) [グループのフィルタリングを有効にする] ボックスをオンにします。
b) [グループ] 列のヘッダにある漏斗（ろうと）アイコンをクリックし、表示するグループを選択
します。
c) 適用する権限の列ヘッダにあるボックスをオンまたはオフにします。
d) セキュア エンティティ タイプの完全な一覧に戻るには、フィルタ アイコンをクリックし、[(す
べて)] を選択して、[グループのフィルタリングを有効にする] ボックスをオフにします。
6. 各エンティティ タイプに付与する権限を選択します。 権限は以下のとおりです。
表示
ユーザは、エンティティ タイプに含まれるエンティティを表示できます。 例えば、
JDBC 接続エンティティ タイプに対する表示権限を許可すると、この役割を持つユー
ザは Management Console でデータベース接続を表示できます。
変更
ユーザは、エンティティ タイプに含まれるエンティティを変更できます。 例えば、
JDBC 接続エンティティ タイプに対する変更権限を許可すると、この役割を持つユー
ザは Management Console でデータベース接続を変更できます。
作成
ユーザは、このエンティティ タイプのカテゴリに分類されるエンティティを作成でき
ます。 例えば、JDBC 接続エンティティ タイプに対する作成権限を許可すると、この
役割を持つユーザは Management Console で新しいデータベース接続を作成できます。
削除
ユーザは、エンティティ タイプに含まれるエンティティを削除できます。 例えば、
JDBC 接続エンティティ タイプに対する削除権限を許可すると、この役割を持つユー
ザは Management Console でデータベース接続を削除できます。
実行
ユーザは、ジョブ、サービス、プロセス フローの処理を開始できます。 例えば、ジョ
ブ エンティティ タイプに対する実行権限を許可すると、この役割を持つユーザはバッ
チ ジョブを実行できます。 例えば、サービス エンティティ タイプに対する実行権限
を許可すると、この役割を持つユーザは Spectrum™ Technology Platform 上で実行さ
れるサービスに API または Web サービスを介してアクセスできます。
7. OK をクリックします。
これで、ユーザに役割を割り当てることができます。
注 : 作成した役割は削除できます。ただし、その場合は、役割の割り当てをユーザ アカウントからす
べて解除した後で行ってください。
関連リンク
セキュリティ モデル（16ページ）
20
Spectrum™ Technology Platform 9.0 SP3
第 2 章 : システムの保護
セキュア エンティティ タイプ - プラットフォーム
エンティティ タイプとは、アクセスを付与または拒否するアイテムのカテゴリです。 例えば、"デー
タフロー" というエンティティ タイプは、システム上のすべてのデータフローに対する権限を制御し
ます。 プラットフォーム エンティティ タイプは、Spectrum™ Technology Platform のすべてのインス
トールに適用され、モジュール固有のエンティティ タイプは、その特定のモジュールをインストール
した場合にのみ適用されます。 プラットフォームレベルのエンティティ タイプを以下に示します。
データフロー
Enterprise Designer ですべてのデータフロー (ジョブ、サービス、
およびサブフロー) へのアクセスを制御します。
データフロー - エクスポーズ
データフローを実行で使用できるようにする Enterprise Designer の
機能を制御します。
イベント ログ
Management Console で [イベント ログ] ノードへのアクセスを制
御します。
実行 - ファイル モニターとスケ Management Console でジョブ スケジュールとファイル モニター
ジューリング
へのアクセスを制御します。
例外 - ジョブ オプション
Management Console で [ジョブ オプション] ノードへのアクセスを
制御します。 すべてのユーザがジョブ オプションに対する View ア
クセスを持ちます。 View アクセスを削除することはできません。
例外 - レポート オプション
Management Console で [レポート オプション] ノードへのアクセス
を制御します。 すべてのユーザがレポート オプションに対する View
アクセスを持ちます。 View アクセスを削除することはできません。
実行 - ソート パフォーマンス
Management Console で [ソート パフォーマンス] ノードへのアクセ
スを制御します。 すべてのユーザがソート パフォーマンス オプショ
ンに対する View アクセスを持ちます。 View アクセスを削除するこ
とはできません。
例外 - タイプ変換オプション
Management Console で [タイプ変換] ノードへのアクセスを制御し
ます。 すべてのユーザがタイプ変換オプションに対する View アク
セスを持ちます。 View アクセスを削除することはできません。
実行履歴 - ジョブ
Enterprise Designer と Management Console でジョブ実行履歴への
アクセスを制御します。
実行履歴 - プロセス フロー
Management Console と Enterprise Designer でプロセス フロー実
行履歴へのアクセスを制御します。
ジョブ
Enterprise Designer、Management Console、および Job Executor
でジョブを実行する機能を制御します。
通知 - ライセンス有効期限
Management Console でライセンス有効期限通知の電子メール設定
へのアクセスを制御します。
通知 - SMTP 設定
Management Console で電子メール通知オプションへのアクセスを
制御します。
プロセス フロー
Enterprise Designer でプロセス フローへのアクセスを制御します。
プロセス フロー - エクスポーズ プロセス フローを実行で使用できるようにする Enterprise Designer
の機能を制御します。
リモートサーバー
管理ガイド
Management Console で [リモート サーバー] ノードへのアクセスを
制御します。
21
役割
リソース - データベース接続
Management Console で JDBC 接続を設定する機能を制御します。
リソース - 外部の Web サービ
ス
Management Console で外部の Web サービスの管理へのアクセス
を制御します。
リソース - ファイル サーバー
Management Console でファイル サーバーを設定する機能を制御し
ます。
リソース - JDBC ドライバ
Management Console で JDBC ドライバを設定する機能を制御しま
す。
リソース - 制限付きサーバー
ディレクトリ アクセス
Management Console でサーバー ディレクトリ リソースに対する
制限を有効または無効にする機能を制御します。
リソース - サーバー ディレクト Management Console でサーバー ディレクトリ リソースを設定す
リ パス
る機能を制御します。
セキュリティ - オプション
Management Console で [セキュリティ オプション] ノードへのアク
セスを制御します。
セキュリティ - 役割
Management Console で役割の設定へのアクセスを制御します。
セキュリティ - セキュア エン
ティティ オーバーライド
Management Console でセキュア エンティティ オーバーライドへ
のアクセスを制御します。
セキュリティ - ユーザ
Management Console の [ユーザ] ノードでユーザ アカウントを管理
するためのアクセスを制御します。
サービス
API と Web サービスを介してサービスを実行する機能を制御しま
す。
ステージ
エクスポーズされたサブフローを Enterprise Designer のデータフ
ローのステージとして使用できるかどうかを制御します。
システム - ライセンス
Management Console に表示されるライセンス情報へのアクセスを
制御します。
システム - バージョン情報
Management Console で [バージョン情報] ノードへのアクセスを制
御します。
トランザクション履歴
Management Console で [トランザクション履歴] ノードへのアクセ
スを制御します。
セキュア エンティティ タイプ - Advanced Matching モジュール
エンティティ タイプとは、アクセスを付与または拒否するアイテムのカテゴリです。 以下のエンティ
ティ タイプは、Advanced Matching モジュールの各部分へのアクセスを制御します。
マッチ ルール管理
検索インデックス管理
22
Enterprise Designer の Interflow Match ステージ、Intraflow Match ステー
ジ、Transactional Match ステージ、およびマッチ ルール管理ツールへのア
クセスを制御します。
Write to Search Index の検索インデックス、Candidate Finder、および
Enterprise Designer の検索インデックス管理ツールへのアクセスを制御
します。
Spectrum™ Technology Platform 9.0 SP3
第 2 章 : システムの保護
セキュア エンティティ タイプ - Business Steward モジュール
エンティティ タイプとは、アクセスを付与または拒否するアイテムのカテゴリです。 以下のエンティ
ティ タイプは、Business Steward モジュールの各部分へのアクセスを制御します。
例外
Read Exceptions ステージと Exception Editor の他のユーザに割り当てられている例外レコー
ドを変更または削除する機能を制御します。 また、例外の管理で例外レコード アクティビ
ティを確認および管理する機能も制御し、Business Steward Portal のパフォーマンス デー
タへのアクセスを可能にします。
また、Business Steward Portal グループに対する変更権限を持つユーザが、例外レコードを
割り当てまたは再割り当てするには、プラットフォーム グループに対するセキュリティ ユーザ表示権限も必要です。
セキュア エンティティ タイプ - Data Hub モジュール
エンティティ タイプとは、アクセスを付与または拒否するアイテムのカテゴリです。 以下のエンティ
ティ タイプは、Data Hub モジュールの各部分へのアクセスを制御します。
アルゴリズム Relationship Analysis Client でアルゴリズムを実行する機能を制御します。
モデル管理
Data Hub ステージと Relationship Analysis Client を使用して以下のアクションを実
行するユーザの機能を制御します。
• モデル データ (エンティティ、関連性、およびプロパティ) を読み込む。
• モデルとモデル データ (エンティティ、関連性、およびプロパティ) を作成する。
• モデル データ (エンティティ、関連性、およびプロパティ) を変更する。
• モデルとモデル データ (エンティティ、関連性、およびプロパティ) を削除する。
例えば、モデルが保険データで構成されている場合、医師と患者がエンティティ、"訪
問" や "保険請求" などが関連性、訪問や保険請求の日付を示すのがプロパティとなり
ます。 この例では、モデル管理エンティティ タイプを使用すると、以下のアクショ
ンを行う権限を付与できます。
• 医師と患者のデータと、訪問または保険請求プロパティを読み込む。
• 医師および患者エンティティを作成し、それらを訪問または保険請求の関連性に
よって関連付けて、住所、保険請求 ID、日付などのプロパティを含める。
• 医師および患者エンティティ、それらの関連性、住所、保険請求 ID、日付などの
プロパティを変更する。
• 医師と患者をモデルから削除する。
モデル メタ
データ
Data Hub ステージと Relationship Analysis Client を使用して以下のアクションを実
行するユーザの機能を制御します。
• エンティティ タイプと関連性タイプを読み込む。
• エンティティ タイプ、関連性タイプ、およびプロパティを作成する。
• エンティティ タイプのプロパティと関連性タイプのプロパティを変更する。
• エンティティと関連性を削除する。
注 : Write to Hub ステージでは、この権限でモデルをクリアすることもできます。
モニター管理 Relationship Analysis Client で、モデルのエンティティや関連性の変更を検出するモ
ニターを作成する機能を制御します。
管理ガイド
23
役割
テーマ管理
Relationship Analysis Client でモデルのテーマを定義する機能を制御します。
セキュア エンティティ タイプ - Data Normalization モジュール
エンティティ タイプとは、アクセスを付与または拒否するアイテムのカテゴリです。 以下のエンティ
ティ タイプは、Data Normalization モジュールの各部分へのアクセスを制御します。
Advanced Transformer の
テーブル
Enterprise Designer のテーブル管理ツールで各 Advanced Transformer
テーブルへのアクセスを制御します。
Open Parser カルチャー
Enterprise Designer の Open Parser ドメインエディター ツールでカ
ルチャーへのアクセスを制御します。
Open Parser ドメイン
Enterprise Designer の Open Parser ドメインエディター ツールでド
メインへのアクセスを制御します。
Open Parser のテーブル
Enterprise Designer のテーブル管理ツールで各 Open Parser テーブ
ルへのアクセスを制御します。
正規化のテーブル
Enterprise Designer のテーブル管理ツールで各正規化テーブルへの
アクセスを制御します。
セキュア エンティティ タイプ - Enterprise Data Integration モジュール
エンティティ タイプとは、アクセスを付与または拒否するアイテムのカテゴリです。 以下のエンティ
ティ タイプは、Enterprise Data Integration モジュールの各部分へのアクセスを制御します。
キャッシュ
Write to Cache および Query Cache ステージと Management Console のキャッ
シュ管理ツールで使用するキャッシュへのアクセスを制御します。
セキュア エンティティ タイプ - Location Intelligence モジュール
エンティティ タイプとは、アクセスを付与または拒否するアイテムのカテゴリです。 Location
Intelligence モジュールには、以下のモジュール固有のエンティティ タイプがあります。
名前付きリソース
Location Intelligence モジュールのすべての名前付きリソース (名前付きマップ、名前付きタイトル、
名前付きテーブル、名前付き接続など) に対する権限を制御します。 Location Intelligence モジュール
サービスのユーザには、最低限、使用するリソースとその従属リソースに対する読み込み権限が必要
です。
セキュア エンティティ タイプ - データベース リソース
エンティティ タイプとは、アクセスを付与または拒否するアイテムのカテゴリです。 使用できるデー
タベース リソースは、インストールされているモジュールによって異なります。以下に例を示しま
す。
• Centrus データベース リソース
• Enterprise Routing
• 空間データベース リソース
24
Spectrum™ Technology Platform 9.0 SP3
第 2 章 : システムの保護
セキュア エンティティ オーバーライド
セキュア エンティティ オーバーライドは、システム上の特定のセキュア エンティティへのアクセス
を制御します。 例えば、セキュア エンティティ タイプの "データフロー" は、システム上のすべての
データフローに対するデフォルトの権限を指定し、個々のデータフローはセキュア エンティティで
す。 特定のデータフローへのアクセスを付与または拒否する場合は、そのデータフローに対してセ
キュア エンティティ オーバーライドを指定します。 ユーザにセキュア エンティティ オーバーライド
を指定すると、そのユーザの役割によって付与されている権限よりも優先できます。 また、役割に対
してセキュア エンティティ オーバーライドを指定して、その役割を持つすべてのユーザにオーバーラ
イドを適用することもできます。 オーバーライドは、あらかじめ定義されている役割やユーザに対し
てではなく、自分が作成した役割やユーザに対してのみ適用できます。
セキュア エンティティ オーバーライドの作成
セキュア エンティティ オーバーライドは、特定のデータフロー、特定のデータベース接続など、特定
のセキュア エンティティに対する権限を指定します。 セキュア エンティティ オーバーライドを作成
するには:
1. Management Console で、[セキュリティ] を展開し、[セキュア エンティティ オーバーライド] を
クリックします。
2. 以下のいずれかの方法を実行します。
• 役割に対するセキュア エンティティ オーバーライドを指定する場合は、[役割] をクリックしま
す。 指定するオーバーライドは、選択した役割を持つすべてのユーザに影響します。
• ユーザに対するセキュア エンティティ オーバーライドを指定する場合は、[ユーザ] をクリック
します。 指定するオーバーライドは、選択したユーザにのみ影響します。
3. [参照] をクリックして、特定の役割やユーザを選択し、[OK] をクリックします。
4. [追加] をクリックし、[参照] をクリックします。
[セキュア エンティティ タイプの選択] ウィンドウが表示されます。
5. オーバーライドするセキュア エンティティが含まれるセキュア エンティティ タイプを選択し、
[OK] をクリックします。 例えば、データフロー セキュア エンティティをオーバーライドする場
合は、プラットフォーム.データフロー を選択します。
ヒント : 複数のセキュア エンティティ オーバーライドを選択するには、Ctrl キーを押しながらセ
キュア エンティティ オーバーライドをクリックします。 セキュア エンティティ オー
バーライドの範囲を選択するには、Shift キーを押しながらクリックします。
6. オーバーライドするセキュア エンティティを選択します。 [追加] をクリックし、[閉じる] をクリッ
クします。
選択したセキュア エンティティが表示されます。 セキュア エンティティ タイプの行に、選択した
役割またはユーザの権限が表示されます。 チェックが付いたグレーのボックスは、権限が有効で
あることを示し、チェックが付いていないグレーのボックスは、権限が無効であることを示しま
す。
7. 希望するセキュア エンティティ オーバーライドを指定します。 各権限は、次のいずれかの設定が
可能です。
権限をオーバーライドしません。 ユーザや役割にデフォルトで付与されている権限を
使用します。
この権限をユーザや役割で拒否して、セキュア エンティティ タイプで指定されるどの
権限よりも優先します。
管理ガイド
25
セキュア エンティティ オーバーライド
この権限をユーザや役割に付与して、セキュア エンティティ タイプで指定されるどの
権限よりも優先します。
セキュア エンティティ オーバーライドの例
以下に、RetentionDepartmentDesigner の役割セキュア エンティティ オーバーライ
ドを示します。
この例では、プラットフォーム.データフロー セキュア エンティティ タイプに表示
および変更権限が許可されていますが、削除権限は許可されていません。 したがっ
て、デフォルトでは、RetentionDepartmentDesigner の役割を持つどのユーザも、
すべてのデータフローに対して表示および変更権限を持ちます。 ただし、この役割
を持つユーザに対し、GeoConfidenceSurface データフローについてのみは変更を許
可しないように制限するとします。 この場合、GeoConfidenceSurface セキュア エ
ンティティの [変更] 列のチェックボックスをオフにします。 これで、この役割を持
つユーザは、このデータフローを変更できなくなりますが、他のデータフローは引
き続き変更可能です。
また、セキュア エンティティ タイプの権限が役割レベルで変更された場合でも、こ
の役割を持つユーザが常に GeocodeAddress データフローを変更できるように設定
するとします。 その場合は、GeocodeAddress の [変更] 列にチェック マークを付け
て、禁止を解除します。 これで、プラットフォーム.データフロー セキュア エンティ
ティ タイプから変更権限が削除されても、この役割を持つユーザは引き続き
GeocodeAddress データフローを変更できます。
関連リンク
セキュリティ モデル（16ページ）
Location Intelligence モジュールのセキュリティ（27ページ）
ユーザ（17ページ）
役割（19ページ）
セキュア エンティティ オーバーライドの表示
セキュア エンティティ オーバーライドは、特定のデータフロー、特定のデータベース接続など、特定
のセキュア エンティティに対する権限を指定します。 役割やユーザに対するセキュア エンティティ
オーバーライドを表示するには:
1. Management Console で、[セキュリティ] を展開し、[セキュア エンティティ オーバーライド] を
クリックします。
2. 以下のいずれかの方法を実行します。
• 役割に対するセキュア エンティティ オーバーライドを表示する場合は、[役割] をクリックしま
す。
26
Spectrum™ Technology Platform 9.0 SP3
第 2 章 : システムの保護
• ユーザに対するセキュア エンティティ オーバーライドを表示する場合は、[ユーザ] をクリック
します。
3. [参照] をクリックして、特定の役割やユーザを選択し、[OK] をクリックします。
選択した役割やユーザに対するオーバーライドを持つセキュア エンティティが表示されます。
セキュア エンティティ タイプの行 (プラットフォーム.データフロー など) に、選択した役割やユー
ザの権限が表示されます。 チェックが付いたグレーのボックスは、権限が有効であることを示し、
チェックが付いていないグレーのボックスは、権限が無効であることを示します。
セキュア エンティティの行 (特定のデータフロー GeocodeAddress など) に、そのエンティティの
権限が表示されます。各権限は以下のいずれかのように設定できます。
権限をオーバーライドしません。 ユーザや役割にデフォルトで付与されている権限を
使用します。
この権限をユーザや役割で拒否して、セキュア エンティティ タイプで指定されるどの
権限よりも優先します。
この権限をユーザや役割に付与して、セキュア エンティティ タイプで指定されるどの
権限よりも優先します。
Location Intelligence モジュールのセキュリティ
Location Intelligence モジュールは、Spectrum™ Technology Platform に対して使用されるものと同じ
役割ベースのセキュリティを使用します。セキュリティはプラットフォーム レベルで処理されるの
で、Location Intelligence モジュールのすべてのセキュリティ アクティビティの管理には Management
Console を使用できます。これには、ユーザ アカウントの管理 (ユーザ アカウントの作成、変更、削
除) に加えて、名前付きリソースの権限の設定が含まれます。
注 : 必要に応じて、User Management Service を使用して権限を設定することもまだできます。ただ
し、権限はリポジトリではなくプラットフォームに格納されます。User Management Service は
次のリリースで非推奨に設定されます。
定義済み spatial 役割
Location Intelligence モジュールをインストールした後は、Management Console で 2 つの定義済みの
役割 spatial-admin と spatial-user を使用できます。
spatial-admin 役割は、すべての名前付きリソース (名前付きマップ、名前付きタイル、名前付き接続、
名前付きテーブル) に対するすべての権限 (表示/変更/作成/削除) を提供します。一方、spatial-user 役
割は、これらのリソースに対する表示権限のみを提供します。これらの権限は、Location Intelligence
モジュールのセキュア エンティティ タイプ Location Intelligence.Named Resources を使用して制御
されます。Location Intelligence モジュール サービスのユーザには、最低限、使用するリソースとその
従属リソースに対する表示権限が必要です。
これらの定義済み spatial 役割を割り当てられたユーザは、空間サービスを使用しているときにのみ、
名前付きリソースにアクセスできます。Management Console では名前付きリソースにアクセスでき
ません。Spectrum の "admin" ユーザはフル アクセス権を持ち、Management Console を使用して、
名前付きリソースを含むシステムのすべての部分を管理できます。名前付きリソースだけにアクセス
できるユーザが Management Console も使用できるようにするには、定義済み spatial 役割の 1 つを
ベースとして使用して、リポジトリ内の名前付きリソースにアクセスできる "名前付きリソース管理
者" の役割を手動で作成した後、その役割を "名前付きリソース管理者" のユーザ アカウントに割り当
てる必要があります。この追加リソース管理者役割の作成方法については、名前付きリソース管理者
管理ガイド
27
Location Intelligence モジュールのセキュリティ
の作成（32ページ）を参照してください。名前付きリソースにアクセスする必要のあるデータフロー
設計者も、"designer" 役割では付与されない権限を必要とします。空間データフロー設計者の作成方
法については、空間データフロー設計者の作成（32ページ）を参照してください。
Location Intelligence.Named Resources セキュア エンティティ タイプでの役割および関連する権限
は、Management Console を使用してすべて見ることができます。
• 編集できない定義済みの役割は次のとおりです。
• Location Intelligence.Named Resources セキュア エンティティでの spatial-admin の権限は次のとお
りです。
• Location Intelligence.Named Resources セキュア エンティティでの spatial-user の権限は次のとお
りです。
注 : User Management Service での権限設定と Spectrum™ Technology Platform の対応は、読み込み
> 表示、変更 > 変更、追加 > 作成、削除 > 削除となります。
カスタム spatial 役割とセキュリティ オーバーライド
定義済み spatial 役割を基にしてカスタム役割を作成し、それをユーザ アカウントに割り当てた後、個
別の名前付きリソースに対するセキュア エンティティ オーバーライドを適用することによって、これ
らの役割およびユーザの名前付きリソースに対するアクセスを微調整できます。Location
Intelligence.Named Resources エンティティ タイプでは、スラッシュ (/) で終わるすべての表示リソー
スがリポジトリ内のフォルダまたはディレクトリです。
28
Spectrum™ Technology Platform 9.0 SP3
第 2 章 : システムの保護
フォルダ権限は、下位のリソースおよびフォルダに特定のオーバーライド設定がない限り、それらの
リソースおよびフォルダよって継承されます。これは、一連のリソースに権限を設定したい場合に便
利です。指定したユーザまたは役割のみがアクセスできるフォルダを作成できます。このフォルダお
よびその下位にあるすべての要素は他のユーザには表示されません。
ただし、このフォルダ レベルの権限は、下位の個別リソース レベルで設定された権限をオーバーライ
ドしません。例えば、特定の役割またはユーザの作成権限を持つフォルダがあり、そのフォルダ内の
1 つのリソースが同じ役割またはユーザの表示権限に設定されたセキュリティ オーバーライドを持つ
場合、その単一リソースの表示 (読み取り専用) 権限はフォルダの作成権限よりも優先されます。
関連リンク
セキュア エンティティ オーバーライドの作成（25ページ）
例: 役割レベルでの権限のオーバーライド
Location Intelligence モジュールのセキュリティ設定に関する一般的なシナリオおよびベスト プラク
ティスは、 権限を持たないカスタム役割を作成し、特定のオーバーライドをカスタム役割に適用し、
その役割をユーザに割り当てるという方法です。
この例では、権限を何も持たないカスタム役割 ("table-modifier") を作成し、この table-modifier の役割
にオーバーライドを適用して /Samples/NamedTables/ フォルダ内のリソースに対する変更および削
除の権限を許可したうえで、ユーザ アカウント ("user-tables") を作成してこのアカウントに table-modifier
および spatial-user の役割を割り当てます。
注 : Location Intelligence.Named Resources エンティティ タイプでは、スラッシュ (/) で終わるすべ
てのリソースがリポジトリ内のフォルダまたはディレクトリです。
1. カスタム役割を作成します。 あらかじめ定義されている役割が組織のニーズに合わない場合は、
独自の役割を作成できます。 この例の最初のステップでは、初期状態では権限を何も持たない
table-modifier というカスタム役割を作成します。 始める前に、セキュリティが有効であることを
確認してください (ユーザ セキュリティの無効化（34ページ）を参照)。
a) Management Console で、[セキュリティ] を参照し、[役割] をクリックします。
b) [追加] をクリックします。
[役割の追加] ダイアログが表示されます。
c) [名前] フィールドに、この役割の名前 (table-modifier) を入力します。
この役割には権限を設定しません。
d) [OK] をクリックします。
これで、このカスタム役割をオーバーライドに割り当てることができます。
2. オーバーライドを役割に適用します。 セキュア エンティティ オーバーライドは、システム内の特
定のセキュア エンティティ (リポジトリ内にある名前付きテーブルなど) に対する権限を付与しま
す。 この例のこのステップでは、/Samples/NamedTables/ フォルダ内のリソースの変更と削除を
許可する table-modifier 役割のオーバーライドを作成します。
a) Management Console で、[セキュリティ] を展開し、[セキュア エンティティ オーバーライド]
をクリックします。
b) [役割] をクリックし、[参照] をクリックします。
[役割の選択] ダイアログが表示されます。
c) table-modifier 役割を選択し、[OK] をクリックします。
d) [追加] をクリックします。
[項目の選択] ダイアログが表示されます。
e) [参照] をクリックします。
[セキュア エンティティ タイプの選択] ウィンドウが表示されます。
管理ガイド
29
Location Intelligence モジュールのセキュリティ
f) [Location Intelligence.Named Resources] セキュア エンティティ タイプを選択します。 [OK]
をクリックします。
名前付きリソースであるすべてのセキュア エンティティのリストが表示されます。
g) セキュア エンティティのリストで、すべての名前付きテーブル リソースを探して選択します
(このダイアログで連続する複数の項目を選択するには、Shift キーを使用します)。
h) [追加] をクリックし、[閉じる] をクリックします。
選択したセキュア エンティティ (NamedTables フォルダ) が表示されます。 セキュア エンティ
ティ タイプの行に、table-modifier 役割の有効な権限が表示されます。 チェックが付いたグレー
のボックスは、権限が有効であることを示し、チェックが付いていないグレーのボックスは、
権限が無効であることを示します。
i)
[表示]、[変更]、および [削除] 列のチェックボックスをオンにして、各セキュア エンティティ
(NamedTables フォルダ) のオーバーライドを指定します。
j)
[保存] をクリックするか、または [ファイル] > [保存] を選択します。
[セキュア エンティティ オーバーライド] ウィンドウのタイトルの隣にアスタリスクが表示され
なくなり、変更が保存されたことを示します。
table-modifier 役割は、/Samples/NamedTables/ フォルダ内の任意のフォルダまたはリソース
を表示、変更、および削除できるようになり、ユーザ アカウントに割り当てることができま
す。
3. ユーザを作成します。 この例の最後のステップでは、ユーザ アカウントを作成し、(名前付きリ
ソースに対する表示のみの権限を提供する) 定義済みの spatial-user 役割と、(名前付きテーブル、
つまり /Samples/NamedTables/ フォルダ内の任意のフォルダまたはリソースの変更と削除の追加
権限を付与する) カスタム table-modifier 役割を割り当てます。
a) Management Console で、[セキュリティ] を展開し、[ユーザ] をクリックします。
b) [追加] をクリックします。
[新しいユーザ] ウィンドウが表示されます。
c) このユーザ アカウントを使用可能にする場合は、[ユーザを有効にする] ボックスをチェックし
たままにします。
d) ユーザ名 (user-tables) を [ユーザ名] フィールドに入力します。
e) [パスワード] フィールドにユーザのパスワードを入力します。
f) [パスワードの確認] フィールドにユーザのパスワードを再入力します。
g) [電子メール アドレス] フィールドにユーザの電子メール アドレスを入力します。
h) [説明] フィールドにユーザの説明を入力します。
i)
spatial-user 役割と table-modifier 役割を選択します。
j)
[OK] をクリックします。
user-tables ユーザ アカウントは、すべての名前付きリソースに対する表示のみ権限
と、/Samples/NamedTables/ フォルダ内の任意のフォルダまたはリソースに対する変更および削除権
限に使用できるようになります。
例: ユーザ レベルでの権限のオーバーライド
Location Intelligence モジュールのセキュリティを設定する一般的なシナリオは、 1 人のユーザにオー
バーライド権限を設定するものです。
この例では、名前付きリソースに対する表示のみ権限を持つユーザ アカウント ("user-tiles") を作成し
たうえで、特定のフォルダ (/Samples/NamedTiles/) 内の名前付きリソースの変更および削除を許可
する user-tiles アカウントにオーバーライドを適用します。
注 : Location Intelligence.Named Resources エンティティ タイプでは、スラッシュ (/) で終わるすべ
てのリソースがリポジトリ内のフォルダまたはディレクトリです。
30
Spectrum™ Technology Platform 9.0 SP3
第 2 章 : システムの保護
1. 表示権限を持つユーザを作成します。 最初にユーザ アカウントを作成し、後でそのアカウントに
定義済みの spatial-user 役割を割り当てます。 この役割は、名前付きリソースに対して表示のみの
権限を提供します。
a) Management Console で、[セキュリティ] を展開し、[ユーザ] をクリックします。
b) [追加] をクリックします。
[新しいユーザ] ウィンドウが表示されます。
c) このユーザ アカウントを使用可能にする場合は、[ユーザを有効にする] ボックスをチェックし
たままにします。
d) ユーザ名 (user-tiles) を [ユーザ名] フィールドに入力します。
e) [パスワード] フィールドにユーザのパスワードを入力します。
f) [パスワードの確認] フィールドにユーザのパスワードを再入力します。
g) [電子メール アドレス] フィールドにユーザの電子メール アドレスを入力します。
h) [説明] フィールドにユーザの説明を入力します。
i)
spatial-user 役割を選択します。
j)
[OK] をクリックします。
user-tiles ユーザ アカウントは、すべての名前付きリソースに対する表示のみ権限で使用でき
るようになります。
2. オーバーライドをユーザに適用します。 セキュア エンティティ オーバーライドは、システム内の
特定のセキュア エンティティに対する権限を付与します。 この例の最後のステップでは、単一の
ユーザ (user-tiles) がすべてのタイプの名前付きリソースを表示できるだけでなく、特定のフォル
ダ内の名前付きリソースを変更および削除できるようにするオーバーライドを作成します。
a) Management Console で、[セキュリティ] を展開し、[セキュア エンティティ オーバーライド]
をクリックします。
b) [ユーザ] をクリックし、[参照] をクリックします。
[ユーザの選択] ダイアログが表示されます。
c) ユーザ (user-tiles) を選択し、[OK] をクリックします。
d) [追加] をクリックします。
[項目の選択] ダイアログが表示されます。
e) [参照] をクリックします。
[セキュア エンティティ タイプの選択] ウィンドウが表示されます。
f) [Location Intelligence.Named Resources] セキュア エンティティ タイプを選択します。 [OK]
をクリックします。
名前付きリソースであるすべてのセキュア エンティティのリストが表示されます。
g) セキュア エンティティのリストから、[/Samples/NamedTiles/] を探して選択します。
h) [追加] をクリックし、[閉じる] をクリックします。
選択したセキュア エンティティ (名前付きタイル フォルダ) が表示されます。 セキュア エン
ティティ タイプの行に、user-tiles ユーザの有効な権限が表示されます。 チェックが付いたグ
レーのボックスは、権限が有効であることを示し、チェックが付いていないグレーのボックス
は、権限が無効であることを示します。
i)
[変更] 列と [削除] 列のチェックボックスをオンにして、セキュア エンティティ (名前付きタイ
ル フォルダ) のオーバーライドを指定します。
j)
[保存] をクリックするか、または [ファイル] > [保存] を選択します。
[セキュア エンティティ オーバーライド] ウィンドウのタイトルの隣にアスタリスクが表示され
なくなり、変更が保存されたことを示します。
これで user-tiles ユーザは /Samples/NamedTiles/ フォルダ内の任意のフォルダまたはリソースを表
示、変更、および削除できますが、他のすべての名前付きリソースは表示しかできません。
管理ガイド
31
Location Intelligence モジュールのセキュリティ
名前付きリソース管理者の作成
Management Console を使用してリポジトリ内の名前付きリソースを表示または管理するには、定義
済みの spatial 役割によって提供されるアクセスに加えて、これらのリソースへの完全アクセスを許可
する役割がユーザに割り当てられている必要があります。 定義済み spatial 役割は変更できず、定義済
みの "名前付きリソース管理者" 役割は Spectrum™ Technology Platform では提供されません。ただ
し、定義済みの spatial 役割を基にしてこのような役割を作成できます。
1. Management Console で、[セキュリティ] を参照し、[役割] をクリックします。
2. [追加] をクリックします。
3. [名前] フィールドに、この役割の名前を入力します (例: "resource-admin")。
4. [コピー元] ボックスをオンにし、基にする役割として spatial-admin または spatial-user を選択し
ます。 spatial-admin 役割には、Location Intelligence モジュール.Named Resources セキュア
エンティティ タイプに対する表示、変更、作成、削除の各権限があります。spatial-user 役割には
表示権限があります。
5. 以下のセキュア エンティティ タイプに対して次のように追加の権限を設定します。
データベース リソース:
• Centrus データベース リソース: 表示/変更/生成/削除/実行 (必要な場合)
• Enterprise Routing: 表示/変更/生成/削除/実行 (必要な場合)
• 空間データベース リソース: (spatial-admin の場合) 表示/変更/生成/削除/実行、(spatial-user の場
合) 表示/実行
プラットフォーム:
• リソース - ファイル サーバー: 表示
• リソース - JDBC ドライバ: 表示
• サービス: 表示/変更/実行
• システム - バージョン情報: 表示
6. [OK] をクリックして、新しい resource-admin 役割を保存します。
7. [セキュリティ] で、[ユーザ] をクリックします。
8. 既存のユーザを選択して [変更] をクリックするか、または [追加] をクリックして新しいユーザを
作成します。
9. 新しい "resource-admin" 役割をユーザ アカウントに割り当てて、ユーザが Management Console
を使用して名前付きリソースを管理および表示できるようにします。
以上で、ユーザには Management Console で名前付きリソースを表示および管理するために必要なア
クセス権が付与されました。
空間データフロー設計者の作成
Location Intelligence モジュールのステージとサービスに対するデータフローを作成するには、ユーザ
に designer と spatial-user の両方の役割が割り当てられている必要があります。 spatial-user の役割
は、Location Intelligence.Named Resources セキュア エンティティ タイプの下にある名前付きリソー
スへの View アクセスを提供します。 designer の役割は、Platform セキュア エンティティ タイプ
(Dataflow など) への必要なアクセスを提供します。
1. Management Console で、[セキュリティ] を参照し、[ユーザ] をクリックします。
2. 既存のユーザを選択して [変更] をクリックするか、または [追加] をクリックして新しいユーザを
作成します。
3. designer と spatial-user の両方の役割をユーザ アカウントに割り当てます。
32
Spectrum™ Technology Platform 9.0 SP3
第 2 章 : システムの保護
これで、ユーザは名前付きリソースを表示したり、Location Intelligence モジュールのステージとサー
ビスのリソースを使用してデータフローを設計したりできる権限を持つことになります。
サービスおよびリポジトリのセキュリティをオフにする
Spectrum™ Technology Platform Location Intelligence モジュールが使用するすべてのサービスおよび
リソースへのアクセスは、デフォルトで認証がオンになるように設定されています。このため、特定
の機能によってリソースへのアクセスを制限したり、リポジトリ内のリソースを変更したりできます。
例えば、Named Resource Service の AddNamedResource 操作と、CSW サービスの Harvest 操作は、
どちらもリポジトリに対する書き込み権限が必要なので、どちらも認証を必要とします。
サービスレベル認証は、すべてのサービスおよびリポジトリに対してオフにすることができます。こ
れは、Location Intelligence モジュール サービスを使用しているソリューションに独自の高レベル認証
を組み込む場合に役立ちます。
サービスおよびリポジトリのセキュリティをオフにするには、JMX コンソールを使用します。
1. URL: http://localhost:8080/jmx-console/ (localhost とポート 8080 は正しい設定に置き換えます)
を使用して、JMX コンソールにアクセスします。
2. Domain: com.pb.spectrum.platform.config セクションで、
WebServiceSecurityConfigurationManager の管理リンクを選択します。
3. RestServiceSecurityType および SoapServiceSecurityType の値フィールドに OPEN と
入力し、それぞれ [set] をクリックします。
4. ‎サーバーを再起動します。
完了すると、サービスおよびリポジトリのセキュリティがオフになります。
関連リンク
プラットフォーム セキュリティの無効化と空間セキュリティの無効化（33ページ）
プラットフォーム セキュリティの無効化と空間セキュリティの無効化
Spectrum™ Technology Platform では、2 つの別々の操作として、役割ベースのセキュリティをプラッ
トフォーム レベルで無効にしたり、サービスレベルのセキュリティを無効にしたりできます。
(Management Console の [セキュリティ] > [オプション] ノードで [ユーザの権限に応じてアクセスを
制限する] の選択を解除して) 役割ベースのセキュリティをプラットフォーム レベルで無効にすると、
(役割およびセキュリティ エンティティのオーバーライドによって) ユーザに割り当てられた権限は適
用されなくなり、すべてのユーザがシステムのすべての部分にアクセスできるようになります。さら
に、Location Intelligence モジュールはリポジトリ内のすべての名前付きリソースにアクセスできるよ
うになります。
JMX コンソールで (RestServiceSecurityType およびSoapServiceSecurityType を OPEN に
設定して) サービスレベルのセキュリティをオフにすると、サービス リクエストの実行で admin ユー
ザが使用されることになります。Location Intelligence モジュールにとって、これはリポジトリに追加
されるすべての名前付きリソースが admin ユーザによって「所有」されることを意味します。そのた
め、User Management Service の getPermissions リクエストを実行すると、非 admin ユーザには「読
み取り」権限しかないことが示されます。
サービスレベルと役割ベースの両方のセキュリティを無効にすると、Location Intelligence モジュール
のサービスおよび名前付きリソースが完全に開放されます。また、User Management Service の
getPermissions リクエストを実行すると、今度は非 admin ユーザが「すべて」の権限を持つことが示
されます。
関連リンク
管理ガイド
33
ユーザ セキュリティの無効化
ユーザ セキュリティの無効化（34ページ）
サービスおよびリポジトリのセキュリティをオフにする（33ページ）
ユーザ セキュリティの無効化
ユーザ セキュリティは、デフォルトで有効になっています。 つまり、役割を通じてユーザに割り当て
られているセキュリティ制約が適用されます。 ユーザ セキュリティを無効にした場合、ユーザに割り
当てられているセキュリティ制約は適用されなくなり、すべてのユーザがシステムのすべての部分に
アクセスできるようになります。 ユーザ セキュリティを無効にした場合でも、サービスにアクセスす
るには有効なユーザ アカウントが必ず必要であることに注意してください。
この手順は、ユーザ セキュリティを無効化する方法を示しています。
警告 : この手順を実行した場合、すべてのユーザが Spectrum™ Technology Platform システムへの完
全アクセスを持つようになります。
1. Management Console を開きます。
2. [セキュリティ] を展開し、[オプション] をクリックします。
3. [ユーザの権限に応じてアクセスを制限する ] ボックスをオフにします。
関連リンク
セキュリティ モデル（16ページ）
プラットフォーム セキュリティの無効化と空間セキュリティの無効化（33ページ）
サーバー ディレクトリ アクセスの制限
Enterprise Designer および Management Console ユーザは、ソースまたはシンク ステージで入力また
は出力ファイルを選択する場合や、データベース リソースを定義する場合に、Spectrum™ Technology
Platform サーバーのフォルダとファイルを参照できます。 サーバーの機密部分を参照できないよう
に、ファイルの参照を制限することもできます。 すべての参照を禁止することも、ユーザが参照でき
るフォルダを指定することもできます。 指定したフォルダは、ユーザのファイル参照ウィンドウの最
上位フォルダとして表示されます。 例えば、サーバー上にある WestRegionCustomers という名前の
フォルダへのアクセスのみを許可している場合、ユーザがそのサーバーを参照すると、次のように、
そのフォルダのみが表示されます。
34
Spectrum™ Technology Platform 9.0 SP3
第 2 章 : システムの保護
サーバーのファイル システムへのアクセスを制限するには、次の手順に従います。
1. Management Console を開きます。
2. [リソース] の下で、[サーバー ディレクトリ アクセス] を選択します。
3. 以下のいずれかの方法を実行します。
• ユーザがサーバー全体を参照するのを防止するには、[制限付きサーバー ディレクトリ アクセス]
ボックスをチェックし、次の手順は実行しないでください。 ユーザは、サーバー上のファイル
またはフォルダに一切アクセスできません。
• サーバー上の一部のフォルダへのアクセスを許可するには、次の手順に進みます。
4. [追加] をクリックします。
5. [名前] フィールドに、アクセスを付与するフォルダの名前を指定します。
6. [パス] フィールドに、アクセスを付与するフォルダを指定します。
注 : ユーザは、指定されたフォルダ内に含まれるすべてのサブフォルダにアクセスできます。
7. [OK] をクリックします。
8. 他のフォルダへのアクセスを追加で指定する場合は、前の手順を必要に応じて繰り返します。
9. [制限付きサーバー ディレクトリ アクセス] ボックスをチェックして、制限を適用します。
これで、ユーザは指定されたフォルダにのみアクセスします。
注 : 以前はアクセスできたが、ファイル参照の制限によって現在はアクセスできないファイルがデー
タフローにある場合、そのデータフローは正しく実行されません。
管理ガイド
35
HTTPS 通信の設定
HTTPS 通信の設定
デフォルトでは、Spectrum™ Technology Platform とクライアント ツール (Enterprise Designer、
Management Console、および Interactive Driver) および API との通信は、HTTP を使用して行われま
す。 これらのネットワーク通信をセキュリティ保護する場合は、HTTPS を使用するように Spectrum™
Technology Platform を設定できます。
1. Spectrum™ Technology Platform サーバーを停止します。
• Windows 上のサーバーを停止するには、Windows システム トレイの Spectrum™ Technology
Platform アイコンを右クリックして、[サーバーの停止] を選択します。 または、 Windows の
[コントロール パネル] の [サービス] を使用して、Pitney Bowes Spectrum™ Technology Platform
サービスを停止できます。
• Unix または Linux 上のサーバーを停止するには、<SpectrumLocation>/server/bin/setup
スクリプトをソースとして、<SpectrumLocation>/server/bin/server.stop スクリプト
を実行します。
2. 信頼できる CA によって署名された証明書を作成して、JSSE キーストアに読み込みます。 詳細に
ついては、www.eclipse.org/jetty/documentation/current/configuring-ssl.html を参照してくだ
さい。
3. spectrum-override-container-ssl.xml という XML ファイルを作成し、次の内容を含めま
す。
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:util="http://www.springframework.org/schema/util"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
http://www.springframework.org/schema/util
http://www.springframework.org/schema/util/spring-util-3.0.xsd">
<bean id="defaultWebServerConnector"
class="org.eclipse.jetty.server.ServerConnector">
<constructor-arg ref="webServer"/>
<constructor-arg>
<bean class="org.eclipse.jetty.util.ssl.SslContextFactory">
<property name="keyStorePath" value="/SpectrumKeystore"/>
<property name="keyManagerPassword" value="password"/>
<property name="keyStorePassword" value="password"/>
</bean>
</constructor-arg>
<property name="host" value="${spectrum.bind.address}"/>
<property name="port" value="${spectrum.http.port}"/>
<property name="idleTimeout" value="-1"/>
</bean>
</beans>
4. 必要に応じて、使用している環境を反映するように以下の行を変更します。
<property name="keyStorePath"
value="/SpectrumKeystore"/>
value 属性の値を、使用するキーストアへのパ
スに変更します。 この例では、Spectrum™
Technology Platform サーバーがインストールさ
れているドライブのルートにキーストアがある
ものとします。
<property name="keyManagerpassword" value 属性の値をキーストアに対するパスワー
value="password"/>
ドに変更します。
36
Spectrum™ Technology Platform 9.0 SP3
第 2 章 : システムの保護
<property name="keyStorePassword"
value="password"/>
value 属性の値をキーストア内のキーに対する
パスワードに変更します。
5. spectrum-override-container-ssl.xml ファイルを
SpectrumLocation/server/app/conf/spring に保存します。
6. 適当なテキスト エディタでファイル spectrum-container.properties を開きます。ファイ
ルの場所は SpectrumLocation/server/app/conf です。 コメントを解除して、以下のプロパ
ティを設定します。
spectrum.http.port=port
spectrum.runtime.port=port
spectrum.runtime.hostname=dnsname
port はクライアントとの通信に使用するネットワーク ポート (例: 8443) で、dnsname は Spectrum™
Technology Platform サーバーのホスト名です。 指定するポートは、spectrum.http.port と
spectrum.runtime.port の両方に対して同じでなければなりません。
7. Location Intelligence モジュールと Spectrum Spatial サービスに対して HTTPS 通信を設定する場
合は、追加設定を実行してから Spectrum™ Technology Platform サーバーを再起動する必要があり
ます。
a) java.properties ファイル (SpectrumLocation/server/modules/spatial) を変更して、す
べてのホスト名とポートが Spectrum™ Technology Platform サーバーで使用されているものと
まったく同じになるようにします。 ホスト名はサーバーの DNS 名と証明書の CN に一致する
必要があります。 プロパティ repository.useSecureConnection を true に設定します。
例:
images.webapp.url=https://www.spectrum.com:8443/Spatial/images
thumbnail.location=https://www.spectrum.com:8443/Spatial/Thumbnails
repository.host=www.spectrum.com
repository.port=8443
repository.useSecureConnection=true
b) サービス設定ファイル (SpectrumLocation\server\modules\spatial\Configuration)
を変更して、すべてのリポジトリ URL で https と前のステップで定義したホスト名およびポー
トを使用するようにします (例:
https://www.spectrum.com:8443/RepositoryService/rmi)。 また、このサービスで
表示されている要素の値の URL も変更します。
MappingConfiguration – <AccessBaseURL>
WFSConfiguration, WMSConfiguration - <OnlineResource>, <ResourceRoot>
c) WebDAV を使用して、変更したファイルをリポジトリにアップロードします (手順については、
38 ページ を参照してください)。
8. Spectrum™ Technology Platform サーバーを開始します。
• Windows 上のサーバーを開始するには、Windows システム トレイの Spectrum™ Technology
Platform アイコンを右クリックして、[サーバーの開始] を選択します。 または、 Windows の
[コントロール パネル] の [サービス] を使用して、Pitney Bowes Spectrum™ Technology Platform
サービスを開始できます。
• Unix または Linux 上のサーバーを開始するには、
SpectrumLocation/server/bin/server.start スクリプトを実行します。
管理ガイド
37
HTTPS 通信の設定
WebFolders を使用してリポジトリ リソースにアクセスする
リソースを追加または変更するには、WebDAV ツールを使用してリソースをリポジトリへ、またはリ
ポジトリからコピーする必要があります。WebFolders を使用すると、リポジトリおよびリポジトリに
含まれるリソースに簡単にアクセスできます。
注 : WebFolders は Windows マシン専用です。リポジトリにアクセスするには、Spectrum™ Technology
Platform とリポジトリがインストールされているマシンと同じマシンにログインしている必要が
あります。
Windows 7 で WebFolder を設定するには
1. Windows エクスプローラを使用して選択します。 Map Network Drive...
2. ポップアップ ウィンドウで、[Connect to a website...] のリンクをクリックして、ネット
ワークの場所の追加ウィザードを開きます。
3. [Next] をクリックし、[Choose a custom network location] を選択します。[Next] をクリッ
クします。
4. [Internet or network address] フィールドに、リポジトリの URL を追加します(例:
http://localhost:8080/RepositoryService/repository/default/)。[Next] をクリッ
クします。
5. 入力を求められた場合は、資格情報 (ユーザ名とパスワード) を入力します。
6. この接続に名前を付けます (例: Spectrum Spatial Repository)。[Next] をクリックします。
完了すると、指定したネットワーク プレースの下にリポジトリのコンテンツへのフォルダ接続が作成
されます。
リポジトリへの WebFolder 接続は、他のすべての Windows エクスプローラと同じように使用できま
す。
38
Spectrum™ Technology Platform 9.0 SP3
データへの接続
このセクションの構成
• 接続の概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .40
• データベース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .40
• ファイル サーバー . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .44
• 外部の Web サービス . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .48
• Windows でマッピングされたドライブの利用 . . . . . . . . . .54
3
接続の概要
接続の概要
接続は、データフローの入力または出力として使用するデータ ソースを定義します。 4 種類のリソー
スがあります。
• データベース
• ファイル サーバー
• Web サービス
• クラウド接続
上記のいずれかのデータにアクセスするにはまず、Management Console を使用してリソースへの接
続を定義する必要があります。 例えば、リモート ファイル サーバー上にある XML ファイルのデータ
をデータフローに読み込む場合は、データフローに入力 XML ファイルを定義する前に、そのファイル
サーバーへの接続を定義する必要があります。 同様に、データフローの出力をデータベースに書き込
む場合は、最初に、データベースを外部リソースとして定義する必要があります。
注 : Spectrum™ Technology Platform サーバー上のデータに対する読み書き操作を行う場合は、接続
を定義する必要はありません。
データベース
データベース接続の追加または変更
データベース接続を使用すると、Spectrum™ Technology Platform でデータベースからの読み込みや、
データベースへの書き込みを行うことができます。 データベースからのデータの読み込みや、データ
ベースへのデータの書き込みを行うデータフローを作成するには、データベース接続を定義する必要
があります。
1. Management Console を開きます。
2. [リソース] を展開し、[接続] をクリックします。
3. [追加] または [変更] をクリックします。 [接続 プロパティ] ダイアログ ボックスが表示されます。
4. [接続名] フィールドに接続の名前を入力します。 任意の名前にすることができます。
5. 適切なデータベース タイプを [データベース ドライバ] フィールドで選択します。
Spectrum™ Technology Platform には SQL Server と Oracle の接続タイプが付属しています。 別
のデータベース タイプに接続する場合は、データベース接続を設定する前に、JDBC ドライバを
定義する必要があります。
6. [接続オプション] テーブルで、必要なフィールドの設定を行います。 ここでは、ホスト、ポート、
インスタンス、ユーザ名、およびパスワードなどを指定します。
7. [テスト] をクリックして、接続をテストします。
8. [OK] をクリックします。
データベース接続の削除
データベース接続を使用すると、Spectrum™ Technology Platform でデータベースからの読み込みや、
データベースへの書き込みを行うことができます。 定義済みのデータベース接続が不要になった場合
は、削除できます。
40
Spectrum™ Technology Platform 9.0 SP3
第 3 章 : データへの接続
重要 : データベース接続を削除する前に、そのデータベース接続を使用するデータフローがないこと
を確認してください。
1. Management Console を開きます。
2. [リソース] を展開し、[接続] をクリックします。
3. 更新する接続をハイライト表示にして、[削除] をクリックします。 接続を削除するかどうかを尋
ねる確認メッセージが表示されます。
4. [OK] をクリックして確認します。
NoSQL データベース接続の追加または変更
NoSQL データベース接続を使用すると、Spectrum™ Technology Platform で NoSQL データベースに
対するデータの読み書きが可能になります。 データベースからのデータの読み込みや、データベース
へのデータの書き込みを行うデータフローを作成するには、データベース接続を定義する必要があり
ます。
1. Enterprise Designer で、[ツール] > [NoSQL データベース接続] に移動します。
2. [NoSQL DB 接続管理] ウィンドウで、[追加] または [変更] をクリックします。 [接続プロパティ]
ウィンドウが表示されます。
3. [接続名] フィールドに、接続名を指定します。 任意の名前にすることができます。
4. [NoSQL データベース フィールド] からデータベース タイプを選択します。
現在サポートされているデータベース タイプは、Mongo DB と Couchbase DB です。
5. [ユーザ名]、 [パスワード]、 [ホスト名]、 [ポート]、および [データベース名]を指定します。
注 : ユーザ名はオプションで、任意の名前を指定できます。
6. [テスト] をクリックして、データベースに正しく接続されていることを確認します。
7. [OK] をクリックします。
NoSQL データベース接続の削除
NoSQL データベース接続を使用すると、Spectrum™ Technology Platform で NoSQL データベースに
対するデータの読み書きが可能になります。 定義済みのデータベース接続が不要になった場合は、削
除できます。
重要 : データベース接続を削除する前に、そのデータベース接続を使用するデータフローがないこと
を確認してください。
1. Enterprise Designer で [ツール] > [NoSQL DB 接続管理] に移動します。
2. 更新する接続をハイライト表示にして、[削除] をクリックします。 接続を削除するかどうかを尋
ねる確認メッセージが表示されます。
3. [OK] をクリックして確認します。
JDBC ドライバ
JDBC ドライバの追加または変更
Spectrum™ Technology Platform では、JDBC ドライバを使用して、任意のデータベースに対してデー
タの読み書き操作を実行できます。 JDBC ドライバを使用してデータにアクセスするには、最初に
管理ガイド
41
データベース
JDBC ドライバを定義し、その JDBC ドライバを使用するデータベース接続を作成する必要がありま
す。 以下の手順では、JDBC ドライバを作成または変更する方法について説明します。
注 : JDBC ドライバの設定は非常に特殊であり、正しく機能させるには正確に設定する必要がありま
す。 JDBC ドライバを追加する前に、データベース/データベース ドライバのプロバイダから正
しい情報を得ていることを確認してください。
1. Management Console を開きます。
2. [リソース] を展開し、[JDBC ドライバ] をクリックします。
3. [追加] をクリックし、新しい JDBC ドライバ接続を作成します。 既存のドライバを変更する場合
は、変更するドライバを選択し、[変更] をクリックします。
注 : Spectrum™ Technology Platform には、Internal (システムが使用)、SQL Server、および Oracle
の 3 つの定義済み JDBC ドライバが付属しています。 これらのドライバは変更または削除で
きません。
4. [JDBC ドライバ構成名] フィールドにドライバの名前を入力します。 任意の名前にすることがで
きます。
5. [JDBC ドライバ クラス名] フィールドにドライバの Java クラス名を入力します。 通常は、JDBC
ドライバのドキュメントにクラス名が記載されています。
例えば、SQL データベースへの SSL 接続で Microsoft JDBC ドライバを使用するには、次のよう
に入力します。
com.microsoft.sqlserver.jdbc.SQLServerDriver
6. [接続文字列テンプレート] フィールドに接続文字列として使用するテンプレートを入力します。
例えば、SQL データベースへの SSL 接続を有効にするには、次のように入力します。
jdbc:sqlserver://${host}:${port};databaseName=${instance};encrypt=true;TrustServerCertificate=true
7. [ドライバ ファイル] セクションで、[追加] をクリックします。
8. 適切なドライバまで移動して選択し、[保存] をクリックします。
9. [接続プロパティ] セクションで、[追加] をクリックします。 [JDBC 接続プロパティ] ダイアログ
ボックスが表示されます。
10. [ラベル] フィールドにプロパティのラベルを入力します。 ラベルには任意の名前を入力できます。
例えば、username と入力します。
11. [プロパティ トークン] フィールドに URL で使用するトークンを入力します。 例えば、user と入
力します。
注 : 作成するすべての JDBC 接続に対し、プロパティ トークン user および password を入力
する必要があります。
12. [OK] をクリックします。
JDBC ドライバの削除
JDBC ドライバを使用すると、Spectrum™ Technology Platform をデータベースに接続できます。 不
要になった JDBC ドライバは削除できます。
重要 : JDBC ドライバを削除する前に、そのドライバを使用するデータベース接続がないことを確認
してください。
1. Management Console を開きます。
2. [リソース] を展開し、[JDBC ドライバ] をクリックします。
3. 既存の JDBC ドライバを選択して、[削除] をクリックします。 [削除の確認] ダイアログボックス
が表示されます。
42
Spectrum™ Technology Platform 9.0 SP3
第 3 章 : データへの接続
注 : いずれかの接続でこのドライバを使用している場合は、どの接続が使用しているかが表示さ
れ、そのドライバを削除することはできません。
サポートされるデータベースのデータ タイプ
Spectrum™ Technology Platform は、データベースで一般的に使用される次のデータ タイプをサポー
トしています。
Bigdecimal
小数点以下 38 桁の精度をサポートする数値データ タイプ。 高い精度が必要な算術
計算で使用されるデータ (特に金融データ) には、このデータ タイプを使用してく
ださい。 bigdecimal データ タイプは、double データ タイプより正確な計算をサ
ポートします。
Boolean
true と false の 2 つの値を持つ論理タイプ。
Date
月、日、年を含むデータ タイプ。 例: 2012-01-30、January 30, 2012。 デフォルト
の日付の形式は Management Console で指定できます。
Datetime
月、日、年、時、分、秒を含むデータ タイプ。 例: 2012/01/30 6:15 PM。
Double
正と負の倍精度数を含む数値データ タイプ。値の範囲は、2
-1074
-52
～ (2-2
1023
。
)×2
指数表記すると、値の範囲は、-1.79769313486232E+308 ～
1.79769313486232E+308 となります。
Float
-149
正と負の単精度数を含む数値データ タイプ。値の範囲は、2
23
127
～ (2-2 )×2
。
指数表記すると、値の範囲は、-3.402823E+38 ～ 3.402823E+38 となります。
Integer
31
正と負の整数を含む数値データ タイプ。値の範囲は、-2
31
(-2,147,483,648) ～ 2 -1
(2,147,483,647)。
Long
63
正と負の整数を含む数値データ タイプ。値の範囲は、-2
63
(-9,223,372,036,854,775,808) ～ 2 -1 (9,223,372,036,854,775,807)。
文字列
文字シーケンス。
Time
時刻を含むデータ タイプ。 例: 21:15:59 or 9:15:59 PM。
Raw
可変長のバイナリ データを格納するための Oracle データタイプ。最大サイズは
2000 バイト (Oracle 7 では最大長は 255 バイトでした)
他のデータベースのデータ タイプは、次のように、サポートされるデータ タイプのいずれかに自動的
に対応付けられます。
表 1 : データベースのデータ タイプとサポートされるデータ タイプの対応
データベースのデータ タイプ
サポートされるデータ タイプ
日付/時間タイプ
TIMESTAMP
datetime
文字列タイプ
CHAR
string
CLOB
string
LONGVARCHAR
string
NCHAR
string
管理ガイド
43
ファイル サーバー
データベースのデータ タイプ
サポートされるデータ タイプ
NVARCHAR
string
VARCHAR
string
数値タイプ
BIGINT
long
DECIMAL
double
FLOAT
double
NUMERIC
bigdecimal
REAL
float
SMALLINT
integer
TINYINT
integer
Boolean タイプ
BIT
boolean
ファイル サーバー
FTP ファイル サーバーへの接続
FTP サーバー上のファイルに対してデータの読み書きを行う必要がある場合は、Management Console
を使用してファイル サーバーへの接続を定義する必要があります。 接続を定義した後は、ファイル
サーバー上のファイルに対してデータの読み書きを行うデータフローを Enterprise Designer で作成で
きます。
1. Management Console を開きます。
2. [リソース] を展開し、[ファイル サーバー] をクリックします。
3. [追加] をクリックします。
4. [接続名] フィールドに、新しい接続の名前を入力します。 任意の名前にすることができます。
5. [ホスト] フィールドに、FTP サーバーの名前または IP アドレスを入力します。
6. [ポート] フィールドに、ネットワーク ポート番号を入力します。
7. [タイプ] フィールドで、FTP を選択します。
8. [ユーザ名] フィールドに、FTP サーバーの認証で使用するユーザ名を入力します。 これは、FTP
サーバーがユーザ名を要求する場合にのみ必要です。
9. [パスワード] フィールドに、FTP サーバーの認証で使用するパスワードを入力します。 これは、
FTP サーバーがユーザ名を要求する場合にのみ必要です。
10. [OK] をクリックします。
11. サーバーをテストするには、テストする接続をハイライト表示し、[ファイル サーバー] ダイアロ
グ ボックスの [テスト] ボタンをクリックします。
ファイル サーバーへの接続を定義した後は、Enterprise Designer のソース ステージとシンク ステー
ジ (Read from File、Write to File など) でその接続を使用できるようになります。 ソースまたはシンク
ステージでファイルを定義するときに [リモート マシン] をクリックすると、FTP サーバーを選択でき
ます。
44
Spectrum™ Technology Platform 9.0 SP3
第 3 章 : データへの接続
Hadoop 分散ファイル システムへの接続
Hadoop 分散ファイル システム (HDFS) は、オープン ソースの分散ファイル システムです。 HDFS
は、大規模なデータ セットに対するアクセスのパフォーマンスが高く、安価なハードウェア上で実行
できます。 HDFS システムがある場合は、Management Console を使用して HDFS クラスタへの接続
を定義すると、HDFS クラスタ上のファイルに対してデータの読み書きを行うように Spectrum™
Technology Platform を設定できます。 この設定を行った後は、HDFS 上のファイルにアクセスする
データフローを Enterprise Designer で作成できます。
注 : HDFS の詳細については、Apache Hadoop プロジェクト Web サイト hadoop.apache.org にあ
るドキュメントを参照してください。
1. Management Console を開きます。
2. [リソース] を展開し、[ファイル サーバー] をクリックします。
3. [追加] をクリックします。
4. [接続名] フィールドに、新しい接続の名前を入力します。 任意の名前にすることができます。
5. [ホスト] フィールドに、HDFS クラスタ内の NameNode の名前または IP アドレスを入力します。
6. [ポート] フィールドに、ネットワーク ポート番号を入力します。
7. [タイプ] フィールドで、HDFS を選択します。
8. [ユーザ] の下で、次のいずれかを選択します。
サーバー ユーザ
HDFS クラスタで認証が有効になっている場合は、このオプションを選択
します。 このオプションでは、Spectrum™ Technology Platform サーバー
を実行するユーザ資格情報を使用して HDFS を認証します。
ユーザ名
HDFS クラスタで認証が無効になっている場合は、このオプションを選択
します。
9. [プロトコル] フィールドで、次のいずれかを選択します。
WEBHDFS HDFS クラスタで HDFS 1.0 以降を実行している場合は、このオプションを選択しま
す。 このプロトコルは、読み込みと書き込みの両方の操作をサポートしています。
HFTP
HDFS クラスタで HDFS 1.0 よりも古いバージョンを実行している場合、または組織
で WEBHDFS プロトコルが許可されていない場合は、このオプションを選択します。
このプロトコルは、読み込み操作のみをサポートしています。
HAR
Hadoop アーカイブ ファイルにアクセスする場合は、このオプションを選択します。
このオプションを選択する場合は、アーカイブ ファイルへのパスを [パス] フィール
ドに指定します。 このプロトコルは、読み込み操作のみをサポートしています。
10. [詳細オプション] を展開します。
11. WEBHDFS プロトコルを選択した場合は、次の詳細オプションを指定できます。
複製係数
各ブロックを複製するデータ ノードの数を指定します。 例えば、デフォルト設定
の 3 は、各ブロックをクラスタ内の異なる 3 つのノードに複製します。 最大複製
係数は 1024 です。
ブロック サ 各ブロックのサイズを指定します。 HDFS は、ここで指定するサイズのブロック
イズ
にファイルを分割します。 例えば、デフォルトの 64 MB を指定した場合、各ファ
イルは 64 MB ブロックに分割されます。 その後、各ブロックは、[複製係数] フィー
ルドに指定された、クラスタ内のノード数に複製されます。
ファイル権
限
Spectrum™ Technology Platform によって HDFS クラスタに書き込まれるファイル
に対するアクセス レベルを指定します。 ユーザとグループのそれぞれに対して、
読み込みおよび書き込み権限を指定できます。
注 : 実行権限は Spectrum™ Technology Platform に適用できません。
管理ガイド
45
ファイル サーバー
ユーザ
これは前の手順で指定した、[サーバー ユーザ] のユーザか、[ユー
ザ名] フィールドに指定したユーザのいずれかです。
グループ
これは、ユーザがメンバーとして所属する任意のグループを指しま
す。 例えば、ユーザが john123 の場合、グループ権限は john123
がメンバーとして所属するグループにすべて適用されます。
その他
これは、他のすべてのユーザと、指定されたユーザがメンバーとし
て所属しないグループを指します。
12. Read from Sequence File ステージのソートおよびフィルタ機能が適切に動作するように、Hadoop
の [サーバー プロパティ] を指定します。
Hadoop1.x
fs.default.name
Hadoop が実行するノードとポートを指定します。
例えば、hdfs://152.144.226.224:9000 とします。
mapred.job.tracker
MapReduce ジョブ トラッカーが実行するホスト名または IP アドレスと、ポートを
指定します。 ホスト名をローカルとして入力した場合は、ジョブは単一のマップと
して実行され、タスクが少なくなります。
例えば、152.144.226.224:9001 とします。
dfs.namenode.name.dir
DFS 名前ノードが名前テーブルを格納する、ローカル ファイルシステム上の場所を
指定します。 ディレクトリのカンマ区切りリストである場合、名前テーブルは冗長
性のためにすべてのディレクトリに複製されます。
例えば、file:/home/hduser/Data/namenode とします。
dfs.datanode.data.dir
DFS データ ノードがブロックを格納する、ローカル ファイルシステム上の場所を指
定します。 ディレクトリのカンマ区切りリストである場合、データは、通常は異な
るデバイス上にあるすべての名前付きディレクトリに格納されます。 存在しないディ
レクトリは無視されます。
例えば、file:/home/hduser/Data/datanode とします。
hadoop.tmp.dir
他の一時ディレクトリのベース ディレクトリを指定します。
例えば、/home/hduser/Data/tmp とします。
Hadoop2.x
fs.default.name
Hadoop が実行するノードとポートを指定します。
例えば、hdfs://152.144.226.224:9000 とします。
yarn.resourcemanager.resource-tracker.address
Resource Manager のホスト名または IP アドレスを指定します。
例えば、152.144.226.224:8025 とします。
yarn.resourcemanager.scheduler.address
Scheduler Interface のアドレスを指定します。
例えば、152.144.226.224:8030 とします。
yarn.resourcemanager.address
Resource Manager に含まれる Applications Manager インターフェイスのアドレス
を指定します。
46
Spectrum™ Technology Platform 9.0 SP3
第 3 章 : データへの接続
例えば、152.144.226.224:8041 とします。
mapreduce.jobhistory.address
MapReduce Job History Server が実行するホスト名または IP アドレスと、ポートを
指定します。
例えば、152.144.226.224:10020 とします。
mapreduce.application.classpath
Map Reduce アプリケーション用の CLASSPATH を指定します。 エントリをカンマ
で区切って指定する必要があります。 この CLASSPATH は、Map Reduce アプリ
ケーションに関連するクラスが存在する場所を表します。
例を次に示します。
$HADOOP_CONF_DIR,
$HADOOP_COMMON_HOME/share/hadoop/common/*,
$HADOOP_COMMON_HOME/share/hadoop/common/lib/*,
$HADOOP_HDFS_HOME/share/hadoop/hdfs/*,
$HADOOP_HDFS_HOME/share/hadoop/hdfs/lib/*,
$HADOOP_MAPRED_HOME/share/hadoop/mapreduce/*,
$HADOOP_MAPRED_HOME/share/hadoop/mapreduce/lib/*,
$HADOOP_YARN_HOME/share/hadoop/yarn/*,
$HADOOP_YARN_HOME/share/hadoop/yarn/lib/*
13. [OK] をクリックします。
14. サーバーをテストするには、テストする接続をハイライト表示し、[ファイル サーバー] ダイアロ
グ ボックスの [テスト] ボタンをクリックします。
HDFS クラスタへの接続を定義した後は、Enterprise Designer のソース ステージとシンク ステージ
(Read from File、Write to File など) でその接続を使用できるようになります。 ソースまたはシンク ス
テージでファイルを定義するときに [リモート マシン] をクリックすると、HDFS クラスタを選択でき
ます。
Amazon クラウドへの接続
このトピックでは、Amazon クラウド サービスへの接続を定義する方法を説明します。
1. Management Console を開きます。
2. [リソース] を展開し、[ファイル サーバー] をクリックします。
3. [追加] をクリックします。
4. [名前] フィールドに、この接続に付ける名前を入力します。 どのような名前を付けてもかまいま
せんが、システム上の他のクラウド接続で既に使用されている名前と重複してはなりません。
5. [タイプ] フィールドで、CLOUD を選択します。
6. [クラウド サービス]の下で、[AmazonS3] をクラウド プロバイダとして選択します。
7. お使いの Amazon S3 クラウド サービスで定義されているバケット名を入力します。 このバケッ
トに、読み書きされるファイルが保存されます。
8. お使いの Amazon S3 クラウド サービスで定義されているアクセス キーと秘密鍵を入力します。
9. ストレージ タイプを選択します。 これによって、データ ストレージに対して適用する冗長性レベ
ルが決まります。
標準
低冗長性
管理ガイド
Amazon S3 で一般的に提供される標準レベルの冗長性を適用します。
重要性が低く、簡単に再作成可能なデータを、低いレベルの冗長性で保存する場
合にこのオプションを使用します。 このオプションを使用すると、適度に信頼で
きるストレージが低いコストで利用できます。
47
外部の Web サービス
10. 必要に応じて、アクセス権限も設定できます。 [権限] セクションで、 [追加]をクリックします。
被付与者は次の 3 種類です。
• Authenticated Users: Amazon にログインしたユーザ。
• Log Delivery: Amazon S3 は Bucket Logging が有効である場合、ユーザが指定したバケットにす
べてのアクティビティ ログを書き込みます。 ログを保持するバケットに対する書き込み権限を、
Log Delivery グループに与える必要があります。
• Everyone: Authenticated Users と Log Delivery グループ以外のすべてのユーザ。
それぞれの被付与者に対し、必要な権限を次の中から選択します。
• Open/Download: ファイルのダウンロードが可能です。
• View Persmissions: ファイルに対する現在の権限を表示できます。
• Edit Permissions: ファイルに対する権限を変更および設定できます。
11. [OK] をクリックします。
12. サーバーをテストするには、テストする接続をハイライト表示し、[ファイル サーバー] ダイアロ
グ ボックスの [テスト] ボタンをクリックします。
ファイル サーバーへの接続を定義した後は、Enterprise Designer のソース ステージとシンク ステー
ジ (Read from File、Write to File など) でその接続を使用できるようになります。 ソースまたはシンク
ステージでファイルを定義するときに [リモート マシン] をクリックすると、クラウド サーバーを選
択できます。
ファイル サーバーの削除
ファイル サーバー接続は、データフローによる FTP または HDFS ファイル サーバー上のファイルに
対するデータの読み書きを可能にします。 どのデータフローにも使用されていないファイル サーバー
接続は、削除できます。
重要 : ファイル サーバーを削除すると、そのファイル サーバーを参照しているデータフローが正し
く機能しなくなります。
1. Management Console を開きます。
2. [リソース] を展開し、[ファイル サーバー] をクリックします。
3. 削除するファイル サーバーをハイライト表示にして、[削除] をクリックします。 サーバーを削除
するかどうかを尋ねる確認メッセージが表示されます。
4. [OK] をクリックして確認します。
外部の Web サービス
外部の Web サービスとは、サードパーティがインターネット上で提供しているデータ処理サービスの
ことです。 外部の Web サービスを Management Console で定義し、それをデータフローのステージ
として使用することも、Spectrum™ Technology Platform サーバー上にエクスポーズされるサービス
として使用することもできます。 したがって、インターネット上には多種多様な Web サービスが公
開されているので、ほとんどすべての種類の処理を Spectrum™ Technology Platform 環境に組み込む
ことができます。
外部の Web サービスは Enterprise Designer のパレットに表示され、他のステージを実行しながら、
それらのサービスを操作できます。 以下に外部の Web サービスの例として、
CompanyReviewsWebService と TimeZoneLookupWebService の 2 つを示します。
48
Spectrum™ Technology Platform 9.0 SP3
第 3 章 : データへの接続
Spectrum™ Technology Platform では、REST、SOAP 1.1、または SOAP 1.2 メッセージングを使用
する外部の Web サービスをサポートします。
外部 SOAP Web サービスの追加
外部の Web サービスとは、サードパーティがインターネット上で提供しているデータ処理サービスの
ことです。 外部 Web サービスをデータフローのステージとして、または Spectrum™ Technology
Platform サーバー上でエクスポーズされるサービスとして使用できます。 これを行うには、外部の
サードパーティ Web サービスへの接続を定義する必要があります。 以下に、外部の SOAP Web サー
ビスへの接続を定義する手順を示します。
1. Management Console を開きます。
2. [リソース] ノードを展開し、[外部の Web サービス] をクリックします。
3. [追加] をクリックします。
4. [名前] フィールドに、外部の Web サービスに付ける名前を入力します。 この名前は、Enterprise
Designer にステージ名として表示されるほか、Spectrum™ Technology Platform サーバーのサービ
ス名としても使用されます。 どのような名前を付けてもかまいませんが、システム上の他の Web
サービスで使用されている名前と重複してはなりません。
5. [外部サービス タイプ] の下で、[SOAP] を選択します。
6. [タイムアウト] フィールドに、Web サービスに送信したリクエストがタイムアウトするまでの経
過時間を秒数で入力します。
注 : ここで指定したタイムアウト値は、Web サービスに対するすべてのリクエストに適用されま
す。 これには、エクスポーズされた Web サービスに対するトランザクションだけでなく、
Web サービスの設定の過程で送信されるリクエストも含まれます。 このような設定のリクエ
ストは、[更新] をクリックしたとき、[操作] リストで新しい項目を選択したとき、およびプ
レビューを実行したときに送信されます。 タイムアウトは、これらのどのアクションを実行
する場合にも生じる可能性があります。 タイムアウトが生じる場合、Web サービスが実際に
稼働中であるならば、[タイムアウト] の値を大きくすることによってそれを回避できる可能
性があります。
管理ガイド
49
外部の Web サービス
7. Web サービスをデータフローで使用できるようにし、Spectrum™ Technology Platform サービス
としてアクセスできるようにするには:
a) [サービスとしてエクスポーズ] ボックスをオンにします。
b) Web サービスを SOAP Web サービスとしてエクスポーズする場合は、[SOAP] ボックスをオ
ンにします。 Web サービスが http://<サーバー名>:<ポート>/soap の一覧に表示されます。
c) Web サービスを REST Web サービスとしてエクスポーズする場合は、[REST] ボックスをオン
にします。 Web サービスが http://<サーバー名>:<ポート>/rest の一覧に表示されます。
8. [URL] フィールドで、Web サービスの WSDL の URL を入力します。
9. 外部 Web サービスへのアクセスに必要ならば、ユーザ名とパスワードを入力します。
10. [更新] をクリックして、[操作] リストに Web サービスで提供されている操作の一覧を表示します。
注 : 一部の Web サービスでは、アクセスする前にユーザ名とパスワードの入力が必要です。 そ
の場合は、[更新] をクリックする前に必要な認証情報を入力する必要があります。 そうしな
ければ、更新オペレーションは失敗してしまいます。
11. [操作] リストで、実行する Web サービスの操作を選択します。
[操作] リストで Web サービスの操作を選択すると、操作要求および応答のフィールド名の一覧が、
[要求] および [応答] タブに表示されます。
12. [WS-Security の使用] ボックスをオンにして、SOAP メッセージのヘッダーを通じて認証情報を
送信することにより、Web サービスをセキュアにします。
13. Web サービスが要求ヘッダーをサポートしている場合は、以下のように [要求ヘッダー] タブを設
定します。 そうでない場合は、手順14（50ページ）に進みます。
a) ボックスをオンまたはオフにして、要求に含めるヘッダー パラメータを選択します。 チェック
ボックスがオンで、グレー表示されている場合は、そのパラメータは必須で、無効にできない
ことを意味します。
b) [値] 列で、各パラメータで使用する値を指定します。
14. [要求] タブ (または、Web サービスが要求ヘッダーをサポートしている場合は [要求の本文] タブ)
で、要求フィールドで使用する設定と値を指定します。
a) 使用可能な要求フィールドのサブセットを使用するには、[フィルタ] フィールドで XPath パス
を選択します。
すると、選択したパスにマッチするすべての XPath パスとその子孫パスが、テーブルに表示さ
れ、それらがリクエストに含まれることになります。
b) [フィールド名] 列に、各要求フィールドを参照するフィールド名を入力します。 フィールドが
エクスポーズされる場合、この名前は最終的な Spectrum™ Technology Platform サービスの入
力フィールド名になります。
テーブル内の各 XPath パスに、対応する要求フィールドが関連付けられます。 要求フィールド
には、外部の Web サービスによって初期のデフォルト名が付いています 各要求フィールドに
対し、デフォルト名のままにするか、または新しい名前を付けることができます。
c) [デフォルト値] 列で、必要に応じて、各要求フィールドのデフォルト名を指定します。
d) 最終的な Spectrum™ Technology Platform サービスで使用可能な入力フィールドとしてエクス
ポーズする各要求フィールドの [エクスポーズ] オプションを選択します。 すべての要求フィー
ルドをエクスポーズする場合は、テーブルのヘッダー行の [エクスポーズ] オプションを選択し
ます。
e) 外部の Web サービスへの要求として送信される XML のテンプレートを表示するには、[テンプ
レートの表示] をクリックします。
15. [応答] タブで、応答フィールドで使用する設定と値を指定します。
a) 外部の Web サービスの応答を、SoapResponse という名前の単一のフィールドとして返す場
合は、[応答 XML をテキストとして返す] オプションを選択します。 XML 応答のテンプレート
が表示されます。 手順16（51ページ）に進みます。
50
Spectrum™ Technology Platform 9.0 SP3
第 3 章 : データへの接続
[応答 XML をテキストとして返す] オプションを選択しなかった場合、Web サービスの応答は、
フィールド名から XPath パスへの指定されたマッピングに基づく個別のフィールドとして返さ
れます。 以下の残りの手順を続けます。
b) 表示されるフィールドの一覧を絞り込む場合は、[フィルタ] フィールドで XPath を選択しま
す。
すると、選択したパスにマッチするすべての XPath パスとその子孫パスが、テーブルに表示さ
れ、それらが応答に含まれることになります。
c) [フィールド名] 列で、必要に応じて、デフォルトのフィールド名を変更します。
テーブル内の各 XPath パスは、外部の Web サービスが提供する初期デフォルト名が付けられ
た、対応する応答フィールドに関連付けられています。 各レスポンス フィールドに対し、デ
フォルト名のままにするか、または新しい名前を付けることができます。
d) 最終的な Spectrum™ Technology Platform サービスで使用可能な出力フィールドとしてエクス
ポーズする各応答フィールドの [エクスポーズ] オプションを選択します。 すべての応答フィー
ルドをエクスポーズする場合は、テーブルのヘッダー行の [エクスポーズ] オプションを選択し
ます。
[エクスポーズ] オプションが選択されているフィールドが、外部の Web サービスからの応答と
して返されることになります。 各フィールドは、外部 Web サービスが提供する XPath パスに
マッピングされています。 [エクスポーズ] オプションが選択されているフィールドが、すべて
同一レベルの XPath パスにマッピングされている場合、フィールドに対して個別のレコードが
返されます。 しかし、エクスポーズされたフィールドが異なるレベルの XPath パスにマッピン
グされている場合は、階層データ オブジェクトが返されます。
e) 外部の Web サービスからの応答として送信される XML のテンプレートを表示するには、[テン
プレートの表示] をクリックします。
16. [プレビュー] タブで、外部の Web サービスに送信する任意のテスト データを入力し、[プレビュー]
をクリックして Web サービスの応答を表示します。
17. [OK] をクリックして、外部の Web サービスを保存します。
関連リンク
外部の Web サービス（48ページ）
外部 REST Web サービスの追加
外部の Web サービスとは、サードパーティがインターネット上で提供しているデータ処理サービスの
ことです。 外部 Web サービスをデータフローのステージとして、または Spectrum™ Technology
Platform サーバー上でエクスポーズされるサービスとして使用できます。 これを行うには、外部の
サードパーティ Web サービスへの接続を定義する必要があります。 以下に、外部の REST Web サー
ビスへの接続を定義する手順を示します。
1. Management Console を開きます。
2. [リソース] ノードを展開し、[外部の Web サービス] をクリックします。
3. [追加] をクリックします。
4. [名前] フィールドに、外部の Web サービスに付ける名前を入力します。 この名前は、Enterprise
Designer にステージ名として表示されるほか、Spectrum™ Technology Platform サーバーのサービ
ス名としても使用されます。 どのような名前を付けてもかまいませんが、システム上の他の Web
サービスで使用されている名前と重複してはなりません。
5. [外部サービス タイプ] の下で、[REST] を選択します。
6. [タイムアウト] フィールドに、Web サービスに送信したリクエストがタイムアウトするまでの経
過時間を秒数で入力します。
注 : ここで指定したタイムアウト値は、Web サービスに対するすべてのリクエストに適用されま
す。 これには、エクスポーズされた Web サービスに対するトランザクションだけでなく、
Web サービスの設定の過程で送信されるリクエストも含まれます。 このような設定のリクエ
管理ガイド
51
外部の Web サービス
ストは、[更新] をクリックしたとき、[操作] リストで新しい項目を選択したとき、およびプ
レビューを実行したときに送信されます。 タイムアウトは、これらのどのアクションを実行
する場合にも生じる可能性があります。 タイムアウトが生じる場合、Web サービスが実際に
稼働中であるならば、[タイムアウト] の値を大きくすることによってそれを回避できる可能
性があります。
7. Web サービスをデータフローで使用できるようにし、Spectrum™ Technology Platform サービス
としてアクセスできるようにするには:
a) [サービスとしてエクスポーズ] ボックスをオンにします。
b) Web サービスを SOAP Web サービスとしてエクスポーズする場合は、[SOAP] ボックスをオ
ンにします。 Web サービスが http://<サーバー名>:<ポート>/soap の一覧に表示されます。
c) Web サービスを REST Web サービスとしてエクスポーズする場合は、[REST] ボックスをオン
にします。 Web サービスが http://<サーバー名>:<ポート>/rest の一覧に表示されます。
8. [URL] フィールドに、Web サービスの URL を入力します。
Web サービスで使用されるパラメータを [要求] および [応答] タブにあらかじめ設定する場合は、
URL にそれらのパラメータを含めることができます。 例えば、ビジネスのレビューを提供する
Web サービスに対して外部の Web サービスを定義するとします。 その場合に、次のような URL
を入力します。
http://ws.someprovider.com/business_reviews?term=insurance&location=207325
これを基に、定義する外部の Web サービスには term と location の 2 つのフィールドが用意さ
れます。 URL のパラメータを省略した場合は、この手順の後で指定できます。
9. 外部 Web サービスへのアクセスに必要ならば、ユーザ名とパスワードを入力します。
10. [更新] をクリックして、[操作] リストに Web サービスで提供されている操作の一覧を表示します。
注 : 一部の Web サービスでは、アクセスする前にユーザ名とパスワードの入力が必要です。 そ
の場合は、[更新] をクリックする前に必要な認証情報を入力する必要があります。 そうしな
ければ、更新オペレーションは失敗してしまいます。
11. [操作] リストで、実行する Web サービスの操作を選択します。
[操作] リストで Web サービスの操作を選択すると、操作要求および応答のフィールド名の一覧が、
[要求] および [応答] タブに表示されます。
12. [要求] タブで、要求フィールドで使用する設定と値を指定します。
a) パラメータの一覧に、前の手順で入力した URL のパラメータが表示されます。 他にもパラメー
タを追加するには、[追加] をクリックします。 パラメータを削除するには、テーブル内でその
パラメータを選択して [削除] をクリックします。
b) [フィールド名] 列に、各パラメータを参照するフィールド名を入力します。 フィールドがエク
スポーズされる場合、この名前は最終的な Spectrum™ Technology Platform サービスの入力
フィールド名になります。
c) 必要に応じて、各リクエスト フィールドのデフォルト名を指定します。
d) 最終的な Spectrum™ Technology Platform サービスで使用可能な入力フィールドとしてエクス
ポーズする各要求フィールドの [エクスポーズ] オプションを選択します。 すべての要求フィー
ルドをエクスポーズする場合は、テーブルのヘッダー行の [エクスポーズ] オプションを選択し
ます。
e) 外部の Web サービスに送信される要求 URL のテンプレートを表示するには、[テンプレートの
表示] をクリックします。
13. [応答] タブで、サードパーティ Web サービスから返されるタイプ応答を指定します。
テキスト
52
Spectrum™ Technology Platform は REST 応答を含む RestResponse という名
前の単一フィールドを返します。 このオプションはすべての応答タイプで使用
できます。
Spectrum™ Technology Platform 9.0 SP3
第 3 章 : データへの接続
区切り記号付
き
サードパーティ Web サービスが CSV などの区切り記号付きデータを返す場合
は、このオプションを選択します。 Spectrum™ Technology Platform はデータを
パースし、データを個別のフィールドとして返します。
XML
サードパーティ Web サービスが XML を返す場合は、このオプションを選択しま
す。 Spectrum™ Technology Platform はデータをパースし、データを個別のフィー
ルドとして返します。
JSON
サードパーティ Web サービスが JSON を返す場合は、このオプションを選択し
ます。 Spectrum™ Technology Platform はデータをパースし、データを個別の
フィールドとして返します。
14. [プレビュー] タブで、外部の Web サービスに送信する任意のテスト データを入力し、[プレビュー]
をクリックします。
15. [OK] をクリックして、外部の Web サービスを保存します。
関連リンク
外部の Web サービス（48ページ）
外部 Web サービスの名前の変更
外部 Web サービスの名前を変更すると、その外部 Web サービスを参照する既存のジョブ/サービスは
分断されてしまいます。 その外部 Web サービスを参照するジョブ/サービスが存在しない場合、ある
いは、別の外部 Web サービスまたは新しい名前を参照するように既存のジョブ/サービスを変更する
場合は、外部 Web サービスの名前を問題なく変更できます。
1. Management Console で、[リソース] ノードを展開し、[外部の Web サービス] をクリックします。
2. 名前を変更する外部の Web サービスをハイライト表示して、[名前の変更] をクリックします。
3. [OK] をクリックして、外部の Web サービスの名前の変更を確認します。
4. 外部の Web サービスの新しい名前を入力し、[OK] をクリックします。
関連リンク
外部の Web サービス（48ページ）
外部 Web サービスの削除
外部 Web サービスを削除すると、その外部 Web サービスを参照する既存のジョブ/サービスは分断さ
れてしまいます。 その外部 Web サービスを参照するジョブ/サービスが存在しない場合、または、別
の外部 Web サービスを参照するように既存のジョブ/サービスを変更する場合は、外部 Web サービス
を問題なく削除できます。
1. Management Console で、[リソース] ノードを展開し、[外部の Web サービス] をクリックします。
2. 削除する外部の Web サービスをハイライト表示して、[削除] をクリックします。 外部 Web サー
ビスを削除するかどうかを尋ねる確認メッセージが表示されます。
3. [OK] をクリックして確認します。
関連リンク
外部の Web サービス（48ページ）
管理ガイド
53
Windows でマッピングされたドライブの利用
Windows でマッピングされたドライブの利用
Spectrum™ Technology Platform サーバーを Windows サーバー上で実行している場合は、Enterprise
Designer および Management Console ユーザに、マッピングされたドライブに保存されるデータへの
アクセスを提供できます。 例えば、Spectrum™ Technology Platform を実行する Windows サーバーに
マップされるドライブ上にあるファイルに対してデータの読み書きを行うデータフローを設計できま
す。 Spectrum™ Technology Platform サーバーは、特定のユーザ アカウント (通常はローカル システ
ム アカウント) によって Windows サービスとして実行されるため、サーバーのスタートアップ プロ
セスでマッピングされたドライブを定義して、そのマッピングされたドライブを Enterprise Designer
と Management Console に表示する必要があります。
1. Spectrum™ Technology Platform サーバーを停止します。
2. Spectrum™ Technology Platform サーバーがインストールされているフォルダの
server\bin\wrapper に移動します。 例えば、C:\Program Files\Pitney
Bowes\Spectrum\server\bin です。
3. wrapper.conf ファイルをテキスト エディタで開きます。
重要 : 以下の手順では、このファイルに新しいプロパティを追加します。 これらの手順に正確に
従って、記載されるパラメータの追加と変更のみを行うことが重要です。 このファイルに
含まれるそれ以外のパラメータを変更しないでください。
4. 次の行を追加します。
wrapper.share.1.location
wrapper.share.1.target
wrapper.share.1.type
wrapper.share.1.account
wrapper.share.1.password
5. wrapper.share.1.location プロパティで、マッピングされたドライブの場所を UNC 形式で
指定します。
注 : UNC に後続バックスラッシュを含めないでください。
例を次に示します。
wrapper.share.1.location=\\myserver\share
6. wrapper.share.1.target プロパティで、このマッピングされたドライブに割り当てるドライ
ブ文字を指定します。
例を次に示します。
wrapper.share.1.target=Y:
7. type プロパティで、DISK を指定します。
例を次に示します。
wrapper.share.1.type=DISK
8. 接続先の共有がユーザ名とパスワードを要求する場合は、wrapper.share.1.accountプロパ
ティにユーザ名を指定し、wrapper.share.1.password プロパティにパスワードを指定しま
す。
54
Spectrum™ Technology Platform 9.0 SP3
第 3 章 : データへの接続
例を次に示します。
wrapper.share.1.account=domain\user123
wrapper.share.1.password=mypassword1
注 : Spectrum™ Technology Platform サーバー サービスがローカル システム ユーザによって実行
されている場合は、ユーザ名とパスワードを指定できません。 共有がユーザ名とパスワード
を要求する場合は、別のアカウントで実行するようにサービスを変更する必要があります。
Wrapper.conf のマッピングされたドライブ プロパティの例
以下の例は、wrapper.conf ファイルに定義される 2 つのマッピングされたドライ
ブを示しています。
wrapper.share.1.location=\\myserver\data
wrapper.share.1.target=Y:
wrapper.share.1.type=DISK
wrapper.share.1.account=sample\user
wrapper.share.1.password=samplepass
wrapper.share.2.location=\\myserver\moredata
wrapper.share.2.target=Z:
wrapper.share.2.type=DISK
wrapper.share.2.account=sample\user
wrapper.share.2.password=samplepass
管理ガイド
55
データベース リソースの設定
このセクションの構成
• データベース リソースの概要 . . . . . . . . . . . . . . . . . . . . . . .58
• データベース リソースの追加 . . . . . . . . . . . . . . . . . . . . . . .58
• データベース リソースのプール サイズの設定 . . . . . . . . . .70
• データベース リソースの削除 . . . . . . . . . . . . . . . . . . . . . . .71
4
データベース リソースの概要
データベース リソースの概要
いくつかのモジュールは、リファレンス データに依存して処理を行っています。 例えば、Universal
Addressing モジュールは住所の妥当性を確認する際に、米国郵政公社®等の郵便当局から得た郵便デー
タを含むデータベースを使用しています。 データベース リソース ツールにより、これらのデータベー
スを管理することができます。
データベース リソースの追加
Enterprise Geocoding モジュール グローバル データベース リソースの追加
Geocode Address Global および Reverse Geocode Global の各ステージは、他のステージとは異なり、
データベース リソースを定義しなければ、Management Console、Enterprise Designer、または
Interactive Driver に表示されません。 定義したグローバル データベース リソースごとに新しいステー
ジが作成されます。 例えば、メキシコとカナダのデータベースを含む 1 つのデータベース リソース
と、オーストラリアとシンガポールのデータを含むもう 1 つのデータベース リソースを定義した場
合、2 つの Geocode Address Global ステージが表示されます。一方ではメキシコとカナダの住所のジ
オコーディングが可能で、もう一方ではオーストラリアとシンガポールの住所のジオコーディングが
可能です。 また、Reverse Geocode Global ステージも、メキシコおよびカナダ用と、オーストラリ
アおよびシンガポール用に 1 つずつ、合計 2 つ表示されます。
注 : • オーストラリア、カナダ、フランス、ドイツ、および日本のジオコーディング データベース
は、サイズが大きくなっています。 これらのデータベースのうちの 2 つまたは 3 つ以上を、
同一のデータベース リソースに入れないでください。
• Spectrum™ Technology Platform サーバーを 64 ビットのマシン上で稼働している場合は、デー
タベース リソースに含めるデータベースは 8 ～ 10 カ国までにしてください。 それ以上のデー
タベースを含める場合は、Java メモリ設定を変更する必要があります。 詳細については、テ
クニカル サポートにお問い合わせください。
Geocode Address Global データベース リソースを作成するには
1. データベースをまだインストールしていない場合は、データベース ファイルをシステムにインス
トールしてください。 データベースのインストール手順については、『Spectrum™ Technology
Platform インストール ガイド』を参照してください。
2. Management Console で、[モジュール] > [Enterprise Geocoding] > [ツール] を展開し、[グロー
バル データベース リソース] をクリックします。
3. [追加] をクリックして新しいデータベース リソースを作成するか、[変更] をクリックして既存の
データベース リソースを変更します。
4. [名前] フィールドに、このリソースの名前を入力します。 任意の名前にすることができます。 通
常は、新しいデータベース リソースを作成するたびに、Pitney Bowes Software から更新済みのジ
オコーディング データベースを受け取るため、データベース リソース名にデータベース日付を使
用することを検討してください。
5. [追加] をクリックします。
6. [追加] を再度クリックします。
7. [名前] フィールドで、このデータベース パスの名前を指定します。 任意の名前にすることができ
ます。
58
Spectrum™ Technology Platform 9.0 SP3
第 4 章 : データベース リソースの設定
8. [パス] フィールドで、選択した国のデータベース ファイルを含むフォルダを指定します。 一般的
に、データベース ファイルは、<InstallLocation>\IGEO-<CountryCode>\<Version>\data
に格納されています。<InstallLocation> はデータベース ファイルをインストールするときに指定し
たディレクトリ、<CountryCode> は 2 文字の国コード、<Version> はデータのバージョン番号で
す。 データ ディレクトリ内に複数のデータベースを持つ国もあります。ライセンスがあるデータ
ベースもあれば、ライセンスがないデータベースもあります。 ライセンスがあるデータのロケー
ションのみを指定してください。
特定の国に対して複数のデータベースを追加する場合は、各データベースを別々のディレクトリに
配置する必要があります。 例えば、同じ国に対してストリート辞書とポイント辞書を追加する場
合、次のように指定できます。
<InstallLocation>\IGEO-<CountryCode>\<Version>\data\Street_dict
<InstallLocation>\IGEO-<CountryCode>\<Version>\data\Point_dict
Street_dict と Point_dict は、それぞれストリート辞書とポイント辞書を指しています。
注 : データベースをネットワーク ドライブに配置しないでください。 パフォーマンスの問題が生
じる恐れがあります。
9. データベースがカスタム データベースである場合は、[カスタム データベース] チェック ボックス
をオンにします。 カスタム データベースとは、ジオコーディングに使用可能な住所および緯度/経
度座標を含むユーザ定義のデータベースです。
注 : カスタム データベースのパスを指定する場合は、Pitney Bowes Software から提供されてい
るデータベースへのパスを先に指定する必要があります。 すべてのデータベース リソースの
中で最初のパスは、Pitney Bowes Software が提供するデータベースのパスでなければなりま
せん。
10. [OK] をクリックします。
11. その他のデータベース パスを追加する場合は、[追加] をクリックします。それ以外の場合は、[OK]
をクリックします。
12. その他の国を追加する場合は、[追加] をクリックします。それ以外の場合は、[OK] をクリックし
ます。 同一のデータベース リソースに複数の国を追加することにより、単一のステージで各国の
住所をジオコード可能な Geocode Address Global ステージが作成されます。
13. [プール サイズ] フィールドで、このデータベースで処理する同時要求の最大数を指定します。
最適なプール サイズはモジュールによって異なります。 一般的には、サーバーが搭載する CPU
の数の半分から 2 倍のプール サイズを設定すると、最適な結果が得られます。ほとんどのモジュー
ルに最適なプール サイズは CPU 数と同数です。 例えば、サーバーが 4 つの CPU を搭載している
場合は、プール サイズを 2 (CPU 数の半分) ～ 8 (CPU 数の 2 倍) の間で試すことができ、多くの
場合、最適なサイズは 4 (CPU 数と同数) です。
プール サイズを変更するときは、データベース リソースにアクセスするステージ用としてデータ
フローに指定されている実行時インスタンスの数を考慮する必要もあります。 例えば、1 つの実行
時インスタンスを使用するように設定された Geocode US Address ステージを持つデータフロー
があるとします。 この場合、米国ジオコーディング データベースのプール サイズを 4 に設定して
も、パフォーマンスは向上しません。実行時インスタンスが 1 つしかないので、データベース リ
ソースへの要求は一度に 1 つになります。 ただし、Geocode US Address の実行時インスタンス
の数を 4 つに増やすと、パフォーマンスが向上します。データベース リソースに同時にアクセス
する Geocode US Address のインスタンスが 4 つあるので、プール全体を使用できます。
ヒント : さまざまな設定でパフォーマンス テストを行って、環境にとって最適なプール サイズと
実行時インスタンスの設定を特定してください。
14. 起動中の Enterprise Designer セッションがある場合は、[更新] ボタンをクリックすると、新しい
ステージが表示されます。
管理ガイド
59
データベース リソースの追加
Enterprise Geocoding モジュールの米国 データベース リソース
新しいデータベース リソースをインストール、または既存のデータベース リソースを変更するたび
に、Management Console で定義して、システム上で使用できるようにする必要があります。 この手
順では、Enterprise Geocoding モジュール用に米国データベース リソースを追加または変更する方法
について説明します。 米国以外の住所のジオコーディングを行うためのデータベース リソースについ
ては、 Enterprise Geocoding モジュールのオーストラリア用データベース リソースの追加（60ペー
ジ）を参照してください。
1. データベースをまだインストールしていない場合は、データベース ファイルをシステムにインス
トールしてください。 データベースのインストール手順については、『Spectrum™ Technology
Platform インストール ガイド』を参照してください。
2. Management Console で、[モジュール] > [Enterprise Geocoding] > [ツール] > [米国データベー
ス リソース] の順に展開します。
3. 新しいデータベースをインストールするには [追加] をクリックし、既存のデータベース リソース
を変更するには [変更] をクリックします。
4. 新しいデータベースをインストールする場合は、[名前] フィールドにデータベース リソースの名
前を入力します。 任意の名前にすることができます。 既存のデータベース リソース名を変更する
ことはできません。 既存のデータベース リソース名を変更すると、そのデータベース リソースを
参照するサービスまたはジョブが失敗します。
注 : Enterprise Geocoding モジュールを Siebel モジュールとともに使用する場合は、 米国ジオ
コーディング データベースの名前を KGDDatasource としてください。
5. [パス要素] フィールドにデータベース ファイルを格納するフォルダを指定します。 複数のデータ
ベース パスを含めることができます。 このため、1 つのリソースを指定して、プライマリ データ
Link
ベースと DPV、LACS 、または標高データなどオプションのデータベースの両方を含めること
ができます。
6. [プール サイズ] フィールドで、このデータベースで処理する同時要求の最大数を指定します。
最適なプール サイズはモジュールによって異なります。 一般的には、サーバーが搭載する CPU
の数の半分から 2 倍のプール サイズを設定すると、最適な結果が得られます。ほとんどのモジュー
ルに最適なプール サイズは CPU 数と同数です。 例えば、サーバーが 4 つの CPU を搭載している
場合は、プール サイズを 2 (CPU 数の半分) ～ 8 (CPU 数の 2 倍) の間で試すことができ、多くの
場合、最適なサイズは 4 (CPU 数と同数) です。
プール サイズを変更するときは、データベース リソースにアクセスするステージ用としてデータ
フローに指定されている実行時インスタンスの数を考慮する必要もあります。 例えば、1 つの実行
時インスタンスを使用するように設定された Geocode US Address ステージを持つデータフロー
があるとします。 この場合、米国ジオコーディング データベースのプール サイズを 4 に設定して
も、パフォーマンスは向上しません。実行時インスタンスが 1 つしかないので、データベース リ
ソースへの要求は一度に 1 つになります。 ただし、Geocode US Address の実行時インスタンス
の数を 4 つに増やすと、パフォーマンスが向上します。データベース リソースに同時にアクセス
する Geocode US Address のインスタンスが 4 つあるので、プール全体を使用できます。
ヒント : さまざまな設定でパフォーマンス テストを行って、環境にとって最適なプール サイズと
実行時インスタンスの設定を特定してください。
7. [OK] をクリックします。
Enterprise Geocoding モジュールのオーストラリア用データベース リソースの
追加
新しいデータベース リソースをインストール、または既存のデータベース リソースを変更するたび
に、Management Console で定義して、システム上で使用できるようにする必要があります。 この手
60
Spectrum™ Technology Platform 9.0 SP3
第 4 章 : データベース リソースの設定
順では、オーストラリア用 Enterprise Geocoding モジュールのデータベース リソースを追加または変
更する方法について説明します。
1. データベースをまだインストールしていない場合は、データベース ファイルをシステムにインス
トールしてください。 データベースのインストール手順については、『Spectrum™ Technology
Platform インストール ガイド』を参照してください。
2. Management Console で、[モジュール] > [Enterprise Geocoding] > [ツール] の順に展開し、デー
タを設定する国のデータベース リソース アイコンをクリックします。
3. 新しいデータベースをインストールするには [追加] をクリックし、既存のデータベース リソース
を変更するには [変更] をクリックします。
4. [データベース] フィールドにデータベース リソース名を指定します。 任意の名前にすることがで
きます。 通常は、新しいデータベース リソースを作成するたびに、Pitney Bowes Software から更
新済みのジオコーディング データベースを受け取るため、データベース リソース名にデータベー
ス日付を使用することを検討してください。
5. [追加] をクリックします。 [名前] フィールドで、このデータベース リソースの名前を指定します。
[パス] フィールドにデータベース ファイルを格納するフォルダを指定します。 一般的に、データ
ベース ファイルは、<InstallLocation>\IGEO-<CountryCode>\<Version>\data に格納
されています。<InstallLocation> はデータベース ファイルをインストールするときに指定したディ
レクトリ、<CountryCode> は 2 文字の国コード、<Version> はデータのバージョン番号です。 デー
タ ディレクトリ内に複数のデータベースを持つ国もあります。ライセンスがあるデータベースも
あれば、ライセンスがないデータベースもあります。 ライセンスがあるデータのロケーションの
みを指定してください。
Australia Geocoded National Address File (G-NAF) データベースの場合は、GNAF123 フォルダと
GNAF456 フォルダに別々のデータベース リソースを指定する必要があります。 住所の有無の確
認には両方のデータベースを使用し、小区画レベルのジオコーディングには GANF123 のみを使用
することを推奨します。 小区画レベルのジオコードが不要な場合は、ジオコーディングに GANF456
データベースを使用することができます。
注 : ユーザ定義データベースのパスを指定する場合は、まず Pitney Bowes Software が提供する
データベースへのパスを指定する必要があります。 すべてのデータベース リソースの中で最
初のパスは、Pitney Bowes Software が提供するデータベースのパスでなければなりません。
6. [OK] をクリックします。
7. [プール サイズ] フィールドで、このデータベースで処理する同時要求の最大数を指定します。
最適なプール サイズはモジュールによって異なります。 一般的には、サーバーが搭載する CPU
の数の半分から 2 倍のプール サイズを設定すると、最適な結果が得られます。ほとんどのモジュー
ルに最適なプール サイズは CPU 数と同数です。 例えば、サーバーが 4 つの CPU を搭載している
場合は、プール サイズを 2 (CPU 数の半分) ～ 8 (CPU 数の 2 倍) の間で試すことができ、多くの
場合、最適なサイズは 4 (CPU 数と同数) です。
プール サイズを変更するときは、データベース リソースにアクセスするステージ用としてデータ
フローに指定されている実行時インスタンスの数を考慮する必要もあります。 例えば、1 つの実行
時インスタンスを使用するように設定された Geocode US Address ステージを持つデータフロー
があるとします。 この場合、米国ジオコーディング データベースのプール サイズを 4 に設定して
も、パフォーマンスは向上しません。実行時インスタンスが 1 つしかないので、データベース リ
ソースへの要求は一度に 1 つになります。 ただし、Geocode US Address の実行時インスタンス
の数を 4 つに増やすと、パフォーマンスが向上します。データベース リソースに同時にアクセス
する Geocode US Address のインスタンスが 4 つあるので、プール全体を使用できます。
ヒント : さまざまな設定でパフォーマンス テストを行って、環境にとって最適なプール サイズと
実行時インスタンスの設定を特定してください。
8. [OK] をクリックします。
管理ガイド
61
データベース リソースの追加
Enterprise Routing モジュールのデータベース リソースの追加
新しいデータベース リソースをインストール、または既存のデータベース リソースを変更するたび
に、Management Console で定義して、システム上で使用できるようにする必要があります。 この手
順では、Enterprise Routing モジュールのデータベース リソースをインストールまたは変更する方法
について説明します。 ルーティング データベース リソースは、Find Nearest、Get Travel Boundary、
Get Travel Cost Matrix、および Get Travel Directions で使用されます。
1. データベースをまだインストールしていない場合は、データベース ファイルをシステムにインス
トールしてください。 データベースのインストール手順については、『Spectrum™ Technology
Platform インストール ガイド』を参照してください。
2. Management Console で、[モジュール] > [Enterprise Routing] > [ツール] > [Routing Database
Resources] の順に展開します。
3. 新しいデータベースをインストールするには [追加] をクリックし、既存のデータベース リソース
を変更するには [変更] をクリックします。
4. 新しいデータベースをインストールする場合は、[名前] フィールドにデータベース リソースの名
前を入力します。 任意の名前にすることができます。 既存のデータベース リソース名を変更する
ことはできません。 既存のデータベース リソース名を変更すると、そのデータベース リソースを
参照するサービスまたはジョブが失敗します。
5. [パス要素] フィールドにデータベース ファイルを格納するフォルダを指定します。 データベース
ファイルは、<InstallLocation>\ERM-<CountryCode>\<Vintage>\<Type>\<Country>
に格納されています。<InstallLocation> はデータベース ファイルをインストールするときに指定し
たディレクトリ、<CountryCode> は 2 文字の国コード、<Vintage> はデータの日付 (例: 2009.1)、
<Type> はドライブまたは歩行者、<Country> は国の名前です。
6. [プール サイズ] フィールドで、このデータベースで処理する同時要求の最大数を指定します。
最適なプール サイズはモジュールによって異なります。 一般的には、サーバーが搭載する CPU
の数の半分から 2 倍のプール サイズを設定すると、最適な結果が得られます。ほとんどのモジュー
ルに最適なプール サイズは CPU 数と同数です。 例えば、サーバーが 4 つの CPU を搭載している
場合は、プール サイズを 2 (CPU 数の半分) ～ 8 (CPU 数の 2 倍) の間で試すことができ、多くの
場合、最適なサイズは 4 (CPU 数と同数) です。
プール サイズを変更するときは、データベース リソースにアクセスするステージ用としてデータ
フローに指定されている実行時インスタンスの数を考慮する必要もあります。 例えば、1 つの実行
時インスタンスを使用するように設定された Geocode US Address ステージを持つデータフロー
があるとします。 この場合、米国ジオコーディング データベースのプール サイズを 4 に設定して
も、パフォーマンスは向上しません。実行時インスタンスが 1 つしかないので、データベース リ
ソースへの要求は一度に 1 つになります。 ただし、Geocode US Address の実行時インスタンス
の数を 4 つに増やすと、パフォーマンスが向上します。データベース リソースに同時にアクセス
する Geocode US Address のインスタンスが 4 つあるので、プール全体を使用できます。
ヒント : さまざまな設定でパフォーマンス テストを行って、環境にとって最適なプール サイズと
実行時インスタンスの設定を特定してください。
7. [OK] をクリックします。
Enterprise Tax モジュールのデータベース リソースの追加
新しいデータベース リソースをインストール、または既存のデータベース リソースを変更するたび
に、Management Console で定義して、システム上で使用できるようにする必要があります。 この手
順では、Enterprise Tax モジュールのデータベース リソースを追加または変更する方法について説明
します。
62
Spectrum™ Technology Platform 9.0 SP3
第 4 章 : データベース リソースの設定
1. データベースをまだインストールしていない場合は、データベース ファイルをシステムにインス
トールしてください。 データベースのインストール手順については、『Spectrum™ Technology
Platform インストール ガイド』を参照してください。
2. Management Console で、[モジュール] > [Enterprise Tax] > [ツール] > [データベース リソース]
の順に展開します。
3. 新しいデータベースをインストールするには [追加] をクリックし、既存のデータベース リソース
を変更するには [変更] をクリックします。
4. 新しいデータベースをインストールする場合は、[名前] フィールドにデータベース リソースの名
前を入力します。 任意の名前にすることができます。 既存のデータベース リソース名を変更する
ことはできません。 既存のデータベース リソース名を変更すると、そのデータベース リソースを
参照するサービスまたはジョブが失敗します。
5. このデータベース リソースに含めるデータベースのパスを指定してください。
6. [プール サイズ] フィールドで、このデータベースで処理する同時要求の最大数を指定します。
最適なプール サイズはモジュールによって異なります。 一般的には、サーバーが搭載する CPU
の数の半分から 2 倍のプール サイズを設定すると、最適な結果が得られます。ほとんどのモジュー
ルに最適なプール サイズは CPU 数と同数です。 例えば、サーバーが 4 つの CPU を搭載している
場合は、プール サイズを 2 (CPU 数の半分) ～ 8 (CPU 数の 2 倍) の間で試すことができ、多くの
場合、最適なサイズは 4 (CPU 数と同数) です。
プール サイズを変更するときは、データベース リソースにアクセスするステージ用としてデータ
フローに指定されている実行時インスタンスの数を考慮する必要もあります。 例えば、1 つの実行
時インスタンスを使用するように設定された Geocode US Address ステージを持つデータフロー
があるとします。 この場合、米国ジオコーディング データベースのプール サイズを 4 に設定して
も、パフォーマンスは向上しません。実行時インスタンスが 1 つしかないので、データベース リ
ソースへの要求は一度に 1 つになります。 ただし、Geocode US Address の実行時インスタンス
の数を 4 つに増やすと、パフォーマンスが向上します。データベース リソースに同時にアクセス
する Geocode US Address のインスタンスが 4 つあるので、プール全体を使用できます。
ヒント : さまざまな設定でパフォーマンス テストを行って、環境にとって最適なプール サイズと
実行時インスタンスの設定を特定してください。
7. [OK] をクリックします。
Location Intelligence モジュール Centrus データベース リソースの追加
新しいデータベース リソースをインストール、または既存のデータベース リソースを変更するたび
に、Management Console で定義して、システム上で使用できるようにする必要があります。 この手
順では、Location Intelligence モジュールの Centrus データベース リソースをインストールまたは変更
する方法について説明します。 Centrus データは、Closest Site および Point in Polygon で使用されま
す。
1. データベースをまだインストールしていない場合は、データベース ファイルをシステムにインス
トールしてください。 データベースのインストール手順については、『Spectrum™ Technology
Platform インストール ガイド』を参照してください。
2. Management Console で、[モジュール] > [Location Intelligence] > [ツール] > [Centrus データ
ベース リソース] の順に展開します。
3. 新しいデータベースをインストールするには [追加] をクリックし、既存のデータベース リソース
を変更するには [変更] をクリックします。
4. 新しいデータベースをインストールする場合は、[名前] フィールドにデータベース リソースの名
前を入力します。 任意の名前にすることができます。 既存のデータベース リソース名を変更する
ことはできません。 既存のデータベース リソース名を変更すると、そのデータベース リソースを
参照するサービスまたはジョブが失敗します。
5. [パス] フィールドにデータベース ファイルへのフル パスを入力します。 Centrus データベース
ファイルには、拡張子 .gsb が付きます。 Spectrum™ Technology Platform で使用できるようにす
管理ガイド
63
データベース リソースの追加
るには、.gsb ファイルのファイル名を Unix および Linux システム上ですべて小文字にする必要が
あります。
6. [キャッシュ サイズ] フィールドで、データのキャッシュに使用するメモリの量を選択します。 一
般的には、キャッシュを大きくするほどパフォーマンスが向上します。 次のオプションがありま
す。
• なし — データをキャッシュしません。
• 中 — 最大 5 MB のメモリを使用してデータをキャッシュします。 キャッシュに使用できるメモ
リの量が少ない場合は、この設定を使用してください。
• 大 — 最大 20 MB のメモリを使用してデータをキャッシュします。 多数のレコードを処理する
場合はこの設定を使用してください。
• 巨大 — 最大 100 MB のメモリを使用してデータをキャッシュします。 多数のレコードを処理す
る場合はこの設定を使用してください。
7. [プール サイズ] フィールドで、このデータベースで処理する同時要求の最大数を指定します。
最適なプール サイズはモジュールによって異なります。 一般的には、サーバーが搭載する CPU
の数の半分から 2 倍のプール サイズを設定すると、最適な結果が得られます。ほとんどのモジュー
ルに最適なプール サイズは CPU 数と同数です。 例えば、サーバーが 4 つの CPU を搭載している
場合は、プール サイズを 2 (CPU 数の半分) ～ 8 (CPU 数の 2 倍) の間で試すことができ、多くの
場合、最適なサイズは 4 (CPU 数と同数) です。
プール サイズを変更するときは、データベース リソースにアクセスするステージ用としてデータ
フローに指定されている実行時インスタンスの数を考慮する必要もあります。 例えば、1 つの実行
時インスタンスを使用するように設定された Geocode US Address ステージを持つデータフロー
があるとします。 この場合、米国ジオコーディング データベースのプール サイズを 4 に設定して
も、パフォーマンスは向上しません。実行時インスタンスが 1 つしかないので、データベース リ
ソースへの要求は一度に 1 つになります。 ただし、Geocode US Address の実行時インスタンス
の数を 4 つに増やすと、パフォーマンスが向上します。データベース リソースに同時にアクセス
する Geocode US Address のインスタンスが 4 つあるので、プール全体を使用できます。
ヒント : さまざまな設定でパフォーマンス テストを行って、環境にとって最適なプール サイズと
実行時インスタンスの設定を特定してください。
8. [OK] をクリックします。データベースの一覧に次の情報が表示されます。
• 名前 — データベースに付与した名前。 このデータベースをステージまたはサービスから参照す
る際に使用する名前です。
• パス — データベース ファイルの場所。
• キャッシュ サイズ — このデータベースのデータのキャッシュに使用するメモリの量。
• フィーチャー タイプ — データベースに格納されている空間データのタイプを示します (ポイン
ト、ポリゴン、またはライン)。 ポイント データベースは、Closest Site ステージおよび Point
In Polygon ステージで使用できます。 ポリゴン データベースおよびライン データベースは、
Point In Polygon ステージで使用できます。
• バッファ有効 — データベースがバッファリングをサポートしているかどうかを示します。バッ
ファリングは Point in Polygon 機能の 1 つで、ポイント、ポリゴン、またはラインに近い領域を
指定するのに使用します。
Location Intelligence モジュール データベースの名前付き接続の追加
新しいデータベース リソースをインストール、または既存のデータベース リソースを変更するたび
に、それを Spectrum Spatial マネージャ で定義してシステム上で使用できるようにする必要がありま
す。 この手順では、Location Intelligence モジュールの空間データベース リソースをインストールま
たは変更する方法について説明します。 これらのリソースは、データベースへの名前付き接続を追加
することによって定義されます。 これらの名前付き接続は、Location Intelligence モジュールのリポジ
トリに保存され、すべての空間サービスが使用できます。 データベースへの名前付き接続を追加する
64
Spectrum™ Technology Platform 9.0 SP3
第 4 章 : データベース リソースの設定
と、名前付きテーブル (データベース内のテーブルへのリンク) の作成にそのデータベースが使用でき
るようになります。 空間データベース リソースは、Find Nearest、Query Spatial Data、および Read
Spatial Data の各ステージで使用されます。
Spectrum™ Technology Platform でサポートされている JDBC データ型は、BIGINT、BINARY、BIT、
BLOB、BOOLEAN、CHAR、DATE、DECIMAL、DOUBLE、FLOAT、INTEGER、LONGVARBINARY、
LONGVARCHAR、NULL、NUMERIC、REAL、SMALLINT、TIME、TIMESTAMP、TINYINT、
VARBINARY、VARCHAR です。
さらに、Spectrum™ Technology Platform では Oracle データ型 SDO_GEOMETRY と
MDSYS.SDO_GEOMETRY もサポートされます。 これらのデータ型は、次のように扱われます。
• string、INTEGER、long、FLOAT、および DOUBLE — 変更なし
• DECIMAL — DOUBLE に変換
• SDO_GEOMETRY および MDSYS.SDO_GEOMETRY — GEOMETRY に変換
• それ以外 — STRING に変換
1. データベースをまだインストールしていない場合は、データベース ファイルをシステムにインス
トールしてください。 データベースのインストール手順については、『Spectrum™ Technology
Platform インストール ガイド』を参照してください。
2. Spectrum Spatial マネージャ を開いて名前付き接続を作成します。 Spectrum Spatial マネージャ
を起動して使用する手順については、『 Spectrum™ Technology Platform Spectrum Spatial ガイ
ド』の「リソースおよびデータ」セクションを参照してください。
3. ツールバーにある [名前付き接続を作成] ボタン
をクリックします。
注 : 十分な権限がない場合は、このボタンは無効になります。
[名前付き接続を作成] ページが表示されます。
4. 名前付き接続の名前を入力します。 その名前を持つ別の名前付き接続が存在する場合は、 Spectrum
Spatial マネージャ が警告を表示します。その場合は、別の名前を入力する必要があります。 名前
は大文字と小文字が区別されます。また、文字 \ / : [ ] | * " { } を使用してはいけません。
5. 接続タイプとして、ファイル システムまたはデータベースを選択します。 TAB ファイルなどの
ファイルベースのデータ ソースには、ファイルシステム タイプを使用します。 データ ソースとし
て JDBC データベース (Oracle、PostGIS、SAP HANA、または SQL Server) を使用する場合は、
データベース タイプを使用します。
6. ファイル システムを選択した場合は、参照ボタンをクリックして、ファイル システムでファイル
を探します。 Windows に対して UNC またはネットワーク パスがサポートされています。 UNC
パスを使用するには、参照ボタンをクリックして [フォルダの選択] ダイアログを開きます。 パス
(\\localhost\share など) を入力して、 Enterキーを押します。 対象フォルダをクリックして [フォ
ルダ] フィールドに表示し、 [選択]をクリックします。 ステップ 10 に進みます。
7. データベースを選択した場合は、データベースへの JDBC 接続 URL を指定します。 この URL は、
jdbc:subprotocol:subnameという形式です。 例:
•
•
•
•
Oracle —jdbc:oracle:thin:@oracle.example.com:1521:pbspatial
SQL Server —jdbc:sqlserver:@sqlserver.example.com;databaseName=pbspatial
Postgres/PostGIS — jdbc:postgresql:@postgres.example.com:1433/pbspatial
SAP HANA —jdbc:sap:@saphana.example.com
• 汎用 JDBC —jdbc:mysql:thin:@mysql.example.com:3306/pbspatial
注 : SQL Server では、jdbc:sqlserver://<serverName>\<instanceName>という形式の JDBC URL が使用
すが、 Spectrum Spatial マネージャ では JDBC URL にバックスラッシュを使用できません。 例えば次の UR
を、代わりに使用してください。
jdbc:sqlserver://<serverName>:<portNumber>;databaseName=<NameOfDatabase>
または
jdbc:sqlserver://<serverName>;instanceName=<instanceName>;databaseName=<NameOfDat
管理ガイド
65
データベース リソースの追加
詳細については、 http://technet.microsoft.com/en-us/library/ms378428(v=SQL.110).aspx と
http://support.microsoft.com/kb/287932を参照してください。
8. [ユーザ名] フィールドで、データベース リソースに接続するユーザを指定します (オプション)。
9. [パスワード] フィールドで、データベース リソースに接続するユーザのパスワードを指定します
(オプション)。
10. [プロパティ] フィールドで、データベース固有の接続プロパティを指定します (オプション)。 接
続文字列に追加できるプロパティ名と値のタイプについては、データベースのドキュメントを参照
してください。 例えば、プロパティ値 networkProtocol とキーtcpを追加できます。
11. [テスト] をクリックして、接続が有効であることを確認します。
12. [Create] をクリックします。
名前付き接続の詳細ページが表示されます。
Find Nearest、Query Spatial Data、および Read Spatial Data で使用可能なリソースの一覧に、この
データベース リソースへの名前付き接続が表示されるようになります。 これらの接続は、データベー
ス リソース内の名前付きテーブルへのアクセスにも使用できます。
Location Intelligence モジュールの名前付きテーブル リソースの追加
Location Intelligence モジュールのステージ、サービス、および操作では、さまざまなデータ タイプに
アクセスする名前付きテーブルが必要です。 名前付きテーブルはデータを指すリソースで、MapInfo
TAB ファイル (ビュー テーブルを含む)、シェイプファイル、JDBC などのデータベース ファイル (XY
テーブルを含む) へのアクセスに使用できます。 以下では、Location Intelligence モジュールの名前付
きテーブル リソースを追加または変更する手順について説明します。 これらの名前付きテーブルは、
Spectrum Spatial リポジトリに保存され、すべての空間サービスが使用できます。
MapInfo Professional を所有している場合は、マップ アップローダ プラグインを使用して、名前付き
マップ、テーブル、レイヤなどの名前付きリソースを Spectrum Spatial リポジトリにアップロードし
ます (詳細については、 マップ アップローダのドキュメントを参照してください)。 それ以外の場合
は、 Spectrum Spatial マネージャ を使用する以下の手順に従います。
注 : 名前付きリソースに対するすべての権限を持つユーザ アカウントのみが、マップ アップローダ
または Spectrum Spatial マネージャを使用して名前付きテーブルを追加できます。 権限の割り
当ての詳細については、 『Spectrum Spatial ガイド』の「管理」セクションの「セキュリティの
管理」の章を参照してください。
1. データベースをまだインストールしていない場合は、データをシステムにインストールしてくださ
い。 データベースのインストール手順については、『Spectrum™ Technology Platform インストー
ル ガイド』を参照してください。 データベース リソース内の名前付きテーブルを追加するには、
まずデータベース リソースに名前付き接続を追加する必要があります。 名前付き接続の追加につ
いては、 名前付き接続の作成を参照してください。
2. Spectrum Spatial マネージャ を開いて名前付きテーブルを作成します。 Spectrum Spatial マネー
ジャを起動して使用する手順については、『 Spectrum™ Technology PlatformSpectrum Spatial ガ
イド』の「リソースおよびデータ」セクションを参照してください。
3. ツールバーにある [名前付きテーブルの作成] ボタン
をクリックします。
注 : 十分な権限がない場合は、このボタンは無効になります。
[名前付きテーブルの作成] ページが表示されます。
4. [名前] フィールドに、名前付きテーブルの名前を入力します。 その名前を持つ別の名前付きテー
ブルが存在する場合は、Spectrum Spatial マネージャ が警告を表示します。その場合は、別の名
前を入力する必要があります。 名前は大文字と小文字が区別されます。また、文字 \ / : [ ] | * " { }
を使用してはいけません。
66
Spectrum™ Technology Platform 9.0 SP3
第 4 章 : データベース リソースの設定
5. 以下のいずれかのデータ ソースを選択します。
• ファイル システム— データがファイル システム上に、MapInfo TAB または ESRI シェイプファ
イル形式で存在する場合はこのオプションを選択します。
• データベース— データが JDBC データベース (Oracle、SQLServer、PostGIS、または SAP HANA
など) 内にあり、名前付き接続を作成済みの場合はこのオプションを選択します。
• ビュー テーブル— データが MapInfo TAB 形式で、テーブルの特定のビューの表示に SQL 文を
使用している場合はこのオプションを選択します。
6. データ ソース タイプとしてファイル システムを選択した場合は、ファイル ツリーで、名前付き接
続と、TAB ファイルまたはシェイプファイルを探します。 テーブルをクリックすると、ファイル
ツリーの下の [テーブル] フィールドにそれが表示されます。
注 : 名前付き接続がない場合は、ファイル ツリーは表示されません。 [名前付き接続を作成] をク
リックして、名前付き接続を作成してください。 方法については、名前付き接続の作成を参
照してください。
7. データ ソース タイプとしてデータベースを選択した場合は、次のフィールドを入力します。
注 : データベース識別子 (下のテーブル名など) はすべて大文字小文字が区別されます。
• 接続名 — データベースにアクセスするために使用する一連のパラメータを定義する、データベー
スへの名前付き接続です。 既存の名前付き接続を指定するには、一覧から名前を選択します。
• スキーマ — データベース スキーマ オブジェクト。 通常は、ユーザ名と同じです。
• テーブル — データフローに読み込むデータを含む、選択されたデータベース内のテーブル。
• XY— 指定したテーブルが以下の条件を満たす場合、このフィールドが表示されます。
• マップ カタログで既に定義済みの XY テーブルである。この場合、このチェック ボックスは
オフとなり、読み取り専用になります。
• 定義済みの空間列を持たない。 データが XY テーブルである場合はこのボックスをオンにしま
す。 X と Y の列を指定し、それらの列の座標系を選択します。 また、 スタイル列を定義する
か、 名前付きスタイルを定義することによって、このテーブルのスタイルが選択できます。
名前付きスタイルを選択する場合は、リポジトリ内に存在する名前付きスタイルを定義し
て、/NamedStyles/PointStylePin のようにルートからの完全なパスを含める必要があります。
8. データ ソース タイプとしてビューを選択した場合は、 [MISQL] フィールドに SQL クエリを指定
します。 ビューの名前付きテーブルは、実行時に名前付きテーブル内のクエリに基づいて、マッ
プ内にレイヤを作成する機能を提供します。 ビューを使用することにより、SQL クエリに基づい
て、複数のリソースからフィルタリングされたビューを含む名前付きビューを作成できます。 ク
エリには名前付きテーブルが含まれるため (例: select Country,Capital, Obj from
"/NamedTables/WorldcapTable" where Country='INDIA')、任意のデータ ソースでビューを使用で
きます。名前付きテーブルは、TAB、XY、Oracle、SQL Server などのデータ ソース タイプを持
つ場合があるためです。 MI SQL コマンドおよび関数の詳細については、『 MapInfo SQL 言語リ
ファレンス 』を参照してください。
クエリが完成したら、 [バリデーション] をクリックして MISQL 文が有効であることを確認しま
す。
9. [Create] をクリックします。
名前付きテーブルの詳細ページが表示されます。
Find Nearest、Query Spatial Data、および Read Spatial Data で使用可能なリソースの一覧にこの名
前付きテーブル リソースが表示されるようになります。
Universal Addressing モジュールのデータベース リソースの追加
新しいデータベース リソースをインストール、または既存のデータベース リソースを変更するたび
に、Management Console で定義して、システム上で使用できるようにする必要があります。 この手
管理ガイド
67
データベース リソースの追加
順では、Get Candidate Addresses、Get City State Province、Get Postal Codes、および Validate
Address で使用されるデータベース リソースを追加または変更する方法について説明します。
注 : Validate Address Global 用のデータベース リソースを設定する場合は、Universal Addressing
モジュールのグローバル データベース リソースの追加（68ページ）を参照してください。
1. データベースをまだインストールしていない場合は、データベース ファイルをシステムにインス
トールしてください。 データベースのインストール手順については、『Spectrum™ Technology
Platform インストール ガイド』を参照してください。
2. Management Console で、[モジュール] > [Universal Addressing] > [ツール] の順に展開し、デー
タベース リソースを設定する国のアイコンをクリックします。
注 : Validate Address Global 用のグローバル データベース リソースを定義する場合は、Universal
Addressing モジュールのグローバル データベース リソースの追加（68ページ）を参照して
ください。
3. 新しいデータベースをインストールするには [追加] をクリックし、既存のデータベース リソース
を変更するには [変更] をクリックします。
4. 新しいデータベースをインストールする場合は、[名前] フィールドにデータベース リソースの名
前を入力します。 任意の名前にすることができます。 既存のデータベース リソース名を変更する
ことはできません。 既存のデータベース リソース名を変更すると、そのデータベース リソースを
参照するサービスまたはジョブが失敗します。
5. データベース ファイルへのパスを指定してください。
6. [プール サイズ] フィールドで、このデータベースで処理する同時要求の最大数を指定します。
最適なプール サイズはモジュールによって異なります。 一般的には、サーバーが搭載する CPU
の数の半分から 2 倍のプール サイズを設定すると、最適な結果が得られます。ほとんどのモジュー
ルに最適なプール サイズは CPU 数と同数です。 例えば、サーバーが 4 つの CPU を搭載している
場合は、プール サイズを 2 (CPU 数の半分) ～ 8 (CPU 数の 2 倍) の間で試すことができ、多くの
場合、最適なサイズは 4 (CPU 数と同数) です。
プール サイズを変更するときは、データベース リソースにアクセスするステージ用としてデータ
フローに指定されている実行時インスタンスの数を考慮する必要もあります。 例えば、1 つの実行
時インスタンスを使用するように設定された Geocode US Address ステージを持つデータフロー
があるとします。 この場合、米国ジオコーディング データベースのプール サイズを 4 に設定して
も、パフォーマンスは向上しません。実行時インスタンスが 1 つしかないので、データベース リ
ソースへの要求は一度に 1 つになります。 ただし、Geocode US Address の実行時インスタンス
の数を 4 つに増やすと、パフォーマンスが向上します。データベース リソースに同時にアクセス
する Geocode US Address のインスタンスが 4 つあるので、プール全体を使用できます。
ヒント : さまざまな設定でパフォーマンス テストを行って、環境にとって最適なプール サイズと
実行時インスタンスの設定を特定してください。
7. [OK] をクリックします。
Universal Addressing モジュールのグローバル データベース リソースの追加
新しいデータベース リソースをインストール、または既存のデータベース リソースを変更するたび
に、Management Console で定義して、システム上で使用できるようにする必要があります。 この手
順では、Validate Address Global モジュールで使用されるデータベース リソースをインストールまた
は変更する方法について説明します。
1. データベース ファイルがまだインストールされていない場合は、インストール作業を行ってから、
<SpectrumLocation>\server\modules\addressglobal\conf\unlockcodes.txt にアン
ロックキーを入力してください。 データベースのインストール手順については、『Spectrum™
Technology Platform インストール ガイド』を参照してください。
68
Spectrum™ Technology Platform 9.0 SP3
第 4 章 : データベース リソースの設定
注 : データベースリソースを作成する前に、unlockcodes.txt ファイルにアンロックキーを指定す
る必要があります。
2. Management Console で、[モジュール] > [Universal Addressing] > [ツール] > [グローバル デー
タベース リソース] を展開します。
3. 新しいデータベースをインストールするには [追加] をクリックし、既存のデータベース リソース
を変更するには [変更] をクリックします。
4. 新しいデータベースをインストールする場合は、[名前] フィールドにデータベース リソースの名
前を入力します。 任意の名前にすることができます。 既存のデータベース リソース名を変更する
ことはできません。 既存のデータベース リソース名を変更すると、そのデータベース リソースを
参照するサービスまたはジョブが失敗します。
5. [キャッシュ サイズ] フィールドで、プリロードされなかった参照データのファイル システム検索
を高速化するために使うメモリの量を選択します (プリローディングについては以降で詳しく説明
します)。以下のいずれかを選択します。
• None— データをキャッシュしません。
• Small— Validate Address Global によるメモリ消費量を減らすには、このオプションを選択しま
す。
• Large— この設定の使用を推奨します。 すべての参照データがプリロードされる場合 (キャッ
シュ サイズを [なし] に選択できる) または Validate Address Global によるメモリ消費量を減ら
す必要がある場合を除き、この設定を使用してください。
6. [パス要素] フィールドにデータベース ファイルを格納するフォルダを指定します。 パス要素を指
定するには
a) [追加] をクリックします (または既存のパスを変更する場合は [変更] をクリックします)。
b) [パス] フィールドにデータベース ファイルを格納するフォルダを指定します。
c) [追加] をクリックして国の優先設定を指定します (既存の優先設定を変更する場合は [変更] を
クリックします)。
7. データベース タイプを選択します。 次のオプションがあります。
• Batch Interactive— (デフォルト) 高速実行以外と認定以外のすべてのデータベースに使用します。
• FastCompletion— クイック住所エントリ アプリケーションで使用される検証モードです。複数
の住所フィールドに入力された不完全なデータから、入力住所の候補を生成できます。 高速実
行を使って、入力の途中で住所候補を作成することもできます。
注 : 高速実行データベースは、拡張パーシングに対応していません。
• Certified— オーストラリアにおける郵便のバッチ処理環境で使用される検証モードです。 Validate
Address Global はオーストラリア郵便公社の Address Matching Approval System (AMAS) で認
定されています。 これは郵便住所ファイルに照らして郵便の正規化と検証を行うことで、郵便
料金の割引と不達郵便物の最小化を実現します。
8. プリローディング タイプを選択します。
プリローディングは、データベース データをメモリにロードすることを意味し、パフォーマンス
を改善する効果があります。 プリローディング中にメモリが大量に割り当てられる可能性がある
ため、データベースがメモリに完全にロードされるまでに多少の時間がかかることがあります。
次のオプションがあります。
• None— データがメモリにプリロードされません。 メモリが限られたマシンでは、このオプショ
ンを使用してください （デフォルト）。
• Partial— 部分プリローディングによって、メタデータおよびインデックス構造がメモリにロード
されます。 参照データ自体はハード ドライブに残ります。 部分プリローディングによって、パ
フォーマンスがやや向上します。また、目的のデータベースをすべてロードするだけのメモリが
使用できない場合の代替策となります。 部分プリローディングは、すべてのデータベースに対
してサポートされていないことがあります。
管理ガイド
69
データベース リソースのプール サイズの設定
• Full— 完全プリローディングによって、参照データベース全体がメモリに移動します。 米国や英
国など、大規模なデータベースを持つ国では、大量のメモリが必要になることがありますが、処
理速度は大幅に向上します。
9. 以下のインストール方法を選択できます。
• Make default— 選択したデータベース タイプとプリローディング タイプをフォルダ内のすべて
の国のデフォルトにします。
• Apply to selected countries only— このデータベース タイプとプリローディング タイプを選択し
た国のみに適用します。
10. [OK] をクリックします。
11. [プール サイズ] フィールドで、このデータベースで処理する同時要求の最大数を指定します。
最適なプール サイズはモジュールによって異なります。 一般的には、サーバーが搭載する CPU
の数の半分から 2 倍のプール サイズを設定すると、最適な結果が得られます。ほとんどのモジュー
ルに最適なプール サイズは CPU 数と同数です。 例えば、サーバーが 4 つの CPU を搭載している
場合は、プール サイズを 2 (CPU 数の半分) ～ 8 (CPU 数の 2 倍) の間で試すことができ、多くの
場合、最適なサイズは 4 (CPU 数と同数) です。
プール サイズを変更するときは、データベース リソースにアクセスするステージ用としてデータ
フローに指定されている実行時インスタンスの数を考慮する必要もあります。 例えば、1 つの実行
時インスタンスを使用するように設定された Geocode US Address ステージを持つデータフロー
があるとします。 この場合、米国ジオコーディング データベースのプール サイズを 4 に設定して
も、パフォーマンスは向上しません。実行時インスタンスが 1 つしかないので、データベース リ
ソースへの要求は一度に 1 つになります。 ただし、Geocode US Address の実行時インスタンス
の数を 4 つに増やすと、パフォーマンスが向上します。データベース リソースに同時にアクセス
する Geocode US Address のインスタンスが 4 つあるので、プール全体を使用できます。
ヒント : さまざまな設定でパフォーマンス テストを行って、環境にとって最適なプール サイズと
実行時インスタンスの設定を特定してください。
12. 必要に応じて、異なる国に対して異なるデータベース タイプとプリローディング 設定の指定を繰
り返します。 例えば、1 つのフォルダに複数の国がある場合、デフォルトのデータベース タイプ
として FastCompletion、プリローディング タイプとして Partial を指定し、[OK] をクリックしま
す。 次に [追加] をクリックし、頻繁に使用すると思われるいくつかの国に対するデフォルトのデー
タベース タイプとして FastCompletion、プリローディング タイプとして Full を指定し、[OK] を
再度クリックします。
13. データベース タイプとプリローディング オプションの定義が完了したら、[OK]をクリックしま
す。
14. 必要に応じて、追加のデータベース パスを定義します。 必要な操作が終了したら、[OK] をクリッ
クします。
Validate Address Global で使用可能なデータベース リソースの一覧にこのデータベース リソースが表
示されるようになります。
データベース リソースのプール サイズの設定
データベース リソースには、住所の検証で使用する郵便データや、住所のジオコードで使用するジオ
コーディング データなど、特定のステージで使用するリファレンス データが含まれます。 これらの
データベース リソースは、それを使用するデータフロー ステージやサービスから同時に行われる複数
の要求を受け付けるように設定することが可能で、その結果、データフローの要求やサービスの要求
のパフォーマンスを高めることができます。 データベース リソースのプール サイズを変更すると、
データベース リソースが受け付ける同時要求の数を変更できます。 データベース リソースが処理で
70
Spectrum™ Technology Platform 9.0 SP3
第 4 章 : データベース リソースの設定
きる同時要求の最大数は、プール サイズによって決まります。 デフォルトでは、データベース リソー
スのプール サイズは 4 で、データベース リソースは 4 つの要求を同時に処理できることを意味しま
す。 ただし、データベース リソースには別のプール サイズを設定できます。
注 : パフォーマンスのチューニング時には、データベース リソースのプール サイズを調整する前に
データフローのプール サイズを最適化します。
1. Management Console を開きます。
2. [モジュール] の下で、データベース リソースのパフォーマンスを最適化するモジュールを展開し
ます。 次に、[ツール] を展開し、データベース リソースを選択します。
3. 最適化するデータベース リソースを選択し、[変更] をクリックします。
4. [プール サイズ] フィールドで、このデータベースで処理する同時要求の最大数を指定します。
最適なプール サイズはモジュールによって異なります。 一般的には、サーバーが搭載する CPU
の数の半分から 2 倍のプール サイズを設定すると、最適な結果が得られます。ほとんどのモジュー
ルに最適なプール サイズは CPU 数と同数です。 例えば、サーバーが 4 つの CPU を搭載している
場合は、プール サイズを 2 (CPU 数の半分) ～ 8 (CPU 数の 2 倍) の間で試すことができ、多くの
場合、最適なサイズは 4 (CPU 数と同数) です。
プール サイズを変更するときは、データベース リソースにアクセスするステージ用としてデータ
フローに指定されている実行時インスタンスの数を考慮する必要もあります。 例えば、1 つの実行
時インスタンスを使用するように設定された Geocode US Address ステージを持つデータフロー
があるとします。 この場合、米国ジオコーディング データベースのプール サイズを 4 に設定して
も、パフォーマンスは向上しません。実行時インスタンスが 1 つしかないので、データベース リ
ソースへの要求は一度に 1 つになります。 ただし、Geocode US Address の実行時インスタンス
の数を 4 つに増やすと、パフォーマンスが向上します。データベース リソースに同時にアクセス
する Geocode US Address のインスタンスが 4 つあるので、プール全体を使用できます。
ヒント : さまざまな設定でパフォーマンス テストを行って、環境にとって最適なプール サイズと
実行時インスタンスの設定を特定してください。
関連リンク
サービスの最適化（93ページ）
データベース リソースの削除
データベース リソースには、住所の検証で使用する住所データや、ジオコーディングで使用する空間
データなど、一部のモジュールで使用するリファレンス データが含まれます。 システムで使用されて
いないデータベース リソースは、削除できます。 データベース リソースを削除すると、Spectrum™
Technology Platform でそのデータベースは使用できなくなりますが、データベース ファイルは削除さ
れません。
注 : データベース リソースを削除する前に、そのデータベースを使用するジョブまたはサービスが存
在しないことを確認します。 ジョブまたはサービスから参照されるデータベース リソースを削
除すると、それらのジョブまたはサービスは機能しなくなります。
1. Management Console を開きます。
2. [モジュール] を展開して、データベース リソースを削除するモジュールを展開します。
3. [ツール] を展開して、データベース リソース アイコンをクリックします。
4. 削除するデータベース リソースを選択し、[削除] をクリックします。
管理ガイド
71
実行の管理
このセクションの構成
• ジョブとプロセス フロー . . . . . . . . . . . . . . . . . . . . . . . . . . .74
• サービス . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .91
• リモート サーバー . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .94
• デフォルトのタイプ変換オプションの設定 . . . . . . . . . . . . .98
5
ジョブとプロセス フロー
ジョブとプロセス フロー
ジョブまたはプロセス フローの手動実行
ジョブまたはプロセス フローを手動で実行する手順を以下に示します。
1. Enterprise Designer で、[ファイル] > [開く] を選択し、実行するデータフローを開きます。
2. 実行の前にデータフローの検証を行い、エラーが存在しないことを確認します。 データフローを
検証するには、[実行] > [検証] を選択します。
3. [実行] > [現在のフローを実行] を選択します。
コマンド ラインからのジョブの実行
コマンド ラインからジョブを実行するには、その前に、ジョブをエクスポーズする必要があります。
ジョブをエクスポーズするには、Enterprise Designer でジョブを開き、[ファイル] > [エクスポーズ/ア
ンエクスポーズして保存] を選択します。
コマンド ラインからジョブを実行するには、ジョブを実行するシステムに Job Executor ユーティリ
ティをインストールする必要があります。 Job Executor は Spectrum™ Technology Platform サーバー
上の Spectrum™ Technology Platform Welcome ページ (例えば、http://myserver:8080) にあります。
使用方法
java -jar jobexecutor.jar -uUserID -p Password-j Job [Optional Arguments]
74
必須
引数
説明
いいえ
-?
使用方法を出力します。
いいえ
-d delimiter
インスタンス/ステータス区切り文字を設定しま
す。 これは、同期出力にのみ表示されます。
いいえ
-e
Spectrum™ Technology Platform サーバーとの
通信にセキュアな SSL 接続を使用します。
いいえ
-f property file
ジョブ プロパティ ファイルへのパスを指定し
ます。 ジョブ プロパティ ファイルには Job
Executor の引数が含まれています。 ジョブ プ
ロパティ ファイルの詳細については、ジョブ
プロパティ ファイルの作成（79ページ）を参照
してください。
いいえ
-h host name
Spectrum™ Technology Platform サーバーの名
前または IP アドレスを指定します。
いいえ
-i poll interval
完了したジョブを確認する間隔を秒数で指定し
ます。 これは、同期モードにのみ適用されま
す。
はい
-j job name
実行するジョブをカンマで区切って指定します。
ジョブ名は大文字と小文字が区別されます。
ジョブは、列挙された順序で開始されます。
いいえ
-n email list
ジョブ通知設定に対する追加の電子メール アド
レスをカンマで区切って指定します。
Spectrum™ Technology Platform 9.0 SP3
第 5 章 : 実行の管理
必須
引数
説明
いいえ
-o property file
データフロー オプション プロパティ ファイル
へのパスを指定します。 データフロー オプショ
ン プロパティ ファイルには、データフローに
よるデータの処理方法を制御するオプションが
含まれています。 例えば、Assign GeoTAX Info
ステージを含むデータフローのデータフロー オ
プション プロパティ ファイルは、次のような
ものになります。
OutputCasing=U
UseStreetLevelMatching=N
TaxKey=T
Database.GTX=gsl
はい
-p password
ユーザのパスワードです。
いいえ
-r
標準出力に出力されるジョブに関する以下の情
報を、区切り文字で区切って返します。
• 位置 1 — ジョブの名前
• 位置 2 — ジョブ プロセス ID
• 位置 3 — ステータス
• 位置 4 — 開始日時 (MM/DD/YYYY HH:MM:SS)
• 位置 5 — 終了日時 (MM/DD/YYYY HH:MM:SS)
• 位置 6 — 成功したレコードの数
• 位置 7 — 失敗したレコードの数
• 位置 8 — 形式に誤りのあるレコードの数
• 位置 9 — 現在未使用
情報は、-d 引数で指定された区切り文字で区切
られて出力されます。 例:
MySimpleJob|4|succeeded|04/09/2010
14:50:47|04/09/2010
14:50:47|100|0|0|
いいえ
-s ポート
Spectrum™ Technology Platform サーバーが実
行されているソケット (ポート)。 デフォルト値
は 8080 です。
いいえ
-t timeout
同期モードの場合のタイムアウト (秒単位) を設
定します。 デフォルト値は 3600 です。 最大数
は 2147483 です。 これは、すべてを合わせた
グローバルなタイムアウト値で、spawn された
すべてのジョブが完了するまでの最大待機時間
を表します。
はい
-u user name
ユーザのログイン名を指定します。
いいえ
-v
詳細な出力を返します。
いいえ
-w
同期モードにおいてジョブの完了を待つように
指定します。
いいえ
StageName=Protocol:FileName
Read from File または Write to File で指定され
た入力または出力ファイルをオーバーライドし
ます。 詳細については、「 コマンド ラインで
の入力ファイルおよび出力ファイルのオーバー
ライド（76ページ）」を参照してください。
管理ガイド
75
ジョブとプロセス フロー
必須
引数
説明
いいえ
StageName:schema=Protocol:SchemaFile Read from File または Write to File で指定され
たファイル レイアウト定義を、スキーマ ファ
イルで定義されたファイル レイアウト定義で
オーバーライドします。 詳細については、「
コマンド ラインでのファイル フォーマットの
オーバーライド （78ページ）」を参照してくだ
さい。
Job Executor の使用例
以下は、コマンド ラインによる起動とその出力の例です。
D:\spectrum\job-executor>java -jar jobexecutor.jar -u user123
-p "mypassword" -j validateAddressJob1 -h spectrum.example.com
-s 8888 -w -d "%" -i 1 -t 9999
validateAddressJob1%105%succeeded
この例の出力からは、'validateAddressJob1' という名前のジョブ (識別子 105) がエ
ラーを生じることなく実行したことがわかります。 その他の実行結果としては、"失
敗" と "実行中" があります。
コマンド ラインでの入力ファイルおよび出力ファイルのオーバーライド
Job Executor を使用してコマンド ラインでジョブを実行する際に、データフローのソース ステージ
(Read from File など) で指定された入力ファイル、およびデータフローのシンク ステージ (Write to File
など) で指定された出力ファイルをオーバーライドできます。 そのためには、Job Executor コマンド
ライン コマンドの終わりに以下を指定します。
<stage name>=<protocol>:<file name>
説明:
<stage name>
Enterprise Designer で、データフローのステージのアイコンの下に表
示されるステージ ラベル。 例えば、ステージのラベルが "Read from
File" の場合は、ステージ名として Read from File と指定します。
埋め込まれたデータフローまたはサブフロー内のステージを指定する
には、ステージ名の前に埋め込まれたデータフローまたはサブフロー
の名前とピリオドを付けて、次のようにします。
EmbeddedOrSubflowName.StageName
例えば、"Subflow1" という名前のサブフローの中の "Write to File" と
いう名前のステージを指定するには、次のようにします。
Subflow1.Write to File
別の埋め込まれたデータフローの中にある埋め込まれたデータフロー
内のステージを指定するには、親データフローをそれぞれピリオドで
区切って追加します。 例えば、Embedded Dataflow 2 が Embedded
Dataflow 1 の中にあり、Embedded Dataflow 2 内の Write to File ス
テージを指定する場合は、次のようにします。
Embedded Dataflow 1.Embedded Dataflow 2.Write to File
<protocol>
76
通信プロトコル。 次のいずれかを選択します。
Spectrum™ Technology Platform 9.0 SP3
第 5 章 : 実行の管理
file
ファイルが Spectrum™ Technology Platform サーバーと同
じコンピュータ上にある場合は、file プロトコルを使用しま
す。 例えば、Windows では、
"file:C:/myfile.txt"
と指定し、Unix または Linux では、
"file:/testfiles/myfile.txt"
esclient ファイルが Job Executor と同じコンピュータ上にある場合
は、escilent プロトコルを使用します。
注 : クライアントとサーバーが同じコンピュータ上で稼
働している場合は、file プロトコルを使用しても
escilent プロトコルを使用しても構いませんが、file
プロトコルを使用した方がパフォーマンスが高くな
る可能性があります。
esfile
ファイルが ファイル サーバー上にある場合は、esfile プロ
トコルを使用します。 このファイル サーバーは
Management Console でリソースとして定義する必要があ
ります。 次の形式を使用します。
esfile:/<file server>/<path to file>
例を次に示します。
esfile:/myserver/testfiles/myfile.txt
ここで、myserver は、Management Console で定義された
FTP ファイル サーバー リソースです。
webhdfs ファイルが Hadoop 分散ファイル サーバー上にある場合
は、webhdfs プロトコルを使用します。 この HDFS サー
バーは Management Console でリソースとして定義する必
要があります。 次の形式を使用します。
webhdfs:<file server>/<path to file>
例を次に示します。
webhdfs:myserver/testfiles/myfile.txt
ここで、myserver は、Management Console で定義された
HDFS ファイル サーバー リソースです。
<file name>
入力または出力として使用するファイルへのフル パス。
注 : ファイルのパスには、バックスラッシュではなくスラッシュ (/)
を使用する必要があります。
ファイルのオーバーライドの例
以下の Job Executor コマンドでは、ファイル C:/myfile_input.txt を Read
from File ステージの入力ファイルとして使用し、ファイル C:/myfile_output.txt
を Write to File ステージの出力ファイルとして使用します。
管理ガイド
77
ジョブとプロセス フロー
java -jar jobexecutor.jar -j Job1 -u Bob1234 -p "" "Read from
File"="file:C:/myfile_input.txt" "Write to
File"="file:C:/myfile_output.txt"
コマンド ラインでのファイル フォーマットのオーバーライド
Job Executor を使用してコマンド ラインでジョブを実行する際に、データフローの Read from File ス
テージおよび Write to File ステージで指定されたファイルのファイル レイアウト (またはスキーマ) を
オーバーライドできます。 そのためには、Job Executor コマンド ライン コマンドの終わりに以下を
指定します。
<stage name>:schema=<protocol>:<settings file>
説明:
<stage name>
Enterprise Designer で、データフローのステージのアイコンの下に表
示されるステージ ラベル。 例えば、ステージのラベルが "Read from
File" の場合は、ステージ名として Read from File と指定します。
埋め込まれたデータフローまたはサブフロー内のステージを指定する
には、ステージ名の前に埋め込まれたデータフローまたはサブフロー
の名前とピリオドを付けて、次のようにします。
EmbeddedOrSubflowName.StageName
例えば、"Subflow1" という名前のサブフローの中の "Write to File" と
いう名前のステージを指定するには、次のようにします。
Subflow1.Write to File
別の埋め込まれたデータフローの中にある埋め込まれたデータフロー
内のステージを指定するには、親データフローをそれぞれピリオドで
区切って追加します。 例えば、Embedded Dataflow 2 が Embedded
Dataflow 1 の中にあり、Embedded Dataflow 2 内の Write to File ス
テージを指定する場合は、次のようにします。
Embedded Dataflow 1.Embedded Dataflow 2.Write to File
<protocol>
通信プロトコル。 次のいずれかを選択します。
file
ファイルが Spectrum™ Technology Platform サーバーと同
じコンピュータ上にある場合は、file プロトコルを使用しま
す。 例えば、Windows では、
"file:C:/myfile.txt"
と指定し、Unix または Linux では、
"file:/testfiles/myfile.txt"
esclient ファイルが Job Executor と同じコンピュータ上にある場合
は、escilent プロトコルを使用します。
注 : クライアントとサーバーが同じコンピュータ上で稼
働している場合は、file プロトコルを使用しても
escilent プロトコルを使用しても構いませんが、file
プロトコルを使用した方がパフォーマンスが高くな
る可能性があります。
78
Spectrum™ Technology Platform 9.0 SP3
第 5 章 : 実行の管理
esfile
ファイルが ファイル サーバー上にある場合は、esfile プロ
トコルを使用します。 このファイル サーバーは
Management Console でリソースとして定義する必要があ
ります。 次の形式を使用します。
esfile:/<file server>/<path to file>
例を次に示します。
esfile:/myserver/testfiles/myfile.txt
ここで、myserver は、Management Console で定義された
FTP ファイル サーバー リソースです。
webhdfs ファイルが Hadoop 分散ファイル サーバー上にある場合
は、webhdfs プロトコルを使用します。 この HDFS サー
バーは Management Console でリソースとして定義する必
要があります。 次の形式を使用します。
webhdfs:<file server>/<path to file>
例を次に示します。
webhdfs:myserver/testfiles/myfile.txt
ここで、myserver は、Management Console で定義された
HDFS ファイル サーバー リソースです。
<settings file>
使用するレイアウトを定義した設定ファイルへのフル パス。
注 : ファイルのパスには、バックスラッシュではなくスラッシュ (/)
を使用する必要があります。
設定ファイルを作成するには、目的のレイアウトを Read from File ま
たは Write to File で定義し、[エクスポート] ボタンをクリックして、
レイアウトを定義した XML ファイルを作成します。
注 : Job Executor を使用する場合は、設定ファイル内のフィールド
のデータ タイプをオーバーライドできません。 <FieldSchema>
要素の子である <Type> 要素の値は、データフローの Read from
File ステージまたは Write to File ステージで指定されたフィー
ルドのタイプと一致している必要があります。
ファイル フォーマットのオーバーライドの例
以下の Job Executor コマンドでは、ファイル C:/myschema.xml を Read from File
ステージによって読み込まれるファイルのレイアウト定義として使用します。
java -jar jobexecutor.jar -j Job1 -u Bob1234 -p "" "Read from
File":schema="file:C:/myschema.xml"
ジョブ プロパティ ファイルの作成
ジョブ プロパティ ファイルには Job Executor の引数が含まれています。 引数を再使用する場合は、
各引数をコマンド ラインで個別に指定するのではなく、単一の Job Executor の引数 (-f) を指定して、
ジョブ プロパティ ファイルを使用します。
管理ガイド
79
ジョブとプロセス フロー
プロパティ ファイルを作成するには、各行に 1 つの引数を含むテキスト ファイルを作成します。 例:
d
h
i
j
u
p
s
t
w
%
spectrum.mydomain.com
30
validateAddressJob1
user
password
8888
9999
true
コマンド ライン入力とプロパティ ファイル入力を組み合わせて使用することもできます。 例:
java -jar jobexecutor.jar -f /dcg/job.properties -j job1
この場合、コマンドライン引数の方が、プロパティ ファイルで指定された引数よりも優先されます。
上の例では、ジョブ job1 の方が、プロパティ ファイルで指定されたジョブよりも優先されることにな
ります。
ジョブ プロパティ ファイルには次の引数を含めることができます。
いいえ
?
使用方法を出力します。
いいえ
d delimiter
インスタンス/ステータス区切り文字を設定しま
す。 これは、同期出力にのみ表示されます。
いいえ
e
Spectrum™ Technology Platform サーバーとの
通信にセキュアな SSL 接続を使用します。
いいえ
h host name
Spectrum™ Technology Platform サーバーの名
前または IP アドレスを指定します。
いいえ
i poll interval
完了したジョブを確認する間隔を秒数で指定し
ます。 これは、同期モードにのみ適用されま
す。
はい
j job name
実行するジョブをカンマで区切って指定しま
す。 ジョブ名は大文字と小文字が区別されま
す。 ジョブは、列挙された順序で開始されま
す。
いいえ
n email list
ジョブ通知設定に対する追加の電子メール アド
レスをカンマで区切って指定します。
はい
p password
ユーザのパスワードです。
いいえ
r
標準出力に出力されるジョブに関する以下の情
報を、区切り文字で区切って返します。
• 位置 1— ジョブの名前
• 位置 2— ジョブ プロセス ID
• 位置 3— ステータス
• 位置 4— 開始日時 (MM/DD/YYYY HH:MM:SS)
• 位置 5— 終了日時 (MM/DD/YYYY HH:MM:SS)
• 位置 6— 成功したレコードの数
• 位置 7— 失敗したレコードの数
• 位置 8— 形式に誤りのあるレコードの数
• 位置 9— 現在未使用
情報は、-d 引数で指定された区切り文字で区切
られて出力されます。 例:
80
Spectrum™ Technology Platform 9.0 SP3
第 5 章 : 実行の管理
MySimpleJob|4|succeeded|04/09/2010
14:50:47|04/09/2010
14:50:47|100|0|0|
いいえ
s ポート
Spectrum™ Technology Platform サーバーが実
行されているソケット (ポート)。 デフォルト値
は 8080 です。
いいえ
t timeout
同期モードの場合のタイムアウト (秒単位) を設
定します。 デフォルト値は 3600 です。 最大
数は 2147483 です。 これは、すべてを合わせ
たグローバルなタイムアウト値で、spawn され
たすべてのジョブが完了するまでの最大待機時
間を表します。
はい
u user name
ユーザのログイン名を指定します。
いいえ
v
詳細な出力を返します。
いいえ
w
同期モードにおいてジョブの完了を待つように
指定します。
いいえ
StageName=Protocol:FileName
Read from File または Write to File で指定され
た入力または出力ファイルをオーバーライドし
ます。 詳細については、「 コマンド ラインで
の入力ファイルおよび出力ファイルのオーバー
ライド（76ページ）」を参照してください。
いいえ
StageName:schema=Protocol:SchemaFile Read from File または Write to File で指定され
たファイル レイアウト定義を、スキーマ ファ
イルで定義されたファイル レイアウト定義で
オーバーライドします。 詳細については、「
コマンド ラインでのファイル フォーマットの
オーバーライド （78ページ）」を参照してく
ださい。
コマンド ラインからのプロセス フローの実行
コマンド ラインからプロセス フローを実行するには、Process Flow Executor を使用します。 Process
Flow Executor は、Spectrum™ Technology Platform Welcome ページ (例えば、http://myserver:8080
など) からインストールできます。
注 : 管理ユーティリティを使用して、コマンド ラインからプロセス フローを実行することもできま
す。
使用方法
java -jar pflowexecutor.jar -rProcessFlowName -u UserID-p Password [Optional
Arguments]
必須
引数
説明
いいえ
-?
使用方法を出力します。
いいえ
-d
コマンド実行時にコマンド ラインに表示されるステータス情報を区切
DelimiterCharacter るのに使用する区切り文字を設定します。 デフォルトは "|" です。 例
えば、デフォルト文字を使用して、"MyProcessflow" というプロセス
フローを実行した場合、コマンド ラインには次のように表示されま
す。
管理ガイド
81
ジョブとプロセス フロー
必須
引数
説明
MyProcessflow|1|Succeeded
いいえ
-e
Spectrum™ Technology Platform サーバーとの通信にセキュアな SSL
接続を使用します。
いいえ
-f PropertyFile
プロパティ ファイルへのパスを指定します。 プロパティ ファイルの
詳細については、プロセス フローのプロパティ ファイルの使用
（84ページ） を参照してください。
いいえ
-h HostName
Spectrum™ Technology Platform サーバーの名前または IP アドレスを
指定します。
いいえ
-i PollInterval
完了したジョブを確認する間隔を秒数で指定します。 デフォルト値は
"5" です。
はい
-p Password
ユーザのパスワードです。 必須
はい
-r
実行するプロセス フローのリストをカンマで区切って指定します。
ProcessFlowNames 必須
いいえ
-s Port
Spectrum™ Technology Platform サーバーが実行されているソケット
(ポート)。 デフォルト値は 8080 です。
いいえ
-t Timeout
同期モードの場合のタイムアウト (秒単位) を設定します。 デフォル
ト値は 3600 です。
はい
-u UserName
ユーザのログイン名を指定します。 必須
いいえ
-v Verbose
詳細な出力を返します。ここで、Verbose は次のいずれかです。
いいえ
いいえ
-w
WaitToComplete
true
詳細な出力を返します。
false
詳細な出力を返しません。
同期モードでプロセス フローの完了を待つことを指定します。ここ
で、WaitToComplete は次のいずれかです。
true
完了を待ちます。
false
完了を待ちません。
StageName=FileName ジョブで指定されている入力または出力ファイルをオーバーライドし
ます。 詳細については、Read from File と Write to File の場所のオー
バーライド（83ページ）を参照してください。
例
プロセス フロー名、ユーザ ID、パスワードを指定した基本的なコマンド ライン エ
ントリを次に示します。
java -jar pflowexecutor.jar -r MyFlow1 -u Bob1234 -p
"mypassword1"
次の例では、前の例と同じ情報に加えて引数を指定しています。
java -jar pflowexecutor.jar -r Flow1 -u Bob1234 -p
"mypassword1" -h spectrum.example.com -s 8888 -w -d "%" -i 1
-t 9999
82
Spectrum™ Technology Platform 9.0 SP3
第 5 章 : 実行の管理
次の例では、コマンド ラインでの起動と出力を示します。
D:\spectrum\pflow-executor>java -jar pflowexecutor.jar -u
Bob1234 -p "mypassword1" -r
validateAddressFlow1 -h spectrum.example.com -s 8888 -w -d
"%" -i
1 -t 9999
validateAddressJob1%111%succeeded
この例では、validateAddressFlow1 という名前のプロセス フローが実行しました
(ID は 111)。 エラーは発生していません。 その他の実行結果としては、"失敗" と
"実行中" があります。
Read from File と Write to File の場所のオーバーライド
Read from File または Write to File の場所をオーバーライドするには、Read from File ステージまたは
Write from File ステージの名前と、その入力ファイルまたは出力ファイルを最後の引数として指定し
ます。
"<jobname>|<stagename>"="<filename>"
ここで、
<jobname> は、プロセス フロー内で参照されるジョブの名前です。
<stagename> は、ジョブ内の Read from File または Write to File ステージの名前です。
<filename> は、ファイルへのフル パスです。
例:
java -jar pflowexecutor.jar -r Flow1 -u Bob1234 -p "mypassword1" -h
spectrum.example.com -s 8888 -w -d "%" -i 1 -t 9999 "Job1|Read from
File"="file:C:/myfile_input.txt" "Job1|Write to
File"="file:C:/myfile_output.txt"
注 : ファイル パスには、バックスラッシュではなくスラッシュ (/) を使用する必要があります。
コマンド ラインで指定するステージ名は、データフロー内のステージのアイコンの下に表示されるス
テージ ラベルと一致する必要があります。 例えば、入力ステージのラベルが "Read From File" である
場合は、次のように指定します。
"Job1|Read From File"="file:C:/inputfile.txt"
入力ステージのラベルが "Illinois Customers" である場合は、次のように指定します。
"Job1|Illinois Customers"="file:C:/inputfile.txt"
Read from File または Write to File の場所をオーバーライドするときは、次のようにプロトコルを指定
する必要があります。
• ファイルが Spectrum™ Technology Platform サーバーと同じコンピュータに存在する場合は、パス
の先頭に "file:" プロトコルを付けます。 例えば、Windows では、"file:C:/myfile.txt" と指定
し、Unix または Linux では、""file:/testfiles/myfile.txt"" と指定します。
• ファイルが Process Flow Executor と同じコンピュータに存在する場合は、パスの先頭に "esclient:"
プロトコルを付けます。 例えば、Windows では、"esclient:C:/myfile.txt" と指定し、Unix
または Linux では、""esclient:/testfiles/myfile.txt"" と指定します。
• クライアントとサーバーが同じコンピュータ上で稼働している場合は、どちらのプロトコルを使用
しても構いませんが、"file:" プロトコルを使用した方がパフォーマンスが高くなる可能性があります
管理ガイド
83
ジョブとプロセス フロー
• Management Console で定義されたファイル サーバーを使用するには、ftp:<name of the file
server>/<path to file という形式を使用します。 例えば、
ftp://FS/testfiles/myfile.txt と指定します。ここで FS は、Management Console で定義
されたファイル サーバー リソースです。
プロセス フローのプロパティ ファイルの使用
プロパティ ファイルには引数が含まれ、Process Flow Executor で -f 引数を使ってプロパティ ファ
イルのパスを指定することにより、引数を再利用できます。 プロパティ ファイルには、少なくともプ
ロセス フロー (r)、ユーザ ID (u)、およびパスワード (p) が含まれる必要があります。
1. テキスト エディタを起動します。
2. 次の例で示すように、1 行で 1 つの引数を指定します。 引数の一覧については、コマンド ライン
からのプロセス フローの実行（81ページ）を参照してください。
D=property=true
d=%
h=myserver.mydomain.com
i=30
u=user
p=password
r=MyFlow1
s=8888
t=9999
w=true
X=Xmx=1024M
3. .properties という拡張子をつけてこのファイルを保存します ("example.properties" など)。
4. Process Flow Executor を実行するときに、-f 引数を使用してプロパティ ファイルのパスを指定
します。 コマンド ライン入力とプロパティ ファイル入力を組み合わせて使用することもできま
す。 コマンド ラインでの引数の方が、プロパティ ファイルで指定されている引数より優先されま
す。
java -jar pflowexecutor.jar -f /dcg/flow.properties -r MyFlow2
この例では、プロセス フロー MyFlow2 が、プロパティ ファイルで指定されているプロセス フロー
より優先されます。
ジョブとプロセス フローのスケジューリング
ジョブまたはプロセス フローを、指定した時間に自動的に実行するには、Management Console を使
用して、ジョブおよびプロセス フローの実行スケジュールを設定します。
1. ジョブまたはプロセス フローをエクスポーズしていない場合は、エクスポーズします。
ジョブやプロセス フローをエクスポーズするには、Enterprise Designer でジョブまたはプロセス
フローを開き、[ファイル] > [エクスポーズ/アンエクスポーズして保存] を選択します。
2. Management Console を開きます。
3. [実行] を表示し、[スケジューリング] をクリックします。
4. [追加] をクリックして新しいスケジュールを作成するか、既存のスケジュールを変更する場合は、
スケジュールを選択して [変更] をクリックします。
5. [タスクの追加] または [タスクの変更] ウィンドウで、タスクに対する設定を選択します。
• [タスク名] — スケジューリングするこのタスクの名前を指定します。 これがタスク一覧に表示
される名前になります。
84
Spectrum™ Technology Platform 9.0 SP3
第 5 章 : 実行の管理
• [フロー タイプ] — スケジューリングするプロセスの種類 (ジョブまたはプロセス フロー) を選択
します。
• [フロー名] — スケジューリングするジョブまたはプロセス フローを選択します。 保存およびエ
クスポーズされたジョブとプロセス フローだけが、ここで使用可能です。 選択したいジョブま
たはプロセス フローが表示されない場合は、Enterprise Designer でジョブまたはプロセス フロー
を開き、[ファイル] > [エクスポーズ/アンエクスポーズして保存] を選択します。
• [タスクの有効化] — ジョブまたはプロセス フローを指定した時間に実行するには、このボック
スをオンにします。 スケジュールを一時的に停止するにはこのボックスをオフにします。
• [スケジュール] — ジョブまたはプロセス フローを実行する日時を指定します。
6. データフローで入力または出力にファイルを使用する場合は、これらのファイルは Spectrum™
Technology Platform サーバー上に存在するか、Management Console で外部リソースとして定義
されたファイル サーバー上に存在する必要があります。 これはジョブと、プロセス フロー内の
ジョブ アクティビティの両方に適用されます。 ソースまたはシンク ステージがクライアント専用
コンピュータ上のファイルを参照している場合は、次の手順のいずれかを実行します。
オプション
説明
オプション 1: データフ ファイルを Spectrum™ Technology Platform サーバーまたはファイル
ローを変更する
サーバーに移動し、データフローを変更します。
1. Enterprise Designer でデータフローを開きます。
2. ソースまたはシンク ステージをダブルクリックします。
3. [ファイル名] フィールドで、参照ボタンをクリックします。
4. [リモート マシン] をクリックして、必要なファイルを選択します。
注 : Spectrum™ Technology Platform サーバーと同じコンピュー
タ上で Enterprise Designer を実行している場合、[リモート
マシン] のクリックは、[マイ コンピュータ] をクリックするの
と同じであるように見えます。 しかし、ファイルが Spectrum™
Technology Platform サーバー上に存在することをシステムに
認識させるためには、[リモート マシン] を使用してファイル
を選択する必要があります。
オプション 2: このスケ このスケジュールを実行するときに、フロー内のファイル参照をオー
ジュールの実行時にデー バーライドします。
タフローのファイルの場
1. [オプション] をクリックします。
所をオーバーライドする
2. [ステージ ファイルの場所] の下で、ローカル ファイルを参照するス
テージを選択します。
3. [変更] をクリックし、Spectrum™ Technology Platform サーバー上
のファイルを選択します。
7. ジョブまたはプロセス フローを、繰り返し実行するようにスケジュールする場合は、[タスクの繰
り返し] チェック ボックスをオンにし、[繰り返し] ボタンをクリックして、フィールドを設定しま
す。
8. データフローが電子メール通知用に設定されている場合は、データフローの実行時に通知が送信さ
れる受信者を追加で指定できます。
a) [オプション] をクリックします。
b) [通知] の下の [追加] をクリックします。
c) 通知を送信する電子メール アドレスを入力します。 例えば、[email protected] と入力し
ます。
d) [OK] をクリックします。
注 : 電子メール通知を機能させるには、Management Console で通知を設定する必要があります。
また、データフローが通知をサポートするように設定されていることも確認してください。
そのためには、Enterprise Designer でデータフローを開き、[編集] > [通知] を選択します。
管理ガイド
85
ジョブとプロセス フロー
9. [OK] をクリックします。
ファイル モニターによるジョブまたはプロセス フローのトリガ
ファイル モニターは、作成したコントロール ファイルをモニターするディレクトリ内に検出すると、
ジョブまたはプロセス フローをトリガします。 このコントロール ファイルの存在は、特定のジョブ
またはプロセス フローに必要なすべてのファイルが配置され、処理できる状態になっていることを意
味します。 コントロール ファイルが現れると、ファイル モニターは指定のジョブまたはプロセス フ
ローを実行します。 ファイル モニターは、ジョブまたはプロセス フローへの入力として使用するファ
イルを作成する他のプロセスがある場合に役立ちます。
1. Management Console を開きます。
2. [実行] メニューから [ファイル モニター] をクリックします。
3. [追加] をクリックします。
4. [タスク名] フィールドで、このファイル モニターに付けたい名前を指定します。 任意の名前にす
ることができます。
5. [タスクの有効化] チェック ボックスをオンにして、このファイル モニターを有効にします。 チェッ
ク ボックスをオフにして、このファイル モニターを無効にします。
6. [フロー タイプ] フィールドで、このファイル モニターで実行したいフローのタイプを選択します。
ジョブ
バッチ ジョブ データフローを実行します。
プロセス フロー
プロセス フローを実行します。
7. [フロー名] フィールドで、この File Monitor で実行したいフローを選択します。
8. データフローが電子メール通知用に設定されている場合は、データフローの実行時に通知が送信さ
れる受信者を追加で指定できます。
a) [オプション] をクリックします。
b) [通知] の下の [追加] をクリックします。
c) 通知を送信する電子メール アドレスを入力します。 例えば、[email protected] と入力し
ます。
d) [OK] をクリックします。
注 : 電子メール通知を機能させるには、Management Console で通知を設定する必要があります。
また、データフローが通知をサポートするように設定されていることも確認してください。
そのためには、Enterprise Designer でデータフローを開き、[編集] > [通知] を選択します。
9. [ファイル] フィールドで、データフローをトリガするコントロール ファイルのフル パスと名前を
指定します。 ファイル名は、そのまま指定するか、ワイルドカードとしてアスタリスク (*) を使用
できます。 たとえば、*.trg と指定すると、フォルダに拡張子 .trg の任意のファイルが現れたとき
データフローがトリガされます。
コントロール ファイルの存在によって、実行するジョブまたはプロセス フローがトリガされます。
これは、特定のジョブまたはプロセス フローに必要なすべてのファイルが配置され、フローで使
用する準備ができていることを意味します。
コントロール ファイルは空白のままでかまいません。このファイルが存在するだけで、ジョブま
たはデータフローの実行がトリガされます。 ただし、ジョブの場合、コントロール ファイルは、
Write to File ステージまたは Read from File ステージで設定されるファイル パスのオーバーライド
を指定できます。 コントロール ファイルを使用してファイル パスをオーバーライドするには、
Read from File ステージまたは Write from File ステージの名前と、その入力ファイルまたは出力
ファイルを最後の引数として指定します。
stagename=filename
86
Spectrum™ Technology Platform 9.0 SP3
第 5 章 : 実行の管理
例:
Read\ from\ File=file:C:/myfile_input.txt
Write\ to\ File=file:C:/myfile_output.txt
コントロール ファイルで指定するステージ名は、データフロー内のステージのアイコンの下に表
示されるステージ ラベルと一致する必要があります。 例えば、入力ステージのラベルが "Read
From File" である場合は、次のように指定します。
Read\ From\ File=file:C:/inputfile.txt
入力ステージのラベルが "Illinois Customers" である場合は、次のように指定します。
Illinois\ Customers=file:C:/inputfile.txt
Read from File または Write to File の場所をオーバーライドする場合は、次のプロトコルに従って
ください。
• パスの先頭に "file:" プロトコルを付けます。 例えば、Windows では、"file:C:/myfile.txt"
と指定し、Unix または Linux では、""file:/testfiles/myfile.txt"" と指定します。
• このファイルのコンテンツは、プレーン テキストで書く必要があります。 具体的には、ASCII
ベースの ISO-8559-1 (Latin-1) 互換文字エンコーディングを使用する必要があります。
• ファイル パスには、バックスラッシュではなくスラッシュ (/) を使用する必要があります。
• ステージ名に含まれるスペースは、バックスラッシュでエスケープする必要があります。
• ステージ名は大文字と小文字を区別します。
注 : 複数のファイル モニターを設定する場合は、それぞれがユニークなファイル セットをモニ
ターすることが重要です。 そうしなければ、同じコントロール ファイルで複数のジョブまた
はプロセス フローがトリガされ、予期せぬ動作を引き起こす恐れがあります。 構造上の理由
から、すべての必要なファイルとコントロール ファイルを専用ディレクトリに配置すること
をお勧めします。
10. [ポーリング間隔] フィールドで、コントロール ファイル用に指定された場所をモニターが確認す
る頻度を秒単位で指定します。 例えば、10 とファイル名 AddressData.trg を指定した場合、
モニターは AddressData.trg がモニター フォルダに現れるかどうかを 10 秒ごとに確認します。
デフォルトでは、60 秒に設定されています。
11. [作業フォルダ] の下の [フォルダ] フィールドで、データフローを実行する前にコントロール ファ
イルを配置するフォルダの名前を指定します。 これによって、フローが二度トリガされることが
なくなります。
12. [完了時] フィールドで、データフローの実行終了時に作業フォルダ内のファイルをどう処理するか
を指定します。
保持
ファイルを現在の場所に現在の名前で保持します。 このオプションを選択し
た場合、作業フォルダ内のファイルはファイル モニターが実行されるたびに
上書きされます。
移動
ファイルを作業フォルダから指定のフォルダに移動します。
タイムスタンプを 作業フォルダ内のファイル名にタイムスタンプを付加します。 これは ファイ
使用して名前を変 ルモニター が繰り返し実行されたとき、作業フォルダ内のファイルのコピー
更
を保持する最も簡単な方法です。フォルダの名前を変更すれば一意の名前が
与えられるので、ファイルモニター がデータフローを次回実行してもファイ
ルが上書きされなくなるからです。
削除
データフローの実行終了時に作業フォルダ内のファイルを削除します。
13. モニターするフォルダの指定が完了したら、[OK] をクリックします。
管理ガイド
87
ジョブとプロセス フロー
ジョブの一時停止
ジョブの一時停止および再開は、Enterprise Designer または Management Console で行うことができ
ます。
• Enterprise Designer を使用してジョブを一時停止するには
a) [表示] > [実行履歴] を選択します。
b) [一時停止] をクリックします。
c) 一時停止したジョブを再開するには、[再開] をクリックします。
• Management Console を使用してジョブを一時停止するには
a) [実行] を展開し、[履歴] をクリックします。
b) [ジョブ] タブをクリックします。
c) 一時停止するジョブを選択し、[一時停止] をクリックします。
d) ジョブの実行を再開するには、[再開] をクリックします。
ジョブまたはプロセス フローのキャンセル
ジョブまたはプロセス フローのキャンセルは、Enterprise Designer または Management Console で行
うことができます。
• Enterprise Designer を使用してジョブまたはプロセス フローをキャンセルするには、[表示] > [実行
履歴] を選択して [キャンセル] をクリックします。
• Management Console を使用してジョブまたはプロセス フローをキャンセルするには、以下の手順
に従います。
a) Management Console を開きます。
b) [実行] を展開し、[履歴] をクリックします。
c) ジョブをキャンセルする場合は [ジョブ] タブを、プロセス フローをキャンセルする場合は [プロ
セス フロー] タブをクリックします。
d) キャンセルするジョブを選択し、[キャンセル] をクリックします。
実行ステータスと履歴の表示
Management Console では、ジョブとプロセス フローの履歴を表示できます。 実行履歴には、データ
フローとプロセス フローの実行日時、正しく実行されたかどうか、処理されたレコードの数などの情
報が表示されます。
1. 実行ステータスと履歴は、Enterprise Designer または Management Console で表示できます。
• Enterprise Designer で実行ステータスを表示するには、[表示] > [実行履歴] を選択します。
• Management Console で実行ステータスを表示するには、[実行] を展開してから [履歴] をクリッ
クします。
2. ジョブの実行履歴を表示するには、[ジョブ] タブをクリックします。 プロセス フローの実行履歴
を表示するには、[プロセス フロー] タブをクリックします。
[ジョブ] タブでは、ジョブ ステータスの監視、実行中のジョブの一時停止、再開、またはキャン
セル、完了したジョブの削除を行います。
注 : [ジョブ] タブに表示されるレコード数は、データフローのすべてのシンクによって出力とし
て書き出されるレコードの総数です。 データフローにおいてレコードが結合または分割され
たり、新しいレコードが作成されたりする場合は、この数は入力レコード数とは異なる可能
性があります。
88
Spectrum™ Technology Platform 9.0 SP3
第 5 章 : 実行の管理
• [正常終了] 列には、データフローのすべてのシンクによって出力として書き出されるレコード
で、[ステータス] フィールドの値が空であるものの総数が表示されます。
• [失敗] 列には、データフローのシンクによって出力として書き出されるレコードで、[ステータ
ス] フィールドの値が F であるものの総数が表示されます。
• [形式誤り] 列には、ソース ステージのすべてのエラー ポートからのレコードの総数が表示され
ます。
[プロセス フロー] タブでは、プロセス フロー ステータスの監視、実行中のプロセス フローのキャ
ンセル、完了したプロセス フローの削除を行います。 [プロセス フロー] タブには、ProcessID 番
号、ProcessFlowID 名、プロセス フローを開始したユーザ名、プロセス フローの開始および終了
時間、およびサーバーから返されたコメント (存在する場合) がグリッド形式で表示されます。 こ
の情報は自動的に収集されます。 各プロセス フローの横にある [+] 記号をクリックすると、その
プロセス フローのアクティビティ ステータス情報が表示されます。 このエリアには、次の情報が
表示されます。
アクティビティ名
成功アクティビティを含む、プロセス フローを構成するすべてのアク
ティビティの名前が含まれます
State
アクティビティのステータスです (失敗、成功、実行中、キャンセル)
リターン コード
アクティビティを実行したときに返されたコードです
開始
アクティビティが開始した日時です
終了
アクティビティが終了した日時です
Comment
アクティビティに関するコメントです
3. [実行履歴] で表示するフィールドを選択するには、最初の列のすぐ左にあるアイコン
クします。
をクリッ
4. 実行履歴では情報の種類をグループにまとめることができます。 列の名前 ([ID] や [名前] など) を
ハイライト表示し、[列ヘッダをここにドラッグすると、その列でグループ化されます。] という領
域にドラッグします。すると、その情報の種類でグループ化されて情報が表示されます。
5. 列名をクリックすることにより、グリッド内のデータをソートできます。 以下の手順に従って、
データにフィルタを適用し、表示されるプロセス フローの一覧を変更します。
a) [次のプロセス フローのみ表示] の下のドロップダウン リストをクリックし、変数 (ProcessID
など) を選択します。
b) 次のドロップダウン リストから条件 ("以上" など) を 1 つ選択します。
c) 最後のボックスに、比較する値 (ゼロなど) を入力します。
d) [更新] をクリックしてデータを更新します。
6. [詳細] 画面では、データフローを表示する、ジョブ定義やプロセス フロー定義を参照できます。
また、もう Enterprise Designer ではアクセスできないデータフローについて、それをどのように
して構成したかを参照することもできます。
a) 表示するジョブまたはプロセス フローをクリックして、[詳細...] をクリックします。
左のウィンドウに、実行情報やフロー定義を表示するために選択したジョブまたはプロセス フ
ローの名前が表示されます。 [実行情報] 内では、プロセス フロー内の任意のアクティビティを
選択できます。
b) 左のウィンドウでジョブ/プロセス フロー定義をクリックすると、そのフローの処理設定が参照
できます。
実行履歴のエクスポート
Management Console の [実行履歴] ウィンドウに表示される情報を Excel ファイルにエクスポートで
きます。
1. Management Console を開きます。
管理ガイド
89
ジョブとプロセス フロー
2. [実行] を展開し、[履歴] をクリックします。
3. ジョブの実行履歴をエクスポートする場合は、[ジョブ] タブをクリックします。 プロセス フロー
の実行履歴をエクスポートする場合は、[プロセス フロー] をクリックします。
4. [エクスポート] をクリックし、エクスポートされたファイルを保存する場所を選択します。
ヒント : 特定のレコードのみをエクスポートする場合は、履歴をエクスポートするジョブまたは
プロセス フローのみが表示されるようにフィルタ設定を変更します。
形式に誤りのあるレコード数の最大値のデフォルトの設定
形式に誤りのあるレコードをいくつ検出したら、ジョブの処理を停止するかを指定できます。 例え
ば、50 個と指定した場合、形式に誤りのあるレコードを 50 個以上含むジョブは、処理を正常に完了
することはできません。
この手順では、システム上のジョブに対して形式に誤りのあるレコード数の最大値のデフォルトを設
定する方法について説明します。
注 : Enterprise Designer でジョブを開き、[編集] > [ジョブ オプション] に移動して、形式に誤りのあ
るレコード数の最大数のデフォルトをオーバーライドできます。
1. Management Console を開きます。
2. Execution を展開し、[ジョブ オプション] をクリックします。
3. 次のオプションのいずれかを選択します。
• [形式に誤りのある入力レコードでジョブを停止しない] — ジョブに含まれる形式に誤りのある
レコードの数に上限を設けない場合は、このオプションを選択します。
• [形式に誤りのあるレコードを次の個数検出した時点でジョブを停止]—形式に誤りのあるレコー
ドを一定の個数検出した時点でジョブを停止するには、このオプションを選択します。 ジョブ
の処理を停止する前に検出してもよい形式に誤りのあるレコードの個数を入力します。
デフォルト レポート オプションの設定
ジョブにレポート ステージが含まれている場合、そのジョブは、データフローで指定されたとおりに
レポート ファイルを生成します。 レポートには、処理の概要や、USPS CASS 3553 フォームなどの
郵便フォームを含めることができます。 一部のモジュールには、定義済みレポートが付属していま
す。 カスタム レポートを作成することもできます。
Management Console において、システムに対するデフォルト レポート オプションを設定できます。
システムに対するデフォルト レポート オプションはオーバーライドが可能です。 Enterprise Designer
において、特定のジョブ、またはジョブ内の特定のレポートに対するオプションをオーバーライドで
きます。
システムに対するデフォルト レポート オプションを設定する手順は以下のとおりです。
1. Management Console を開きます。
2. [実行] を展開し、[レポート オプション] をクリックします。
3. レポート形式として、html、pdf、または txt を選択します。
4. [レポート スナップショットの保存] ボックスをオンにすると、実際のレポート スナップショット
とともにレポートが登録されていることを示す情報が保存されます。
5. レポート スナップショットを保存する場合は、[レポートのアーカイブ] ボックスをオンにします。
[レポートのアーカイブ場所] フィールドで、アーカイブされたレポートを保存する場所を指定しま
す。
6. 新しいレポートで前のレポートを置き換える場合は、[既存のレポートを上書き] をオンにします。
90
Spectrum™ Technology Platform 9.0 SP3
第 5 章 : 実行の管理
7. 名前付けテンプレートを完成させて、レポートの命名方法を指定します。
サービス
サービスは、Web サービスとして、または Spectrum™ Technology Platform API を使用して、アクセ
スできるデータフローです。 レコードをサービスに渡し、レコードを処理する際に使用するオプショ
ンを任意で指定できます。 サービスはデータを処理し、そのデータを返します。
一部のサービスは、モジュールをインストールしたときに使用可能になります。 例えば、Universal
Addressing モジュールをインストールすると、お使いのシステム上で ValidateAddress サービスが使
用可能になります。 Enterprise Designer でサービスを作成し、そのサービスをシステム上でユーザ定
義サービスとしてエクスポーズしなければならない場合もあります。 例えば、Location Intelligence モ
ジュールのステージは、このモジュールのステージを使用するサービスをまず作成しなければ、サー
ビスとして使用できません。
デフォルト サービス オプションの指定
デフォルト サービス オプションは、システム上の各サービスのデフォルトの動作を制御します。 サー
ビス内の各オプションのデフォルト値を指定できます。 デフォルト オプション設定は、API 呼び出し
または Web サービス リクエストで、オプションの値が明示的に定義されていない場合に有効です。
また、デフォルト サービス オプションは、Enterprise Designer でこのサービスを使用してデータフ
ローを作成する際にデフォルトとして使用される設定です。
1. Management Console を開きます。
2. [モジュール] を展開し、次にデフォルト オプションを指定するサービスを含むモジュールを展開
します。
3. デフォルト オプションを指定するサービスをクリックします。
4. サービスのオプションを設定します。
5. [ファイル] > [保存] を選択します。
サービスのプレビュー
[プレビュー] タブを使用して、サービスの結果をプレビューできます。 プレビューは、どのオプショ
ンを指定するかを決める際に便利です。異なるオプションが、サービスから返されるデータに与える
影響を直ちに確認できるためです。
1. Management Console を開きます。
2. Management Console の左側で、サービスを選択します。
3. [プレビュー] タブをクリックします。
4. テスト入力データを手動で入力するか、ファイルからデータをインポートします。 すべてのフィー
ルドにデータを入力する必要はありません。 必要に応じて、フィールドを空白のままにすること
ができます。
• データを手動で入力する場合は、単に各フィールドにテストデータを入力していきます。
• データをファイルからインポートする場合は、[データのインポート] ボタンをクリックします。
インポートできるレコードの最大数は、システムで設定されている処理レコードの最大数までと
なります。 詳細については、プレビュー用にインポートするレコード数の上限値の設定（92ペー
ジ）を参照してください。
注 : 日付または時間データをインポートすると、プレビューするデータのパースに日付および
時間タイプ変換オプションが使用されます。
管理ガイド
91
サービス
5. [プレビューを実行] をクリックします。 データが、出力グリッドに表示されます。
6. 出力データをプレビューして、適切な結果が得られることを確認します。 必要に応じて、サービ
スの設定に変更を加えて、[プレビューを実行] を再度クリックすることができます (データを再度
入力する必要はありません)。
デフォルトでは垂直表示です。 垂直表示に変更する場合は、[表示] をクリックして [垂直方向] を
選択します。
プレビュー用にインポートするレコード数の上限値の設定
Management Console または Interactive Driver において、サービスのプレビューに使用するデータを
ファイルからインポートする場合、インポート可能なレコード数には上限があります。 デフォルトで
は、ファイルからインポートできるレコードは最大 5 個です。 以下の手順によって、この上限値が変
更できます。
1. Management Console または Interactive Driver を開きます。
2. [ツール] > [オプション] をクリックします。
3. [設定のプレビュー] タブをクリックします。
4. [処理するレコードの最大数] フィールドに、サービス プレビューにインポートするレコードの最
大数を入力します。 入力可能な数の最大値は 100 です。
フィールド区切り文字の指定
フィールド区切り文字とは、サービスへの入力としてフラット ファイルを使用する場合に、1 つの
フィールドの末尾と次のフィールドの先頭を表すために使用される文字のことです。 API または Web
サービスからサービスに対して作成される呼び出しでフィールド区切り文字として使用する文字を指
定できます。
サービスで使用するフィールド区切り文字を指定するには、次の手順に従います。
1. Management Console を開きます。
92
Spectrum™ Technology Platform 9.0 SP3
第 5 章 : 実行の管理
2. [ツール] > [オプション] をクリックします。
3. [サービス実行の設定] タブをクリックします。
4. [ファイル フィールド区切り文字] フィールドに、使用する区切り文字を指定します。 使用したい
文字が一覧にない場合は、
a) [. . . ボタンをクリックします。
b) [追加] をクリックします。
c) 文字を入力または選択したら、Tab を押します。 [Unicode] フィールドは自動的に入力されま
す。 また、Unicode 値を入力することもできます。この場合は、[文字] フィールドが自動的に
入力されます。
d) 必要に応じて、[説明] フィールドに、文字の説明を入力します。 例えば、文字が "&" の場合、
説明には "アンパサンド" と入力できます。説明を入力しない場合は、その文字のみが使用可能
な文字の一覧に表示されます。
e) [OK] を 2 回クリックします。
サービス タイムアウトの設定
1. Management Console を開きます。
2. [ツール] > [オプション] をクリックします。
3. [サービス実行の設定] タブをクリックします。
4. [タイムアウト (秒)] フィールドで、サービスがタイムアウトするまでにレスポンスを待つ秒数を指
定します。
サービスの最適化
Spectrum™ Technology Platform サービスを呼び出す方法は多数あり、そのいくつかは他に比べてパ
フォーマンスに優れています。‎Spectrum™ Technology Platform サービスを呼び出すさまざまな方法
を最も速いものから順に並べると、おおよそ次のようになります。
• ソケットを使用したクライアント API
• HTTP を使用したクライアント API
• HTTPS を使用したクライアント API
• HTTP を使用した XML
• Web サービス - HTTP を使用した SOAP および REST
一般的に、クライアント API によるサービスの起動は、Web サービスの呼び出しより速くなります。
ネットワーク プロトコルは、サービス呼び出しのラウンドトリップ タイムに大きな影響を与えること
があります。例えば、HTTP の代わりに持続的なソケット接続を使用すると、応答時間を 30% ～ 50%
向上させることができます。
リアルタイム アプリケーションによる Spectrum™ Technology Platform サービス呼び出しのパフォー
マンスは、アプリケーションがシングルスレッドかマルチスレッドか、またサーバーがサービス要求
を満たすだけのリソースを使用できるかどうかにも依存します。シングルスレッドのクライアント ア
プリケーションでは、リモート コンポーネントのインスタンスやステージの実行時インスタンスを追
加で指定しても、応答時間に及ぼす影響は最小限です。マルチスレッドのクライアント アプリケー
ションは、通常、リモート コンポーネント インスタンスおよび実行時インスタンスを複数にする (最
大で同時並行スレッド数) ことによって恩恵を受けます。
関連リンク
データベース リソースのプール サイズの設定（70ページ）
管理ガイド
93
リモート サーバー
トランザクション履歴
トランザクション履歴には、指定した日付範囲におけるサービスの使用状況に関するデータが表示さ
れます。 データは、サービスまたはユーザごとにまとめられ、ソートされます。
トランザクション履歴の表示
1. Management Console を開きます。
2. [トランザクション履歴] を展開し、[レポート] をクリックします。
3. レポートの日付範囲を選択します。 以下のオプションから選択できます。
すべての日
すべてのトランザクションの履歴レポートが含まれます。
この日以前 (この日を含む)
終了日を入力すると、その日までのトランザクションが含まれま
す。
この日以降 (この日を含む)
開始日を入力すると、その日からのトランザクションが含まれま
す。
この日からこの日まで
開始日と終了日の両方を入力すると、その 2 つの日付の間のト
ランザクションが含まれます。
4. [レポートの表示] をクリックして、レポートを実行し、表示します。 指定した日付範囲のトラン
ザクション履歴レポートが表示されます。 このレポートには、サービスおよびユーザごとに、各
サービスへの呼び出しの成功数、失敗数、エラー数が示されます。
5. レポートを外部ファイルに保存する場合は、[エクスポート] ボタンをクリックします。
トランザクション履歴オプションの設定
1. Management Console を開きます。
2. [トランザクション履歴] を展開し、[オプション] をクリックします。
3. [トランザクション履歴追跡を有効にする] チェック ボックスをオンにします。 サービスおよびサー
バーに対するその後のすべてのトランザクションが記録されることになります。
4. トランザクションをログから削除するには、[これまでに発生したすべてのトランザクション ログ
エントリをクリア] の横のドロップダウン ボックスをクリックし、日付 (MM/DD/YYYY) を入力す
るか、下に表示されるカレンダーから日付を選択します。
5. [クリア] をクリックして、トランザクションを削除します。
リモート サーバー
Spectrum™ Technology Platform を複数のサーバーで実行している場合、特定のサービスに対する処
理を別のサーバーにルーティングすることで、サーバー間に処理を分散できます。 この機能を使用す
ると、ローカル以外のサーバーで使用できるサービスにアクセスできるので、サービスをインストー
ルして管理する時間を短縮できます。 また、リモート サーバーにインストールされているサービスを
使用するカスタム データフローを設計できます。 別のサーバーへサービスが送られると、そのサービ
スがデータフロー内にある、Interactive Driver から実行された、または Spectrum™ Technology Platform
API を通してコールされた場合であっても、サービスの実行場所はリモート サーバーへ移ります。
サービスをルーティングできるかどうかを確認するには、Management Console を開き、そのサービ
スをクリックして、[オプション] タブの下部にある [ルーティング] ボタンが有効になるかどうかを調
べます。
94
Spectrum™ Technology Platform 9.0 SP3
第 5 章 : 実行の管理
注 : リモート サーバーのモジュールでバッチ データフローを実行するには、リアルタイム ライセン
スがリモート マシンに必要です。
特定の製品で展開されるツールは、製品が物理的にインストールされているマシンでのみ使用できま
す。 例えば、Enterprise Geocoding モジュールがローカル サーバーとリモート サーバーの両方にイ
ンストールされている場合、そのモジュールのツールはローカル サーバー バージョンに対してのみ表
示されます。 Enterprise Geocoding モジュールをリモート サーバーでのみ実行している場合、ツール
は一つも表示されません。
リモート サーバーの追加
リモート サーバーを追加するには、次の手順に従います。
1. Spectrum™ Technology Platform を別のサーバーにインストールします。 これがリモート サーバー
になります。 インストール手順については、『Spectrum™ Technology Platform インストール ガ
イド』を参照してください。
2. Management Console を開きます。
3. [システム] の下の [リモート サーバー] を選択します。
4. [追加] をクリックします。
5. [名前] フィールドにリモート サーバーの名前を入力します (必須)。
6. [ホスト] フィールドにリモート サーバーのホスト名または IP アドレスを入力します (必須)。
7. [ポート] フィールドにポート番号を入力します (必須)。
8. [ユーザ名] フィールドにリモート サーバーの有効なユーザ名を入力します (必須)。
9. [パスワード] フィールドに入力したユーザ名の有効なパスワードを入力します (サーバーで必要な
場合は必須)。
10. [マイクロバッチ サイズ] フィールドに、一度に渡されるレコードの数 (1 ～ 99) を入力します (必
須)。 デフォルトは 50 です。 このフィールドに大きい値を入力すると、入力と出力は速くなりま
すが、データ転送は遅くなります。
11. [タイムアウト] フィールドに、接続がタイムアウトする秒数 (1 ～ 99) を入力します (必須)。 デフォ
ルト値は 2 です。
12. 接続しようとしているリモート サーバーが HTTPS アクセスだけを許可するファイアウォールの内
側にある場合は、[Secure Sockets Layer を使用] ボックスをオンにします。
13. 接続をテストする場合は、[テスト] ボタンをクリックします。 リモート サーバーが正常に追加さ
れた場合は、"リモート サーバー接続テストに成功しました" というメッセージが表示されます。
リモート サーバーのテストが失敗した場合は、"リモート サーバー構成テストに失敗しました" と
いうメッセージと失敗の理由が表示されます。
リモート サーバーのテストにかかる時間が予想より長い場合は (テストが失敗することを意味しま
す)、[停止] ボタンをクリックできます。
14. [OK] をクリックします。
15. リモート サーバーでサービスを追加または削除した後、[更新] をクリックして Management Console
を更新します (リモート サーバーを追加、変更、または削除したときは、Management Console は
自動的に更新されます)。
関連リンク
リモート サーバー（94ページ）
リモート サーバーのエラーのトラブルシューティング（97ページ）
管理ガイド
95
リモート サーバー
リモート サーバーへのサービスのルーティング
[ルーティング] ボタンを使用すると、ステージまたはサービスの処理に対して使用する異なるサーバー
を指定でき、サービスをインストールして管理する時間を節約できます。 また、リモート サーバーに
インストールされているサービスおよびステージを使用するカスタム データフローを設計できます。
注 : Enterprise Designer または Spectrum™ Technology Platform API で、サービスのリモート サー
バー設定をオーバーライドできます。 Interactive Driver ではリモート サーバー ルーティングを
オーバーライドできません。Interactive Driver は、Management Console で指定されているリ
モート サーバー ルーティングを使用します。
サービスまたはステージをリモート サーバーにルーティングするには、次の手順に従います。
1. Management Console を開きます。
2. リモート サーバーにルーティングするサービスを選択します。
3. [オプション] タブで [ルーティング] をクリックします。 [ルーティング] ボタンがグレー表示され
ている場合は、そのモジュールにはルーティングを使用できません。 [ルーティング] ダイアログ
ボックスが表示されます。
4. [リモート] をクリックし、そのステージの処理をルーティングするリモート サーバーを選択しま
す。
5. OK をクリックします。
ローカル サーバーでは使用できないサービスまたはステージを含むリモート サーバーを追加すると、
そのリモート サーバーのデフォルト オプションが使用されます。
リモートの Management Console でサービスまたはステージを変更しても、ローカル サーバーに変更
は反映されません。 ローカルの Management Console では、ローカルのデフォルト オプションが使
用されます。
関連リンク
リモート サーバー（94ページ）
リモート サーバーのエラーのトラブルシューティング（97ページ）
リモート サーバーの変更
リモート サーバーを変更するには、次の手順に従います。
1. Management Console を開きます。
2. [システム] の [リモート サーバー] サブノードを選択します。 [リモート サーバー] ダイアログ ボッ
クスが表示されます。
3. 更新するサーバーをハイライト表示にして、[変更] をクリックします。 [リモート サーバーの変更]
ダイアログ ボックスが表示されます。
4. サーバーを適切に変更し、[OK] をクリックします。
5. リモート サーバーでモジュールを追加または削除した後、[更新] をクリックして Management
Console を更新します (リモート サーバーを追加、変更、または削除したときは、Management
Console は自動的に更新されます)。
リモート サーバーの削除
接続を削除するには、次の手順に従います。
注 : 依存するデータフローを使用しているユーザがいる場合は、リモート サーバーを削除できませ
ん。
96
Spectrum™ Technology Platform 9.0 SP3
第 5 章 : 実行の管理
1. Management Console を開きます。
2. [システム] の [リモート サーバー] サブノードを選択します。 [リモート サーバー] ダイアログ ボッ
クスが表示されます。
3. 更新するサーバーをハイライト表示にして、[削除] をクリックします。
4. サーバーを削除するかどうかを尋ねる確認メッセージが表示されます。 [OK] をクリックして確認
します。
5. リモート サーバーでモジュールを追加または削除した後、[更新] をクリックして Management
Console を更新します (リモート サーバーを追加、変更、または削除したときは、Management
Console は自動的に更新されます)。
6. リモート サーバーを削除すると、そのリモート サーバーを参照しているデータフローが正しく機
能しなくなります。 ルーティングされるサービスまたはステージを含むリモート サーバーを削除
した場合は、そのサービスまたはステージのルーティングの変更を求められます。
• 影響を受けるサービス、ステージ、データフローが使用できなくなるのを防ぐには、削除される
サーバーを置き換えるサーバーを望ましい順序に再設定した後、[次へ] をクリックします。
• 削除したリモート サーバーを使用するデータフローがある場合は、[データフロー参照の確認]
ダイアログ ボックスが表示されます。
• 削除したリモート サーバーを使用するサービスまたはステージがある場合は、[サービス参照の
確認] ダイアログ ボックスが表示されます。
• これらのダイアログ ボックスの情報を確認し、データフローまたはサービスが使用していたサー
バーを変更します。 [終了] をクリックします。
リモート サーバーのエラーのトラブルシューティング
ここでは、リモート サーバーの使用中に発生する可能性があるエラーについて説明します。
モジュールのライセンスがない
モジュールでリモート サーバーの要求を実行するには、リモート サーバーがリアルタイム ライセン
スを持っている必要があります。 ジョブの実行を試行したときに、リモート サーバーがモジュールの
リアルタイム ライセンスを持っていない場合は、次のようなエラーが表示されます。
StageException: No license for stage GetCandidateAddresses on remote server
myremoteserver. A realtime license is required.
リモート サーバーは使用できません
リモート サーバーが実行されていない場合、またはリモート サーバーが何かの理由で到達不能な場
合、Enterprise Designer と Management Console ではリモート サービスを使用できません。 画面下
部のステータス バーに黄色のハザード アイコンが表示されます。
このアイコンをクリックすると、使用できないリモート サーバーについて説明するエラー メッセージ
が表示されます。
また、Enterprise Designer では、リモート ステージを使用するすべてのステージが、今後ステージを
使用できないことを示すアイコンに置き換えられます。
管理ガイド
97
デフォルトのタイプ変換オプションの設定
ルーティングが変化した
ローカルとリモートの両方にインストールされていて、リモート サーバーにルーティングされるサー
ビスを、削除または展開解除した後、Management Console でそのサービスをクリックすると、その
サービスの [オプション] タブのルーティング ボタンの横に、ルーティング変更インジケータ (点滅す
る感嘆符) が表示されます。 このインジケータは、そのサービスのルーティングが変化したことを意
味します。
関連リンク
リモート サーバー（94ページ）
リモート サーバーの追加（95ページ）
リモート サーバーへのサービスのルーティング（96ページ）
デフォルトのタイプ変換オプションの設定
Spectrum™ Technology Platform では、データフロー内の各ステージで必要となるデータ タイプにデー
タを自動的に変換します。 また、データは文字列と数値の間で、また、Read from File などの一部の
ステージでは文字列と日付/時間データ タイプの間で変換できます。 デフォルトでは、データ タイプ
変換が失敗すると、データフローは Management Console で指定されているデフォルトのデータ タイ
プ変換オプションを使用します Enterprise Designer では、必要に応じて個別のデータフローのデフォ
ルト動作をオーバーライドできます。
システムにデフォルトのタイプ変換オプションを設定するには、次の手順に従います。
1. Management Console を開きます。
2. [実行] メニューから [タイプ変換オプション] をクリックします。
3. 次のいずれかのオプションを選択して、データ タイプ変換オプションの処理方法を選択します。
これらのオプションでは、Spectrum™ Technology Platform がフィールドのデータをステージで必
要なデータ タイプに変換できないときの処理を指定します。
データフローの処理を失敗
として扱う
フィールドを変換できない場合、データフローは失敗します。
レコードのエラー
フィールドを変換できない場合、レコードは失敗しますが、データ
フローの実行は続行されます。
フィールドをデフォルト値
で初期化する
フィールドを変換できない場合、フィールドの値はここで指定する
値に置き換えられます。 一部のレコードに不正なデータが含まれる
ことがわかっていて、不正なデータをデフォルト値に置き換える場
合、このオプションが役に立ちます。 各データ タイプの値を指定
します。
4. 文字列に変換する日付および時間データで使用する形式を指定します。 日付または時間を文字列
に変換する場合、文字列にはここで指定する形式が使用されます。
a) [ロケール] フィールドで、文字列に変換する日付で使用する形式を持つ国を選択します。 [日
付]、[時間]、および [DateTime] フィールドのデフォルト値は、ここでの選択によって決まり
ます。 また、月のスペルを表記するときの言語も、ここでの選択によって決まります。 例え
ば、英語を指定した場合、1 年の最初の月は "January" ですが、フランス語を指定した場合は
"Janvier" になります。
b) [日付] フィールドで、日付データを文字列に変換するときに使用する形式を指定します。 選択
したロケールで最も一般的に使用される形式の一覧が表示されます。
98
Spectrum™ Technology Platform 9.0 SP3
第 5 章 : 実行の管理
例えば、形式として [M/D/YY] を選択し、日付フィールドに 2012-3-2 が含まれている場合、日
付データは文字列 3/2/12。
c) [時間] フィールドで、時間データを文字列に変換するときに使用する形式を指定します。 選択
したロケールで最も一般的に使用される形式の一覧が表示されます。
例えば、形式として [h:mm a] を選択し、時間フィールドに 23:00 が含まれている場合、時間
データは文字列 11:00 PM。
d) [DateTime] フィールドで、DateTime データ タイプを含むフィールドを文字列に変換するとき
に使用する形式を選択します。 選択したロケールで最も一般的に使用される形式の一覧が表示
されます。
例えば、形式として [M/d/yy h:mm a] を選択し、DateTime フィールドに 2012-3-2 23:00 が含
まれている場合、DateTime データは文字列 3/2/12 11:00 PM。
e) [数値型] フィールドで、数値型 (Float および Double データ タイプ) で使用する書式設定を選
択します。
例えば、形式 [#,###] を選択すると、数字 4324 は4,324。
注 : このフィールドを空白にしておくと、数字には Spectrum™ Technology Platform 8.0 以降
と同じ形式が使用されます。 特に、桁区切り文字は使用されません。小数点記号として
-3
7
ドット (".") が使用されます。10 未満または 10 以上の数字は指数表示されます。負の
数には先頭にマイナス記号 ("-") が付きます。 また、このフィールドを空白にしておくと、
BigDecimal データ タイプを使用する数字には常に形式 #,###.000 が使用されます。
f) [Decimal] フィールドで、Decimal (Integer および Long データ タイプ) を含む数字で使用する
書式設定を選択します。
例えば、形式 [#,##0.0#] を選択すると、数字 4324.25 は4,324.25。
注 : このフィールドを空白にしておくと、数字には Spectrum™ Technology Platform 8.0 以降
と同じ形式が使用されます。 特に、桁区切り文字は使用されません。小数点記号として
-3
7
ドット (".") が使用されます。10 未満または 10 以上の数字は指数表示されます。負の
数には先頭にマイナス記号 ("-") が付きます。 また、このフィールドを空白にしておくと、
BigDecimal データ タイプを使用する数字には常に形式 #,###.000 が使用されます。
また、ニーズを満たす形式がない場合は、独自の日付、時間、および数値形式を指定することもで
きます。 独自の日付または時間形式を指定するには、日付および時間パターン（99ページ） に記
載される表記を使用して、その形式をフィールドに入力します。 独自の数値形式を指定するには、
数字パターン（101ページ） に記載される表記を使用して、形式をファイルに入力します。
日付および時間パターン
日付および時間データのデータ タイプ オプションを定義する場合、あらかじめ定義されているオプ
ションでニーズを満たすことができないときは、独自の日付または時間パターンを作成できます。 日
付または時間パターンを作成するには、次の表に記載される表記法を使用します。 例えば、次のパ
ターンを使用します。
dd MMMM yyyy
これは、次のような日付を生成します。
14 December 2012
文字
説明
例
G
年代指示子
AD
管理ガイド
99
デフォルトのタイプ変換オプションの設定
100
文字
説明
例
yy
年数の 2 桁表記
96
yyyy
年数の 4 桁表記
1996
M
月の数字表記。
7
MM
月の数字表記。 数字が 10 未満の場合は、2 桁の 07
数字にするためにゼロが付加されます。
MMM
月の名前の短縮表記
Jul
MMMM
月の名前の完全表記
July
w
年の週数
27
ww
年の週数の 2 桁表記。 週が 10 未満の場合はゼロ 06
が付加されます。
W
月の週数
2
D
年の日数
189
DDD
年の日数の 3 桁表記。 数字が 3 桁未満の場合は
ゼロが付加されます。
006
d
月の日数
10
dd
月の日数の 2 桁表記。 数字が 10 未満の場合はゼ 09
ロが付加されます。
F
週の日数
2
E
曜日の短縮表記
Tue
EEEE
曜日の完全表記
Tuesday
a
AM/PM マーカー
PM
H
1 日の時間。最初の時間は 0 で表記し、最後の時 0
間は 23 で表記
HH
1 日の時間の 2 桁表記。最初の時間は 0 で表記
し、最後の時間は 23 で表記します。 数字が 10
未満の場合はゼロが付加されます。
k
1 日の時間。最初の時間は 1 で表記し、最後の時 24
間は 24 で表記
kk
1 日の時間の 2 桁表記。最初の時間は 1 で表記
し、最後の時間は 24 で表記します。 数字が 10
未満の場合はゼロが付加されます。
K
午前中 (AM) または午後 (PM) の時間。最初の時間 0
は 0 で表記し、最後の時間は 11 で表記
KK
1 日の時間の 2 桁表記。最初の時間は 1 で表記
し、最後の時間は 24 で表記します。 数字が 10
未満の場合はゼロが付加されます。
08
02
02
Spectrum™ Technology Platform 9.0 SP3
第 5 章 : 実行の管理
文字
説明
例
h
午前中 (AM) または午後 (PM) の時間。最初の時間 12
は 1 で表記し、最後の時間は 12 で表記します。
hh
午前中 (AM) または午後 (PM) の時間の 2 桁表記。 09
最初の時間は 1 で表記し、最後の時間は 12 で表
記します。 数字が 10 未満の場合はゼロが付加さ
れます。
m
1 時間の分数
mm
1 時間の分数の 2 桁表記。 数字が 10 未満の場合 05
はゼロが付加されます。
s
1 分の秒数
ss
1 分の秒数の 2 桁表記。 数字が 10 未満の場合は 02
ゼロが付加されます。
S
1 秒のミリ秒数
SSS
1 秒のミリ秒数の 3 桁表記。 数字が 3 桁未満の場 978
合は、3 桁にするために 1 つまたは 2 つのゼロが 078
008
付加されます。
z
時間帯の名前の省略形。 時間帯に名前がない場合 PST
GMT-08:00
は GMT オフセットを使用
zzzz
時間帯の名前の完全表記。 時間帯に名前がない場 太平洋標準時
GMT-08:00
合は GMT オフセットを使用
Z
RFC 822 時間帯
-0800
X
ISO 8601 時間帯
-08Z
XX
分を付加した ISO 8601 時間帯
-0800Z
XXX
分、およびコロン区切り文字を時間と分の間に付 -08:00Z
加した ISO 8601 時間帯
30
55
978
関連リンク
デフォルトのタイプ変換オプションの設定（98ページ）
数字パターン
数値データのデータ タイプ オプションを定義する場合、あらかじめ定義されているオプションでニー
ズを満たすことができないときは、独自の数字パターンを作成できます。 基本的な数字パターンは、
次の要素で構成されます。
• 通貨記号などの接頭辞 (オプション)
• オプションのグループ文字を含む数字のパターン (例えば、桁区切り文字として使用するカンマ)
• 接尾辞 (オプション)
例えば、次のパターンを使用します。
$ ###,###.00
管理ガイド
101
デフォルトのタイプ変換オプションの設定
次のような形式の数字が生成されます (最初の 3 桁の数字の後に桁区切り文字を使用していることに注
意)。
$232,998.60
負の数のパターン
デフォルトでは、負の数は、正の数と同じ形式で表記されますが、数字の先頭に負記号が追加されま
す。 数字記号に使用される文字はロケールに基づきます。 マイナス記号 "-" は、ほとんどのロケール
で使用されます。 例えば、次の数字パターンを指定するとします。
0.00
マイナス 10 は、ほとんどのロケールで次の形式で表記されます。
-10.00
ただし、負の数に使用する別の接頭辞または接尾辞を定義する場合は、2 つ目のパターンを指定し、
そのパターンと 1 つ目のパターンをセミコロン (";") で区切ります。 例:
0.00;(0.00)
このパターンでは、負の数は、次のように括弧で囲んで表記されます。
(10.00)
指数表記
数字を指数表示する場合は、文字 E の後に続けて、指数に含める最小桁数を指定します。 例えば、次
のパターンを使用するとします。
0.###E0
数字 1234 は、次のような形式で表記されます。
1.234E3
3
つまり、これは 1.234 x 10 を表します。
次のことに注意してください。
• 指数文字の後に続く桁数は、指数の最小桁数を表します。 最大桁数はありません。
• 負の指数は、このパターンの接頭辞や接尾辞ではなく、ローカライズされた負の記号を使用した形
式で表記されます。
• 指数表記パターンにグループ区切り文字 (桁区切り文字など) を含めることはできません。
特殊な数字パターン文字
次の文字は、その文字自体では別の文字を表しますが、実際には結果の数字で再現されます。 次の特
殊文字を数字パターンの接頭辞または接尾辞のリテラル文字として使用する場合は、特殊文字を引用
符で囲みます。
記号
説明
0
必要な位置にゼロを含むパターン内の桁を表します。 例えば、数字
27 に次のパターンを適用するとします。
0000
次のように表されます。
0027
102
Spectrum™ Technology Platform 9.0 SP3
第 5 章 : 実行の管理
記号
説明
#
桁を表しますが、ゼロは省略されます。 例えば、数字 27 に次のパター
ンを適用するとします。
####
次のように表されます。
27
.
選択したロケールで使用される小数点記号または通貨区切り文字。 例
えば、米国の場合、 小数点記号にはドット (.) が使用されますが、フ
ランスの場合、小数点記号にはカンマ (,) が使用されます。
-
選択したロケールで使用される負の記号。 ほとんどのロケールでは、
マイナス記号 (-) が使用されます。
,
選択されたロケールで使用されるグループ文字。 選択されたロケール
の適切な文字が使用されます。 例えば、米国の場合、区切り文字には
カンマ (,) が使用されます。
一般に、グループ区切り文字は千の位を区切るのに使用されますが、
一部の国では一万の位を区切るのに使用されます。 グループのサイズ
は、グループ区切り文字間の桁数を指定する定数です。例えば、3 は
100,000,000、4 は 1,0000,0000 になります。 パターンに複数のグルー
プ区切り文字を指定すると、最後のグループ区切り文字と数値の末尾
との間隔が、使用される間隔です。 例えば、次のパターンはすべて同
じ結果を生成します。
#,##,###,####
######,####
##,####,####
E
指数表記の仮数と指数を区切ります。 パターン内で E を引用符で囲
む必要はありません。 指数表記（102ページ） を参照してください。
;
正のサブパターンと負のサブパターンを区切ります。 負の数のパター
ン（102ページ） を参照してください。
%
数字を 100 で乗算し、その数字をパーセンテージで表示します。 例
えば、数字 .35 に次のパターンを適用するとします。
##%
次のような結果が生成されます。
35%
¤
選択したロケールの通貨記号。 double の場合、国際通貨記号が使用
されます。 パターンで表す場合、小数点記号ではなく、通貨区切り文
字が使用されます。
'
接頭辞または接尾辞の特殊文字を引用符で囲むのに使用されます。 例:
"'#'#"
123 は次のように表記されます。
"#123"
管理ガイド
103
デフォルトのタイプ変換オプションの設定
記号
説明
単一引用符自体を作成するには、2 つの単一引用符を続けて使用しま
す。
"# o''clock"
関連リンク
デフォルトのタイプ変換オプションの設定（98ページ）
104
Spectrum™ Technology Platform 9.0 SP3
パフォーマンスの最適化
このセクションの構成
• パフォーマンス チューニングのチェックリスト . . . . . . . .106
• パフォーマンスのモニタリング . . . . . . . . . . . . . . . . . . . . .118
6
パフォーマンス チューニングのチェックリスト
パフォーマンス チューニングのチェックリスト
このチェックリストでは、パフォーマンス チューニングのための推奨アプローチ、および Spectrum™
Technology Platformのパフォーマンスを最適化するためのベスト プラクティスについて説明します。
各手法は、パフォーマンスに対する影響が最も高いものから最も低いものの順に記載されています。
パフォーマンス設定
説明
追加情報
データフロー設計
パフォーマンスに対する影響が最も高いの パフォーマンス最適化のための
は、データフローの設計です。 いくつかの 設計ガイドライン（106ページ）
ベスト プラクティスに従うことによって、
データフローのパフォーマンスを確実に高
めることができます。
データフローのプー
ル サイズ
データフローのプール サイズのデフォルト データフロー プール サイズの設
値は 8 です。 8 個を上回るデータフローの 定（107ページ）
インスタンスを同時に実行する予定の場合
は、データフローのプール サイズのデフォ
ルト値を同時インスタンス数と同じ数まで
増加させることができます。
データベース リソー
スのプール サイズ
と、ステージ実行時
インスタンス
データベース リソースのプール サイズと、 プール サイズと実行時インスタ
ステージの実行時インスタンスの設定は、 ンス設定のチューニング
複数の同時要求を処理するシステムの能力 （108ページ）
を制御します。 両者を連動させて調整する
必要があります。
リモート コンポーネ これらの設定は、住所検証やジオコーディ
ントのオプション
ングなどの特定のステージのメモリ使用率
を制御します。
リモート コンポーネントのオプ
ションの設定（111ページ）
個々のステージ
特定の種類の処理を最適化するために採用 個々のステージの最適化
できる、いくつかのアクションがあります。 （112ページ）
以下のいずれかを行うデータフローが存在
する場合は、パフォーマンスのベスト プラ
クティスを参照して、最適なパフォーマン
スが得られるようにデータフローが設定さ
れているかどうかを確認してください。
JVM 設定
特定のハードウェアにおいてパフォーマン JVM パフォーマンス チューニン
スを向上させることのできる JVM オプショ グ（118ページ）
ンがあります。
関連リンク
管理ユーティリティによるパフォーマンスのモニタリング（118ページ）
performancemonitor enabled get（154ページ）
performancemonitor enabled set（154ページ）
パフォーマンス最適化のための設計ガイドライン
パフォーマンスが最適化されるようデータフローを慎重に設計することは、Spectrum™ Technology
Platform のパフォーマンス向上のために実行できる最も重要な作業です。以下のガイドラインでは、
データフローのパフォーマンス最適化に使用できる手法について説明します。
106
Spectrum™ Technology Platform 9.0 SP3
第 6 章 : パフォーマンスの最適化
ステージ数の最小化
Spectrum™ Technology Platform は、並列処理によって高パフォーマンスを実現します。従来のワー
クフロー サーバーの多くがワークフローの各ステップを逐次処理 (最初のステップがすべてのデータ
を処理してから次のステップにデータを渡す) するのに対し、Spectrum™ Technology Platform は各ス
テージをそれぞれのスレッドで非同期に処理するため、データフローの並列処理とパフォーマンスに
優れた実行が可能です。
ただし、データフローのタイプによっては、実行中にプロセッサがオーバースレッドになる可能性が
あります。これは、"実際の仕事" を行う以上の時間がスレッドの管理に費やされるということです。
130 の個別ステージを持つデータフローの場合、1 つまたは 2 つのプロセッサを搭載した小規模なサー
バーでのパフォーマンスが非常に悪いことが確認されています。
したがって、パフォーマンスに優れたデータフローを設計するためにまず検討すべきは、必要なだけ
のステージを使用し、それ以上は使用しないということです。必要以上のステージを使用した例とし
ては、次のものがあります。
• 1 つで十分にもかかわらず複数のconditional routerを使用する
• 複数のトランスフォームを 1 つのステージに結合する代わりに複数の Transformer ステージを定義
する
幸いなことに、通常はこのようなデータフローを設計し直して、冗長または不要なステージを削除し、
パフォーマンスを向上させることができます。
レコード長の短縮
同時並行で実行されるステージ間でデータが渡されるため、入力レコードの長さについても検討する
必要があります。一般的に、長いレコードの入力では、短いレコードの入力に比べ、処理に時間がか
かります。これは、読み込み、書き出し、ソートするデータが多いためです。複数のソート操作を行
うデータフローは、レコード長を短くすることで特に恩恵を受けます。レコード長が非常に大きい場
合、Spectrum™ Technology Platform ジョブを実行する前に、入力から不要なフィールドを削除し、
後で結果出力ファイルに追加することで、処理速度を向上させることができます。
ソートの適切な使用
ソート操作の最小化についても検討する必要があります。ソートは他の操作よりも時間がかかること
が多いため、入力レコードの数およびサイズが増加すると問題となる場合があります。しかし、多く
の Spectrum™ Technology Platform ステージが、ソートされた入力データを必要としたり、優先した
りします。例えば、Universal Addressing モジュールと Enterprise Geocoding モジュールは、入力が
国および郵便番号によってソートされている場合にパフォーマンスが最適化されます。Intraflow Match
や Interflow Match などのステージでは、入力が [グループ化方法] フィールドによってソートされてい
る必要があります。外部ソート アプリケーションを使用して、入力データを事前にソートできる場合
もあります。この場合、Spectrum™ Technology Platform データフロー内でのソートより速く処理で
きます。
データフロー プール サイズの設定
データフローに対して多数の同時要求が発生すると予測される場合は、データフローのプール サイズ
を増加させることによって応答時間を短縮できます。 データフローのプール サイズのデフォルト値は
8 です。 データフローのプール サイズを増加するには、次のファイルでサービス名とプール サイズを
指定します。
1. JMX コンソールのパフォーマンス モニターを有効にします。 詳細については、JMX コンソール
によるパフォーマンスのモニタリング（120ページ）を参照してください。
2. データフローを実行します。
管理ガイド
107
パフォーマンス チューニングのチェックリスト
3. JMX コンソールにおいて、 ServiceRuntimeManager.borrow.DataflowNameの応答時間を記録し
ます。
注 : 時間はミリ秒単位で表示されます。
4. 次のファイルを開きます。
SpectrumLocation\server\app\conf\dataflowpool-pool-sizes.properties
5. データフローのプール サイズに、データフローを同時に実行する予定のユーザ数を設定します。
6. ファイルを保存して閉じます。
7. データフローを再度実行し、JMX コンソールで ServiceRuntimeManager.borrow.DataflowName
の応答時間を観測します。
8. 最適な設定が得られるまで、他のプール サイズでも実験を行います。
プール サイズと実行時インスタンス設定のチューニング
パフォーマンスを向上させるために使用できる 2 つの主要な設定として、データベース リソースの
プール サイズと、ステージ実行時インスタンスがあります。 以下の手順に従ってテストを行うことに
よって、お使いの環境におけるプール サイズと実行時インスタンスの最適な設定を判断してくださ
い。
1. パフォーマンス テストで使用する入力データを特定します。 パフォーマンス テストで使用する
データを選択する際には、次の点を考慮してください。
• 実行時間を測定し、一貫性を確認するには、テスト データに十分な数のレコードが含まれてい
ることが重要です。
• テスト データとしては必ず、実際に処理するデータを代表するものを選択します。 例えば、ジ
オコーディングのパフォーマンス テストを行う場合は、ジオコードする予定のすべての国に対
して同数のレコードがテスト データに含まれるようにします。
2. 郵便データベースやジオコーディング データベースなど、データベース リソースの使用が必要な
サービスまたはデータフローをテストする場合は、データベースの最新版がインストールされてい
ることを確認してください。
3. ファイルからデータを読み込み、最適化したいステージでそれを処理し、ファイルに書き出す、簡
単なデータフローを作成します。
例えば、Validate Address のパフォーマンス設定をテストする場合は、Read from File、Validate
Address、Write to File で構成されるデータフローを作成します。
4. デフォルトでは、データフローのプール サイズは 8 に設定されます。 8 個を上回るデータフロー
のインスタンスを同時に実行する予定の場合は、データフローのプール サイズ設定を最適化しま
す。 詳細については、データフロー プール サイズの設定（107ページ）を参照してください。
5. データベース リソースのプール サイズを 1 に設定します。 データベース リソースのプール サイ
ズを設定する手順については、「 データベース リソースのプール サイズの設定（70ページ）」を
参照してください。
6. ステージの実行時インスタンスを 1 に設定します。 ステージの実行時インスタンスを設定する手
順については、「 ローカル実行時インスタンスの設定（110ページ）」を参照してください。
7. データフローを複数回実行し、次の各項目の平均を記録することによって、ベースライン パフォー
マンスを算出します。
• 経過時間
• CPU 使用率
• メモリ使用率
108
Spectrum™ Technology Platform 9.0 SP3
第 6 章 : パフォーマンスの最適化
ヒント : JMX コンソールを使用してパフォーマンスをモニタリングできます。 詳細については、
JMX コンソールによるパフォーマンスのモニタリング（120ページ）を参照してくださ
い。
8. ジョブの複数インスタンスの同時実行をサポートする必要がある場合は、それを実行します。 そ
れぞれの場合に対して、経過時間、CPU 使用率、メモリ使用率を記録します。
ヒント : ファイル モニターを使用して、ジョブの複数インスタンスを同時に実行できます。 詳細
については、ファイル モニターによるジョブまたはプロセス フローのトリガ（86ペー
ジ）を参照してください。
9. データベース リソースのプール サイズと、ステージ実行時インスタンスの設定値を増加させます。
10. ‎サーバーを再起動します。
11. データフローを再度実行し、経過時間、CPU 使用率、メモリ使用率を記録します。
12. パフォーマンスが低下し始めるまで、データベース リソースのプール サイズとステージ実行時イ
ンスタンスの設定値を増加していきます。
13. ジオコーディング パフォーマンスをテストする場合は、単一国と複数国の入力を使用してこの手
順を繰り返します。
データベース リソースのプール サイズの設定
データベース リソースには、住所の検証で使用する郵便データや、住所のジオコードで使用するジオ
コーディング データなど、特定のステージで使用するリファレンス データが含まれます。 これらの
データベース リソースは、それを使用するデータフロー ステージやサービスから同時に行われる複数
の要求を受け付けるように設定することが可能で、その結果、データフローの要求やサービスの要求
のパフォーマンスを高めることができます。 データベース リソースのプール サイズを変更すると、
データベース リソースが受け付ける同時要求の数を変更できます。 データベース リソースが処理で
きる同時要求の最大数は、プール サイズによって決まります。 デフォルトでは、データベース リソー
スのプール サイズは 4 で、データベース リソースは 4 つの要求を同時に処理できることを意味しま
す。 ただし、データベース リソースには別のプール サイズを設定できます。
注 : パフォーマンスのチューニング時には、データベース リソースのプール サイズを調整する前に
データフローのプール サイズを最適化します。
1. Management Console を開きます。
2. [モジュール] の下で、データベース リソースのパフォーマンスを最適化するモジュールを展開し
ます。 次に、[ツール] を展開し、データベース リソースを選択します。
3. 最適化するデータベース リソースを選択し、[変更] をクリックします。
4. [プール サイズ] フィールドで、このデータベースで処理する同時要求の最大数を指定します。
最適なプール サイズはモジュールによって異なります。 一般的には、サーバーが搭載する CPU
の数の半分から 2 倍のプール サイズを設定すると、最適な結果が得られます。ほとんどのモジュー
ルに最適なプール サイズは CPU 数と同数です。 例えば、サーバーが 4 つの CPU を搭載している
場合は、プール サイズを 2 (CPU 数の半分) ～ 8 (CPU 数の 2 倍) の間で試すことができ、多くの
場合、最適なサイズは 4 (CPU 数と同数) です。
プール サイズを変更するときは、データベース リソースにアクセスするステージ用としてデータ
フローに指定されている実行時インスタンスの数を考慮する必要もあります。 例えば、1 つの実行
時インスタンスを使用するように設定された Geocode US Address ステージを持つデータフロー
があるとします。 この場合、米国ジオコーディング データベースのプール サイズを 4 に設定して
も、パフォーマンスは向上しません。実行時インスタンスが 1 つしかないので、データベース リ
ソースへの要求は一度に 1 つになります。 ただし、Geocode US Address の実行時インスタンス
の数を 4 つに増やすと、パフォーマンスが向上します。データベース リソースに同時にアクセス
する Geocode US Address のインスタンスが 4 つあるので、プール全体を使用できます。
管理ガイド
109
パフォーマンス チューニングのチェックリスト
ヒント : さまざまな設定でパフォーマンス テストを行って、環境にとって最適なプール サイズと
実行時インスタンスの設定を特定してください。
関連リンク
サービスの最適化（93ページ）
ローカル実行時インスタンスの設定
データフローの各ステージはそれぞれのスレッドで非同期に動作し、他のステージから独立していま
す。 このため、データフロー内の複数ステージが並列処理され、1 つのステージに対して複数の実行
時インスタンスを利用することができます。 これは、一部のステージが他のステージより速くデータ
を処理するデータフローで役に立ちます。 その結果、スレッド間での作業の分配のバランスが悪くな
る可能性があります。 例えば、次の 2 つのステージで構成されるデータフローを考えてみましょう。
ステージの設定によって、Validate Address ステージが Geocode US Address ステージより速くレコー
ドを処理することがあります。 その場合、データフロー実行のある時点で、Validate Address はすべ
てのレコードを処理していますが、Geocode US Address にはまだ未処理のレコードがあります。 こ
のデータフローのパフォーマンスを向上させるには、最も速度の遅いステージ (この場合は Geocode
US Address) のパフォーマンスを向上させる必要があります。 その方法の 1 つは、ステージの実行時
インスタンスを複数指定することです。 例えば、実行時インスタンス数を 2 に設定すると、そのス
テージのインスタンスが 2 つになります。各インスタンスはそれぞれのスレッド内で動作し、レコー
ドの処理に使用することができます。
注 : 複数の実行時インスタンスを使用してパフォーマンスが向上するのは、複数のレコードを使用す
るジョブまたはサービス要求を実行する場合のみです。
以下の手順は、複数の実行時インスタンスを使用するようにステージを設定する方法を示しています。
注 : パフォーマンスのチューニング時には、実行時インスタンスを調整する前にデータフローのプー
ル サイズを最適化します。
1. Enterprise Designer でデータフローを開きます。
2. 複数の実行時インスタンスを使用するように設定するステージをダブルクリックします。
3. [実行時] をクリックします。
例えば、Geocode US Address ステージの [実行時] ボタンは次のようになっています。
110
Spectrum™ Technology Platform 9.0 SP3
第 6 章 : パフォーマンスの最適化
注 : すべてのステージで複数の実行時インスタンスを使用できるわけではありません。 ステージ
のウィンドウの下部に [実行時] ボタンがない場合、そのステージでは複数の実行時インスタ
ンスを使用できません。
4. [ローカル] を選択し、このステージで使用する実行時インスタンスの数を指定します。
一般的なルールとして、実行時インスタンス数は、少なくともリモート コンポーネントのインス
タンス数と等しくなければなりません。 リモート コンポーネントの詳細については、『Spectrum™
Technology Platform 管理ガイド』を参照してください。 複数の実行時インスタンスを指定すると
パフォーマンスが向上しますが、この値を高くしすぎると、システムのリソースに負荷がかかり、
パフォーマンスが低下する可能性があります。
5. [OK] をクリックして [実行時パフォーマンス] ウィンドウを閉じます。さらに [OK] をクリックし
てステージを閉じます。
リモート コンポーネントのオプションの設定
一部のリモート コンポーネントは、パフォーマンスを最大化するよう設定できます。例えば、メモリ
内にキャッシュする参照データの量や、入力データを参照データとマッチングする方法を制御するオ
プションを持つリモート コンポーネントがあります。また、リモート コンポーネントは別個の JVM
内で実行されるため、Spectrum™ Technology Platform サーバーに影響を与えることなく、パフォー
マンスが向上するようにその JVM を設定することができます。
リモート コンポーネントのオプションは、そのコンポーネントを使用するステージだけでなく、コン
ポーネントのすべてのインスタンスに影響を与えます。これは、設計時および実行時に変更可能なス
テージのオプションと異なる点です。
管理ガイド
111
パフォーマンス チューニングのチェックリスト
Universal Addressing モジュール コンポーネントの設定
米国の住所の処理の場合、メモリにキャッシュする参照データを制御する、いくつかのオプションが
あります。これらのオプションは、設定ファイル server/modules/c1p/java.properties で設
定されます。
• DpvMemoryModel: メモリにキャッシュする DPV ファイルを制御する
Link
ファイルを制御する
Link
ファイルを制御する
• LacsLinkMemoryModel: メモリにキャッシュする LACS
• SuiteLinkMemoryModel: メモリにキャッシュする Suite
これらのオプションのさまざまな値の詳細については、java.properties 設定ファイルを参照して
ください。
Enterprise Geocoding モジュール コンポーネントの設定
Enterprise Geocoding モジュールには、米国ジオコーディングのパフォーマンスに影響を与えるいく
つかのオプションがあります。これらのオプションは、設定ファイル
server/modules/geostan/java.properties にあります。その中で、特に興味深いオプション
は次のとおりです。
• egm.us.multimatch.max.records: 可能性のあるマッチが返される最大数を指定します。この数値を小
さくするとパフォーマンスは向上しますが、マッチ数は少なくなります。
• egm.us.multimatch.max.processing: 実行する検索の数を指定します。この数値を小さくするとパ
フォーマンスは向上しますが、マッチ数は少なくなります。
• FileMemoryLimit: 最初にメモリにロードする参照データの量を制御します。
個々のステージの最適化
マッチングの最適化
通常、マッチングはあらゆるデータ品質実装の中で最も時間のかかる操作の 1 つであり、できる限り
効率的にマッチングを実行することが重要になります。マッチング結果とパフォーマンスは、常にバ
ランスが保たれています。ファイル内の各レコードをそれ以外のすべてのレコードと比較する場合、
すべてのマッチを確実に特定できます。しかし、データ量が増大すると、このアプローチは持続でき
なくなります。例えば、100 万レコードからなる入力ファイルがある場合、各レコードをそれ以外の
すべてのレコードとマッチングすると、各マッチ ルールを評価するのにほぼ 1 兆回の比較が必要にな
ります。
ファイル内の大部分のレコードがマッチしない場合、この問題を解決する一般的なアプローチは、マッ
チ キーを定義して、同じマッチ キーを持つレコードとのみ比較することです。適切なマッチ キーを
定義することが、マッチング エンジンのパフォーマンスに影響を与える最も重要な変数です。適切な
マッチ キーを定義するには、マッチング エンジンがレコードをどのように処理するか、および使用可
能なオプションについて理解する必要があります。
デフォルトのマッチング方法では、マッチ キュー内のレコードをすべて比較して、最大数のマッチを
特定します。そのため、この方法はしばしば最も時間のかかるマッチング方法になります。デフォル
トのマッチング方法では、マッチ キュー内の先頭のレコードがサスペクト レコードになります。次の
レコードが比較され、マッチした場合は重複として書き出されます。マッチしない場合はサスペクト
として追加され、次のレコードが 2 つのアクティブなサスペクトと比較されます。次のマッチ キュー
を考えてみましょう。
112
ユニーク ID
マッチ キー
1
123A
Spectrum™ Technology Platform 9.0 SP3
第 6 章 : パフォーマンスの最適化
ユニーク ID
マッチ キー
2
123A
3
123A
4
123A
5
123A
6
123A
7
123A
8
123A
9
123A
10
123A
まず、レコード 2 がレコード 1 と比較されます。マッチしない場合、レコード 2 はサスペクトとして
追加されます。次に、レコード 3 がレコード 1 および 2 と比較されます。以降も同様です。マッチン
グ レコードが存在しない場合、比較の総回数は 45 回になります。マッチするレコードがある場合、
比較回数はそれより少なくります。サイズ N のマッチ キューの場合、比較の最大回数は N×(N-1)÷2
です。キュー サイズが小さい場合は目立ちませんが、キュー サイズが増大すると、影響が大きくなり
ます。例えば、キュー サイズ 100 の場合の比較回数は 4,450 回で、キュー サイズが 500 の場合の比
較回数は 124,750 回です。
適切なマッチ キーの定義
適切なマッチ キーを定義するには、以下の点を考慮してください。
• 覚えておくべき最も重要な点は、大部分のレコードはマッチしないということです。したがって、
マッチする可能性のあるレコードのみを比較したいと考えます。
• 同じマッチ キーを持つレコードのみを比較します。
• パフォーマンスは重要な検討事項です。
• マッチ キーにより、マッチ キューのサイズが決定されます。
• 一定のレコード数では、マッチ キュー サイズが倍になると、実行時間も倍になります。
• "厳格" なマッチ キーによって、パフォーマンスが向上します。"厳格" なマッチ キーは限定的な
マッチ キーで、多数のフィールドからの多数の文字で構成されます。
• "あいまい" なマッチ キーによって、マッチ数が増加する場合があります。"あいまい" なマッチ
キーはそれほど限定的ではないマッチ キーで、少数のフィールドからの少数の文字で構成されま
す。
パフォーマンスとマッチ結果のバランスを見出す
パフォーマンスと結果のバランスをうまく保つには、マッチ ルールとデータの密度について検討して
ください。
• マッチ ルールに関して、以下の点を考慮してください。
• 完全一致を必要とするフィールドをマッチ キーに含めることができます。
• マッチ ルールに適したキーを作成してください。例えば、発音表記に関するマッチ ルールでは、
発音表記に関するマッチ キーが適していると考えられます。
• 多くの場合、マッチ キーはマッチングするすべてのフィールドの一部で構成されます。
• 欠落しているデータが及ぼす影響に注意してください。
管理ガイド
113
パフォーマンス チューニングのチェックリスト
• データ密度に関して、以下のことを考慮してください。
• 例えば、住所マッチングにおいて、すべてのレコードがある国のデータセットではなくある 1 つ
の町にある場合、マッチ キーはより厳格になる可能性があります。
• 平均ではなく最大のマッチ キューを検討してください。Match Summary Report を精査して、最
大マッチ キューを判断します。
• Transactional Match を使用する場合、同じ考慮事項が Candidate Finder の SELECT 文にも当ては
まります。
Express マッチ キー
一般的なファイルでは、大部分の重複レコードが完全に、またはほぼ完全に一致します。Express マッ
チ キーを定義すると、マッチング エンジンが Experss マッチ キーを最初に比較して、2 つのレコー
ドが重複かどうかを判断できます。これにより、フィールド レベルのマッチ ルールをすべて評価する
必要はなくなるので、パフォーマンスを大幅に向上させることができます。
Intraflow Match の方法
デフォルトの Intraflow Match マッチング方法では、同じマッチ キーを持つすべてのレコードが比較さ
れます。マッチ キューのサイズが N の場合、デフォルトの方法では N−1 から N×(N−1) までのいずれ
かの回数の比較が実行されます。すべてのレコードがマッチした場合、比較回数は N-1 です。レコー
ドがまったくマッチしなかった場合、比較回数は N×(N−1) です。たいていの場合、比較回数はこの範
囲の後半部分のどこかの値になります。
パフォーマンスが優先事項である場合は、デフォルトの方法ではなく、スライディング ウィンドウ
マッチング方法の使用を検討してください。スライディング ウィンドウ マッチング方法では、各レ
コードを次の W レコード (W はウィンドウ サイズ) と比較します。ファイル サイズが N の場合、ス
ライディング ウィンドウ方法で実行される比較回数は最大で N×W です。この方法によってパフォー
マンスは向上しますが、一部のマッチが検出されなくなることがあります。
Candidate Finder の最適化
Candidate Finder は、Transactional Match で比較する候補レコードをデータベースから選択します。
サスペクト レコードを Candidate Finder が返すすべての候補レコードと比較するため、Transactional
Match のパフォーマンスは比較回数に比例します。
しかし、Candidate Finder のパフォーマンス向上のためにできることがいくつかあります。Candidate
Finder のパフォーマンスを最大化するには、データベース管理者またはデータベース スキーマおよび
インデックスについて豊富な知識を持つ開発者が、Candidate Finder の SQL SELECT 文をチューニン
グする必要があります。パフォーマンスに関する最も一般的な問題の 1 つは、テーブル全体のスキャ
ンが必要となる JOIN を含んだクエリです。この場合は、インデックスの追加や、JOIN の代わりに
UNION を使用することを検討してください。原則として、適任者が SQL クエリを確認し、最適化し
てください。
ソートのカスタマイズ
ソートは、バッチ処理中に実行される操作の中で最も時間のかかるものの 1 つなので、パフォーマン
スの最適化が重要です。Sorter ステージ、およびソート操作を含む他のすべてのステージには、ソー
トのパフォーマンスに影響を与えるオプションがあります。
最初のオプションは、メモリ内でソートするレコード数です。デフォルトでは、10,000 レコード未満
のソートはメモリ内で行われ、10,000 レコードを越えるソートはディスク ソートとして実行されま
す。通常、メモリ内ソートはディスク ソートよりはるかに速いため、大部分のソートがメモリ内ソー
トとなり、大規模セットのみがディスクに書き出されるよう、この値を十分大きく設定してください。
114
Spectrum™ Technology Platform 9.0 SP3
第 6 章 : パフォーマンスの最適化
2 つ目のオプションは、ディスク ソートに使用される一時ファイル数を制御します。使用する一時ファ
イル数が増えるとパフォーマンスは向上しますが、最適な数は Spectrum™ Technology Platform を実
行しているサーバーの設定に大きく依存します。使用する一時ファイルの増減がパフォーマンスに与
える影響を確認するとよいでしょう。手始めに、次の式を目安とします。
(レコード数 × 2) ÷ メモリ内レコードの最大数 = 一時ファイル数
メモリ内でソートするレコード数と一時ファイル数のデフォルト設定を指定するには、Management
Console を開き、[実行]、[ソート パフォーマンス] の順に表示します。
トランスフォームの最適化
Transformer ステージには、入力データに対して実行できる定義済みの操作セットがあります。これら
の定義済みトランスフォームは既にコンパイルされているため、通常はカスタム トランスフォームよ
り実行速度が速くなります。ただし、多数のトランスフォームを定義すると、カスタム トランスフォー
ムの方がしばしば実行速度が速くなります。例えば、多数のフィールドをトリムする場合、通常は、
9 つの個別のトリム トランスフォームよりも、次のカスタム トランスフォームの方が実行速度が速く
なります。
data['AddressLine1'] = (data['AddressLine1'] != null) ?
data['AddressLine1'].trim() : null;
data['AddressLine2'] = (data['AddressLine2'] != null) ?
data['AddressLine2'].trim() : null;
data['AddressLine3'] = (data['AddressLine3'] != null) ?
data['AddressLine3'].trim() : null;
data['AddressLine4'] = (data['AddressLine4'] != null) ?
data['AddressLine4'].trim() : null;
data['City'] = (data['City'] != null) ? data['City'].trim() : null;
data['StateProvince'] = (data['StateProvince'] != null) ?
data['StateProvince'].trim() : null;
data['PostalCode'] = (data['PostalCode'] != null) ?
管理ガイド
115
パフォーマンス チューニングのチェックリスト
data['PostalCode'].trim() : null;
data['LastName'] = (data['LastName'] != null) ? data['LastName'].trim() :
null;
data['FirstName'] = (data['FirstName'] != null) ? data['FirstName'].trim()
: null;
Write to DB の最適化
デフォルトでは、Write to DB ステージは各行をテーブルに挿入した後で確定されます。ただし、パ
フォーマンスを向上するためには、[一括確定] オプションを有効にします。このオプションが有効に
なっている場合は、指定された数のレコードを処理した後に確定が行われます。データベースによっ
ては、これによって書き出しパフォーマンスを大幅に向上させることができます。
バッチ サイズの選択時には、以下の点を考慮してください。
• Write To DB ステージへのデータ到着速度: データの到着速度がデータベースの処理速度よりも遅い
場合は、バッチ サイズを変更してもデータフローの全般的なパフォーマンスは改善しません。 例え
ば、データフローで住所検証またはジオコーディングが行われている場合は、バッチ サイズを大き
くしても効果が得られないことがあります。
• ネットワーク トラフィック: 低速のネットワークでは、バッチ サイズを中程度 (1,000 ～ 10,000) ま
で大きくすると、パフォーマンスが改善します。
• データベースの負荷や処理速度: データベースの処理能力が高い場合は、バッチ サイズを大きくす
ると、パフォーマンスが改善します。
• 複数の実行時インスタンス: Write to DB の複数の実行時インスタンスを使用している場合、バッチ
サイズを大きくすると大量のメモリが消費されるので、小または中程度のバッチ サイズ (100 ～
10,000) を使用してください。
• データベース ロールバック: いずれかの文が失敗すると、バッチ全体がロールバックされます。 バッ
チ サイズを大きくすると、ロールバックの実行時間が長くなります。
住所検証の最適化
Validate Address は、入力レコードが郵便番号でソートされている場合にパフォーマンスが最高にな
ります。これは、参照データが郵便番号でソートされてメモリ内にロードされているためです。入力
がソートされていると、ソートされていない入力に比べ、実行速度が数倍速くなることもあります。
郵便番号フィールドにデータが入っていないレコードもあるため、次のソート順を推奨します。
1.
2.
3.
4.
Country (複数の国のレコードを処理する場合のみ必要)
PostalCode
StateProvince
City
ジオコーディングの最適化
ジオコーディング ステージでは、入力レコードが郵便番号でソートされている場合に最大のパフォー
マンスが得られます。 これは、参照データが郵便番号でソートされてメモリ内にロードされているた
めです。 入力がソートされていると、ソートされていない入力に比べ、実行速度が数倍速くなること
もあります。 郵便番号フィールドにデータが入っていないレコードもあるため、次のソート順を推奨
します。
1. PostalCode
2. StateProvince
3. City
116
Spectrum™ Technology Platform 9.0 SP3
第 6 章 : パフォーマンスの最適化
異なるマッチ モードを試してみることによっても、ジオコーディング ステージを最適化できます。
マッチ モードは、ジオコーディング結果が近似一致であるかどうかを、ジオコーディング ステージが
判定する方法を制御します。 マッチ モードを 緩和 に設定して、要件を満たす結果が得られるかどう
か確認してみてください。 一般的に 緩和 モードは、他のマッチ モードよりもパフォーマンスが向上
します。
Table Lookup の最適化
64 ビット システムの場合のみ、Advanced Transformer、Open Parser、および Table Lookup が使用
するテーブルをメモリにロードすることができます。 デフォルトでは、これらのテーブルはディスク
から読み込まれます。 テーブルをメモリにロードすることによって、パフォーマンスを向上させるこ
とができます。 これらのテーブルをメモリにロードする場合は、最大 Java ヒープ領域を 4 GB に増
やす必要があります。
これらのテーブルをメモリにロードするには、次の手順を実行します。
1. server/bin/wrapper に移動します。
2. ファイル wrapper.conf をテキスト エディタで開きます。
3. プロパティ wrapper.java.maxmemory を 4096 に設定します。
# Maximum Java Heap Size (in MB)
wrapper.java.maxmemory=4096
4. ファイルを保存して閉じます。
5. /server/modules/cdqdb/library に移動します。
6. 適切なプロパティ ファイルをテキスト エディタで開きます。
• Advanced Transformer のテーブル: tablemanagement-cdq-AdvTransformer.properties
• Open Parser のテーブル: tablemanagement-cdq-OpenParser.properties
• Table Lookup のテーブル: tablemanagement-cdq-Standardization.properties
7. ファイルを保存して閉じます。
8. ‎Spectrum™ Technology Platform サーバーを再起動します。
ソート パフォーマンスの最適化
ソート パフォーマンス オプションにより、大きなデータ セットに対するソート操作のパフォーマン
スを最適化することができます。 Management Console で指定したソート パフォーマンス値は、デー
タに対してソート操作を実行する個々のステージでオーバーライドできます。
ソート パフォーマンス設定を指定するには
1. Management Console を開きます。
2. [実行] を展開して、[ソート パフォーマンス] をクリックします。
3. 以下の設定によって、ソート パフォーマンスを制御します。
メモリ内レコードの上限値 ソートでメモリ内に保持できるデータ行の最大数を指定します。こ
の上限を越えると、ディスクにページングします。 複数のジョブを
同時並行で実行する環境では、[メモリ内レコードの上限値] の設定
を増やすと、メモリ不足になる可能性が高くなります。
使用する一時ファイルの最 ソート プロセスで使用できる一時ファイルの最大数を指定します。
大数
圧縮を有効にする
管理ガイド
一時ファイルをディスクに書き込むときに圧縮します。
117
パフォーマンスのモニタリング
注 : 最適なソート パフォーマンスの設定は、サーバーのハードウェア構成によって異なります。
それでも一般には、次の式で妥当なソート パフォーマンスが得られます。
(InMemoryRecordLimit × MaxNumberOfTempFiles ÷ 2) >=
TotalNumberOfRecords
JVM パフォーマンス チューニング
特定のハードウェアにおいてパフォーマンスを向上させることのできる JVM オプションがあります。
これらは、高度なオプションであり、誤って使用すると予期せぬ動作を引き起こす恐れがあります
(JVM がクラッシュする可能性もあります)。JVM のチューニングによってパフォーマンスを上げたい
という場合は、テクニカル サポートにお問い合わせいただくことを推奨します。
• マルチ CPU のコンピュータでは、-XX:+UseParallelGC オプションを追加することによって、
GC 処理を向上させることができます。
• 以下のオプションの追加によっても、パフォーマンスが向上することが確認されていますが、一部
のハードウェア上では JVM がクラッシュすることもわかっています。
• -Xmn512m
• -XX:+AggressiveOpts
パフォーマンスのモニタリング
データフローのパフォーマンスをモニタリングすることにより、パフォーマンスのボトルネックを特
定してパフォーマンスを調整できます。 パフォーマンスは、管理ユーティリティと JMX コンソール
の 2 つの方法でモニタリングできます。
管理ユーティリティは、パフォーマンス モニターを含む多数の管理機能へのアクセスが可能なコマン
ド ライン ツールです。 パフォーマンス モニターを有効にすると、データフローが実行される度にパ
フォーマンス データがログ ファイルに書き込まれます。これには、データフロー内の各ステージのパ
フォーマンス データが含まれます。
JMX コンソールはブラウザベースのツールで、データフロー内の各ステージのパフォーマンス統計を
記録するパフォーマンス モニタリング ツールを提供します。
管理ユーティリティによるパフォーマンスのモニタリング
管理ユーティリティは、パフォーマンス モニターを含む多数の管理機能へのアクセスが可能なコマン
ド ライン ツールです。 パフォーマンス モニターを有効にすると、データフローが実行される度にパ
フォーマンス データがログ ファイルに書き込まれます。これには、データフロー内の各ステージのパ
フォーマンス データが含まれます。
1. 管理ユーティリティを開きます。
2. 次のコマンドを入力します。
performancemonitor enabled set --eTrue --dDataflowName
ここで DataflowName は、モニタリングするジョブまたはサービスの名前です。
これによって、指定したデータフローに対するパフォーマンス モニタリングが有効になります。 デー
タフローを実行すると、パフォーマンス情報がパフォーマンス ログに記録されます。
関連リンク
118
Spectrum™ Technology Platform 9.0 SP3
第 6 章 : パフォーマンスの最適化
パフォーマンス チューニングのチェックリスト（106ページ）
performancemonitor enabled get（154ページ）
performancemonitor enabled set（154ページ）
パフォーマンス ログ
パフォーマンス ログには、ジョブまたはサービスの実行にかかった時間の詳細が記録されます。 ジョ
ブまたはサービスの全般的なパフォーマンス情報に加えて、ジョブまたはサービス データフロー内の
各ステージのパフォーマンス情報が含まれます。 この情報を使用して、各ステージの実行時間と処理
時間を確認し、ボトルネックを特定できます。 実行時間と処理時間が大きく異なる場合、そのステー
ジでは上流ステージからのデータを待つ時間が長いことを意味します。 この場合は、上流ステージが
データフローにおけるボトルネックである可能性があります。 シンクについては、実行時間と処理時
間が大きく異なることが、必ずしもパフォーマンスの問題を意味するとは限らないことに注意してく
ださい。シンクは一般的に、データフローのその他の部分からの最初のレコードを待たなければなら
ないためです。
ジョブまたはサービスのパフォーマンス モニタリングを有効にするには、管理ユーティリティでコマ
ンド performancemonitor enabled set を使用します。
パフォーマンス ログは、お使いの Spectrum™ Technology Platform サーバーの次の場所にあります。
SpectrumLocation\Spectrum\server\app\repository\logs\performance.log
パフォーマンス ログは、モニタリング対象のジョブまたはサービスの各実行に対して 1 行で書き出さ
れます。 循環式のログで、最大 5 ファイルで構成されます。 各ファイル サイズの上限は 10 MB で
す。 この上限に達すると、最も古いパフォーマンス データが削除され、新しいパフォーマンス デー
タが記録されます。
パフォーマンス ログの各エントリには、次の情報が含まれます。
注 : 以下では読みやすいように、改行とインデントを挿入しています。 実際のログでは、エントリは
1 行で書き出されます。
Date Time [performance]
{
"username":"UserName",
"dataflowId":"DataflowName",
"runMode":"BatchOrRealTime",
"remote":TrueOrFalse,
"elapsedTime":Nanoseconds,
"stageInfo":[
{
"stageName":"Name",
"stageLabel":"Label",
"options":{
OptionsList
},
"recordsRead":Count,
"recordsWritten":Count,
"executionTime":Nanoseconds,
"processingTime":Nanoseconds
}
]
}
ここで、
ユーザ名
ジョブまたはサービスを実行したユーザ。
dataflowID
Enterprise Designer で定義されているサービスまたはジョブの名前。
管理ガイド
119
パフォーマンスのモニタリング
runMode
ジョブとサービスのどちらのログ エントリであるかを示します。 次のいずれかで
す。
バッチ
ジョブに対するログ エントリです。
RealTime
サービスに対するログ エントリです。
remote
ジョブまたはサービスが、ローカル サーバーとリモート サーバーのどちらで実行さ
れたかを示します。 リモート サーバーで実行された 1 つ以上のステージを含むジョ
ブの場合、ジョブを実行したサーバー上のパフォーマンス ログでは、ジョブはリモー
トではない ("false" の値) と示され、ジョブの 1 つ以上のステージを実行したリモー
ト サーバー上のパフォーマンス ログでは、ジョブはリモートである ("true" の値) と
示されます。 次のいずれかです。
true
リモート サーバーで実行されたジョブまたはサービスです。
false
ローカル サーバーで実行されたジョブまたはサービスです。
elapsedTime
ジョブまたはサービスのリクエストを実行するのにかかった時間 (単位: ナノ秒)。
stageInfo
データフローの各ステージの実行情報を一覧表示します。 各ステージに対して、次
の情報が表示されます。
stageName
ステージの永続的な名前。
stageLabel
ステージのユーザ定義の名前。 ステージ ラベルは、Enterprise Designer のキャンバ
ス上に表示されます。
オプション
実行時に指定されたオプションがある場合、それらのオプションとその設定がここ
に一覧表示されます。
recordsRead
ステージの全入力ポートを通してこのステージに引き渡されたレコードの総数。
recordsWritten
ステージの全出力ポートに書き出されたレコードの総数。
executiontime
ステージで最初のレコードが処理されてから最後のレコードが処理されるまでの時
間。 これには、データフローの他のステージからのデータを待つ間、ステージがア
イドル状態だった時間が含まれます。
processingtime
ステージがレコードを実際に処理していた時間。データフローの他のステージから
のデータ待ちでアイドル状態だった時間を除きます。
JMX コンソールによるパフォーマンスのモニタリング
JMX コンソールはブラウザベースのツールで、データフロー内の各ステージのパフォーマンス統計を
記録するパフォーマンス モニタリング ツールを提供します。
1. Web ブラウザーを開いて、http://<server>:<port>/jmx-console に移動します。
120
Spectrum™ Technology Platform 9.0 SP3
第 6 章 : パフォーマンスの最適化
ここで、
<server> は Spectrum™ Technology Platform サーバーの IP アドレスまたはホスト名です。
<port> は Spectrum™ Technology Platform が使用する HTTP ポートです。 デフォルト値は 8080
です。
2. 管理者アカウントでログインします。
3. "Domain: com.pb.spectrum.platform.performance" の下にある
[com.pb.spectrumplatform.performance:server=PerformanceMonitorManager] をクリックし
ます。
4. [enable] の横にある [Invoke] ボタンをクリックします。
5. [Return to MBean View] をクリックして、[PerformanceMonitorManager] 画面に戻ります。
これでパフォーマンス モニタリングが有効になります。 データフローを実行すると、パフォーマンス
統計が [PerformanceMonitorManager] 画面の上部に表示されます。
次のことに注意してください。
• 更新を確認するには、画面を再表示する必要があります。
• カウンタをリセットするには、[reset] の横にある [Invoke] ボタンをクリックします。
• Spectrum™ Technology Platform サーバーを停止すると、パフォーマンス モニタリングはオフにな
ります。 サーバーを再起動したら、パフォーマンス モニタリングを再度オンにする必要がありま
す。
JMX パフォーマンス モニター統計
JMX コンソールのパフォーマンス モニター マネージャは、総実行時間、スループット、個々のステー
ジの実行時間など、データフロー実行の様々な部分のパフォーマンスに関する統計を表示します。 統
計はセミコロン区切り形式でレポートされます。
ヒント : データをスプレッドシートに配置すると、見やすくなります。
先頭行は、次の列で構成されるヘッダ レコードです。
管理ガイド
121
パフォーマンスのモニタリング
Monitor
パフォーマンスを測定する項目。
Hits
項目の実行回数。
Avg
項目が要求の処理に費やした時間の平均値 (単位: ミリ秒)。
Delta
この統計は未使用です。
Min
項目が要求の処理に費やした時間の最小値 (単位: ミリ秒)。
Max
項目が要求の処理に費やした時間の最大値 (単位: ミリ秒)。
Total
合計処理時間 (単位: ミリ秒)。
以下は、確認すべき最も重要な項目です。
Dataflow
データフローの総応答時間とスループット。
ServiceRuntimeManager.borrow.DataflowName
同時要求処理の応答時間 (単位: ミリ秒)。 こ
の応答時間は、データフローのプール サイ
ズを変更することによって短縮できる可能
性があります。
RemoteComponent.borrow.RemoteComponentName データベース リソースのプール サイズに
よって直接影響を受けるデータベースリソー
スのパフォーマンス。この応答時間は、デー
タフローのプール サイズを増加させると長
くなる可能性があります。 この数値が ½ ミ
リ秒も増加する場合は、データベースリソー
スのプール サイズを増加します。
Stage[StageName]
各ステージの応答時間。 これにより、他の
ステージよりも処理にかなり長い時間がか
かり、ボトルネックとなっているステージ
を特定できます。 ボトルネックとなってい
るステージは、既存ステージの機能の実装
方法を変更したり、そのステージの実行時
インスタンスを増やしたりすることによっ
て解消できる可能性があります。
関連リンク
プール サイズと実行時インスタンス設定のチューニング（108ページ）
122
Spectrum™ Technology Platform 9.0 SP3
システムの監視
このセクションの構成
• 通知 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .124
• ログ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .125
• トランザクション上限に関する警告 . . . . . . . . . . . . . . . . .126
• バージョン情報の表示 . . . . . . . . . . . . . . . . . . . . . . . . . . . .127
• ライセンス情報の表示とエクスポート . . . . . . . . . . . . . . . .127
7
通知
通知
電子メール通知の設定
Spectrum™ Technology Platform では、重要なビジネス プロセスが中断されることがないように、潜
在する問題について警告を通知することができます。 データフローおよびプロセス フロー内の各種条
件の結果として、通知を送信します。 発生したイベントに関するコンテキスト依存の情報を含むよう
に、メッセージをフォーマットすることが可能です。 また、時間ベースのライセンスやデータベース
などの項目の有効期限が切れる前に、通知を送信することができます。
注 : 電子メール通知は、トランザクションベースのライセンスに対しては提供されていません。 ライ
センスのトランザクション数が上限に近づいている場合は、Management Console のイベント
ログにメッセージが表示されます。
以下に、電子メール通知に使用する SMTP 設定を行う手順を示します。 また、通知のタイミングや受
信者も指定します。
1. Management Console を開きます。
2. [システム] を展開し、[通知] をクリックします。
3. [ホスト] フィールドに有効なホスト名または IP アドレスを入力します。
4. [ポート] フィールドに有効なポート番号または範囲を入力します。 デフォルト値は 25 です。
5. [ユーザ名] フィールドに SMTP サーバーにログインするためのユーザ名を入力します。
6. [パスワード] フィールドに SMTP サーバーにログインするためのパスワードを入力します。
7. [パスワード] フィールドにパスワードを入力したら、[パスワードの確認] フィールドに SMTP サー
バーにログインするためのパスワードを再入力します。
8. [送信者アドレス] フィールドに、通知メールを送信する有効な電子メール アドレスを入力します。
9. [テスト アドレス] フィールドに、通知メールを送信する有効な電子メール アドレスを入力します。
これによって、通知プロセスが正しく動作することを確認します。
10. [テスト] をクリックして、テスト メッセージを送信します。
11. [有効期限設定] タブをクリックします。
12. [通知送信日 (有効期限までの日数で指定)] フィールドに、期限の何日前に通知するかを、期限まで
の日数で指定します。
例えば、項目の有効期限が切れる 30 日前の通知を希望する場合は、 30と指定します。
13. [有効期限通知を送信] チェック ボックスをオンにします。
14. [追加] をクリックし、通知を受信する電子メール アドレスを指定します。
15. [ファイル] > [保存] を選択します。
これでお使いの Spectrum™ Technology Platform システムは、有効期限が近づいているデータフロー
と項目について通知を送信するように設定されます。
注 : デフォルトでは、有効期限が近づいているすべての項目 (ライセンス、データベース、ソフトウェ
ア コンポーネントなど) に対して有効期限通知が送信されます。 [システム] > [ライセンスと有
効期限]を選択して、特定の項目の有効期限通知を無効にすることができます。
124
Spectrum™ Technology Platform 9.0 SP3
第 7 章 : システムの監視
有効期限通知を受信する項目の選択
Spectrum™ Technology Platform は、ライセンス、データベース、ソフトウェア コンポーネントの有
効期限が切れる前に電子メール通知を送付できます。 これによって、期限切れによってビジネス プロ
セスに支障をきたすことなく、必要な措置を講じることができます。 有効期限があるコンポーネント
には、以下のようなものがあります。
• ライセンス
• データベース (CASS 処理に使用される米国 郵便データベースなど)
• 一部のソフトウェア コンポーネント (Universal Addressing モジュールにおいて米国 住所の検証に
用いられるエンジンなど)
ヒント : 有効期限がある項目を参照するには、Management Console を開き、 [システム] を展開して
[有効期限]をクリックします。
有効期限通知メールを受信する項目が選択できるため、気になる項目についてのみメール通知を受け
取ることができます。
1. Management Console を開きます。
2. [システム] を展開し、 [ライセンスと有効期限]をクリックします。
3. ある項目に対する有効期限通知メールを受信するには、 [通知を送る] 列のチェックボックスをオ
ンにします。
注 : [通知を送る] 列のボックスをオンにできない場合、それはお使いのシステムにおいて通知が
無効になっているためです。 通知を有効にするには、 [システム] を展開して [通知]をクリッ
クします。 [有効期限設定] タブをクリックして、 [有効期限通知を送信] オプションを有効に
します。
4. [ファイル] > [保存] を選択します。
ログ
イベント ログの表示
イベント ログには、Spectrum™ Technology Platform サーバーのラッパー ログからのメッセージが表
示されます。 イベント ログには、サーバー操作や、API および Web サービスからサービスに対して
作成されたリクエストに関する情報が含まれます。 トラブルが発生し、考えられる原因についての情
報を探す場合、イベント ログを使用します。
1. Management Console を開きます。
2. [イベント ログ] を展開し、[イベント] をクリックします。
3. 最新のエントリを表示するには、[更新] をクリックします。
4. イベント ログを自動的にロードするには、[オープン時にイベントを表示] をオンにします。 この
オプションをオンにしない場合、最新の情報を表示するには [更新] ボタンをクリックする必要が
あります。
テキスト エディタを使用してファイル
ServerLocation\server\app\repository\logs\wrapper.log を開くことによっても、イベ
ント ログを表示できます。
管理ガイド
125
トランザクション上限に関する警告
イベント ログ オプションの設定
デフォルトのログ レベルや、システム上の各サービスのログ レベルを指定することができます。 ロ
グ レベルを変更しても、変更前に作成されたログ エントリにはその変更は反映されません。
1. Management Console を開きます。
2. [イベント ログ] を展開し、[オプション] をクリックします。
3. [システム デフォルト ログ レベル] ドロップダウン リストをクリックして、イベント ログ レベル
を選択します。 イベント ログ レベルには、次の種類があります。
無効
すべてのイベント ログを無効にします。
致命的
最小限のログです。致命的なエラーのみを記録します。 致命的なエラーとは、シス
テムを使用不可能にするエラーのことです。
エラー
エラーと致命的なエラーのみを記録します。 エラーが生じると、単一の呼び出し、
あるいは単一のサービスが使用不可能になりますが、システム全体が使用不可能に
なることはありません。 特定のサービスがロードできないという現象は、エラーで
ある可能性があります。他のサービスは使用できる場合があるからです。
警告
イベント警告とエラーを記録します。 警告とは、システムの動作を停止することの
ない問題を指します (例えば、サービスのロード時にパラメータに無効な値が設定さ
れている場合には、警告が発行され、デフォルトのパラメータが使用されます)。
サービスの使用時に、結果は返ってきたが問題が存在するという場合に、警告がロ
グに記録されます。 例えば、大文字と小文字の区別で小文字が指定されているが、
カナダでは大文字と小文字の区別がサポートされていない、といった場合が挙げら
れます。 この場合、結果とともに、大文字と小文字の区別のオプションが無視され
たという警告が返されます。
情報
高いレベルのシステム情報を記録します。 これは、実稼働に適した最も詳細なログ
レベルです。 情報ログ レベルは通常、起動時および初期化時に使用され、製品およ
びバージョン情報や、どのサービスがロードされたかなどの情報を提供します。
デバッグ
システムの問題のデバッグ時に適した、非常に詳細なログ レベルです。
トレース
プログラムの実行 (メソッドの開始と終了) をトレースする、最も詳細なログ レベル
です。 デバッグに使用する詳細なプログラム フロー情報を提供します。
各ログ レベルは、1 つ上のログ レベルの内容を含みます。 つまり、警告ログ レベルが選択されて
いる場合、エラーと致命的なエラーも記録されます。 情報ログ レベルが選択されている場合は、
情報メッセージ、警告、エラー、および致命的なエラーが記録されます。
注 : 最も詳細なログ レベルを選択すると、システムのパフォーマンスに影響が生じる恐れがあり
ます。 したがって、必要なログ要件を満たす最小レベルの設定を選択する必要があります。
4. サービスごとに異なるログ レベルを指定することもできます。
トランザクション上限に関する警告
トランザクションベースのライセンスでは、実行可能なトランザクション数に上限が設けられており、
上限に達する前にライセンスを更新する必要があります。 トランザクション上限までの残数がおよそ
10% になると、Management Console のイベント ログに警告メッセージが表示されます。 例えば、
Universal Addressing モジュールの Validate Address サービスに対してトランザクションを 100 万回
126
Spectrum™ Technology Platform 9.0 SP3
第 7 章 : システムの監視
実行可能なライセンスを保有している場合、トランザクションを 90 万回実行した時点で、次のような
メッセージがイベント ログに表示されるようになります。
WARN [ValidateAddress] license for feature(s): UNC/USA/RealTime has 100,000
transactions remaining
上限に達すると、機能が無効になり、次のようなメッセージがイベント ログに表示されます。
ERROR [ValidateAddress] Usage limit exceeded for feature(s):
UNC/USA/RealTime
注 : システムは、数分ごとにトランザクション残数を計算し、必要に応じて警告メッセージをログに
出力します。 一度に最後の 10% 分のトランザクションを実行する、ジョブや大量のトランザク
ションが発生した場合は、警告メッセージが表示される前に、残りのトランザクションが使い切
られてしまう可能性があります。 このような場合には、警告メッセージが表示されることなく機
能が無効になります。
ライセンスに対するトランザクション残数を確認するには、Management Console を開いて [システ
ム]を展開し、 [ライセンスと有効期限]をクリックしてから、 [ライセンス情報] タブをクリックしま
す。
ライセンスを更新する場合は、 Pitney Bowes Software 営業担当者までご連絡ください。
バージョン情報の表示
Management Console で、[システム] を展開し、[バージョン情報] をクリックします。
ライセンス情報の表示とエクスポート
ライセンスに関する情報を XML ファイルにエクスポートできます。 この機能は、テクニカル サポー
トとともにライセンスの問題を解決する際に必要となる場合があります。
1. Management Console を開きます。
2. [システム] を展開し、[ライセンス] をクリックします。
3. [有効期限情報] タブをクリックして、有効期限が近づいているライセンスの一覧を表示します。
[有効期限設定] タブの [通知] ノードに指定された期間内のライセンスのみが表示されます。
4. システム上にインストールされているすべてのライセンスの一覧を表示するには、[ライセンス情
報] タブをクリックします。
5. [エクスポート]をクリックします。
ライセンス情報は、拡張子が .lic である XML ファイルに保存されます。
管理ガイド
127
バックアップと復元
このセクションの構成
• バックアップのスケジュール化 . . . . . . . . . . . . . . . . . . . . .130
• バックアップを手動で作成する . . . . . . . . . . . . . . . . . . . . .131
• サーバーの復元 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .131
8
バックアップのスケジュール化
バックアップのスケジュール化
Spectrum™ Technology Platform サーバーをバックアップするには、サーバーの構成データベースの
バックアップ コピーを作成する必要があります。構成データベースには、セキュリティ設定、データ
フロー、サービス オプション、データ リソース定義、その他の構成情報が含まれています。サーバー
のシステム障害やその他の災害でサーバーが稼働できなくなった場合、構成データベースのバックアッ
プを使用してサーバー構成を別の Spectrum™ Technology Platform サーバーに復元できます。
この手順では、Spectrum™ Technology Platform を構成してバックアップを定期的に作成する方法を
説明します。
重要 : スケジュールに基づくバックアップは、Spectrum™ Technology Platform サーバーのアクティ
ビティが非常に少ないかまったくない時間帯に実行されます。バックアップの実行中は、サー
ビスの呼び出しがタイムアウトになったり、ジョブが正常に実行できなかったりする場合があ
ります。
1. Spectrum™ Technology Platform サーバーを停止します。
注 : Spectrum™ Technology Platform をクラスタ環境で実行している場合は、スケジュールに基
づくバックアップを構成するノードを選択し、そのノードで実行しているサーバーを停止し
ます。このノードでは、スケジュールに基づくバックアップを構成してから、この構成を他
のノードに適用します。
2. 次のファイルをテキスト エディタで開きます。
SpectrumLocation\server\app\conf\spectrum-container.properties
3. 次のパラメータを指定します。
spectrum.orientdb.backup.enabled=true
spectrum.orientdb.backup.cron=Interval
spectrum.orientdb.backup.directory=Destination
各パラメータの意味は次のとおりです。
Interval
バックアップ データベースを作成する間隔を指定する cron 式。cron 式は、スペー
スで区切られた 6 つの値で構成されます。オプションとして、第 7 の値を指定でき
ます。
秒
分
時
月内の日
月
曜日
年 (オプション)
例えば、次の式は構成データベースを毎日午前 10 時にバックアップします。
spectrum.orientdb.backup.directory=0 0 10 * * ?
cron 式の詳細については、quartz-scheduler.org/documentation を参照してくだ
さい。
Destination
バックアップ データベースの保存先とするディレクトリ。
130
Spectrum™ Technology Platform 9.0 SP3
第 8 章 : バックアップと復元
:注
Spectrum™ Technology Platform をクラスタ環境で使用している場合は、
一元化された場所をバックアップの保存先として指定する必要がありま
す。クラスタ環境では、スケジュールに基づくバックアップがクラスタ
内の不特定のノードで実行されるからです。一元化された場所を指定す
ると、クラスタから最新のバックアップを取得するのが容易になります。
4. プロパティ ファイルを保存して閉じます。
5. Spectrum™ Technology Platform サーバーを開始します。
6. オプション: Spectrum™ Technology Platform をクラスタ環境で使用している場合は、ファイル
spectrum-container.properties をクラスタ内の各ノードにコピーしてください。ノードの
サーバーにプロパティ ファイルをコピーする前に、サーバーを必ず停止してください。
すべてのノードで spectrum-container.properties ファイルの設定が同一になっている必要
があるため、このファイルをクラスタ内のすべてのサーバーにコピーします。つまり、スケジュー
ルに基づくバックアップを 1 つのノードで有効にする場合、同じ実行間隔とバックアップ ディレ
クトリを適用してすべてのノードでバックアップを有効にする必要があります。
関連リンク
server backup（167ページ）
バックアップを手動で作成する
Spectrum™ Technology Platform サーバーをバックアップするには、サーバーの構成データベースの
バックアップ コピーを作成する必要があります。構成データベースには、セキュリティ設定、データ
フロー、サービス オプション、データ リソース定義、その他の構成情報が含まれています。サーバー
のシステム障害やその他の災害でサーバーが稼働できなくなった場合、構成データベースのバックアッ
プを使用してサーバー構成を別の Spectrum™ Technology Platform サーバーに復元できます。
この手順では、構成データベースのバックアップを手動で作成する方法を説明します。
重要 : Spectrum™ Technology Platform サーバーにアクティビティがある時間帯には、バックアップ
を実行しないでください。バックアップの実行中は、サービスの呼び出しがタイムアウトに
なったり、ジョブが正常に実行できなかったりする場合があります。
1. Web ブラウザで、次の場所に移動します。
http://ServerName:port/managers/PlatformContainer/database/backup
例:
http://myserver:8080/managers/PlatformContainer/database/backup
2. 応答が要求されたら、ファイルの保存を選択します。
これで、構成データベースのバックアップが格納された zip ファイルが作成されます。
関連リンク
server backup（167ページ）
サーバーの復元
深刻なシステム障害や災害などでサーバーが稼働しなくなった場合は、構成データベースのバックアッ
プを使用してサーバーを復元できます。バックアップを用意するには、手動で作成しておくか、
管理ガイド
131
サーバーの復元
Spectrum™ Technology Platform を構成して定期的にバックアップが作成されるようにする必要があ
ります。デフォルトで、Spectrum™ Technology Platform は構成データベースのバックアップを作成
しません。
バックアップからサーバーを復元する手順は以下のとおりです。
注 : この手順は、Spectrum™ Technology Platform サーバーが 1 台のケースを想定しています。
Spectrum™ Technology Platform サーバーがクラスタ化されているシステムで 1 つのノードだけ
を復元する場合は、新しいサーバーをインストールし、それをノードに追加してください。クラ
スタの構成が新しいノードに自動的に適用されるため、ノードを復元したのと同じ結果が得られ
ます。クラスタ環境でバックアップからの復元を行う必要がある唯一のシナリオは、クラスタに
含まれるすべてのノードが完全に失われた場合です。
1. 新しい Spectrum™ Technology Platform サーバーをインストールします。手順については、『 イ
ンストール ガイド』を参照してください。
2. サーバーのインストールが完了したら、サーバーを停止します。
3. バックアップの zip ファイルを取得し、以下の場所に解凍して既存のファイルを上書きします。
SpectrumLocation\server\app\repository\store\databases\spectrum
4. サーバーを開始します。
関連リンク
server backup（167ページ）
132
Spectrum™ Technology Platform 9.0 SP3
管理ユーティリティの使用
このセクションの構成
• 管理ユーティリティを使用する前に . . . . . . . . . . . . . . . . .134
• 管理ユーティリティをスクリプトから使用する . . . . . . . .135
• コマンド . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .136
9
管理ユーティリティを使用する前に
管理ユーティリティを使用する前に
管理ユーティリティでは、いくつかの管理機能をコマンドラインから実行できます。 この機能はスク
リプトで利用できるため、特定の管理タスクを自動化できます。 対話式の操作で機能を実行すること
もできます。 すべての管理機能を管理ユーティリティで利用できるわけではありません。 Management
Console を使用すると、管理ユーティリティでは利用できない機能にアクセスできます。
注 : 管理ユーティリティには Java 7 が必要です。 管理ユーティリティを Spectrum™ Technology
Platform サーバーがインストールされているコンピュータにインストールする場合、Java 7 は
サーバーに含まれているため、既にインストールされています。 管理ユーティリティを別のコン
ピュータにインストールする場合は、そのコンピュータに Java 7 がインストールされているこ
とを確認してください。
1. Web ブラウザを起動し、次の Spectrum™ Technology Platform の Welcome ページを開きます。
http://<サーバー名>:<ポート>
例えば、Spectrum™ Technology Platform が "myspectrumplatform" という名前のコンピュータにイ
ンストールされており、デフォルトの HTTP ポート 8080 を使用している場合は、次のアドレスに
移動します。
http://myspectrumplatform:8080
2. [プラットフォーム クライアント ツール] をクリックします。
3. [コマンドライン クライアント] をクリックします。
4. [管理ユーティリティ] で [ダウンロード] をクリックして、管理ユーティリティを使用するコン
ピュータに zip ファイルをダウンロードします。
5. zip ファイルの内容を解凍します。
6. コマンドライン インターフェイスを起動するには、次のいずれかの操作を実行します。
• サーバーが Unix または Linux システムで実行されている場合は、cli.sh を実行します。
• サーバーが Windows システムで実行されている場合は、cli.cmd を実行します。
注 : 必要に応じて、Java のインストール パスが正しく使用されるように .sh または.cmd ファイ
ルを変更します。
7. 管理する Spectrum™ Technology Platform サーバーに接続します。 サーバーに接続するには、次
のコマンドを実行します。
connect --h servername:port --u username --p password --s SSLTrueOrFalse
例:
connect --h myserver:8080 --u admin --p myPassword1--s true
8. 接続が完了すると、コマンドを実行できます。 使用できるコマンドの一覧は、help コマンドで表
示できます。
9. 作業が終わったら、exit コマンドを入力して管理ユーティリティを終了します。
134
Spectrum™ Technology Platform 9.0 SP3
第 9 章 : 管理ユーティリティの使用
管理ユーティリティをスクリプトから使用する
管理ユーティリティのいくつかのコマンドは、スクリプト ファイルから実行できます。 管理ユーティ
リティや Management Console でコマンドを手動で実行する代りにスクリプトを使用して管理業務を
自動化または規格化したい場合に、これは便利です。
1. テキスト エディタでスクリプト ファイルを作成します。 スクリプト ファイルには、実行したいコ
マンドを記述します。
コマンドをスクリプト ファイルに追加するには、コマンド プロンプトでコマンドを入力する場合
と同様にコマンドと必要なパラメータを入力します。 コマンドは、1 行に 1 つ入力します。
スクリプト ファイルにコメントを挿入する場合は、次の表記方法を使用します。
/*
コメント ブロックの開始を示します。
*/
コメント ブロックの終了を示します。
//
インライン コメントを示します。 行の先頭のみに使用します。
;
インライン コメントを示します。 行の先頭のみに使用します。
2. スクリプトは、管理ユーティリティを実行するコンピュータに保存するか、管理ユーティリティを
実行するコンピュータからアクセスが可能な場所に保存します。 ファイル名と拡張子は任意に選
択できます。 ファイル拡張子 .cli の使用を推奨します。
3. 管理ツールを開き、Spectrum™ Technology Platform コマンドを使用して connect サーバーに接
続します。 このコマンドの詳細については、connect（165ページ）を参照してください。
4. script コマンドを使用してスクリプトを実行します。 このコマンドの詳細については、script
（168ページ）を参照してください。
例: データフローをステージングから実稼働に移動する
Deduplication、AddressValidation、および DrivingDirections の 3 つのデータフロー
があります。 これらのデータフローに修正を加え、テストするためのステージング
サーバーと、データフローを実行可能にする実稼働環境があります。 これらのデー
タフローをステージング サーバーから実稼働ササーバーに移動する作業に一貫性を
与え、自動化する必要があるため、管理ユーティリティ スクリプトを利用すること
にしました。 使用するスクリプトは、次のような内容です。
// Connect to the staging server
connect --h stagingserver:8080 --u allan12 --p something123
// Export from staging
dataflow export --d "Deduplication" --e true --o exported
dataflow export --d "AddressValidation" --e true --o exported
dataflow export --d "DrivingDirections" --e true --o exported
// Close connection to the staging server
close
// Connect to the production server
connect --h productionserver:8080 --u allan12 --p something123
// Import to production
dataflow import --f exported\Deduplication.df
dataflow import --f exported\AddressValidation.df
dataflow import --f exported\DrivingDirections.df
// Close the connection to the production server
close
管理ガイド
135
コマンド
関連リンク
script（168ページ）
コマンド
データベース
米国データベース用の Enterprise Geocoding モジュール
egmusadb add
コマンド egmusadb add は、Enterprise Geocoding モジュールの米国データベースを追加します。
使用方法
egmusadb add--fFile
必須
引数
説明
はい
--fFile
データベース ファイル名を指定します。
例
この例は、C:\Dataset\CENTRUS_JUL14 にある "EGM_CENTRUS_PTS" という名
前のデータベースを追加します。
egmusadb add --f EGM_CENTRUS_PTS C:\Dataset\CENTRUS_JUL14
egmusadb delete
コマンド egmusadb delete は、設定されている Enterprise Geocoding モジュールの米国データベー
スを削除します。
使用方法
egmusadb delete--n Name
必須
引数
説明
はい
--n 名前
データベースの名前を指定します。
例
この例は、"EGM_CENTRUS_POINTS" という名前のデータベースを削除します。
egmusadb delete --n EGM_CENTRUS_POINTS
egmusadb import
コマンド egmusadb import は、Enterprise Geocoding モジュールの米国データベース プロパティ
ファイルをインポートします。このファイルは、現在のシステム上にある 1 つ以上のデータベース リ
ソースを設定します。
136
Spectrum™ Technology Platform 9.0 SP3
第 9 章 : 管理ユーティリティの使用
使用方法
egmusadb import--fFile
必須
引数
説明
はい
--fFile
JSON 形式のデータベース プロパティ ファイルを指定します。
例
この例では、JSON 形式ファイルである EgmDbResource.txt 内の設定の定義に従っ
て米国データベース リソースを作成します。
egmusadb import --f EgmDbResource.txt
egmusadb export
コマンド egmusadb export は、すべての米国データベース リソース情報を、指定された場所にあ
るデータベース プロパティ ファイル EgmDbResource.txt にエクスポートします。 出力ファイルの場
所が指定されていない場合は、EgmDbResource.txt ファイルは現在のフォルダに書き出されます。 そ
の後、データベース プロパティ ファイルにコマンド egmusadb import を使用することにより、別
のシステム上のデータベースを設定できます。
使用方法
egmusadb export--oDirectory
必須
引数
説明
いいえ
--oDirectory
データベース プロパティ情報を含む JSON 形式の出力ファイルであ
る EgmDbResource.txt を保存する、出力ディレクトリを指定します。
例
この例は、データベース リソース情報を指定された場所にエクスポートします。
egmusadb export --o C:\DBs\
出力ファイル EgmDbResource.txt には、次のようなデータベース リソース情報が
含まれます。
[{"product":"GeoStan",
"module":"geostan",
"name":"TomTomStreets",
"maxActive":4,
"properties":{"BASE_DB_PATHS":"C:/Dataset/DVDGDT",
"DataSetName":"TomTomStreets"}},
{"product":"GeoStan",
"module":"geostan",
"name":"CentrusPoints",
"maxActive":4,
"properties":{"BASE_DB_PATHS":"C:/Dataset/DVDCPoints;C:/Dataset/DVDGDT",
"DataSetName":"CentrusPoints"}}]
egmusadb get
コマンド egmusadb get は、US Enterprise Geocoding モジュール データベースに関する情報を返し
ます。
使用方法
egmusadb get--nName
管理ガイド
137
コマンド
必須
引数
説明
はい
--n名前
データベースの名前を指定します。
例
この例は、"EGM_CENTRUS_PTS" という名前のデータベースの情報を取得します。
egmusadb get --n EGM_CENTRUS_PTS
次のような情報が返されます。
DATABASE NAME = EGM_CENTRUS_PTS
POOL SIZE = 4
BASE_DB_PATH = C:\DBs\EGM\CENTRUS_JUL14
DataSetName = EGM_CENTRUS_PTS
egmusadb list
コマンド egmusadb list は、設定されているすべての US Enterprise Geocoding モジュール データ
ベースと、そのプール サイズを表示します。
使用方法
egmusadb list このコマンドにはプロパティはありません。
例
この例は、Enterprise Geocoding モジュールの米国データベースをすべて一覧表示
します。
egmusadb list
次のような情報が返されます。
+----------------+---------+
| DATABASE NAME |POOL SIZE|
+----------------+---------+
| TomTomStreets |
4 |
| TomTomPoints
|
4 |
| NAVTEQStreets |
4 |
| CentrusPoints |
4 |
+----------------+---------+
egmusadb poolsize set
コマンド egmusadb poolsize set は、設定されている US Enterprise Geocoding モジュール デー
タベースのプール サイズを設定します。 プール サイズとは、データベースに対して許容される同時
要求の最大数です。
使用方法
egmusadb poolsize set--n Name--s Poolsize
138
必須
引数
説明
はい
--n 名前
データベースの名前を指定します。
いいえ
--sPoolsize
データベースのプール サイズを設定します (整数値で指定)。 デフォ
ルト値は 4 です。
Spectrum™ Technology Platform 9.0 SP3
第 9 章 : 管理ユーティリティの使用
例
この例では、"EGM_CENTRUS_PTS" データベースのプール サイズを '3' に設定し
ます。
egmusadb poolsize set --n EGM_CENTRUS_PTS --s 3
Universal Addressing モジュールのデータベース
uamdb create
uamdb create コマンドは、新しい Universal Addressing モジュール データベースを作成します。
使用方法
uamdb create --tType --n Name --c CacheSize --i Country--pl PreloadingType --dt
DatabaseType --b BasePath--d DPVPath --l LACSPath --s SuiteLinkPath--r RDIPath --e
EWSPath --p Poolsize
必須
引数
説明
はい
--t タイプ
データベースのタイプを指定します。ここで Type は次のいずれかで
す。
USA
米国のデータベース
CAN
カナダのデータベース
INTL
国際データベース
Loqate
Loqate データベース
グローバル
Validate Address Global データベース
Amas
オーストラリアのデータベース
はい
--n 名前
データベースの名前を指定します。
いいえ
--c CacheSize
Validate Address Global データベースのキャッシュ サイズを指定しま
す。 CacheSize は次のいずれかです。
None
キャッシュなし
Small
小さいキャッシュ
Large
大きいキャッシュ (デフォルト)
いいえ
--i Country
使用する Validate Address Global データベース内の各国の 3 桁の ISO
コードを指定します。 Country は、"All" (デフォルト)、またはカンマ
で区切られたコードのリストです。
いいえ
--pl
PreloadingType
プリロードする Validate Address Global データベースの量を指定しま
す。 PreloadingType は次のいずれかです。
None
データをプリロードしません (デフォルト)。
Partial メタデータおよびインデックス構造をメモリにロードしま
す。 参照データ自体はハード ドライブに残します。 パフォー
マンスがやや向上します。また、目的のデータベースをすべ
てロードするだけのメモリが使用できない場合の代替策とな
ります。
管理ガイド
139
コマンド
必須
引数
説明
Full
いいえ
--dt
DatabaseType
参照データベース全体をメモリに移します。 米国や英国な
ど、大規模なデータベースを持つ国では、大量のメモリが必
要になることがありますが、処理速度は大幅に向上します。
Validate Address Global データベースの処理モードを指定します。
DatabaseType は次のいずれかです。
Batch_Interactive バッチ処理またはインタラクティブな環境で使用
します。 処理速度を重視して最適化されているた
め、自動で修正できないあいまいなデータが見つ
かった場合は、住所修正の試行を停止します (デ
フォルト)。
確認済み
オーストラリアの郵便物を対象に、Postal Address
File に対する郵便物の正規化と検証を行うための
バッチ処理環境で使用されます。
高速実行
住所フィールドに不完全なデータを入力し、
Validate Address Global に候補を生成してもらう
場合に使用します。
はい
--b BasePath
ベース サブスクリプション データベース パスを指定します。
いいえ
--d DPVPath
DPV データベース パスを指定します。
いいえ
--l LACSPath
LACS データベース パスを指定します。
いいえ
--s SuiteLinkPath SuiteLink データベース パスを指定します。
いいえ
--r RDIPath
RDI データベース パスを指定します。
いいえ
--e EWSPath
EWS データベース パスを指定します。
いいえ
--p Poolsize
このデータベースで処理する同時要求の最大数を指定します。 デフォ
ルト値は 4 です。
例
この例は、C:\DBs\UAM\US_JUL14 に "UAM_US" という米国のデータベースを、同
じ場所にある DPV データベースと共に作成します。
uamdb create --t USA --n UAM_US --b C:\DBs\UAM\US_JUL14 --d
C:\DBs\UAM\US_JUL14
uamdb modify
uamdb modify コマンドは、既存の Universal Addressing モジュール データベースを更新します。
使用方法
uamdb modify --tType --n Name--b BasePath --dDPVPath --l LACSPath --s SuiteLinkPath
--r RDIPath --e EWSPath --p Poolsize
140
必須
引数
説明
はい
--t タイプ
データベースのタイプを指定します。ここで Type は次のいずれかで
す。
USA
米国のデータベース
CAN
カナダのデータベース
Spectrum™ Technology Platform 9.0 SP3
第 9 章 : 管理ユーティリティの使用
必須
引数
説明
INTL
国際データベース
Loqate
Loqate データベース
グローバル
Validate Address Global データベース
Amas
オーストラリアのデータベース
はい
--n 名前
データベースの名前を指定します。
はい
--b BasePath
ベース サブスクリプション データベース パスを指定します。
いいえ
--d DPVPath
DPV データベース パスを指定します。
いいえ
--l LACSPath
LACS データベース パスを指定します。
いいえ
--s SuiteLinkPath SuiteLink データベース パスを指定します。
いいえ
--r RDIPath
RDI データベース パスを指定します。
いいえ
--e EWSPath
EWS データベース パスを指定します。
いいえ
--p Poolsize
このデータベースで処理する同時要求の最大数を指定します。 デフォ
ルト値は 4 です。
例
この例は、C:\DBs\UAM\US_JUL14 にある "UAM_US" という米国のデータベース
を、同じ場所にある LACS データベースと共に更新します。
uamdb modify --n UAM_US --t USA --b C:\DBs\UAM\US_JUL14 --l
C:\DBs\UAM\US_JUL14
uamdb delete
uamdb delete コマンドは、Universal Addressing モジュール データベースを削除します。
使用方法
uamdb delete --tType --n Name
必須
引数
説明
はい
--t タイプ
データベースのタイプを指定します。ここで Type は次のいずれかで
す。
はい
--n 名前
USA
米国のデータベース
CAN
カナダのデータベース
INTL
国際データベース
Loqate
Loqate データベース
グローバル
Validate Address Global データベース
Amas
オーストラリアのデータベース
データベースの名前を指定します。
例
この例は、"UAM_CAN" という名前のカナダのデータベースを削除します。
管理ガイド
141
コマンド
uamdb delete --t CAN --n UAM_CAN
uamdb import
uamdb import コマンドは、Universal Addressing モジュール データベースをエクスポートします。
使用方法
uamdb import --tType
必須
引数
説明
はい
--t タイプ
データベースのタイプを指定します。ここで Type は次のいずれかで
す。
USA
米国のデータベース
CAN
カナダのデータベース
INTL
国際データベース
Loqate
Loqate データベース
グローバル
Validate Address Global データベース
Amas
オーストラリアのデータベース
例
この例は、米国のデータベースをインポートします。
uamdb import --t USA
uamdb export
uamdb export コマンドは、Universal Addressing モジュール データベースをエクスポートします。
使用方法
uamdb export --tType
必須
引数
説明
はい
--t タイプ
データベースのタイプを指定します。ここで Type は次のいずれかで
す。
USA
米国のデータベース
CAN
カナダのデータベース
INTL
国際データベース
Loqate
Loqate データベース
グローバル
Validate Address Global データベース
Amas
オーストラリアのデータベース
例
この例は、国際データベースをエクスポートします。
uamdb export --t INTL
142
Spectrum™ Technology Platform 9.0 SP3
第 9 章 : 管理ユーティリティの使用
uamdb get resource info
uamdb get resource info コマンドは、データベースに関する情報を返します。
使用方法
uamdb get resource info --tType --n Name
必須
引数
説明
はい
--t タイプ
データベースのタイプを指定します。ここで Type は次のいずれかで
す。
はい
--n 名前
USA
米国のデータベース
CAN
カナダのデータベース
INTL
国際データベース
Loqate
Loqate データベース
グローバル
Validate Address Global データベース
Amas
オーストラリアのデータベース
データベースの名前を指定します。
例
この例は、"UAM_US" という米国データベースの情報を取得します。
uamdb get resource info --t USA --n UAM_US
次のような情報が返されます。
DATABASE NAME = UAM_US
POOL SIZE = 4
LACS_DB_PATH = Z:\UAM\US_AUG12
SUITELINK_DB_PATH = Z:\UAM\US_AUG12
BASE_DB_PATH = Z:\UAM\US_AUG12
DPV_DB_PATH = E:\UAM_US_MAY_14_DB
RDI_DB_PATH = E:\UAM_US_MAY_14_DB
EWS_DB_PATH = Z:\UAM\US_AUG12
uamdb list
uamdb list コマンドは、該当するタイプのすべての Universal Addressing モジュール データベース
をテーブル形式で返します。
使用方法
uamdb list --tType
必須
引数
説明
はい
--t タイプ
データベースのタイプを指定します。ここで Type は次のいずれかで
す。
管理ガイド
USA
米国のデータベース
CAN
カナダのデータベース
INTL
国際データベース
Loqate
Loqate データベース
143
コマンド
必須
引数
説明
グローバル
Validate Address Global データベース
Amas
オーストラリアのデータベース
例
この例は、すべてのカナダ データベースを一覧表示します。
uamdb list --t CAN
uamdbglobalmultipath create_sample_file
コマンド uamdbglobalmultipath create_sample_file は、複数のパス要素を持つデータベー
ス リソースを設定し、プレース ホルダやデータ パスが変更可能なサンプル JSON ファイル
(UamDbGlobalMultiPath.txt) を作成します。 このコマンドの後には、その他のデータベース設定を行
うコマンド uamdb_import が続く必要があります。
注 : テキスト ファイル内のトークン値を、絶対値とデータ パスで置き換える必要があります。
使用方法
uamdbglobalmultipath create_sample_file--o OutputDirectory--nNumberOfPathElements
必須
引数
説明
いいえ
--o
OutputDirectory
ファイルを出力するディレクトリを指定します。 現在のディレクトリ
がデフォルトの場所になります。
はい
--n
パス内の要素数を指定します。
NumberOfPathElements
例
この例では、プロパティが JSON のキーと値の形式で記述され
た、"UamDbGlobalMultiPath.txt" という名前のサンプル JSON ファイルを作成しま
す。 このデータベース リソースには、3 つのパス要素があります。
uamdbglobalmultipath create_sample_file --n 3
データフロー
delete dataflow
delete dataflow コマンドは、データフローをシステムから削除します。
使用方法
delete dataflow --dDataflowName
144
必須
引数
説明
はい
--d DataflowName 削除するデータフローを指定します。データフローの名前にスペース
が含まれる場合は、データフロー名を引用符で囲みます。
Spectrum™ Technology Platform 9.0 SP3
第 9 章 : 管理ユーティリティの使用
例
この例では、My Dataflow という名前のデータフローを削除します。
delete dataflow --d "My Dataflow"
dataflow export
dataflow export コマンドは、データフローをサーバーから .df ファイルにエクスポートします。
このデータフローは、さらに別のサーバーにインポートできます。
注 : データフローの交換は、同じバージョンの Spectrum™ Technology Platform の間でのみ行うこと
ができます。
使用方法
dataflow export --dDataflowName --e TrueOrFalse--o OutputDirectory
必須
引数
説明
はい
--d DataflowName エクスポートするデータフローの名前を指定します。 データフローの
名前にスペースが含まれる場合は、名前を引用符で囲みます。
ヒント : 使用するデータフローの名前が正確にわからない場合は、
dataflow list コマンドを使用してデータフロー名のリ
ストを取得できます。
はい
--e TrueOrFalse
データフローの公開済みバージョンをエクスポートするかどうかを指
定します。ここで、TrueOrFalse は次のいずれかです。
true
データフローの公開済みバージョンをエクス
ポートします。
false
データフローの最新の保存済みバージョンをエ
クスポートします。
いいえ
--o
OutputDirectory
データフローのエクスポート先となるディレクトリを指定します。 こ
こでは、管理ユーティリティを実行しているディレクトリへの相対パ
スを使用します。 この引数を省略すると、データフローは管理ユー
ティリティと同じディレクトリにエクスポートされます。
例
この例では、"My Dataflow" という名前のデータフローの公開済みバージョンを、管
理ユーティリティがインストールされたディレクトリの下にある exported という
名前のサブフォルダにエクスポートします。
dataflow export --d "My Dataflow" --e true --o exported
dataflow expose
dataflow expose コマンドは、データフローを実行できる状態にします。 サービス データフロー
の場合、データフローを公開すると、そのサービスは Web サービス要求や API 呼び出しを受け付け
るようになり、ログ レベルの設定が可能になります。 サブフローの場合は、データフローを公開する
と、データフローでの使用が可能になります。 ジョブ データフローの場合は、データフローを公開す
管理ガイド
145
コマンド
ると、 Job Executor コマンドライン ツールによるジョブの実行が可能になります。 プロセス フロー
を公開するには、 processflow expose コマンドを使用します。
注 : Enterprise Designer でデータフロー ビジョニングを使用する場合、dataflow expose コマン
ドはデータフローの最新の保存済みバージョンを公開します。
使用方法
dataflow expose --dDataflowName
必須
引数
説明
はい
--d DataflowName 公開するデータフローの名前を指定します。 データフローの名前にス
ペースが含まれる場合は、名前を引用符で囲みます。
ヒント : 使用するデータフローの名前が正確にわからない場合は、
dataflow list コマンドを使用してデータフロー名のリ
ストを取得できます。
例
この例では、My Dataflow という名前のデータフローを公開します。
dataflow expose --d "My Dataflow"
import dataflow
import dataflow コマンドは、データフロー ファイル (.df ファイル) をサーバにインポートしま
す。データフロー ファイルは、export dataflow コマンドを使用してデータフローをサーバーから
エクスポートすると作成されます。
使用方法
import dataflow --fDataflowFile --uTrueOrFalse
必須
引数
説明
はい
--f DataflowFile
インポートするデータフロー ファイル (.df ファイル) を指定します。
ここでは、管理ユーティリティを実行しているディレクトリへの相対
パスを使用します。
いいえ
--u TrueOrFalse
同じ名前のデータフローがすでにサーバーに存在する場合にそのデー
タフローを上書きするかどうかを指定します。ここで、TrueOfFalse
は次のいずれかです。
true
インポートするデータフローと同じ名前のデー
タフローがサーバーに存在する場合は、サー
バーにあるデータフローを上書きします。これ
がデフォルト設定です。
false
インポートするデータフローと同じ名前のデー
タフローがサーバーに存在する場合は、データ
フローをインポートしません。
146
Spectrum™ Technology Platform 9.0 SP3
第 9 章 : 管理ユーティリティの使用
例
この例では、MyDataflow.df という名前のデータフローを、管理ユーティリティ
を実行しているディレクトリの下にある exported という名前のサブフォルダにイ
ンポートします。
import dataflow --f exported\MyDataflow.df
dataflow list
dataflow list コマンドは、サーバーにあるすべてのデータフローを一覧に表示します。 各データ
フローに関連する情報として、データフロー名、データフローの種類 (ジョブ、サービス、またはサブ
フロー)、データフローが公開されているかどうか、などが表示されます。
使用方法
dataflow list
dataflow unexpose
dataflow unexpose コマンドは、データフローをサービスまたはジョブとして実行できないように
設定します。
使用方法
dataflow unexpose --dDataflowName
必須
引数
説明
はい
--d DataflowName 公開を解除するデータフローの名前を指定します。 データフローの名
前にスペースが含まれる場合は、名前を引用符で囲みます。
ヒント : 使用するデータフローの名前が正確にわからない場合は、
dataflow list コマンドを使用してデータフロー名のリ
ストを取得できます。
例
この例では、My Dataflow という名前のデータフローの公開を解除します。
dataflow unexpose --d "My Dataflow"
マッチ ルール
matchrule delete
matchrule delete コマンドは、システムからマッチ ルールを削除します。詳細については、『デー
タ品質ガイド』の「マッチング」セクションを参照してください。
使用方法
matchrule deletematchRuleName
管理ガイド
147
コマンド
必須
引数
説明
はい
--d
matchRuleName
削除するマッチ ルールを指定します。
例
この例は、My Match Rule というマッチ ルールを削除します。
matchrule delete My Match Rule
matchrule export
matchrule export コマンドは、Enterprise Designer でマッチング ステージ (Interflow Match、
Intraflow Match、Transactional Match) の 1 つを使用して作成されたマッチ ルールをエクスポートし
ます。その後、このマッチ ルールは別のサーバーにインポートできます。詳細については、『データ
品質ガイド』の「マッチング」セクションを参照してください。
使用方法
matchrule export matchRuleName--o OutputDirectory
必須
引数
説明
はい
--m
matchRuleName
エクスポートするマッチ ルールの名前を指定します。
--o
OutputDirectory
マッチ ルールのエクスポート先となるディレクトリを指定します。こ
こでは、管理ユーティリティを実行しているディレクトリへの相対パ
スを使用します。この引数を省略すると、マッチ ルールは管理ユー
ティリティと同じディレクトリにエクスポートされます。
いいえ
ヒント : マッチ ルールの名前が正確にわからない場合は、
matchrule list コマンドを使用してマッチ ルール名の
リストを取得できます。
例
この例は、"My Match Rule.mr" というマッチ ルールを、管理ユーティリティを実行
している場所にある export というサブフォルダにエクスポートします。
matchrule export My Match Rule.mr --o export
matchrule import
matchrule import コマンドは、マッチ ルール ファイルをサーバーにインポートします。マッチ
ルールは、Enterprise Designer でマッチング ステージ (Interflow Match、Intraflow Match、Transactional
Match) の 1 つを使用して作成されます。詳細については、『データ品質ガイド』の「マッチング」セ
クションを参照してください。
使用方法
matchrule import MatchRule--u TrueOrFalse
148
必須
引数
説明
はい
--f MatchRuleFile インポートするマッチ ルール ファイルを指定します。ここでは、管
理ユーティリティを実行しているディレクトリへの相対パスを使用し
ます。
Spectrum™ Technology Platform 9.0 SP3
第 9 章 : 管理ユーティリティの使用
必須
引数
説明
いいえ
--u TrueOrFalse
同じ名前のマッチ ルール ファイルが既にサーバー上に存在する場合
にそのマッチ ルール ファイルを上書きするかどうかを指定します。
ここで、TrueOfFalse は次のいずれかです。
true
インポートするマッチ ルール ファイルと同じ
名前のマッチ ルール ファイルがサーバー上に
存在する場合、サーバー上のマッチ ルール ファ
イルは上書きされます。これがデフォルト設定
です。
false
インポートするマッチ ルール ファイルと同じ
名前のマッチ ルール ファイルがサーバー上に
存在する場合、マッチ ルール ファイルはイン
ポートされません。
例
この例は、MyMatchRule.mr というマッチ ルールをインポートします。このマッ
チ ルールは、管理ユーティリティを実行している場所の exported というサブフォ
ルダにあります。-u コマンドが指定されていないため、サーバー上に同じ名前のマッ
チ ルール ファイルがあれば上書きされます。
matchrule import exported\MyMatchRule.mr
matchrule list
matchrule list コマンドは、サーバーにあるすべてのマッチ ルールを一覧表示します。マッチ
ルールごとに、マッチ ルール名と、そのマッチ ルールがエクスポーズされているかどうかの情報が表
示されます。詳細については、『データ品質ガイド』の「マッチング」セクションを参照してくださ
い。
使用方法
matchrule list
Open Parser カルチャー
openparser culture export
openparser culture export コマンドは、すべての Open Parser カルチャーをエクスポートしま
す。その後、このカルチャーは別のサーバーにインポートできます。詳細については、『データ品質
ガイド』の「パーシング」セクションを参照してください。
使用方法
openparser culture exportOutputFile
必須
引数
説明
いいえ
--f OutputFile
エクスポートするカルチャーが含まれているファイルを指定します。
この引数を省略すると、管理ユーティリティによって cultures.xml ファ
イルが自動的にエクスポートされます。
管理ガイド
149
コマンド
例
この例は、culturesFR.xml ファイルをエクスポートします。
openparser culture export culturesFR.xml
openparser culture import
openparser culture import コマンドは、Open Parser カルチャー ファイルをサーバーにイン
ポートします。詳細については、『データ品質ガイド』の「パーシング」セクションを参照してくだ
さい。
使用方法
openparser culture importCultureFileName
必須
引数
説明
はい
--f
CultureFileName
インポートするカルチャーが含まれているファイルを指定します。
例
この例は、MyCulture.xml というファイルをインポートします。
openparser culture import MyCulture.xml
Open Parser ドメイン
openparser domain export
openparser domain export コマンドは、Open Parser ドメインをエクスポートします。その後、
このドメインは別のサーバーにインポートできます。詳細については、『データ品質ガイド』の「パー
シング」セクションを参照してください。
使用方法
openparser domain exportDomainName --oOutputDirectory
必須
引数
説明
はい
--d DomainName エクスポートするドメインの名前を指定します。
ヒント : ドメイン名が正確にわからない場合は、openparser
domain list コマンドを使用してドメイン名のリストを
取得できます。
いいえ
--o
OutputDirectory
ドメインのエクスポート先となるディレクトリを指定します。ここで
は、管理ユーティリティを実行しているディレクトリへの相対パスを
使用します。この引数を省略すると、ドメインは管理ユーティリティ
と同じディレクトリにエクスポートされます。
例
この例は、"MyDomain" というドメインを、管理ユーティリティのインストール場
所にある exported というサブフォルダにエクスポートします。
150
Spectrum™ Technology Platform 9.0 SP3
第 9 章 : 管理ユーティリティの使用
openparser domain export MyDomain --o exported
openparser domain import
openparser domain import コマンドは、Open Parser ドメインをサーバーにインポートします。
詳細については、『データ品質ガイド』の「パーシング」セクションを参照してください。
使用方法
openparser domain importDomainFileName
必須
引数
説明
はい
--f
DomainFileName
インポートするドメインが含まれているファイルを指定します。ここ
では、管理ユーティリティを実行しているディレクトリへの相対パス
を使用します。
例
この例は、MyDomain.xml というファイルをインポートします。このファイルは、
管理ユーティリティを実行している場所の exported というサブフォルダにありま
す。
openparser domain import exported\MyDomain.xml
openparser domain list
openparser domain list コマンドは、サーバー上のすべての Open Parser ドメインを一覧表示し
ます。ドメインごとに、ドメイン名と、ドメインがエクスポーズされているかどうかの情報が表示さ
れます。
使用方法
openparser domain list
通知
notification daystoexpire set
notification daystoexpire set コマンドは、ライセンスまたはデータの有効期限をその何日前
に通知するかを、有効期限までの日数で指定します。
使用方法
notification daystoexpire set--d Days
必須
引数
説明
はい
--d Days
ライセンスまたはデータの有効期限をその何日前に通知するかを、有
効期限までの日数で指定します。
例
この例は、ライセンスまたはデータの有効期限が切れる 30 日前に通知を送信するよ
うに設定します。
管理ガイド
151
コマンド
notification daystoexpire set --d 30
notification enabled set
notification enabled set コマンドは、電子メールによるライセンスまたはデータの有効期限の
事前通知を有効または無効にします。
使用方法
notification enabled set --eTrueOrFalse
必須
引数
説明
はい
--e TrueOrFalse
ライセンスの有効期限の通知を有効または無効にします。ここで
TrueOrFalse は次のいずれかです。
true
ライセンスの有効期限の通知を有効にします。
false
ライセンスの有効期限の通知を無効にします。
例
この例は、通知を有効にします。
notification enabled set --e true
notification expirationsettings list
notification expirationsettings list コマンドは、システムに適用されている有効期限通
知設定を表示します。このコマンドは、通知が送信される有効期限までの日数、通知を受け取るユー
ザ、通知が有効か無効化を表示します。
使用方法
notification expirationsettings list
notification smtp get
notification smtp get コマンドは、ライセンス有効期限の通知の送信に使用される電子メール
の設定を表示します。
使用方法
notification smtp get
notification smtp set
notification smtp set コマンドは、ライセンス有効期限通知の電子メール送信に使用する電子
メールの設定を指定します。
使用方法
notification smtp set --hHost --o Port--u UserName --pPassword --e FromEmail
152
必須
引数
説明
いいえ
--h Host
通知の電子メール送信に使用する SMTP サーバーのホスト名または
IP アドレスを指定します。
Spectrum™ Technology Platform 9.0 SP3
第 9 章 : 管理ユーティリティの使用
必須
引数
説明
いいえ
--o ポート
SMTP サーバーによって使用されるポート番号または範囲を指定しま
す。デフォルト値は 25 です。
いいえ
--u UserName
電子メールの送信に使用するユーザ名を指定します。SMTP サーバー
上の有効なユーザ アカウントでなければなりません。
いいえ
--p パスワード
--u パラメータで指定したユーザ アカウントのパスワードを指定しま
す。
いいえ
--e FromEmail
通知電子メールの送信元電子メール アドレスを指定します。
例
この例は、電子メールによる通知の SMTP 設定を指定します。
notification smtp set --h mail.example.com --o 25 --u me123 --p
MyPassword --e [email protected]
notification smtp test
notification smtp test コマンドは、指定の電子メール アドレスにテスト電子メールを送信し
ます。ライセンス有効期限の通知に使用する SMTP 設定を検証するには、このコマンドを使用しま
す。
使用方法
notification smtp test --eDestinationEmail
必須
引数
説明
はい
--e
DestinationEmail
テスト電子メール メッセージの送信先電子メール アドレスを指定し
ます。
例
この例は、テスト電子メール アドレスを [email protected] に送信します。
notification smtp test --e [email protected]
notification subscriber add
notification subscriber add コマンドは、ライセンス有効期限の通知を受け取る電子メール
アドレスを追加します。
使用方法
notification subscriber add--e Email
必須
引数
説明
はい
--e Email
ライセンス有効期限の通知を受け取る電子メール アドレスを指定しま
す。
管理ガイド
153
コマンド
例
この例は、ライセンス有効期限の通知を受け取る電子メール アドレスとして
[email protected] を追加します。
notification subscriber add --e [email protected]
notification subscriber delete
notification subscriber delete コマンドは、ライセンス有効期限の通知を受け取る電子メー
ル アドレスのリストから電子メール アドレスを削除します。
使用方法
notification subscriber delete--e Email
必須
引数
説明
はい
--e Email
ライセンス有効期限の通知を受け取る電子メール アドレスのリストか
ら削除する電子メール アドレスを指定します。
例
この例は、ライセンス有効期限の通知を受け取る電子メール アドレスのリストから
電子メール アドレス [email protected] を削除します。
notification subscriber delete --e [email protected]
パフォーマンス モニター
performancemonitor enabled get
コマンド performancemonitor enabled get は、パフォーマンス モニタリングを有効にしたジョ
ブおよびサービスを表示します。
使用方法
performancemonitor enabled get
関連リンク
パフォーマンス チューニングのチェックリスト（106ページ）
管理ユーティリティによるパフォーマンスのモニタリング（118ページ）
performancemonitor enabled set
コマンド performancemonitor enabled set は、ジョブまたはサービスのパフォーマンス モニ
タリングを有効または無効にします。 パフォーマンス モニタリングを有効にすると、ジョブまたは
サービスのパフォーマンス情報がパフォーマンス ログに書き出されます。 パフォーマンス ログには、
ジョブまたはサービスの全般的なパフォーマンス情報に加えて、ジョブまたはサービス データフロー
内の各ステージのパフォーマンス情報が含まれます。
使用方法
performancemonitor enabled set--e TrueOrFalse --dDataflowName
154
Spectrum™ Technology Platform 9.0 SP3
第 9 章 : 管理ユーティリティの使用
必須
引数
説明
はい
--e TrueOrFalse
パフォーマンス モニタリングを有効または無効にします。ここで
TrueOrFalse は次のいずれかです。
はい
true
パフォーマンス モニタリングを有効にします。
false
パフォーマンス モニタリングを無効にします。
--d DataflowName パフォーマンス モニタリングを有効または無効にするデータフローの
名前を指定します。
ヒント : 使用するデータフローの名前が正確にわからない場合は、
dataflow list コマンドを使用してデータフロー名のリ
ストを取得できます。
例
この例では、データフロー MyNameParsingDataflow のパフォーマンス モニタリン
グを有効にします。
performancemonitor enabled set --e true --d
"MyNameParsingDataflow"
関連リンク
パフォーマンス チューニングのチェックリスト（106ページ）
管理ユーティリティによるパフォーマンスのモニタリング（118ページ）
パフォーマンス ログ
パフォーマンス ログには、ジョブまたはサービスの実行にかかった時間の詳細が記録されます。 ジョ
ブまたはサービスの全般的なパフォーマンス情報に加えて、ジョブまたはサービス データフロー内の
各ステージのパフォーマンス情報が含まれます。 この情報を使用して、各ステージの実行時間と処理
時間を確認し、ボトルネックを特定できます。 実行時間と処理時間が大きく異なる場合、そのステー
ジでは上流ステージからのデータを待つ時間が長いことを意味します。 この場合は、上流ステージが
データフローにおけるボトルネックである可能性があります。 シンクについては、実行時間と処理時
間が大きく異なることが、必ずしもパフォーマンスの問題を意味するとは限らないことに注意してく
ださい。シンクは一般的に、データフローのその他の部分からの最初のレコードを待たなければなら
ないためです。
ジョブまたはサービスのパフォーマンス モニタリングを有効にするには、管理ユーティリティでコマ
ンド performancemonitor enabled set を使用します。
パフォーマンス ログは、お使いの Spectrum™ Technology Platform サーバーの次の場所にあります。
SpectrumLocation\Spectrum\server\app\repository\logs\performance.log
パフォーマンス ログは、モニタリング対象のジョブまたはサービスの各実行に対して 1 行で書き出さ
れます。 循環式のログで、最大 5 ファイルで構成されます。 各ファイル サイズの上限は 10 MB で
す。 この上限に達すると、最も古いパフォーマンス データが削除され、新しいパフォーマンス デー
タが記録されます。
パフォーマンス ログの各エントリには、次の情報が含まれます。
注 : 以下では読みやすいように、改行とインデントを挿入しています。 実際のログでは、エントリは
1 行で書き出されます。
Date Time [performance]
{
管理ガイド
155
コマンド
"username":"UserName",
"dataflowId":"DataflowName",
"runMode":"BatchOrRealTime",
"remote":TrueOrFalse,
"elapsedTime":Nanoseconds,
"stageInfo":[
{
"stageName":"Name",
"stageLabel":"Label",
"options":{
OptionsList
},
"recordsRead":Count,
"recordsWritten":Count,
"executionTime":Nanoseconds,
"processingTime":Nanoseconds
}
]
}
ここで、
ユーザ名
ジョブまたはサービスを実行したユーザ。
dataflowID
Enterprise Designer で定義されているサービスまたはジョブの名前。
runMode
ジョブとサービスのどちらのログ エントリであるかを示します。 次のいずれかで
す。
バッチ
ジョブに対するログ エントリです。
RealTime
サービスに対するログ エントリです。
remote
ジョブまたはサービスが、ローカル サーバーとリモート サーバーのどちらで実行さ
れたかを示します。 リモート サーバーで実行された 1 つ以上のステージを含むジョ
ブの場合、ジョブを実行したサーバー上のパフォーマンス ログでは、ジョブはリモー
トではない ("false" の値) と示され、ジョブの 1 つ以上のステージを実行したリモー
ト サーバー上のパフォーマンス ログでは、ジョブはリモートである ("true" の値) と
示されます。 次のいずれかです。
true
リモート サーバーで実行されたジョブまたはサービスです。
false
ローカル サーバーで実行されたジョブまたはサービスです。
elapsedTime
ジョブまたはサービスのリクエストを実行するのにかかった時間 (単位: ナノ秒)。
stageInfo
データフローの各ステージの実行情報を一覧表示します。 各ステージに対して、次
の情報が表示されます。
stageName
ステージの永続的な名前。
stageLabel
ステージのユーザ定義の名前。 ステージ ラベルは、Enterprise Designer のキャンバ
ス上に表示されます。
オプション
156
Spectrum™ Technology Platform 9.0 SP3
第 9 章 : 管理ユーティリティの使用
実行時に指定されたオプションがある場合、それらのオプションとその設定がここ
に一覧表示されます。
recordsRead
ステージの全入力ポートを通してこのステージに引き渡されたレコードの総数。
recordsWritten
ステージの全出力ポートに書き出されたレコードの総数。
executiontime
ステージで最初のレコードが処理されてから最後のレコードが処理されるまでの時
間。 これには、データフローの他のステージからのデータを待つ間、ステージがア
イドル状態だった時間が含まれます。
processingtime
ステージがレコードを実際に処理していた時間。データフローの他のステージから
のデータ待ちでアイドル状態だった時間を除きます。
プロセス フロー
processflow delete
processflow delete コマンドは、システムからプロセスを削除します。
使用方法
processflow delete --nProcessFlowName
必須
引数
説明
はい
--n
削除するプロセス フローを指定します。プロセス フローの名前にス
ProcessFlowName ペースが含まれている場合は、プロセス フロー名を引用符で囲みま
す。
例
この例は、My Process Flow というプロセス フローを削除します。
processflow delete --n "My Process Flow"
processflow execute
processflow execute コマンドは、1 つ以上のプロセス フローを実行します。 このコマンドは、
プロセス フローをコマンド ラインから実行できる 2 つの方法のうちの 1 つです。 もう 1 つの方法は、
サーバーの Spectrum™ Technology Platform ウェルカム ページから実行できるコマンド ライン ユー
ティリティである Process Flow Executor を使用することです。 管理ユーティリティの processflow
execute コマンドを使用する利点は、1 つのスクリプトまたはバッチ ファイルに他のコマンドも含め
られることです。 例えば、processflow expose コマンドを使用してプロセス フローをエクスポー
ズした後、processflow execute コマンドを使用してそのプロセス フローを実行することができ
ます。 processflow execute コマンドは、Process Flow Executor と同じ機能を備えています。
使用方法
processflow execute --rProcessFlowNames --f propertyFile--i PollInterval --dDelimiterCharacter
--t Timeout--w WaitToComplete --oOverrideInputOutputFiles
管理ガイド
157
コマンド
必須
引数
説明
いいえ
--?
使用方法を出力します。
いいえ
--d
コマンド実行時にコマンド ラインに表示されるステータス情報を区切
DelimiterCharacter るのに使用する区切り文字を設定します。 デフォルトは "|" です。 例
えば、デフォルト文字を使用して、"MyProcessflow" というプロセス
フローを実行した場合、コマンド ラインには次のように表示されま
す。
MyProcessflow|1|Succeeded
いいえ
--f PropertyFile
プロパティ ファイルへのパスを指定します。 プロパティ ファイルの
詳細については、プロセス フローのプロパティ ファイルの使用
（84ページ） を参照してください。
いいえ
--i PollInterval
完了したジョブを確認する間隔を秒数で指定します。 デフォルト値は
"5" です。
はい
--r
実行するプロセス フローのリストをカンマで区切って指定します。
ProcessFlowNames 必須
いいえ
--t タイムアウト 同期モードの場合のタイムアウト (秒単位) を設定します。 デフォル
ト値は 3600 です。
いいえ
--v 詳細
いいえ
いいえ
--w
WaitToComplete
詳細な出力を返します。ここで、Verbose は次のいずれかです。
true
詳細な出力を返します。
false
詳細な出力を返しません。
同期モードでプロセス フローの完了を待つことを指定します。ここ
で、WaitToComplete は次のいずれかです。
true
完了を待ちます。
false
完了を待ちません。
--oStageName=FileName ジョブで指定されている入力または出力ファイルをオーバーライドし
ます。 詳細については、Read from File と Write to File の場所のオー
バーライド（83ページ）を参照してください。
例
この例は、"My Process Flow" というプロセス フローを実行します。
processflow execute --r "My Process Flow"
processflow export
processflow export コマンドは、サーバーから .pf ファイルにプロセス フローをエクスポートし
ます。その後、このプロセス フローは別のサーバーにインポートできます。
注 : プロセス フローの交換は、同じバージョンの Spectrum™ Technology Platform の間でのみ行う
ことができます。
使用方法
processflow export --nProcessFlowName --oOutputFile
158
Spectrum™ Technology Platform 9.0 SP3
第 9 章 : 管理ユーティリティの使用
必須
引数
説明
はい
--n
エクスポートするプロセス フローの名前を指定します。プロセス フ
ProcessFlowName ローの名前にスペースが含まれている場合は、その名前を引用符で囲
みます。
ヒント : プロセス フローの名前が正確にわからない場合は、
processflow list コマンドを使用してプロセス フロー
名のリストを取得できます。
いいえ
--o OutputFile
プロセス フローのエクスポート先ディレクトリを指定します。ここで
は、管理ユーティリティを実行しているディレクトリへの相対パスを
使用します。この引数を省略すると、プロセス フローは管理ユーティ
リティと同じディレクトリにエクスポートされます。
例
この例は、"My Process Flow" というプロセス フローを、管理ユーティリティのイ
ンストール場所にある exported というサブフォルダにエクスポートします。
processflow export --n "My Process Flow" --o exported
processflow expose
processflow expose コマンドは、プロセス フローを実行できる状態にします。
注 : Enterprise Designer におけるデータフローのバージョン管理を使用する場合は、 processflow
expose コマンドはデータフローの最新バージョンを公開します。
使用方法
processflow expose --nProcessFlowName
必須
引数
説明
はい
--n
エクスポーズするプロセス フローの名前を指定します。 プロセス フ
ProcessFlowName ローの名前にスペースが含まれている場合は、その名前を引用符で囲
みます。
ヒント : プロセス フローの名前が正確にわからない場合は、
processflow list コマンドを使用してプロセス フロー
名のリストを取得できます。
例
この例は、"My Process Flow" というプロセス フローをエクスポーズします。
processflow expose --n "My Process Flow"
processflow import
processflow import コマンドは、プロセス フロー ファイル (.pf ファイル) をサーバーにインポー
トします。processflow export コマンドを使用してサーバーからプロセス フローをエクスポート
すると、プロセス フロー ファイルが作成されます。
管理ガイド
159
コマンド
使用方法
processflow import --fProcessFlowFile --uTrueOrFalse
必須
引数
説明
はい
--f
ProcessFlowFile
インポートするプロセス フロー ファイル (.pf ファイル) を指定しま
す。ここでは、管理ユーティリティを実行しているディレクトリへの
相対パスを使用します。
いいえ
--u TrueOrFalse
同じ名前のプロセス フローが既にサーバー上に存在する場合、既存の
プロセス フローを上書きするかどうかを指定します。ここで、
TrueOfFalse は次のいずれかです。
true
インポートするプロセス フローと同じ名前のプ
ロセス フローがサーバー上に存在する場合、
サーバー上のプロセス フローは上書きされま
す。これがデフォルト設定です。
false
インポートするプロセス フローと同じ名前のプ
ロセス フローがサーバー上に存在する場合、プ
ロセス フローのインポートは行われません。
例
この例は、MyProcessFlow.pf というプロセス フローをインポートします。この
ファイルは、管理ユーティリティを実行している場所の exported というサブフォ
ルダにあります。
processflow import --f exported\MyProcessFlow.pf
processflow list
processflow list コマンドは、サーバー上のすべてのプロセス フローを一覧表示します。プロセ
ス フローごとに、プロセス フロー名と、そのプロセス フローがエクスポーズされているかどうかが
表示されます。
使用方法
processflow list
processflow unexpose
processflow unexpose コマンドは、プロセス フローを実行できない状態にします。
使用方法
processflow unexpose --nProcessFlowName
必須
引数
説明
はい
--n
アンエクスポーズするプロセス フローの名前を指定します。プロセス
ProcessFlowName フローの名前にスペースが含まれている場合は、その名前を引用符で
囲みます。
ヒント : プロセス フローの名前が正確にわからない場合は、
processflow list コマンドを使用してプロセス フロー
名のリストを取得できます。
160
Spectrum™ Technology Platform 9.0 SP3
第 9 章 : 管理ユーティリティの使用
例
この例は、"My Process Flow" というプロセス フローをアンエクスポーズします。
processflow unexpose --n "My Process Flow"
processflow version list
コマンド processflow version list は、プロセス フローのすべての保存済みバージョンのバー
ジョン情報を表示します。これには、バージョン番号、作成者、作成日、コメント、公開バージョン
が含まれます。
使用方法
processflow version list --nProcessFlowName
必須
引数
説明
はい
--n
バージョン情報を表示するプロセス フローの名前を指定します。 プ
ProcessFlowName ロセス フローの名前にスペースが含まれている場合は、その名前を引
用符で囲みます。
ヒント : プロセス フローの名前が正確にわからない場合は、
processflow list コマンドを使用してプロセス フロー
名のリストを取得できます。
例
この例では、"My Process Flow" という名前のプロセス フローのバージョン情報を
表示します。
processflow version list --n "My Process Flow"
サービス
service list
service list コマンドは、サーバーに公開されたサービスを一覧に表示します。 公開されていな
いサービスは、一覧に表示されません。
注 : サービスを公開するには、dataflow expose コマンドを使用します。
使用方法
service list
service loglevel list
service loglevel list コマンドは、各サービスのログに含まれる詳細レベルを一覧に示します。
次のログ レベルがあります。
Default
サービスでは、システム デフォルトのログ レベルが使用されます。 システム ログ レベ
ルは、systemloglevel set コマンドを使用して設定できます。
Disabled すべてのイベント ログを無効にします。
管理ガイド
161
コマンド
Fatal
最小限のログです。致命的なエラーのみを記録します。 致命的なエラーとは、システム
を使用不可能にするエラーのことです。
Error
エラーと致命的なエラーのみを記録します。 エラーが生じると、単一の呼び出し、ある
いは単一のサービスが使用不可能になりますが、システム全体が使用不可能になること
はありません。 特定のサービスがロードできないという現象は、エラーである可能性が
あります。他のサービスは使用できる場合があるからです。
Warn
イベント警告とエラーを記録します。 警告とは、システムの動作を停止することのない
問題を指します (例えば、サービスのロード時にパラメータに無効な値が設定されている
場合には、警告が発行され、デフォルトのパラメータが使用されます)。 サービスの使用
時に、結果は返ってきたが問題が存在するという場合に、警告がログに記録されます。
例えば、大文字と小文字の区別で小文字が指定されているが、カナダでは大文字と小文
字の区別がサポートされていない、といった場合が挙げられます。 この場合、結果とと
もに、大文字と小文字の区別のオプションが無視されたという警告が返されます。
Info
高いレベルのシステム情報を記録します。 これは、実稼働に適した最も詳細なログ レベ
ルです。 情報ログ レベルは通常、起動時および初期化時に使用され、製品およびバー
ジョン情報や、どのサービスがロードされたかなどの情報を提供します。
Debug
システムの問題のデバッグ時に適した、非常に詳細なログ レベルです。
Trace
プログラムの実行 (メソッドの開始と終了) をトレースする、最も詳細なログ レベルで
す。 デバッグに使用する詳細なプログラム フロー情報を提供します。
使用方法
service loglevel list
service loglevel set
service loglevel set コマンドは、サービス ログに含まれる詳細レベルを指定します。
デフォルトのログ レベルや、システム上の各サービスのログ レベルを指定することができます。 ロ
グ レベルを変更しても、変更前に作成されたログ エントリにはその変更は反映されません。
使用方法
service loglevel set --sServiceName --l LogLevel
必須
引数
説明
はい
--s serviceName, ログ レベルを設定するサービスの名前を指定します。
はい
--l LogLevel
サービスのログ レベルを指定します。ここで、LogLevel は次のいず
れかです。
Default サービスでは、システム デフォルトのログ レベルが使用さ
れます。 システム ログ レベルは、systemloglevel set
コマンドを使用して設定できます。
Disabled すべてのイベント ログを無効にします。
162
Fatal
最小限のログです。致命的なエラーのみを記録します。 致
命的なエラーとは、システムを使用不可能にするエラーの
ことです。
Error
エラーと致命的なエラーのみを記録します。 エラーが生じ
ると、単一の呼び出し、あるいは単一のサービスが使用不
可能になりますが、システム全体が使用不可能になること
はありません。 特定のサービスがロードできないという現
Spectrum™ Technology Platform 9.0 SP3
第 9 章 : 管理ユーティリティの使用
必須
引数
説明
象は、エラーである可能性があります。他のサービスは使
用できる場合があるからです。
Warn
イベント警告とエラーを記録します。 警告とは、システム
の動作を停止することのない問題を指します (例えば、サー
ビスのロード時にパラメータに無効な値が設定されている
場合には、警告が発行され、デフォルトのパラメータが使
用されます)。 サービスの使用時に、結果は返ってきたが問
題が存在するという場合に、警告がログに記録されます。
例えば、大文字と小文字の区別で小文字が指定されている
が、カナダでは大文字と小文字の区別がサポートされてい
ない、といった場合が挙げられます。 この場合、結果とと
もに、大文字と小文字の区別のオプションが無視されたと
いう警告が返されます。
Info
高いレベルのシステム情報を記録します。 これは、実稼働
に適した最も詳細なログ レベルです。 情報ログ レベルは
通常、起動時および初期化時に使用され、製品およびバー
ジョン情報や、どのサービスがロードされたかなどの情報
を提供します。
Debug
システムの問題のデバッグ時に適した、非常に詳細なログ
レベルです。
Trace
プログラムの実行 (メソッドの開始と終了) をトレースす
る、最も詳細なログ レベルです。 デバッグに使用する詳細
なプログラム フロー情報を提供します。
各ログ レベルは、1 つ上のログ レベルの内容を含みます。 つまり、
警告ログ レベルが選択されている場合、エラーと致命的なエラーも記
録されます。 情報ログ レベルが選択されている場合は、情報メッセー
ジ、警告、エラー、および致命的なエラーが記録されます。
注 : 最も詳細なログ レベルを選択すると、システムのパフォーマン
スに影響が生じる恐れがあります。 したがって、必要なログ要
件を満たす最小レベルの設定を選択する必要があります。
例
この例では、ValidateAddress のログ レベルを Warn に設定します。
service loglevel set --s ValidateAddress --l Warn
list serviceoptions
list serviceoptions コマンドは、サービスに適用できるオプションを一覧に表示します。各サー
ビスのオプションと値については、『API ガイド』、『REST Web サービス ガイド』、または『SOAP
Web サービス ガイド』を参照してください。
使用方法
list serviceoptions --sServiceName
必須
引数
はい
--s serviceName, オプションを表示するサービスの名前を指定します。サービス名は大
文字と小文字を区別します。
管理ガイド
説明
163
コマンド
例
この例では、ValidateAddress サービスに適用できるオプションのリストを表示しま
す。
list serviceoptions --s ValidateAddress
service option set
service option set コマンドは、サービス オプションのデフォルト設定を指定します。
デフォルト サービス オプションは、システム上の各サービスのデフォルトの動作を制御します。 サー
ビス内の各オプションのデフォルト値を指定できます。 デフォルト オプション設定は、API 呼び出し
または Web サービス リクエストで、オプションの値が明示的に定義されていない場合に有効です。
また、デフォルト サービス オプションは、Enterprise Designer でこのサービスを使用してデータフ
ローを作成する際にデフォルトとして使用される設定です。
使用方法
service option set --sServiceName --o OptionName--v Value
必須
引数
説明
はい
--s serviceName, オプションを設定するサービスの名前を指定します。 サービス名は大
文字と小文字を区別します。
はい
--o OptionName
設定するオプションの名前。 各サービスのオプションと値について
は、『API ガイド』、『REST Web サービス ガイド』、または『SOAP
Web サービス ガイド』を参照してください。
はい
--v 値
オプションに設定する値。 各サービスのオプションと値については、
『API ガイド』、『REST Web サービス ガイド』、または『SOAP
Web サービス ガイド』を参照してください。
例
この例では、ValidateAddress サービスの MaximumResults オプションを 15 に設定
します。
service option set --s ValidateAddress --o MaximumResults --v
15
システム
close
close コマンドは、Spectrum™ Technology Platform サーバーとのセッションを閉じます。管理ユー
ティリティを終了しないでサーバーとの接続を閉じる場合は、このコマンドを使用します。exit コマ
ンドを使用すると、セッションを閉じて管理ユーティリティを終了できます。
使用方法
close
164
Spectrum™ Technology Platform 9.0 SP3
第 9 章 : 管理ユーティリティの使用
connect
connect コマンドは、指定した Spectrum™ Technology Platform サーバーとのセッションを開きま
す。 他のコマンドを実行する前に、connect コマンドを実行する必要があります。
使用方法
connect --hHostName --u UserName--p Password --sTrueOrFalse
必須
引数
説明
はい
--h HostName
接続先のホスト名とポート。コロンで区切って指定します。 例えば、
MyServer のポート 8080 に接続するには、--h MyServer:8080 と
指定します。
はい
--u UserName
サーバーとの認証に使用するユーザ名。
はい
--p パスワード
ユーザのパスワードです。
いいえ
--s TrueOrFalse
SSL を使用してセキュアな接続を作成するかどうかを指定します。
サーバーが SSL 通信をサポートするように構成されている場合は、セ
キュアな通信を介して接続しなければなりません。 TrueOrFalse は、
次のいずれかです。
true
SSL を使用します。
false
SSL を使用しません。 これがデフォルト設定で
す。
例
この例では、ユーザ名 admin とパスワード myPassword1 を使用して、サーバー
MyServer のポート 8080 への接続を開きます。
connect --h MyServer:8080 --u admin --p myPassword1
関連リンク
HTTPS 通信の設定（36ページ）
date
date コマンドは、管理ユーティリティを実行しているコンピュータの現在の日付と時刻を表示しま
す。
使用方法
date
exit
exit コマンドは、セッションを閉じ、管理ユーティリティを終了します。セッションを閉じるだけ
で、管理ユーティリティは終了しない場合は、close コマンドを使用します。
使用方法
exit
管理ガイド
165
コマンド
help
help コマンドは、管理ユーティリティで使用できるコマンドのリストを表示します。各コマンドで使
用するパラメータについても、help コマンドで情報を表示できます。
使用方法
help Command
必須
引数
説明
いいえ
Command
コマンド名をパラメータとして help コマンドに指定すると、そのコ
マンドに関する詳しい情報が表示されます。コマンド名を指定しない
場合は、すべてのコマンドのリストが表示されます。
例
次のコマンドを実行すると、管理ユーティリティで使用可能なコマンドのリストが
表示されます。
help
次のコマンドは、set serviceoption コマンドの詳しい情報を表示します。
help set serviceoption
license expirationinfo export
license expirationinfo export コマンドは、有効期限が近づいているライセンスのリストをエ
クスポートします。 これらのライセンスは、Management Console の [通知] タブで指定した期間内に
期限切れとなるものです。
使用方法
license expirationinfo export --oDirectory
必須
引数
説明
いいえ
--o Directory
ライセンス有効期限情報のエクスポート先とするディレクトリを指定
します。 ここでは、管理ユーティリティを実行しているディレクトリ
への相対パスを使用します。 このオプションを省略すると、有効期限
情報は管理ツールを実行しているフォルダ内のファイルに格納されま
す。
例
この例では、ライセンス有効期限情報を、管理ツールがあるフォルダの下の
LicenseExpiration サブフォルダにエクスポートします。
license expirationinfo export --o LicenseExpiration
license expirationinfo list
license expirationinfo list コマンドは、有効期限が近づいているライセンスのリストを返し
ます。 表示されるライセンスは、Management Console の [通知] タブで指定した期間内に期限切れと
なるものです。
166
Spectrum™ Technology Platform 9.0 SP3
第 9 章 : 管理ユーティリティの使用
使用方法
license expirationinfo list
licenseinfo export
licenseinfo export コマンドは、ライセンス情報をファイルにエクスポートします。 ライセンス
ファイルは、ライセンスの問題をテクニカル サポートが解決する際に必要となります。
使用方法
licenseinfo export --oDirectory
必須
引数
説明
いいえ
--o Directory
ライセンス ファイルのエクスポート先とするディレクトリを指定しま
す。 ここでは、管理ユーティリティを実行しているディレクトリへの
相対パスを使用します。 このオプションを省略すると、ライセンス
ファイルは管理ツールを実行しているフォルダ内のファイルに格納さ
れます。
例
この例では、ライセンス情報を、管理ツールがあるフォルダの下の License サブフォ
ルダにエクスポートします。
licenseinfo export --o License
list licenseinfo
list licenseinfo コマンドは、インストールされているライセンス、ライセンスの有効期限まで
の日数、残りのトランザクション数などのライセンス情報を表示します。
使用方法
list licenseinfo
server backup
Spectrum™ Technology Platform サーバーのバックアップを行うには、server backup コマンドを
使用します。
Spectrum™ Technology Platform サーバーをバックアップするには、サーバーの構成データベースの
バックアップ コピーを作成する必要があります。構成データベースには、セキュリティ設定、データ
フロー、サービス オプション、データ リソース定義、その他の構成情報が含まれています。サーバー
のシステム障害やその他の災害でサーバーが稼働できなくなった場合、構成データベースのバックアッ
プを使用してサーバー構成を別の Spectrum™ Technology Platform サーバーに復元できます。
使用方法
server backup --oDirectory
必須
引数
説明
いいえ
--o Directory
サーバーのデータベースのバックアップ コピーの保存先ディレクトリ
を指定します。ここでは、管理ユーティリティを実行しているディレ
クトリへの相対パスを使用します。このオプションを省略すると、管
理ツールを実行しているフォルダがバックアップの置き場所になりま
す。
管理ガイド
167
コマンド
例
この例は、管理ツールが存在するフォルダの下にある LatestServerBackup サブフォ
ルダにバックアップを保存します。
server backup --o LatestServerBackup
関連リンク
バックアップのスケジュール化（130ページ）
バックアップを手動で作成する（131ページ）
サーバーの復元（131ページ）
script
script コマンドは、一連のコマンドが含まれるスクリプトの実行を管理ツールに指示します。スク
リプトを使用して、管理タスクを自動化できます。
使用方法
script --fileScriptFile --linenumbers TrueOrFalse
必須
引数
説明
はい
--file ScriptFile
スクリプト ァイルへのパスを指定します。
いいえ
--linenumbers TrueOrFalse
スクリプトの実行中に行番号を表示するかどうか
を指定します。ここで、TrueOrFalse は次のいず
れかです。
true
スクリプトの実行中に行番
号を表示します。
false
スクリプトの実行中に行番
号を表示しません。この値
がデフォルトです。
例
この例では、myscript.cli という名前でフォルダ scripts の下に格納されてい
るスクリプトを実行します。このフォルダは、管理ユーティリティがあるフォルダ
のサブフォルダです。
script --fle scripts/myscript.cli
関連リンク
管理ユーティリティをスクリプトから使用する（135ページ）
system loglevel get
system loglevel get コマンドはサービスのデフォルトのログ レベルを返します。 ログ レベルは
次のとおりです。
168
Off
すべてのイベント ログを無効にします。
Fatal
最小限のログです。致命的なエラーのみを記録します。 致命的なエラーとは、システムを
使用不可能にするエラーのことです。
Spectrum™ Technology Platform 9.0 SP3
第 9 章 : 管理ユーティリティの使用
Error
エラーと致命的なエラーのみを記録します。 エラーが生じると、単一の呼び出し、あるい
は単一のサービスが使用不可能になりますが、システム全体が使用不可能になることはあ
りません。 特定のサービスがロードできないという現象は、エラーである可能性がありま
す。他のサービスは使用できる場合があるからです。
Warn
イベント警告とエラーを記録します。 警告とは、システムの動作を停止することのない問
題を指します (例えば、サービスのロード時にパラメータに無効な値が設定されている場
合には、警告が発行され、デフォルトのパラメータが使用されます)。 サービスの使用時
に、結果は返ってきたが問題が存在するという場合に、警告がログに記録されます。 例え
ば、大文字と小文字の区別で小文字が指定されているが、カナダでは大文字と小文字の区
別がサポートされていない、といった場合が挙げられます。 この場合、結果とともに、大
文字と小文字の区別のオプションが無視されたという警告が返されます。
Info
高いレベルのシステム情報を記録します。 これは、実稼働に適した最も詳細なログ レベ
ルです。 情報ログ レベルは通常、起動時および初期化時に使用され、製品およびバージョ
ン情報や、どのサービスがロードされたかなどの情報を提供します。
Debug
システムの問題のデバッグ時に適した、非常に詳細なログ レベルです。
Trace
プログラムの実行 (メソッドの開始と終了) をトレースする、最も詳細なログ レベルです。
デバッグに使用する詳細なプログラム フロー情報を提供します。
使用方法
system loglevel get
system loglevel set
system loglevel set コマンドはシステム上のサービスのデフォルトのログ レベルを設定します。
使用方法
system loglevel set --lレベル
必須
引数
説明
はい
--l レベル
システム上のサービスのデフォルトのログ レベルを指定します。ここ
で、レベルは次のいずれかです。
Off
すべてのイベント ログを無効にします。
Fatal 最小限のログです。致命的なエラーのみを記録します。 致命
的なエラーとは、システムを使用不可能にするエラーのこと
です。
Error エラーと致命的なエラーのみを記録します。 エラーが生じる
と、単一の呼び出し、あるいは単一のサービスが使用不可能
になりますが、システム全体が使用不可能になることはあり
ません。 特定のサービスがロードできないという現象は、エ
ラーである可能性があります。他のサービスは使用できる場
合があるからです。
Warn イベント警告とエラーを記録します。 警告とは、システムの
動作を停止することのない問題を指します (例えば、サービス
のロード時にパラメータに無効な値が設定されている場合に
は、警告が発行され、デフォルトのパラメータが使用されま
す)。 サービスの使用時に、結果は返ってきたが問題が存在す
るという場合に、警告がログに記録されます。 例えば、大文
字と小文字の区別で小文字が指定されているが、カナダでは
大文字と小文字の区別がサポートされていない、といった場
管理ガイド
169
コマンド
必須
引数
説明
合が挙げられます。 この場合、結果とともに、大文字と小文
字の区別のオプションが無視されたという警告が返されます。
Info
高いレベルのシステム情報を記録します。 これは、実稼働に
適した最も詳細なログ レベルです。 情報ログ レベルは通常、
起動時および初期化時に使用され、製品およびバージョン情
報や、どのサービスがロードされたかなどの情報を提供しま
す。
Debug システムの問題のデバッグ時に適した、非常に詳細なログ レ
ベルです。
Trace プログラムの実行 (メソッドの開始と終了) をトレースする、
最も詳細なログ レベルです。 デバッグに使用する詳細なプロ
グラム フロー情報を提供します。
注 : 最も詳細なログ レベルを選択すると、システムのパフォーマン
スに影響が生じる恐れがあります。 したがって、必要なログ要
件を満たす最小レベルの設定を選択する必要があります。
例
この例では、デフォルトのログ レベルを Warn に設定します。
systemloglevel set --l warn
system properties
system properties コマンドは、管理ユーティリティを実行するシェルに関する情報 (Java プロパ
ティ、OS のバージョンなど) を表示します。Spectrum™ Technology Platform サーバーに関する情報
は表示しません。
使用方法
system properties
versioninfo export
versioninfo export コマンドは、システム、コンポーネント、およびサービスのバージョン情報
をファイルにエクスポートします。
使用方法
versioninfo export --oDirectory
170
必須
引数
説明
いいえ
--o Directory
バージョン情報テキスト ファイルのエクスポート先ディレクトリを指
定します。 ここでは、管理ユーティリティを実行しているディレクト
リへの相対パスを使用します。 このオプションを省略すると、管理
ツールを実行しているフォルダがバージョン情報ファイルの置き場所
になります。
Spectrum™ Technology Platform 9.0 SP3
第 9 章 : 管理ユーティリティの使用
例
この例は、管理ツールが存在するフォルダの下にある VersionInformation サブフォ
ルダにライセンス情報をエクスポートします。
versioninfo export --o VersionInformation
list versioninfo
list versioninfo コマンドは、システムにインストールされている Spectrum™ Technology Platform
のバージョンや基盤となるコンポーネントに関する情報、およびその他のシステム情報を表示します。
使用方法
list versioninfo
テーブル
table delete
table delete コマンドは、テーブルをシステムから削除します。詳細については、『データ品質ガ
イド』の「検索テーブル」セクションを参照してください。
使用方法
table deleteTableName--t TableType
必須
引数
説明
はい
--n TableName
削除するテーブルを指定します。
はい
--t TableType
削除するテーブルのタイプ (AdvancedTransformer、OpenParser、ま
たは TableLookup) を指定します。
例
この例は、My Table という名前の Table Lookup テーブルを削除します。
table delete My Table --t TableLookup
table export
table export コマンドは、Enterprise Designer のテーブル管理機能を使用して作成されたカスタム
テーブルをエクスポートします。その後、このテーブルは別のサーバーにインポートできます。詳細
については、『データ品質ガイド』の「検索テーブル」セクションを参照してください。
使用方法
table export TableName--t TableType --o OutputDirectory
必須
引数
説明
はい
--n TableName
エクスポートするテーブルの名前を指定します。
ヒント : テーブルの名前が正確にわからない場合は、table list
コマンドを使用してテーブル名のリストを取得できます。
管理ガイド
171
コマンド
必須
引数
説明
はい
--t TableType
エクスポートするテーブルのタイプ (AdvancedTransformer、
OpenParser、または TableLookup) を指定します。
いいえ
--o
OutputDirectory
テーブルのエクスポート先ディレクトリを指定します。ここでは、管
理ユーティリティを実行しているディレクトリへの相対パスを使用し
ます。この引数を省略すると、テーブルは管理ユーティリティと同じ
ディレクトリにエクスポートされます。
例
この例は、"My Table" という名前の Open Parser テーブルを、管理ユーティリティ
がインストールされている場所にエクスポートします。
table export My Table --t OpenParser
table import
table import コマンドは、カスタム テーブルをサーバーにインポートします。カスタム テーブル
は、Enterprise Designer のテーブル管理機能を使用して作成されます。詳細については、『データ品
質ガイド』の「検索テーブル」セクションを参照してください。
使用方法
table import CustomTable--u TrueOrFalse
必須
引数
説明
はい
--f CustomTable
インポートするカスタム テーブルを指定します。ここでは、管理ユー
ティリティを実行しているディレクトリへの相対パスを使用します。
いいえ
--u TrueOrFalse
同じ名前のテーブルが既にサーバー上に存在する場合、既存のテーブ
ルを上書きするかどうかを指定します。ここで、TrueOfFalse は次の
いずれかです。
true
インポートするテーブルと同じ名前のテーブル
がサーバー上に存在する場合、サーバー上の
テーブルは上書きされます。これがデフォルト
設定です。
false
インポートするテーブルと同じ名前のテーブル
がサーバー上に存在する場合、テーブルのイン
ポートは行われません。
例
この例は、MyTable.db というテーブルをインポートします。このテーブルは、管
理ユーティリティを実行している場所の exported というサブフォルダにありま
す。-u コマンドが指定されていないため、サーバー上に同じ名前のテーブルがあれ
ば上書きされます。
table import exported\MyTable.db
172
Spectrum™ Technology Platform 9.0 SP3
第 9 章 : 管理ユーティリティの使用
table list
table list コマンドは、サーバー上のすべてのテーブルを一覧表示します。テーブルごとに、テー
ブル名と、データフローがエクスポーズされているかどうかの情報が表示されます。
使用方法
table list --tTableType
必須
引数
説明
はい
--t TableType
一覧表示するテーブルのタイプ (AdvancedTransformer、OpenParser、
または TableLookup) を指定します。
例
この例は、すべての Advanced Transformer テーブルを一覧表示します。
table list --t AdvancedTransformer
ユーザ アカウント
user create
user create コマンドは、新しいユーザを作成し、役割をそのユーザに割り当てます。
使用方法
user create --uUserName --p Password--d Description --eEmailAddress --r Roles
必須
引数
説明
はい
--u UserName
新しいユーザの名前を指定します。
はい
--p パスワード
新しいユーザのパスワードを変更します。
いいえ
--d 説明
ユーザの説明を指定します。 説明にスペースが含まれる場合は、説明
を引用符で囲みます。
いいえ
--e EmailAddress 新しいユーザの電子メール アドレスを指定します。
いいえ
--r 役割
ユーザの役割を指定します。 複数の役割を指定するには、カンマで区
切ります。 スペースは使用できません。 役割の名前にスペースが含
まれる場合は、名前を引用符で囲みます。
例
この例では、allan12 という名前で新しいユーザを作成し、myPassword1 というパ
スワード、 Allan P. Smith という説明、[email protected] という電子メール アド
レス、および USBanking と California Users という 2 つの役割をこのユーザに割り
当てます。
user create --u allan12 --p myPassword1 --d "Allan P. Smith"
--e [email protected] --r USBanking,"California Users"
管理ガイド
173
コマンド
delete user
delete user コマンドは、ユーザ アカウントをシステムから削除します。
ヒント : また、ユーザ アカウントは無効にすることもできます。ユーザ アカウントを無効にすると、
アカウントを削除しなくても、システムへのアクセスにそのアカウントを使用できなくなり
ます。
使用方法
delete user --uUserName
必須
引数
説明
はい
--u UserName
削除するユーザの名前を指定します。
例
この例では、allan12 というユーザ アカウントを削除します。
delete user --u allan12
user description set
user description set コマンドは、アカウントの説明を変更します。
使用方法
user description set --uUserName --d Description
必須
引数
説明
はい
--u UserName
説明を変更するユーザ アカウントを指定します。
はい
--d 説明
ユーザの説明を指定します。 説明にスペースが含まれる場合は、説明
を引用符で囲みます。
例
この例では、ユーザ allan12 の説明を "Allan P. Smith" に変更します。
user description set --u allan12 --d "Allan P. Smith"
user email set
user email set コマンドは、ユーザに関連付けられた電子メール アドレスを変更します。
使用方法
user email set --uUserName --e EmailAddress
174
必須
引数
説明
はい
--u UserName
電子メールを変更するユーザ アカウントを指定します。
はい
--e EmailAddress ユーザに関連付けられた電子メール アドレスを指定します。
Spectrum™ Technology Platform 9.0 SP3
第 9 章 : 管理ユーティリティの使用
例
この例では、account allan12 というユーザ アカウントの電子メール アドレスを
[email protected] に設定します。
user email set --u allan12 --e [email protected]
user enabled set
user enabled set コマンドは、ユーザ アカウントを有効または無効にします。
ユーザ アカウントを無効にすると、そのユーザ アカウントを Spectrum™ Technology Platform へのア
クセスに使用できなくなります。 ユーザ アカウントを無効にすると、そのユーザ アカウントを
Management Console、Enterprise Designer、または Interactive Driver へのアクセスに使用できなくな
ります。 また、そのユーザ アカウントを使用して実行がスケジュールされているジョブもすべて実行
できなくなります。 そのユーザ アカウントを使用する API 呼び出しも機能しなくなります。
注 : "admin" ユーザ アカウントは無効にできません。
使用方法
user enabled set --uUserName --e TrueOrFalse
必須
引数
説明
はい
--u UserName
無効にするユーザの名前を指定します。
はい
--e TrueOrFalse
ユーザ アカウントを有効にするか無効にするかを指定します。ここで
TrueOfFalse は次のいずれかです。
true
ユーザ アカウントを有効にします。
false
ユーザ アカウントを無効にします。
例
この例では、allan12 というユーザ アカウントを無効にします。
user enabled set --u allan12 --e false
user list
user list コマンドは、ユーザのリストを返します。 各ユーザーの役割、電子メール アドレス、説
明、ユーザが有効か無効かを一覧にして返します。
使用方法
user list
user password set
user password set コマンドは、ユーザ アカウントのパスワードを変更します。
使用方法
user password set --uUserName --p Password
管理ガイド
175
コマンド
必須
引数
説明
はい
--u UserName
パスワードを変更するユーザ アカウントを指定します。
はい
--p パスワード
ユーザ アカウントに割り当てるパスワードを指定します。
例
この例では、allan12 というユーザ アカウントのパスワードを mypassword1 に設定
します。
user password set --u allan12 --p mypassword1
user role grant
user role grant コマンドは、1 つ以上の役割をユーザに割り当てます。
使用方法
user role grant --uUserName --r Roles
必須
引数
説明
はい
--u UserName
役割を割り当てるユーザの名前を指定します。
はい
--r 役割
ユーザの役割を指定します。 複数の役割を指定するには、カンマで区
切ります。 スペースは使用できません。 役割の名前にスペースが含
まれる場合は、名前を引用符で囲みます。
例
この例では、2 つの役割 USBanking と CaliforniaUsers をユーザ allan12 に割り当て
ます。
user role grant --u allan12 --r USBanking,CaliforniaUsers
user role list
user role list コマンドは、システムにある役割のリストを返します。
使用方法
user role list
user role revoke
user role revoke コマンドは、ユーザから役割を削除して、役割によって付与された権限を取り
消します。
使用方法
user role revoke --uUserName --r Roles
176
必須
引数
説明
はい
--u UserName
役割を取り消すユーザの名前を指定します。
はい
--r 役割
取り消す役割を指定します。 複数の役割を指定するには、カンマで区
切ります。 スペースは使用できません。 役割の名前にスペースが含
まれる場合は、名前を引用符で囲みます。
Spectrum™ Technology Platform 9.0 SP3
第 9 章 : 管理ユーティリティの使用
例
この例では、ユーザ allan12 の役割 USBanking を取り消します。
user role revoke --u allan12 --r USBanking
管理ガイド
177
クラスタの管理
このセクションの構成
• クラスタ アーキテクチャ . . . . . . . . . . . . . . . . . . . . . . . . . .180
• クラスタでのクライアント ツールの使用 . . . . . . . . . . . . .181
• クラスタへのノードの追加 . . . . . . . . . . . . . . . . . . . . . . . . .181
• クラスタからのノードの削除 . . . . . . . . . . . . . . . . . . . . . . .182
• クラスタのシャットダウン . . . . . . . . . . . . . . . . . . . . . . . . .182
• Location Intelligence モジュール用のクラスタの管理 . . .183
10
クラスタ アーキテクチャ
クラスタ アーキテクチャ
Spectrum™ Technology Platform のクラスタ環境では、サーバーの複数のインスタンスが処理を共有
します。 Spectrum™ Technology Platform とのすべての通信は、ロード バランサーを通して行われま
す。 Spectrum™ Technology Platform サーバーの URL とポートを使用する代わりに、ロード バラン
サーの URL とポートを使用します。
次の図は、このアーキテクチャを表したものです。
ロード バランサー
クラスタに要求が届くと、ロード バランサーは要求の処理に使用できる最善の Spectrum™ Technology
Platform ノードを特定します。 要求はその Spectrum™ Technology Platform ノードに渡されます。
分散アーキテクチャは、ユーザからは見えないところで自動的に処理されます。 ユーザは、単独の
Spectrum™ Technology Platform サーバーの場合と同じように、ロード バランサーの Spectrum™
Technology Platform の URL とポート (通常、分散環境の場合はポート 80) に要求を送信します。
Spectrum ノード
各 Spectrum ノードは、構成データベースのコピーを保持しています。 各コピーは常に同期されてい
ます。 これにより、各ノードは同じ設定を共有できます。 構成データベースが共有されるため、クラ
スタのライセンス情報、データフロー、データベース リソースなどを集中管理できます。
クラスタを構成するには、Management Console または Enterprise Designer で Spectrum™ Technology
Platform に対するロード バランサーの URL とポート (通常、分散環境の場合はポート 80) を指定する
だけです。
外部リソース
データベース リソース (郵便データベース、ジオコーディング データベースなど)、JDBC 接続、ファ
イル サーバーなどの外部リソースの定義は、構成データベースに存在します。 リソース自体 (データ
ベース、ファイル、Web サービス) は、ユーザが自由に選択できます。
データベース リソース自体はクラスタの外部にあるので、複数のクラスタが同じデータベース リソー
スを共有できます。 Management Console を使用してクラスタごとにリソース定義を作成する必要が
あります。 例えば、複数のクラスタで同じジオコーディング データベースを共有する場合は、各クラ
180
Spectrum™ Technology Platform 9.0 SP3
第 10 章 : クラスタの管理
スタからアクセスできるサーバーにジオコーディング データベースをインストールし、各クラスタが
そのジオコーディング データベースを参照するように Management Console で設定します。
クラスタでのクライアント ツールの使用
1. クライアント ツールを起動します (Management Console、Enterprise Designer、または Interactive
Driver)。
2. [サーバー名] フィールドに、ロード バランサーのサーバー名を入力します。
3. [ポート] フィールドに、ロード バランサーがリッスンするように設定したポートを入力します。
Note: 入力ファイル、出力ファイル、およびデータベース リソースは、共有ドライブ、ファイル
サーバー、またはその他の共通にアクセスできる場所に置く必要があります。 そうしない
場合は、Spectrum™ Technology Platform サーバーをホストする各サーバーにすべてのファ
イルをロードする必要があり、すべてのファイルが同じパスに存在する必要があります。
ログインした後は、普通にクライアント ツールを使用できます。 実行するアクションは、ログインし
ているクラスタのすべての Spectrum™ Technology Platform インスタンスに対して適用されます。
クラスタへのノードの追加
ロード バランサーと少なくとも 1 つの Spectrum™ Technology Platform ノードを含むクラスタを既に
セットアップしてあり、新しい Spectrum™ Technology Platform ノードを追加する場合は、以下の手
順で行います。
1. ノードをホストするサーバーに Spectrum™ Technology Platform をインストールします。 手順に
ついては、『Spectrum™ Technology Platform インストール ガイド』を参照してください。
2. サーバーをインストールした後、サーバーを停止します。
• Unix または Linux では、作業ディレクトリを Spectrum™ Technology Platform サーバーの bin
ディレクトリに変更し、セットアップ ファイルのソースを指定して、コマンド./server.stop
を入力します。
• Windows の場合は、システム トレイの Spectrum™ Technology Platform アイコンを右クリック
し、[サーバーの停止] を選択します。
3. ファイル server/app/conf/spectrum-container.properties を次のように編集します。
spectrum.cluster.enabled
これを true に設定します。
spectrum.cluster.name
これには、このノードを参加させるクラスタの名前を設定します。
spectrum.cluster.address
これには、このノードをバインドするネットワーク インターフェイスを設定します。
ノードをすべてのネットワーク インターフェイスにバインドする場合は、0.0.0.0 を
指定します。
spectrum.cluster.seeds
これには、このノードがクラスタに参加したときにこのノードにコピーされる構成
データベースのコピー元の Spectrum™ Technology Platform サーバーの IP アドレス
を設定します。
管理ガイド
181
クラスタからのノードの削除
カンマで区切って複数の IP アドレスを指定できます。 1 つのサーバーがダウンした
場合でも他のサーバーを使用してノードをクラスタに参加させることができるよう
に、複数のシード ノードを指定する必要があります。 各シード ノードへのアクセス
は、リストの順序で試みられます。 どのシード ノードにもアクセスできない場合、
ノードはクラスタに参加しません。
4. 以下の行のコメントを解除します。
spectrum.runtime.hostname=localhost
spectrum.runtime.port=80
これらの値を、ロード バランサーのホスト名と、ロード バランサーがリッスンするように設定し
たポートに変更します。
5. spectrum-container.properties ファイルを保存して閉じます。
6. サーバーを開始します。
• Unix または Linux では、作業ディレクトリを Spectrum™ Technology Platform サーバーの bin
ディレクトリに変更し、セットアップ ファイルのソースを指定して、コマンド./server.start
を入力します。
• Windows の場合は、システム トレイの Spectrum™ Technology Platform アイコンを右クリック
し、[サーバーの開始] を選択します。
クラスタからのノードの削除
クラスタからノードを削除するには、Spectrum™ Technology Platform サーバーを停止します。
• Unix または Linux では、作業ディレクトリを Spectrum™ Technology Platform サーバーの bin ディ
レクトリに変更し、セットアップ ファイルのソースを指定して、コマンド ./server.stop を入力
します。
• Windows の場合は、システム トレイの Spectrum™ Technology Platform アイコンを右クリックし、
[サーバーの停止] を選択します。
次回起動時にはサーバーがクラスタに参加しないようにする場合は、
server/app/conf/spectrum-container.properties ファイルをテキスト エディターで開き、
spectrum.cluster.enabled を false に設定します。
Location Intelligence モジュールを使用する場合: ノードをスタンドアロンのままにして、クラスタ
の外部で実行できるようにするには、元の repository.xml ファイルをコピーして戻し、Spectrum™
Technology Platform の各インスタンスの /server/modules/spatial/jackrabbit ディレクトリ
から、repository、version、workspaces というフォルダを削除します。 サーバーを再起動し、リポジ
トリのコンテンツをインポートします。
クラスタのシャットダウン
クラスタ全体をシャットダウンするには:
• クラスタの各 Spectrum™ Technology Platform サーバーをシャットダウンします。
182
Spectrum™ Technology Platform 9.0 SP3
第 10 章 : クラスタの管理
• Unix または Linux では、作業ディレクトリを Spectrum™ Technology Platform サーバーの bin
ディレクトリに変更し、セットアップ ファイルのソースを指定して、コマンド ./server.stop
を入力します。
• Windows の場合は、システム トレイの Spectrum™ Technology Platform アイコンを右クリック
し、[サーバーの停止] を選択します。
• クラスタを再び開始するときは、最後にシャットダウンしたノードを最初に起動する必要がありま
す。
Important: ジョブ履歴や構成設定などのデータが失われるのを防ぐため、最後にシャットダウンし
たノードを起動してから、他のノードを起動します。
Location Intelligence モジュール用のクラスタの管理
システムの設定
Spectrum™ Technology Platform をインストールして共通リポジトリを設定した後、別の仮想マシン
に複製する前に、インスタンスを構成設定する必要があります。 仮想マシン環境を使用していない場
合は、インストールされている各 Spectrum™ Technology Platform に対して以下の手順を実行する必
要があります。
マップ ファイル共有の追加
マップ ファイル共有 (共有イメージ フォルダ) を Spectrum™ Technology Platform に追加できます(マッ
プ ファイル共有の作成については 187 ページを参照)。
マップ ファイル共有を追加するには、次の手順を実行します。
1. マッピング サービス構成を、共有イメージ フォルダと負荷分散サーバーを使用するように変更し
ます。ImageCache において、Directory パラメータを共通イメージ ディレクトリに変更し、
AccessBaseURL パラメータをロード バランサー マシンのイメージ URL に変更します。
仮想マシン環境を使用している場合は、この IP アドレスを覚えておいてください。ロード バラン
サー VM をこの IP に設定する必要があるためです。
<ImageCache>
<Directory>/mnt/<linux mount>/images</Directory>
<AccessBaseURL>http://<loadbalance_IP_address>/Spatial/images</AccessBaseURL>
<FileExpire>30</FileExpire>
<ScanInterval>30</ScanInterval>
</ImageCache>
2. 共有ファイル システムに移動するためのシンボリック リンクが張られたマップ イメージを設定し
ます。
cd /<spatial server root>/server/modules/spatial
rm –Rf images
ln -s / mnt/<linux mount>/images
サービス構成の変更
負荷分散のサービス構成を変更するには、次の手順を実行します。
管理ガイド
183
Location Intelligence モジュール用のクラスタの管理
各サービス構成ファイルで、<RepositoryURL> が負荷分散サーバーのリポジトリ URL を指すよう
に変更します。
RepositoryURL を http://<Spectrum>/RepositoryService/rmi から
http://<Balancer>/RepositoryService/rmi に変更して、ロード バランサーを指すように
します。
Java プロパティ ファイルの変更
Spectrum™ Technology Platform の Java プロパティを変更するには、次の手順を実行します。
1. java.properties ファイルを、負荷分散サーバーを使用するように変更します。このファイルは、
<spectrum>/server/modules/spatial/java.properties にあります。
2. images.webapp.url と、すべてのサービス ホストおよびポート番号を変更して、負荷分散サーバー
を指すようにします。
複数の Spectrum インスタンスのポートの構成
単一のマシン上に複数の Spectrum™ Technology Platform のインスタンスがある場合は、ポート番号
を変更する必要があります。
Spectrum™ Technology Platform の各インスタンスのポート番号を変更するには、次の手順を実行し
ます。
1. <Spectrum root>/server/app/conf/spectrum-container.properties 内のすべての
ポートを、使用されていない新しいポートに変更します。 http ポートは、インストーラで入力さ
れたポート番号に対応します。
2. /<spectrum root>/server/modules/spatial フォルダにある bootstrap.properties の rmi ポートを更新
します (11099 など)。 デフォルトは 1099 です。
共通リポジトリの設定
クラスタに対して共通リポジトリ データベースを使用するように、Spectrum を設定する必要があり
ます。 これによって、名前付きリソース、地理メタデータ、構成設定が、クラスタ全体で管理される
ようになります。 PostgreSQL、Oracle、または Microsoft SQL Server データベースを用いて、共通
リポジトリ データベースを使用するように Spectrum を設定できます。
リポジトリは、一連の名前付きリソース、地理メタデータ、構成ファイルとともにインストールされ
ています。 これらのリソースを共通データベース リポジトリに移行するには、リソースをデフォルト
の内部リポジトリ データベースから新しい共有リポジトリ データベースへとエクスポートする必要が
あります。
リポジトリ コンテンツのバルク エクスポート/インポートをサポートするために、リポジトリでは
WebDAV インターフェイスが提供されています。
WebDAV を使用したバルク エクスポート
インストールしたリポジトリのコンテンツをエクスポートする必要があります。このステップは 1 回
だけ実行します。Spectrum™ Technology Platform のすべてのインスタンスに対し、この時点でのリ
ポジトリのコンテンツを同一にするためです。Microsoft Windows Explorer や GNOME- Nautilus など、
多数の無償の WebDAV クライアントが存在します。以下の例では、GNOME- Nautilus を使用して
Spectrum™ Technology Platform からリソースをエクスポートしています。
1. Spectrum™ Technology Platform サーバーを開始します。
2. 以下の手順で、WebDAV を使用して Spectrum™ Technology Platform に接続します。
a) GNOME – Nautilus を使用して WebDAV ディレクトリに接続します。
184
Spectrum™ Technology Platform 9.0 SP3
第 10 章 : クラスタの管理
b) [場所] メニューで [サーバーに接続] を選択します。ここで、[ファイル ブラウザ] ウィンドウが
開きます。
リポジトリは、
http://<YourMachine>:<Port>/RepositoryService/repository/default
3. リポジトリのコンテンツをローカル ドライブにコピーします。
共通リポジトリ データベースのセットアップ
以下の手順は、負荷分散環境に含まれるすべての Spectrum™ Technology Platform インスタンスに対
して実行する必要があります。
1. Spectrum™ Technology Platform サーバーを停止します。
2. データベース JDBC ドライバを Spectrum の共通 lib ディレクトリに追加して、選択されたデータ
ベースを使用できるようにします。
この例では PostGreSQL JDBC ドライバを使用しています。/<spectrum
root>/server/modules/spatial/lib/postgresql-8.4-701.jdbc4.jar ファイルを
/<spectrum root>/server/app/lib/postgresql-8.4-701.jdbc4.jar にコピーします。
3. リポジトリがデータベースを指すように、およびクラスタリングを追加するように、/<spectrum
root>/server/modules/spatial/jackrabbit/repository.xml ファイルを編集します。
以下の変更を行います。
a) ファイルの Repository セクションと Workspace セクションの中の 2 つの FileSystem セクショ
ンを次のように変更します。
<FileSystem class="org.apache.jackrabbit.core.fs.db.DbFileSystem">
<param name="driver" value="org.postgresql.Driver"/>
<param name="url"
value="jdbc:postgresql://<hostname>:<port>/<databasename>"/>
<param name="schema" value="postgresql"/>
<param name="user" value="<user>"/>
<param name="password" value="<pwd>"/>
<param name="schemaObjectPrefix" value="rep_"/>
</FileSystem>
管理ガイド
185
Location Intelligence モジュール用のクラスタの管理
b) Workspace 内の Persistence Manager を次のように変更します。
<PersistenceManager
class="org.apache.jackrabbit.core.persistence.pool.PostgreSQLPersistenceManager">
<param name="url"
value="jdbc:postgresql://<hostname>:<port>/<databasename>"/>
<param name="schema" value="postgresql"/>
<param name="user" value="<user>"/>
<param name="password" value="<pwd>"/>
<param name="schemaObjectPrefix" value="${wsp.name}_"/>
<param name="externalBLOBs" value="false"/>
</PersistenceManager>
c) ファイルの最後の </Repository> タグのすぐ上の部分で、クラスタリングを有効にします。ク
ラスタリングを正しく同期させるために、Spectrum™ Technology Platform の各インスタンス
にそれぞれ個別の ID を付与する必要があります。syncDelay には、同期の遅延時間をミリ秒で
指定します。
<Cluster id="node1" syncDelay="2000">
<Journal class="org.apache.jackrabbit.core.journal.DatabaseJournal">
<param name="revision" value="${rep.home}/revision.log" />
<param name="driver" value="org.postgresql.Driver" />
<param name="url"
value="jdbc:postgresql://<hostname>:<port>/<databasename>" />
<param name="schema" value="postgresql"/>
<param name="schemaObjectPrefix" value="rep_"/>
<param name="user" value="<user>"/>
<param name="password" value="<pwd>"/>
<param name="databaseType" value="postgresql"/>
</Journal>
</Cluster>
d) DataStore セクションをコメント アウトします。
<DataStore class="org.apache.jackrabbit.core.data.FileDataStore"/>
4. Spectrum の各インスタンスの /server/modules/spatial/jackrabbit ディレクトリから、
repository、version、workspaces というフォルダを削除します。
5. データベースにこれまでにリポジトリ コンテンツを追加したことがある場合は、クリーンなリポ
ジトリが作成できるようにデータベースからテーブルを削除しておく必要があります。新しいデー
タベースである場合は、テーブルが存在しないことを確認してください。以下のテーブルをデータ
ベースから削除する必要があります。
public.default_names_id_seq
public.default_binval
public.default_bundle
public.default_names
public.default_refs
public rep_fsentry
public.rep_global_revision
public.rep_journal
public.rep_local_revisions
public.security_binval
public.security_bundle
public.security_names
public.security_refs
リポジトリ コンテンツのインポート
先ほどエクスポートしたリポジトリのコンテンツを、リポジトリにインポートして戻します。この手
順は、Spectrum™ Technology Platform インスタンスの 1 つに対してのみ実行する必要があります。
186
Spectrum™ Technology Platform 9.0 SP3
第 10 章 : クラスタの管理
1. Spectrum™ Technology Platform サーバーを開始します。
2. 先ほどエクスポートしたリポジトリのコンテンツを、リポジトリにコピーして戻します。まず、以
下の手順で、WebDAV を使用して Spectrum に接続します。
a) GNOME – Nautilus を使用して WebDAV ディレクトリに接続します。[場所] メニューで [サー
バーに接続] を選択します。ここで、[ファイル ブラウザ] ウィンドウが開きます。
リポジトリは、
http://<YourMachine>:<Port>/RepositoryService/repository/default にあり
ます。
b) コンテンツを、リポジトリのルート ディレクトリにコピーします。
これで Spectrum™ Technology Platform の構成設定が完了し、負荷分散できる状態になりました。
マップ イメージ ファイル共有のセットアップ
ファイル共有は、Spectrum Spatial によって生成されたマップ イメージを格納するためのフォルダを
提供します。すべての Spectrum ノードからアクセス可能な共有フォルダを作成します。マップが
Base64 エンコード イメージとして Web サービスから返される場合は、ファイル共有は必要ありませ
ん。
マップ イメージ ファイル共有をセットアップするには、次の手順を実行します。
1. Spectrum をホスティングする各オペレーティング システム上で、共有フォルダをマウントしま
す。以下のコマンドによって、Microsoft Windows Server または CIFS をサポートするネットワー
ク ドライブ上にドライブをマウントします。
mkdir /mnt/<linux mount>
mount -t cifs //<windows host>/<windows share> /mnt/<linux mount>-o
username=shareuser,password=sharepassword,domain=pbi
2. /etc/fstab において、起動時にイメージ シェアをロードするように設定します。
//<windows ip address for share>/share /path_to/mount cifs
username=server_user,password=secret,_netdev 0 0
管理ガイド
187
Location Intelligence モジュール用のクラスタの管理
共有される Spectrum ローカル データ
ファイル システム上の TAB ファイル データを使用する場合は、このデータを負荷分散環境に含まれ
るすべての Spectrum インスタンスがアクセス可能な共有場所に配置する必要があります。また、ファ
イル システム上のデータにアクセスするリポジトリ内のすべての名前付きリソースが、この共有場所
を指す必要があるということも、重要な点です。
Spectrum をホスティングする各 VM またはマシンは、マウントされた共有ドライブにアクセスできる
必要があります。
注 : データベース テーブルを指す名前付きリソースを使用するのに、共有ドライブは必要ではありま
せん。リポジトリ内の名前付きリソースは、ファイル パスを使用してデータにアクセスするので
はなく、データベース内のデータへの名前付き接続を使用するためです。
188
Spectrum™ Technology Platform 9.0 SP3
Spectrum Technology
Platform について
このセクションの構成
• Spectrum™ Technology Platform とは . . . . . . . . . . . . . .190
• エンタープライズ データ管理アーキテクチャ . . . . . . . . . .191
• Spectrum™ Technology Platform のアーキテクチャ . . .194
• モジュールとコンポーネント . . . . . . . . . . . . . . . . . . . . . . .197
11
Spectrum™ Technology Platform とは
Spectrum™ Technology Platform とは
Spectrum™ Technology Platform は、データの正規化、検証、拡張 (価値向上) の 3 つの側面からデー
タの完全性、妥当性、一貫性、適時性、および正確性を高めるシステムです。 データを正確かつ包括
的に、最新の状態に維持することで、顧客への理解を深め、顧客とより良好な関連性を構築できます。
Spectrum™ Technology Platform は、以下の機能を実行して、データの品質を高めるビジネス ルール
の設計と実装を支援します。
パーシング、名前の正規化、名前のバリデーション
正規化をきわめて正確に実行するには、一連のデータ列を複数のフィールドに分割する必要がある場
合があります。 Spectrum™ Technology Platform は、個人名、企業名、およびその他多くの語や略語
をパースする高度なパーシング機能を備えています。 また、スキャン/抽出操作のベースとして使用す
るカスタム表現のリストを独自に作成することもできます。 Universal Name モジュールは、この機能
を備えています。
重複除外統合
一意のエンティティを識別することで、レコードを統合する、重複レコードを排除する、および "最良
の組み合わせ" レコードを作成できます。 "最良の組み合わせ" レコードとは、別のレコードのデータ
を使用して作成する複合的なレコードです。 Advanced Matching モジュールと Data Normalization モ
ジュールは、この機能を備えています。
住所検証
住所検証では、管轄の郵便当局のルールを適用して、住所を標準形式に変換し、その住所が配達可能
な住所であるかどうかを確認します。 住所検証により、郵便料金の割引を受けやすくなり、郵便物の
配達品質を高めることができます。 Universal Addressing モジュールと Address Now モジュールは、
この機能を備えています。
ジオコーディング
ジオコーディングとは、住所を地図上のポイント（緯度と経度）に変換する処理です。 ジオコーディ
ングは、地図製作に使用されますが、それは 1 つの使用例にすぎません。 基盤を成すロケーション
データがあると、ビジネス上の意思決定を行いやすくなります。 処理を逆にすることで、ジオコード
(緯度と経度で表現される地図上のポイント) を入力し、そのジオコードに関する住所情報を取得でき
ます。 Enterprise Geocoding モジュールは、この機能を備えています。
ロケーション インテリジェンス
ロケーション インテリジェンスは、地理関係を調査、評価、分析、およびモデル化して、データに関
する新しい情報を作成します。 ロケーション インテリジェンス処理を使用すると、ロケーションを検
証し、情報を有益なビジネス インテリジェンスに変換できます。 Location Intelligence モジュールは、
この機能を備えています。
マスター データ管理
マスター データ管理では、重要なデータ アセットの関連性を中心に捉えたマスター データ ビューを
作成できます。 Data Hub モジュールは、インフルエンサーと明白でない関連性の特定、詐欺行為の
検出、情報の品質、統合、およびアクセシビリティを高めるのに役立ちます。
190
Spectrum™ Technology Platform 9.0 SP3
第 11 章 : Spectrum Technology Platform について
税務管轄区域の割り当て
税務管轄区域の割り当てでは、住所の地域に適用される税務管轄区域を判断します。 税務管轄区域を
最も正確に割り当てると、経済上のリスクや、法的義務を軽減できます。
Spectrum™ Technology Platform が提供する Pitney Bowes Software ソフトウェアでは、最新の税務管
轄区域と顧客レコードの正確な住所を統合して正確な州、郡、郡区、市、および特殊な税務管轄区域
の情報をレコードに追加できます。 税務管轄区域の割り当ての使用例を次に示します。
• 売上税と使用税
• 動産税
• 保険料税
Enterprise Tax モジュールは、この機能を備えています。
エンタープライズ データ管理アーキテクチャ
Spectrum™ Technology Platform では、包括的なエンタープライズ データ管理処理を構築できます。
また、改善が必要な個々の領域に対象を絞り込むこともできます。 次の図は、ソースからデータを取
得し、データ強化およびデータ品質処理を経て、マスター データ管理ハブに引き渡す、包括的なソ
リューションを示したものです。MDM ハブは、データの単一のビューを作成して複数のビジネス ア
プリケーションに提供します。
管理ガイド
191
エンタープライズ データ管理アーキテクチャ
データ検出
データ検出は、データ リソースをスキャンしてデータの状況を詳細に把握するプロセスです。
Spectrum™ Technology Platform は、さまざまなデータプロファイリング手法を使用して、構造化さ
れたデータ、構造化されていないデータ、および一部分のみ構造化されたデータをスキャンできます。
スキャン結果は、会社のデータ アセットを記述するドキュメントのライブラリの生成とメタデータ リ
ポジトリの作成に自動的に使用されます。 このドキュメントと付属のメタデータ リポジトリから提供
される情報を十分に吟味したうえで、データ統合、データ品質、データ制御、またはマスター データ
管理プロジェクトを始めてください。
Spectrum™ Technology Platform のデータ検出モジュールの詳細については、営業担当者にお問い合
わせください。
データ統合
データの状況を把握したら、次は、管理する必要があるデータへのアクセス方法を検討する必要があ
ります。 Spectrum™ Technology Platform は、複数のソースのデータに直接接続できます。また、既
192
Spectrum™ Technology Platform 9.0 SP3
第 11 章 : Spectrum Technology Platform について
存のデータ アクセス手法を統合した方法で接続することもできます。 データ ウェアハウス、データ
品質、システム統合、移行といった多様なビジネス ニーズに対応するバッチおよびリアル タイム デー
タ統合機能をサポートします。 Spectrum™ Technology Platform は RDBMS データベース、データ
ウェアハウス、XML ファイル、フラット ファイル、可変フォーマット ファイルのデータにアクセス
できます。 Spectrum™ Technology Platform は、複雑な結合や集計を含むSQL クエリをサポートし、
視覚的なクエリ開発ツールを提供します。 また、Spectrum™ Technology Platform は REST および
SOAP Web サービスを介してデータにアクセスできます。
Spectrum™ Technology Platform は、指定されたフォルダ内の1つ以上のソースファイルの存在チェッ
ク結果に基づいてバッチ処理をトリガできます。 この "ホット フォルダ" トリガは、FTP アップロー
ドの監視と、アップロード直後の処理に役立ちます。
これらのデータ統合機能の一部には、Enterprise Data Integration モジュールのライセンスが必要です。
詳細については、営業担当者に問い合わせてください。
最後に、Spectrum™ Technology Platform は SAP や Siebel などのパッケージ アプリケーションと統
合可能です。
データ品質/ガバナンス
データ品質およびデータ ガバナンス処理では、重複レコード、矛盾した情報、不正確な情報がない
か、データを確認します。
重複マッチングは、重複レコードの可能性や、レコード間の関連性を特定します。データが実際の名
前や住所であるか、または他の種類の顧客情報であるかは関係ありません。 Spectrum™ Technology
Platform では、boolean 型マッチング方式、スコアリング方式、しきい値、アルゴリズム、および重
みを使用する一貫したビジネスマッチルールを指定して、レコードのグループに重複が含まれている
かどうかを調べることができます。 Spectrum™ Technology Platform は、多種多様なカスタマイズを
サポートしているため、ビジネス固有のニーズに適合するようにルールを調整できます。
重複レコードを特定したら、それらのレコードを統合することもできます。 Spectrum™ Technology
Platform は、重複レコードをリンクまたは結合して、収集した顧客情報から最も正確かつ包括的なレ
コードを作成する方法を指定できます。 例えば、ある世帯のすべてのレコードに基づいて、1 つの
Best-of-Breed (最良の組み合わせ) レコードを作成できます。 重複の特定とその排除には、Advanced
Matching モジュールを使用します。
データ品質処理では、データの正規化も行われます。 正規化は、きわめて重要な処理です。レコード
の照合とレコード間の関連性の識別において、最も可能性の高い結果を得るために、正規化データ要
素が必要であるためです。 モジュールによっては、複数のタイプの正規化を実行するものもあります
が、Spectrum™ Technology Platform の Data Normalization モジュールは最も包括的な正規化機能セッ
トを備えています。 また、Universal Name モジュールは、個人名や企業名データを処理するための特
定のデータ品質機能を提供します。
正規化データは、必ずしも正確なデータではありません。 Spectrum™ Technology Platform は、デー
タを既知の最新の参照データと比較して、その妥当性を確認できます。 この処理に用いられるソース
としては、米国 郵政公社などの規制機関、Experian やD&B などのサードパーティのデータプロバイ
ダ、会計データなどの企業内の参照ソースがあります。 Spectrum™ Technology Platform は、住所デー
タの検証に特に優れています。 世界中の 250 の国および地域の住所の検証または正規化が可能です。
住所の検証を実行するモジュールには、Address Now モジュールと Universal Addressing モジュール
の 2 つがあります。
どちらのモジュールがニーズに適しているかは、営業担当者と相談して判断してください。
Spectrum™ Technology Platform は、幅広いデータ品質問題を自動的に処理できますが、データ スチュ
ワードによる手動確認が適切である場合が存在します。 これをサポートするために、Business Steward
モジュールでは、手動確認をトリガするルールを指定するための方法と、例外レコードを確認するた
めの Web ベースのツールが提供されています。 確認および解決処理においてデータ スチュワードを
管理ガイド
193
Spectrum™ Technology Platform のアーキテクチャ
支援するための、Bing マップや Experian データといったサードパーティ ツールへの統合アクセスも
含まれています。
データ強化(データ・エンリッチメント)
データ強化処理は、追加情報によってデータを増補します。 強化は、データに詳細情報を追加するた
めにユーザが使用したいと考える、空間データ、マーケティング データ、または他のソースからの
データに基づいて行うことができます。 例えば、顧客住所のデータベースが存在する場合、住所のジ
オコーディングを行って、住所の緯度/経度座標を特定し、その座標をレコードの一部として保存する
ことができます。 これによって顧客データは、顧客に最も近い銀行支店の検索など、多様な空間分析
に使用できるようになります。 Spectrum™ Technology Platform では、データをさまざまな情報で強
化できます。例えば、ジオコーディング (Enterprise Geocoding モジュールを使用)、税務管轄区域の
割り当て (Enterprise Tax モジュール)、地理空間分析 (Location Intelligence モジュール)、2 点間の車
移動または徒歩経路 (Enterprise Routing モジュール) の情報を利用できます。
マスター データ管理ハブ
マスター データ管理 (MDM) ハブは、エンティティと、その役割、処理、やり取りの間の複雑な関連
性の迅速なモデリングを可能にします。 ソーシャル ネットワーク分析機能が組み込まれており、イン
フルエンサー (influencer) の理解、チャーンの予測、明白でない関係や不正パターンの検出、レコメン
デーションを支援します。
Spectrum™ Technology Platform は、MDM ハブに対する 2 つのアプローチをサポートします。 マス
ター ハブのアプローチでは、データは単一の MDM データベースに維持され、アプリケーションは
MDM データベースからデータにアクセスします。 レジストリのアプローチでは、データは各ビジネ
ス アプリケーションに維持され、MDM ハブ レジストリに、関連レコードの検索に用いられるキーが
含まれます。 例えば、顧客のレコードが、注文入力データベースと顧客サポート データベースに存在
する場合があります。 この場合 MDM レジストリには、両方の場所の顧客データへのアクセスに使用
できる単一のキーが含まれます。
Data Hub モジュールが、MDM 機能を提供します。
Spectrum™ Technology Platform のアーキテクチャ
Spectrum™ Technology Platform が提供する Pitney Bowes Software のソフトウェアには、いくつかの
モジュールをサポートするサーバーが同梱されています。 これらのモジュールは、住所のバリデー
ション、ジオコーディング、高度なパーシング等、さまざまな機能を備えています。 次の図に、
Spectrum™ Technology Platform のアーキテクチャを示します。
194
Spectrum™ Technology Platform 9.0 SP3
第 11 章 : Spectrum Technology Platform について
サーバー
このサーバーが Spectrum™ Technology Platform の基盤となります。 サーバーは、データ処理、リポ
ジトリ データの同期、およびクライアントと変換モジュールの間での TCP/IP 通信を処理します。 ま
た、ジョブ管理およびセキュリティ機能も提供します。
モジュール
モジュールは、特定の機能を実行する機能群です。 例えば、USPS の規格に準拠するように顧客の住
所を正規化する場合は、Universal Addressing モジュールの使用を許可します。 個々の顧客に適用さ
れる税務管轄区域を調べる場合は、Enterprise Tax モジュールの使用を許可します。 特定のニーズに
応じて、1 つのモジュールの使用のみを許可することも、複数のモジュールの使用を許可することも
できます。 ほとんどのモジュールは、"コンポーネント" とデータベースで構成されます。
コンポーネント
コンポーネントは、顧客データ品質処理の基本的な構成要素です。 コンポーネントごとに固有の機能
を実行します。 例えば、Enterprise Geocoding モジュールの Geocode US Address コンポーネント
は、住所を地図上のポイント (緯度と経度) に変換して返します。Universal Addressing モジュールの
Get City State Province は、郵便番号が示す都市および州/省を返します。
コンポーネントによっては実行する前に、別のコンポーネントと組み合わせて、ジョブ、サービス、
またはサブフローを作成する必要がある場合もあります。 Enterprise Designer を使用して、ジョブ、
サービス、サブフロー、およびプロセス フローを作成します。 詳細については、Enterprise Designer
（196ページ）を参照してください。
システムで利用できるコンポーネントは、Spectrum™ Technology Platform から Pitney Bowes Software
のどのモジュールのライセンスを取得したかによって異なります。
管理ガイド
195
Spectrum™ Technology Platform のアーキテクチャ
データベース
一般に、モジュールにはデータベースが付属し、モジュールのコンポーネントに必要なデータが格納
されます。 例えば、Universal Addressing モジュールで、住所を確認して正規化するには、USPS デー
タにアクセスする必要があります。 そのため、Universal Addressing モジュールには、米国郵便デー
タベースが付属しています。このデータベースは、Spectrum™ Technology Platform システムからア
クセスできる場所にロードしなければなりません。
モジュールには、必須データベースとオプションのデータベースがあります。 オプションのデータ
ベースは、Spectrum™ Technology Platform の処理を大幅に強化する特定の機能のために必要なデー
タを提供します。
Management Console
Management Console は、Spectrum™ Technology Platform を管理する Windows ベースのツールで
す。 Management Console で実行できる操作は、次のとおりです。
• サーバーのアクセス アドレスを指定する。
• コンポーネントのアクセス方法を選択する (ローカルまたはホステッド)
• Spectrum™ Technology Platform のコンポーネントのデフォルト設定を指定する。
• 権限やパスワード等、ユーザ アカウントを管理する。
• ログ、追跡、およびレポートを設定する。
Enterprise Designer
Enterprise Designer は、Spectrum™ Technology Platform のジョブ、サービス、サブフロー、および
プロセス フローを作成する Windows ベースのツールです。 ドラッグアンドドロップ インターフェイ
スを利用して、複雑なデータフローをグラフィカルに、容易に作成できます。
196
Spectrum™ Technology Platform 9.0 SP3
第 11 章 : Spectrum Technology Platform について
API
Spectrum™ Technology Platform のクライアント API に付属する Spectrum™ Technology Platform API
は、シンプルな統合を提供し、レコード処理を効率化し、将来のバージョンの下位互換性をサポート
することを念頭に置いて設計されています。 Spectrum™ Technology Platform API には、次を通じて
アクセスできます。
•
•
•
•
•
C
C++
COM
Java
.NET
• Web サービス
モジュールとコンポーネント
表 2 : モジュールとコンポーネント
モジュール
説明
コンポーネント
Address Now モジュー
ル
米国以外の住所についての高度なバリデー Build Global Address
ションと正規化を提供します。また、別の住 Get Global Candidate
所処理も提供します。
Addresses
Validate Global Address
Advanced Matching モ
ジュール
管理ガイド
入力ファイル内や入力ファイル間でレコード Best Of Breed
を照合します。
Candidate Finder
197
モジュールとコンポーネント
モジュール
説明
コンポーネント
Duplicate Synchronization
Filter
Interflow Match
Intraflow Match
Match Key Generator
Transactional Match
Business Steward モ
ジュール
例外レコードを特定し、例外レコードを手動 Exception Monitor
で確認するためのブラウザベースのツールを Read Exceptions
提供します。
Write Exceptions
Country Identifier
国名を、または郵便番号と州/省の組み合わ Country Identifier
せを受け取って、2 文字の ISO 国コード、3
文字の Universal Postal Union (UPU) コー
ド、および国名を英語で返します。
Data Hub モジュール
データをリンクおよび分析して、関係と傾向 Write to Hub
を識別します。
Read From Hub
Query Hub
Graph Visualization
Data Integration モ
ジュール
データ ウェアハウジング、データ品質、シ Field Selector
ステム統合、および移行に便利な機能を備え Generate Time Dimension
ています。
Query Cache
Write to Cache
Data Normalization モ
ジュール
データの不整合を取り除きます。
Advanced Transformer
Open Parser
Table Lookup
Transliterator
Enterprise Data
Integration
データ ウェアハウジングや、データ品質、 Call Stored Procedure
システム統合、移行などのさまざまなビジネ Field Selector
ス ニーズに対応するために複数のソースの
Generate Time Dimension
データに接続します。
Query Cache
Write to Cache
Enterprise Geocoding モ 住所を表す地図上のポイント（緯度と経度） Geocode Address AUS
ジュール
に変換します。 また、指定された緯度と経 Geocode Address GBR
度を住所に変換します。
GeocodeAddressGlobal
GeocodeAddressWorld
GeocodeUSAddress
GNAFPIDLocationSearch
ReverseAPNLookup
Reverse Geocode Address
Global
ReverseGeocodeUSLocation
198
Spectrum™ Technology Platform 9.0 SP3
第 11 章 : Spectrum Technology Platform について
モジュール
説明
コンポーネント
Enterprise Routing モ
ジュール
自動車移動または徒歩の経路を取得し、移動 Get Route Data
時間および移動距離を計算し、始点から一定 Get Travel Boundary
の時間または距離内に含まれる領域を特定し
Get Travel Cost Matrix
ます。
Get Travel Directions
Persistent Update
Enterprise Tax モジュー 特定の地域に適用する税務管轄区域を決定し AssignGeoTAXInfo
ル
ます。
CalculateDistance
GeoConfidence モ
ジュール
指定された領域に住所または交差点が含まれ Geo Confidence Surface
る可能性を判定します。
CreatePointsConvexHull
Global Sentry
政府から提供される、各国のデータを含む警 Global Sentry
戒リストとトランザクションとの照合を試み Global Sentry Address Check
ます。
Global Sentry ID Number
Check
Global Sentry Name Check
Global Sentry Other Data
Check
Location Intelligence モ さまざまな地理空間データベースと照合して Closest Site
ジュール
Point In Polygon と半径分析を実行します。 Find Nearest
Point In Polygon
Query Spatial Data
Read Spatial Data
Spatial Calculator
Spatial Union
SAP モジュール
SAP Generate Match Key
Spectrum™ Technology Platform と SAP
Customer Relationship Management モジュー SAP Generate Match Score
ル アプリケーションとの連携を有効にしま
SAP Generate Search Key
す。
SAP Generate Search Key
Constant
SAP Generate Search Key
Metaphone
SAP Generate Search Key
Substring
SAP Validate Address With
Candidates
Siebel モジュール
Spectrum™ Technology Platform と Siebel ア Siebel Generate Match Key
プリケーションとの連携を有効にします。 Siebel Generate Match Score
Siebel Generate Search Key
Siebel Business Name
Standardization
Siebel Standardize Name
Siebel Geocode US Address
With Candidates
管理ガイド
199
モジュールとコンポーネント
モジュール
説明
コンポーネント
Siebel Geocode US Address
With No Candidates
Siebel Get Global Candidate
Addresses
Siebel Validate Address With
Candidates
Siebel Validate Address With
No Candidates
Universal Addressing モ 郵便当局の規格に従って、住所を正規化して Get Candidate Addresses
ジュール
バリデーションを実行します。
Get City State Province
Get Postal Codes
Validate Address
Validate Address AUS
Validate Address Global
Universal Name モ
ジュール
個人名、企業名、住所、およびその他多くの Name Parser (非推奨)
語や略語をパースします。
Name Variant Finder
Open Name Parser
200
Spectrum™ Technology Platform 9.0 SP3
Appendix
このセクションの構成
• Country ISO Codes and Module Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .203
Country ISO Codes and
Module Support
このセクションの構成
• 各国の ISO コードとモジュール サポート . . . . . . . . . . . . .204
A
各国の ISO コードとモジュール サポート
次の表に、各国の ISO コードと、各国の住所作成、ジオコーディング、およびルーティングをサポー
トするモジュールを示します。
Enterprise Geocoding モジュールにアフリカ (30 か国)、中東 (8 か国)、ラテン アメリカ (20 か国) の
データベースが含まれていることに注意してください。 これらのデータベースは、国別のジオコー
ディング データベースがない、各地域の比較的小さな国をカバーします。 [サポートされるモジュー
ル] 列は、これらのアフリカ、中東、ラテン アメリカ データベースに含まれる国を示しています。
また、Geocode Address World データベースは、すべての国について地図上の限定的な郵便ジオコー
ディング (ストリート レベルではない) を提供します。
ISO 国名
ISO 3116-1
Alpha-2
ISO 3116-1
Alpha-3
サポートされるモジュール
Afghanistan
AF
AFG
Address Now モジュール
Universal Addressing モジュール
Aland Islands
AX
ALA
Address Now モジュール
Universal Addressing モジュール
Albania
AL
ALB
Address Now モジュール
Universal Addressing モジュール
Algeria
DZ
DZA
Address Now モジュール
Universal Addressing モジュール
American Samoa
AS
ASM
Address Now モジュール
Universal Addressing モジュール
Andorra
AD
AND
Address Now モジュール
1
Enterprise Geocoding モジュール
Universal Addressing モジュール
GeoComplete モジュール
1
204
Angola
AO
AGO
Address Now モジュール
Enterprise Geocoding モジュール (アフ
リカ)
Universal Addressing モジュール
Anguilla
AI
AIA
Address Now モジュール
Universal Addressing モジュール
Antarctica
AQ
ATA
Address Now モジュール
Universal Addressing モジュール
Antigua And Barbuda
AG
ATG
Address Now モジュール
Universal Addressing モジュール
アンドラは、スペインのジオコーダでサポートされています。
Spectrum™ Technology Platform 9.0 SP3
付録 A : Country ISO Codes and Module Support
ISO 国名
ISO 3116-1
Alpha-2
ISO 3116-1
Alpha-3
サポートされるモジュール
Argentina
AR
ARG
Address Now モジュール
Enterprise Geocoding モジュール
Universal Addressing モジュール
Armenia
AM
ARM
Address Now モジュール
Universal Addressing モジュール
Aruba
AW
ABW
Address Now モジュール
Enterprise Geocoding モジュール (ラテ
ン アメリカ)
Universal Addressing モジュール
Australia
AU
AUS
Address Now モジュール
Enterprise Geocoding モジュール
Enterprise Routing モジュール
Universal Addressing モジュール
Austria
AT
AUT
Address Now モジュール
Enterprise Geocoding モジュール
Enterprise Routing モジュール
Universal Addressing モジュール
GeoComplete モジュール
Azerbaijan
AZ
AZE
Address Now モジュール
Universal Addressing モジュール
Bahamas
BS
BHS
Address Now モジュール
Enterprise Geocoding モジュール
Universal Addressing モジュール
Bahrain
BH
BHR
Address Now モジュール
Enterprise Geocoding モジュール (中東)
Enterprise Routing モジュール
Universal Addressing モジュール
Bangladesh
BD
BGD
Address Now モジュール
Universal Addressing モジュール
Barbados
BB
BRB
Address Now モジュール
Enterprise Geocoding モジュール (ラテ
ン アメリカ)
Universal Addressing モジュール
Belarus
BY
BLR
Address Now モジュール
Universal Addressing モジュール
Belgium
BE
BEL
Address Now モジュール
Enterprise Geocoding モジュール
Enterprise Routing モジュール
管理ガイド
205
ISO 国名
ISO 3116-1
Alpha-2
ISO 3116-1
Alpha-3
サポートされるモジュール
Universal Addressing モジュール
GeoComplete モジュール
206
Belize
BZ
BLZ
Address Now モジュール
Enterprise Geocoding モジュール (ラテ
ン アメリカ)
Universal Addressing モジュール
Benin
BJ
BEN
Address Now モジュール
Enterprise Geocoding モジュール (アフ
リカ)
Universal Addressing モジュール
Bermuda
BM
BMU
Address Now モジュール
Universal Addressing モジュール
Bhutan
BT
BTN
Address Now モジュール
Universal Addressing モジュール
Bolivia, Plurinational State Of BO
BOL
Address Now モジュール
Enterprise Geocoding モジュール (ラテ
ン アメリカ)
Universal Addressing モジュール
Bonaire, Saint Eustatius And BQ
Saba
BES
Address Now モジュール
Universal Addressing モジュール
Bosnia And Herzegovina
BA
BIH
Address Now モジュール
Universal Addressing モジュール
Botswana
BW
BWA
Address Now モジュール
Enterprise Geocoding モジュール (アフ
リカ)
Universal Addressing モジュール
Bouvet Island
BV
BVT
Address Now モジュール
Universal Addressing モジュール
Brazil
BR
BRA
Address Now モジュール
Enterprise Geocoding モジュール
Enterprise Routing モジュール
Universal Addressing モジュール
GeoComplete モジュール
British Indian Ocean Territory IO
IOT
Address Now モジュール
Universal Addressing モジュール
Brunei Darussalam
BRN
Address Now モジュール
Universal Addressing モジュール
BN
Spectrum™ Technology Platform 9.0 SP3
付録 A : Country ISO Codes and Module Support
ISO 国名
ISO 3116-1
Alpha-2
ISO 3116-1
Alpha-3
サポートされるモジュール
Bulgaria
BG
BGR
Address Now モジュール
Universal Addressing モジュール
Burkina Faso
BF
BFA
Address Now モジュール
Enterprise Geocoding モジュール (アフ
リカ)
Universal Addressing モジュール
Burundi
BI
BDI
Address Now モジュール
Enterprise Geocoding モジュール (アフ
リカ)
Universal Addressing モジュール
Cambodia
KH
KHM
Address Now モジュール
Universal Addressing モジュール
Cameroon
CM
CMR
Address Now モジュール
Enterprise Geocoding モジュール (アフ
リカ)
Universal Addressing モジュール
Canada
CA
CAN
Address Now モジュール
Enterprise Geocoding モジュール
Enterprise Routing モジュール
Universal Addressing モジュール
GeoComplete モジュール
Cape Verde
CV
CPV
Address Now モジュール
Universal Addressing モジュール
Cayman Islands
KY
CYM
Address Now モジュール
Universal Addressing モジュール
Central African Republic
CF
CAF
Address Now モジュール
Universal Addressing モジュール
Chad
TD
TCD
Address Now モジュール
Universal Addressing モジュール
Chile
CL
CHL
Address Now モジュール
Enterprise Geocoding モジュール
Universal Addressing モジュール
GeoComplete モジュール
China
CN
CHN
Address Now モジュール
Enterprise Geocoding モジュール
Universal Addressing モジュール
Christmas Island
CX
CXR
Address Now モジュール
Universal Addressing モジュール
管理ガイド
207
208
ISO 国名
ISO 3116-1
Alpha-2
ISO 3116-1
Alpha-3
サポートされるモジュール
Cocos (Keeling) Islands
CC
CCK
Address Now モジュール
Universal Addressing モジュール
Colombia
CO
COL
Address Now モジュール
Universal Addressing モジュール
Comoros
KM
COM
Address Now モジュール
Universal Addressing モジュール
Congo
CG
COG
Address Now モジュール
Enterprise Geocoding モジュール (アフ
リカ)
Universal Addressing モジュール
Congo, The Democratic
Republic Of The
CD
COD
Address Now モジュール
Enterprise Geocoding モジュール (アフ
リカ)
Universal Addressing モジュール
Cook Islands
CK
COK
Address Now モジュール
Universal Addressing モジュール
Costa Rica
CR
CRI
Address Now モジュール
Enterprise Geocoding モジュール (ラテ
ン アメリカ)
Universal Addressing モジュール
Côte d'Ivoire
CI
CIV
Address Now モジュール
Universal Addressing モジュール
Croatia
HR
HRV
Address Now モジュール
Enterprise Geocoding モジュール
Enterprise Routing モジュール
Universal Addressing モジュール
Cuba
CU
CUB
Address Now モジュール
Enterprise Geocoding モジュール (ラテ
ン アメリカ)
Universal Addressing モジュール
Curacao
CW
CUW
Address Now モジュール
Universal Addressing モジュール
Cyprus
CY
CYP
Address Now モジュール
Universal Addressing モジュール
Czech Republic
CZ
CZE
Address Now モジュール
Enterprise Geocoding モジュール
Enterprise Routing モジュール
Spectrum™ Technology Platform 9.0 SP3
付録 A : Country ISO Codes and Module Support
ISO 国名
ISO 3116-1
Alpha-2
ISO 3116-1
Alpha-3
サポートされるモジュール
Universal Addressing モジュール
GeoComplete モジュール
Denmark
DK
DNK
Address Now モジュール
Enterprise Geocoding モジュール
Enterprise Routing モジュール
Universal Addressing モジュール
GeoComplete モジュール
Djibouti
DJ
DJI
Address Now モジュール
Universal Addressing モジュール
Dominica
DM
DMA
Address Now モジュール
Universal Addressing モジュール
Dominican Republic
DO
DOM
Address Now モジュール
Enterprise Geocoding モジュール (ラテ
ン アメリカ)
Universal Addressing モジュール
Ecuador
EC
ECU
Address Now モジュール
Enterprise Geocoding モジュール (ラテ
ン アメリカ)
Universal Addressing モジュール
Egypt
EG
EGY
Address Now モジュール
Enterprise Geocoding モジュール (中東)
Enterprise Routing モジュール
Universal Addressing モジュール
El Salvador
SV
SLV
Address Now モジュール
Enterprise Geocoding モジュール (ラテ
ン アメリカ)
Universal Addressing モジュール
Equatorial Guinea
GQ
GNQ
Address Now モジュール
Universal Addressing モジュール
Eritrea
ER
ERI
Address Now モジュール
Universal Addressing モジュール
Estonia
EE
EST
Address Now モジュール
Enterprise Geocoding モジュール
Enterprise Routing モジュール
Universal Addressing モジュール
Ethiopia
ET
ETH
Address Now モジュール
Universal Addressing モジュール
管理ガイド
209
ISO 国名
ISO 3116-1
Alpha-2
ISO 3116-1
Alpha-3
サポートされるモジュール
Falkland Islands (Malvinas)
FK
FLK
Address Now モジュール
Universal Addressing モジュール
Faroe Islands
FO
FRO
Address Now モジュール
Universal Addressing モジュール
Fiji
FJ
FJI
Address Now モジュール
Universal Addressing モジュール
Finland
FI
FIN
Address Now モジュール
Enterprise Geocoding モジュール
Enterprise Routing モジュール
Universal Addressing モジュール
GeoComplete モジュール
France
FR
FRA
Address Now モジュール
Enterprise Geocoding モジュール
Enterprise Routing モジュール
Universal Addressing モジュール
GeoComplete モジュール
French Guiana
GF
GUF
Address Now モジュール
2
Enterprise Geocoding モジュール
Universal Addressing モジュール
2
210
French Polynesia
PF
PYF
Address Now モジュール
Universal Addressing モジュール
French Southern Territories
TF
ATF
Address Now モジュール
Universal Addressing モジュール
Gabon
GA
GAB
Address Now モジュール
Enterprise Geocoding モジュール (アフ
リカ)
Universal Addressing モジュール
Gambia
GM
GMB
Address Now モジュール
Universal Addressing モジュール
Georgia
GE
GEO
Address Now モジュール
Universal Addressing モジュール
Germany
DE
DEU
Address Now モジュール
Enterprise Geocoding モジュール
Enterprise Routing モジュール
Universal Addressing モジュール
GeoComplete モジュール
フランス領ギアナは、フランスのジオコーダでサポートされています。
Spectrum™ Technology Platform 9.0 SP3
付録 A : Country ISO Codes and Module Support
ISO 国名
ISO 3116-1
Alpha-2
ISO 3116-1
Alpha-3
サポートされるモジュール
Ghana
GH
GHA
Address Now モジュール
Enterprise Geocoding モジュール (アフ
リカ)
Universal Addressing モジュール
Gibraltar
GI
GIB
Address Now モジュール
Enterprise Geocoding モジュール
3
Universal Addressing モジュール
Greece
GR
GRC
Address Now モジュール
Enterprise Geocoding モジュール
Universal Addressing モジュール
Greenland
GL
GRL
Address Now モジュール
Universal Addressing モジュール
Grenada
GD
GRD
Address Now モジュール
Universal Addressing モジュール
Guadeloupe
GP
GLP
Address Now モジュール
4
Enterprise Geocoding モジュール
Universal Addressing モジュール
3
4
Guam
GU
GUM
Address Now モジュール
Universal Addressing モジュール
Guatemala
GT
GTM
Address Now モジュール
Enterprise Geocoding モジュール (ラテ
ン アメリカ)
Universal Addressing モジュール
Guernsey
GG
GGY
Address Now モジュール
Universal Addressing モジュール
Guinea
GN
GIN
Address Now モジュール
Universal Addressing モジュール
Guinea-Bissau
GW
GNB
Address Now モジュール
Universal Addressing モジュール
Guyana
GY
GUY
Address Now モジュール
Enterprise Geocoding モジュール (ラテ
ン アメリカ)
Universal Addressing モジュール
Haiti
HT
HTI
Address Now モジュール
Universal Addressing モジュール
ジブラルタルは、スペインのジオコーダでサポートされています。
グアドループは、フランスのジオコーダでサポートされています。
管理ガイド
211
ISO 国名
ISO 3116-1
Alpha-2
ISO 3116-1
Alpha-3
サポートされるモジュール
Heard Island and McDonald
Islands
HM
HMD
Address Now モジュール
Universal Addressing モジュール
VAT
Address Now モジュール
5
Enterprise Geocoding モジュール
Holy See (Vatican City State) VA
Universal Addressing モジュール
5
212
Honduras
HN
HND
Address Now モジュール
Enterprise Geocoding モジュール (ラテ
ン アメリカ)
Universal Addressing モジュール
Hong Kong
HK
HKG
Address Now モジュール
Enterprise Geocoding モジュール
Universal Addressing モジュール
Hungary
HU
HUN
Address Now モジュール
Enterprise Geocoding モジュール
Enterprise Routing モジュール
Universal Addressing モジュール
GeoComplete モジュール
Iceland
IS
ISL
Address Now モジュール
Universal Addressing モジュール
India
IN
IND
Address Now モジュール
Enterprise Geocoding モジュール
Universal Addressing モジュール
Indonesia
ID
IDN
Address Now モジュール
Enterprise Geocoding モジュール
Universal Addressing モジュール
Iran, Islamic Republic Of
IR
IRN
Address Now モジュール
Universal Addressing モジュール
Iraq
IQ
IRQ
Address Now モジュール
Universal Addressing モジュール
Ireland
IE
IRL
Address Now モジュール
Enterprise Geocoding モジュール
Enterprise Routing モジュール
Universal Addressing モジュール
GeoComplete モジュール
Isle Of Man
IM
IMN
Address Now モジュール
Universal Addressing モジュール
バチカンは、イタリアのジオコーダでサポートされています。
Spectrum™ Technology Platform 9.0 SP3
付録 A : Country ISO Codes and Module Support
ISO 国名
ISO 3116-1
Alpha-2
ISO 3116-1
Alpha-3
サポートされるモジュール
Israel
IL
ISR
Address Now モジュール
Universal Addressing モジュール
Italy
IT
ITA
Address Now モジュール
Enterprise Geocoding モジュール
Enterprise Routing モジュール
Universal Addressing モジュール
GeoComplete モジュール
Jamaica
JM
JAM
Address Now モジュール
Enterprise Geocoding モジュール (ラテ
ン アメリカ)
Universal Addressing モジュール
Japan
JP
JPN
Address Now モジュール
Enterprise Geocoding モジュール
Enterprise Routing モジュール
Universal Addressing モジュール
GeoComplete モジュール
Jersey
JE
JEY
Address Now モジュール
Universal Addressing モジュール
Jordan
JO
JOR
Address Now モジュール
Universal Addressing モジュール
Kazakhstan
KZ
KAZ
Address Now モジュール
Universal Addressing モジュール
Kenya
KE
KEN
Address Now モジュール
Enterprise Geocoding モジュール (アフ
リカ)
Universal Addressing モジュール
Kiribati
KI
KIR
Address Now モジュール
Universal Addressing モジュール
Korea, Democratic People's
Republic Of
KP
PRK
Address Now モジュール
Universal Addressing モジュール
Korea, Republic Of
KR
KOR
Address Now モジュール
Universal Addressing モジュール
Kosovo
KS
KOS
Address Now モジュール
Universal Addressing モジュール
GeoComplete モジュール
Kuwait
KW
KWT
Address Now モジュール
Enterprise Geocoding モジュール (中東)
管理ガイド
213
ISO 国名
ISO 3116-1
Alpha-2
ISO 3116-1
Alpha-3
サポートされるモジュール
Enterprise Routing モジュール
Universal Addressing モジュール
Kyrgyzstan
KG
KGZ
Address Now モジュール
Universal Addressing モジュール
Lao People's Democratic
Republic
LA
LAO
Address Now モジュール
Universal Addressing モジュール
Latvia
LV
LVA
Address Now モジュール
Enterprise Geocoding モジュール
Enterprise Routing モジュール
Universal Addressing モジュール
Lebanon
LB
LBN
Address Now モジュール
Enterprise Geocoding モジュール (中東)
Universal Addressing モジュール
Lesotho
LS
LSO
Address Now モジュール
Enterprise Geocoding モジュール (アフ
リカ)
Universal Addressing モジュール
Liberia
LR
LBR
Address Now モジュール
Universal Addressing モジュール
Libyan Arab Jamahiriya
LY
LBY
Address Now モジュール
Universal Addressing モジュール
Liechtenstein
LI
LIE
Address Now モジュール
6
Enterprise Geocoding モジュール
Enterprise Routing モジュール
Universal Addressing モジュール
GeoComplete モジュール
Lithuania
LT
LTU
Address Now モジュール
Enterprise Geocoding モジュール
Enterprise Routing モジュール
Universal Addressing モジュール
Luxembourg
LU
LUX
Address Now モジュール
7
Enterprise Geocoding モジュール
Enterprise Routing モジュール
Universal Addressing モジュール
GeoComplete モジュール
6
7
214
リヒテンシュタインは、スイスのジオコーダでサポートされています。
ルクセンブルクは、ベルギーのジオコーダでサポートされています。
Spectrum™ Technology Platform 9.0 SP3
付録 A : Country ISO Codes and Module Support
8
ISO 国名
ISO 3116-1
Alpha-2
ISO 3116-1
Alpha-3
サポートされるモジュール
Macao
MO
MAC
Address Now モジュール
Enterprise Geocoding モジュール
Universal Addressing モジュール
Macedonia, Former Yugoslav MK
Republic Of
MKD
Address Now モジュール
Universal Addressing モジュール
Madagascar
MG
MDG
Address Now モジュール
Universal Addressing モジュール
Malawi
MW
MWI
Address Now モジュール
Enterprise Geocoding モジュール (アフ
リカ)
Universal Addressing モジュール
Malaysia
MY
MYS
Address Now モジュール
Enterprise Geocoding モジュール
Enterprise Routing モジュール
Universal Addressing モジュール
Maldives
MV
MDV
Address Now モジュール
Universal Addressing モジュール
Mali
ML
MLI
Address Now モジュール
Enterprise Geocoding モジュール (アフ
リカ)
Universal Addressing モジュール
Malta
ML
MLT
Enterprise Routing モジュール
Address Now モジュール
Universal Addressing モジュール
Marshall Islands
MH
MHL
Address Now モジュール
Universal Addressing モジュール
Martinique
MQ
MTQ
Address Now モジュール
Enterprise Geocoding モジュール グア
ドループは、フランスのジオコーダで
サポートされています。 Universal
Addressing モジュール
Mauritania
MR
MRT
Address Now モジュール
Enterprise Geocoding モジュール (アフ
リカ)
Universal Addressing モジュール
Mauritius
MU
MUS
Address Now モジュール
Enterprise Geocoding モジュール (アフ
マルティニークは、フランスのジオコーダでサポートされています。
管理ガイド
215
ISO 国名
ISO 3116-1
Alpha-2
ISO 3116-1
Alpha-3
サポートされるモジュール
リカ)
Universal Addressing モジュール
9
10
216
Mayotte
YT
MYT
Address Now モジュール
Enterprise Geocoding モジュール
Universal Addressing モジュール
Mexico
MX
MEX
Address Now モジュール
Enterprise Geocoding モジュール
Universal Addressing モジュール
Micronesia, Federated States FM
Of
FSM
Address Now モジュール
Universal Addressing モジュール
Moldova, Republic Of
MD
MDA
Address Now モジュール
Universal Addressing モジュール
Monaco
MC
MCO
Address Now モジュール
Enterprise Geocoding モジュール
10
Universal Addressing モジュール
Mongolia
MN
MNG
Address Now モジュール
Universal Addressing モジュール
Montenegro
ME
MNE
Address Now モジュール
Universal Addressing モジュール
Montserrat
MS
MSR
Address Now モジュール
Universal Addressing モジュール
Morocco
MA
MAR
Address Now モジュール
Enterprise Geocoding モジュール (アフ
リカ)
Enterprise Routing モジュール
Universal Addressing モジュール
Mozambique
MZ
MOZ
Address Now モジュール
Enterprise Geocoding モジュール (アフ
リカ)
Universal Addressing モジュール
Myanmar
MM
MMR
Address Now モジュール
Universal Addressing モジュール
Namibia
NA
NAM
Address Now モジュール
Enterprise Geocoding モジュール (アフ
リカ)
Universal Addressing モジュール
マヨットは、フランスのジオコーダでサポートされています。
モナコは、フランスのジオコーダでサポートされています。
Spectrum™ Technology Platform 9.0 SP3
付録 A : Country ISO Codes and Module Support
ISO 国名
ISO 3116-1
Alpha-2
ISO 3116-1
Alpha-3
サポートされるモジュール
Nauru
NR
NRU
Address Now モジュール
Universal Addressing モジュール
Nepal
NP
NPL
Address Now モジュール
Universal Addressing モジュール
Netherlands
NL
NLD
Address Now モジュール
Enterprise Geocoding モジュール
Enterprise Routing モジュール
Universal Addressing モジュール
GeoComplete モジュール
New Caledonia
NC
NCL
Address Now モジュール
Universal Addressing モジュール
New Zealand
NZ
NZL
Address Now モジュール
Enterprise Geocoding モジュール
Enterprise Routing モジュール
Universal Addressing モジュール
Nicaragua
NI
NIC
Address Now モジュール
Enterprise Geocoding モジュール (ラテ
ン アメリカ)
Universal Addressing モジュール
Niger
NE
NER
Address Now モジュール
Enterprise Geocoding モジュール (アフ
リカ)
Universal Addressing モジュール
Nigeria
NG
NGA
Address Now モジュール
Enterprise Geocoding モジュール (アフ
リカ)
Enterprise Routing モジュール
Universal Addressing モジュール
Niue
NU
NIU
Address Now モジュール
Universal Addressing モジュール
Norfolk Island
NF
NFK
Address Now モジュール
Universal Addressing モジュール
Northern Mariana Islands
MP
MNP
Address Now モジュール
Universal Addressing モジュール
Norway
NO
NOR
Address Now モジュール
Enterprise Geocoding モジュール
Enterprise Routing モジュール
Universal Addressing モジュール
GeoComplete モジュール
管理ガイド
217
218
ISO 国名
ISO 3116-1
Alpha-2
ISO 3116-1
Alpha-3
サポートされるモジュール
Oman
OM
OMN
Address Now モジュール
Enterprise Geocoding モジュール (中東)
Enterprise Routing モジュール
Universal Addressing モジュール
Pakistan
PK
PAK
Address Now モジュール
Universal Addressing モジュール
Palau
PW
PLW
Address Now モジュール
Universal Addressing モジュール
Palestinian Territory,
Occupied
PS
PSE
Address Now モジュール
Universal Addressing モジュール
Panama
PA
PAN
Address Now モジュール
Enterprise Geocoding モジュール (ラテ
ン アメリカ)
Universal Addressing モジュール
Papua New Guinea
PG
PNG
Address Now モジュール
Universal Addressing モジュール
Paraguay
PY
PRY
Address Now モジュール
Enterprise Geocoding モジュール (ラテ
ン アメリカ)
Universal Addressing モジュール
Peru
PE
PER
Address Now モジュール
Enterprise Geocoding モジュール (ラテ
ン アメリカ)
Universal Addressing モジュール
Philippines
PH
PHL
Address Now モジュール
Enterprise Geocoding モジュール
Universal Addressing モジュール
Pitcairn
PN
PCN
Address Now モジュール
Universal Addressing モジュール
Poland
PL
POL
Address Now モジュール
Enterprise Geocoding モジュール
Enterprise Routing モジュール
Universal Addressing モジュール
GeoComplete モジュール
Portugal
PT
PRT
Address Now モジュール
Enterprise Geocoding モジュール
Enterprise Routing モジュール
Universal Addressing モジュール
GeoComplete モジュール
Spectrum™ Technology Platform 9.0 SP3
付録 A : Country ISO Codes and Module Support
ISO 国名
ISO 3116-1
Alpha-2
ISO 3116-1
Alpha-3
サポートされるモジュール
Puerto Rico
PR
PRI
Address Now モジュール
Universal Addressing モジュール
Qatar
QA
QAT
Address Now モジュール
Enterprise Geocoding モジュール (中東)
Enterprise Routing モジュール
Universal Addressing モジュール
Reunion
RE
REU
Address Now モジュール
Enterprise Geocoding モジュール
11
Universal Addressing モジュール
Romania
RO
ROU
Address Now モジュール
Universal Addressing モジュール
Enterprise Routing モジュール
11
Russian Federation
RU
RUS
Address Now モジュール
Enterprise Geocoding モジュール
Universal Addressing モジュール
GeoComplete モジュール
Rwanda
RW
RWA
Address Now モジュール
Enterprise Geocoding モジュール (アフ
リカ)
Universal Addressing モジュール
Saint Barthelemy
BL
BLM
Address Now モジュール
Universal Addressing モジュール
Saint Helena, Ascension &
Tristan Da Cunha
SH
SHE
Address Now モジュール
Universal Addressing モジュール
Saint Kitts and Nevis
KN
KNA
Address Now モジュール
Enterprise Geocoding モジュール (ラテ
ン アメリカ)
Universal Addressing モジュール
Saint Lucia
LC
LCA
Address Now モジュール
Universal Addressing モジュール
Saint Martin (French Part)
MF
MAF
Address Now モジュール
Universal Addressing モジュール
Saint Pierre and Miquelon
PM
SPM
Address Now モジュール
Universal Addressing モジュール
Saint Vincent And The
Grenadines
VC
VCT
Address Now モジュール
Universal Addressing モジュール
レユニオンは、フランスのジオコーダでサポートされます。
管理ガイド
219
ISO 国名
ISO 3116-1
Alpha-2
ISO 3116-1
Alpha-3
サポートされるモジュール
Samoa
WS
WSM
Address Now モジュール
Universal Addressing モジュール
San Marino
SM
SMR
Address Now モジュール
12
Enterprise Geocoding モジュール
Universal Addressing モジュール
12
220
Sao Tome And Principe
ST
STP
Address Now モジュール
Universal Addressing モジュール
Saudi Arabia
SA
SAU
Address Now モジュール
Enterprise Geocoding モジュール (中東)
Universal Addressing モジュール
Senegal
SN
SEN
Address Now モジュール
Enterprise Geocoding モジュール (アフ
リカ)
Universal Addressing モジュール
Serbia
RS
SRB
Address Now モジュール
Universal Addressing モジュール
Seychelles
SC
SYC
Address Now モジュール
Universal Addressing モジュール
Sierra Leone
SL
SLE
Address Now モジュール
Universal Addressing モジュール
Singapore
SG
SGP
Address Now モジュール
Enterprise Geocoding モジュール
Enterprise Routing モジュール
Universal Addressing モジュール
GeoComplete モジュール
Sint Maarten (Dutch Part)
SX
SXM
Universal Addressing モジュール
Slovakia
SK
SVK
Address Now モジュール
Enterprise Geocoding モジュール
Enterprise Routing モジュール
Universal Addressing モジュール
GeoComplete モジュール
Slovenia
SI
SVN
Address Now モジュール
Enterprise Geocoding モジュール
Enterprise Routing モジュール
Universal Addressing モジュール
GeoComplete モジュール
サンマリノは、イタリアのジオコーダでサポートされています。
Spectrum™ Technology Platform 9.0 SP3
付録 A : Country ISO Codes and Module Support
ISO 国名
ISO 3116-1
Alpha-2
ISO 3116-1
Alpha-3
サポートされるモジュール
Solomon Islands
SB
SLB
Address Now モジュール
Universal Addressing モジュール
Somalia
SO
SOM
Address Now モジュール
Universal Addressing モジュール
South Africa
ZA
ZAF
Address Now モジュール
Enterprise Geocoding モジュール
Universal Addressing モジュール
GeoComplete モジュール
South Georgia And The South GS
Sandwich Islands
SGS
Address Now モジュール
Enterprise Geocoding モジュール
Universal Addressing モジュール
South Sudan
SS
SSD
Address Now モジュール
Universal Addressing モジュール
Spain
ES
ESP
Address Now モジュール
Enterprise Geocoding モジュール
Enterprise Routing モジュール
Universal Addressing モジュール
GeoComplete モジュール
Sri Lanka
LK
LKA
Address Now モジュール
Universal Addressing モジュール
Sudan
SD
SDN
Address Now モジュール
Universal Addressing モジュール
Suriname
SR
SUR
Address Now モジュール
Enterprise Geocoding モジュール (ラテ
ン アメリカ)
Universal Addressing モジュール
Svalbard And Jan Mayen
SJ
SJM
Address Now モジュール
Universal Addressing モジュール
Swaziland
SZ
SWZ
Address Now モジュール
Enterprise Geocoding モジュール (アフ
リカ)
Universal Addressing モジュール
Sweden
SE
SWE
Address Now モジュール
Enterprise Geocoding モジュール
Enterprise Routing モジュール
Universal Addressing モジュール
GeoComplete モジュール
管理ガイド
221
222
ISO 国名
ISO 3116-1
Alpha-2
ISO 3116-1
Alpha-3
サポートされるモジュール
Switzerland
CH
CHE
Address Now モジュール
Enterprise Geocoding モジュール
Enterprise Routing モジュール
Universal Addressing モジュール
GeoComplete モジュール
Syrian Arab Republic
SY
SYR
Address Now モジュール
Universal Addressing モジュール
Taiwan, Province of China
TW
TWN
Enterprise Routing モジュール
Address Now モジュール
Universal Addressing モジュール
Tajikistan
TJ
TJK
Address Now モジュール
Universal Addressing モジュール
Tanzania, United Republic Of TZ
TZA
Address Now モジュール
Enterprise Geocoding モジュール (アフ
リカ)
Universal Addressing モジュール
Thailand
TH
THA
Address Now モジュール
Enterprise Geocoding モジュール
Enterprise Routing モジュール
Universal Addressing モジュール
Timor-Leste
TL
TLS
Address Now モジュール
Universal Addressing モジュール
Togo
TG
TGO
Address Now モジュール
Enterprise Geocoding モジュール (アフ
リカ)
Universal Addressing モジュール
Tokelau
TK
TKL
Address Now モジュール
Universal Addressing モジュール
Tonga
TO
TON
Address Now モジュール
Universal Addressing モジュール
Trinidad and Tobago
TT
TTO
Address Now モジュール
Enterprise Geocoding モジュール (ラテ
ン アメリカ)
Universal Addressing モジュール
Tunisia
TN
TUN
Address Now モジュール
Enterprise Geocoding モジュール (アフ
リカ)
Universal Addressing モジュール
Spectrum™ Technology Platform 9.0 SP3
付録 A : Country ISO Codes and Module Support
ISO 国名
ISO 3116-1
Alpha-2
ISO 3116-1
Alpha-3
サポートされるモジュール
Turkey
TR
TUR
Address Now モジュール
Enterprise Geocoding モジュール
Universal Addressing モジュール
GeoComplete モジュール
Turkmenistan
TM
TKM
Address Now モジュール
Universal Addressing モジュール
Turks And Caicos Islands
TC
TCA
Address Now モジュール
Universal Addressing モジュール
Tuvalu
TV
TUV
Address Now モジュール
Universal Addressing モジュール
Uganda
UG
UGA
Address Now モジュール
Enterprise Geocoding モジュール (アフ
リカ)
Universal Addressing モジュール
Ukraine
UA
UKR
Address Now モジュール
Enterprise Geocoding モジュール
Enterprise Routing モジュール
Universal Addressing モジュール
United Arab Emirates
AE
ARE
Address Now モジュール
Enterprise Geocoding モジュール (中東)
Enterprise Routing モジュール
Universal Addressing モジュール
United Kingdom
GB
GBR
Address Now モジュール
Enterprise Geocoding モジュール
Enterprise Routing モジュール
Universal Addressing モジュール
GeoComplete モジュール
United States
US
USA
Address Now モジュール
Enterprise Geocoding モジュール
Enterprise Routing モジュール
Universal Addressing モジュール
GeoComplete モジュール
United States Minor Outlying UM
Islands
UMI
Address Now モジュール
Universal Addressing モジュール
Uruguay
UY
URY
Address Now モジュール
Enterprise Geocoding モジュール
Universal Addressing モジュール
Uzbekistan
UZ
UZB
Address Now モジュール
Universal Addressing モジュール
管理ガイド
223
224
ISO 国名
ISO 3116-1
Alpha-2
ISO 3116-1
Alpha-3
サポートされるモジュール
Vanuatu
VU
VUT
Address Now モジュール
Universal Addressing モジュール
Venezuela, Bolivarian
Republic Of
VE
VEN
Address Now モジュール
Enterprise Geocoding モジュール
Universal Addressing モジュール
Viet Nam
VN
VNM
Enterprise Routing モジュール
Address Now モジュール
Universal Addressing モジュール
Virgin Islands, British
VG
VGB
Address Now モジュール
Universal Addressing モジュール
Virgin Islands, U.S.
VI
VIR
Address Now モジュール
Universal Addressing モジュール
Wallis and Futuna
WF
WLF
Address Now モジュール
Universal Addressing モジュール
Western Sahara
EH
ESH
Address Now モジュール
Universal Addressing モジュール
Yemen
YE
YEM
Address Now モジュール
Universal Addressing モジュール
Zambia
ZM
ZMB
Address Now モジュール
Enterprise Geocoding モジュール (アフ
リカ)
Universal Addressing モジュール
Zimbabwe
ZW
ZWE
Address Now モジュール
Enterprise Geocoding モジュール (アフ
リカ)
Universal Addressing モジュール
Spectrum™ Technology Platform 9.0 SP3
著作権に関する通知
2014 Pitney Bowes Software Inc. All rights reserved. MapInfo および Group 1 Software は Pitney
Bowes Software Inc. の商標です。その他のマークおよび商標はすべて、それぞれの所有者の資産で
す。
©
®
USPS 情報
®
Pitney Bowes Inc. は、ZIP + 4 データベースを光学および磁気媒体に発行および販売する非独占的ラ
イセンスを所有しています。 CASS、CASS 認定、DPV、eLOT、FASTforward、First-Class Mail、
Link
Link
Intelligent Mail、LACS 、NCOA 、PAVE、PLANET Code、Postal Service、POSTNET、Post
Link
Office、RDI、Suite
、United States Postal Service、Standard Mail、United States Post Office、
USPS、ZIP Code、および ZIP + 4 の各商標は United States Postal Service が所有します。 United
States Postal Service に帰属する商標はこれに限りません。
Link®
Pitney Bowes Inc. は、NCOA
®
処理に対する USPS の非独占的ライセンスを所有しています。
Pitney Bowes Software の製品、オプション、およびサービスの価格は、USPS® または米国政府によっ
™
て規定、制御、または承認されるものではありません。 RDI データを利用して郵便送料を判定する
®
場合に、使用する郵便配送業者の選定に関するビジネス上の意思決定が USPS または米国政府によっ
て行われることはありません。
データ プロバイダおよび関連情報
このメディアに含まれて、Pitney Bowes Software アプリケーション内で使用されるデータ製品は、各
種商標によって、および次の 1 つ以上の著作権によって保護されています。
©
Copyright United States Postal Service. All rights reserved.
©
2014 TomTom. All rights reserved. TomTom および TomTom ロゴは TomTom N.V の登録商標です。
©
Copyright NAVTEQ. All rights reserved
データ © 2014 NAVTEQ North America, LLC
Fuente: INEGI (Instituto Nacional de Estadística y Geografía)
電子データに基づいています。© National Land Survey Sweden.
©
Copyright United States Census Bureau
©
Copyright Nova Marketing Group, Inc.
このプログラムの一部は著作権で保護されています。© Copyright 1993-2007 by Nova Marketing Group
Inc. All Rights Reserved
©
Copyright Second Decimal, LLC
©
Copyright Canada Post Corporation
この CD-ROM には、Canada Post Corporation が著作権を所有している編集物からのデータが収録さ
れています。
©
2007 Claritas, Inc.
Geocode Address World データ セットには、http://creativecommons.org/licenses/by/3.0/legalcode
に存在するクリエイティブ コモンズ アトリビューション ライセンス (「アトリビューション ライセン
ス」) の下に提供されている GeoNames Project (www.geonames.org) からライセンス供与されたデー
タが含まれています。 お客様による GeoNames データ (Spectrum™ Technology Platform ユーザ マ
ニュアルに記載) の使用は、アトリビューション ライセンスの条件に従う必要があり、お客様と Pitney
Bowes Software, Inc. との契約と、アトリビューション ライセンスの間に矛盾が生じる場合は、アト
リビューション ライセンスのみに基づいてそれを解決する必要があります。お客様による GeoNames
データの使用に関しては、アトリビューション ライセンスが適用されるためです。
226
Spectrum™ Technology Platform 9.0 SP3
Copyright
ICU 情報
Copyright © 1995-2011 International Business Machines Corporation and others.
All rights reserved.
ここでの許可は、このソフトウェアおよび関連ドキュメント ファイル (以下「ソフトウェア」) のコ
ピーを取得する任意のユーザに無償で付与されるものであり、ソフトウェアのコピーを使用、複製、
改変、結合、発行、頒布、および/または販売する権利に対する制限などの制約を一切受けることなく
ソフトウェアを扱い、かつ、ソフトウェアが提供されるユーザがそうした目的で使用することを認め
るもので、その条件として、上記の著作権情報およびここでの許可情報をソフトウェアのすべてのコ
ピーに掲載すること、かつ上記の著作権情報およびここでの許可情報の両方を補足ドキュメントに掲
載する必要があります。
ソフトウェアは、何等保証のない「現状有姿」で提供されるものであり、商品性、特定用途に対する
適合性、第三者の権利非侵害、およびその他について、明示であると黙示であるとを問わず、一切保
証しないものとします。 いかなる場合も、ここに記載される著作権所有者は、あらゆる請求に対し
て、あるいは契約上の行為であれ、怠慢であれ、このソフトウェアの使用またはパフォーマンスに起
因または関連して発生するその他の不法行為であれ、使用不能損失、データ損失、または利益損失を
原因として発生する特別損害、間接損害、派生的損害、またはその他のいかなる損害に対しても、一
切責任を負わないものとします。
ここでの記載を除き、著作権所有者の名前を、著作権所有者の書面による事前の許可なく、広告で、
あるいはこのソフトウェアの販売、使用、または取扱を促進するその他媒体で使用してはなりません。
管理ガイド
227

TOOLS NEWS B146J 歯車加工用工具 不等ランドシェービングカッタ

ダスト・ネットワークス

Lシリーズスタンダード高輝度 (PDF 614KB)

住商情報システム http://www.curlap.com TEL:03-5547

cyberRAILパンフレット - Niccabi｜ニッキャビ株式会社

平成 27 年2月 24 日 会 社 名 株式会社テラプローブ 代 表 者 代表

太陽の光で家の電気を作っちゃうシステムです

階層を考慮した論理等価性チェック・フォーマル検証

TeraFaces TMモジュール TeraFaces TMモジュール

Magnetic - シルバコ・ジャパン