14 tm1 turbointegrator

Printed on 2017/12/27
Title 14. Turbo Integrator
14. Turbo Integrator
Turbo Integratorとは、さまざまな種類のデータをIBM Cognos TM1 キューブにインポートするためのツールです。
Turbo Integratorで利用可能なデータ・ソースは以下のとおりです。
・ASCII ファイルを含む、コンマ区切りのテキスト・ファイル
・ODBC データ・ソース経由でアクセス可能なリレーショナル・データベース・テーブル
・他のキューブおよびビュー
・Microsoft Analysis Services
・RFC経由のSAP
・IBM Cognos パッケージ
Turbo Integratorには、TM1 オブジェクト(キューブ、ビュー、ディメンション、要素など) をデータのインポート時に操作することができる一連の関数が用意されています。
Turbo Integrator操作
■テキスト(ASCII ファイル含む、コンマ区切り)データのインポート
以下では、ASCII ファイルを含む、コンマ区切りのテキスト・ファイルのインポート手順について説明します。
Server Explorerでプロセスを右クリックし、新規プロセスの作成を選択します。
ここではSDataサーバを利用します。
14_TurboIntegrator.xls 1/41 14.Turbo Integrator

Turbo Integratorウィンドウが開くので、データ・ソース・タイプにてテキストを選択し、データ・ソース名の参照ボタンをクリックします。

今回はTM1のサンプルデータ(.cma形式)を利用します。
入力ファイルにC:Program Filesibmcognostm1samplestm1TI_Dataexample.cmaを選択します。
ファイルを選択すると以下の警告が出ますが、OKをクリックします。

example.cmaは区切り文字がコンマ、引用符に二重引用符、タイトルレコードなし、小数点記号にピリオド、桁区切り記号にコンマを利用しています。
このソースを定義するため次の設定を入力します。
・「区切り記号の種類」で「区切り付き」を選択
・「区切り記号」として「コンマ」を選択
・「引用符」に" を入力
・「タイトル・レコード数」のフィールドは空白のまま
・「小数点記号」に . (ピリオド)を入力
・「桁区切り記号」に , (コンマ)を入力
Turbo Integratorウィンドウの下部にプレビューが表示されます。

一度プロセスを保存します。「保存」ボタンをクリックします。

プロセスに名前をつけて保存することを求められるので、任意の名前(ここではnewdata)を入力し、OKボタンをクリックします。

■ディメンションの作成
変数のマッピング
データソースのフィールドごとに内容を識別するため、変数を割り当てます。
これによりデータ構造を設定することができます。
まず、変数の識別を行います。
Turbo Integratorウィンドウにて、「変数タブ」を選択します。

ここで表示される内容は、データの構造を示します。
「変数名」は、データソースフィールドごとに割り当てられた変数の名称を示します。
「変数の型」は、各変数の型を示します。
「サンプル値」は、これらの変数が持つ最初の値を示します。
「コンテンツ」は、各変数が表すデータ型(要素、集約、データ、属性、その他、無視) を規定します。
この例の最初の3 つの変数は、地域階層の集約と要素を表すので、コンテンツのドロップダウンリストから選択し、以下を設定します。
V1->集約
Massachusetts->集約
Boston->要素

変更結果は以下となります。

また、変数名も統一するために、以下のように変更します。
Massachusetts->V2
Boston->V3
SuperMart->V4
Feb->V5
変数名をクリックすることにより、変更できます。

次に、識別した変数をマッピングします。
Turbo Integratorウィンドウにて、マップタブを選択、ディメンションサブタブをクリックします。
操作ドロップダウンリストから「作成」を選択します。

要素の型ドロップダウンリストから「数値」を選択します。
ディメンション列にExampleと入力します。
これにより、V3変数はExampleという新しいディメンションの数値要素としてマッピングされます。

次に、集約として識別した変数をマッピングします。
集約に対して子の変数を設定します。
集約サブタブを選択します。
V1集約変数について、「V2」を子の変数とします。
V2集約変数について、「V3」を子の変数とします。
以上でマッピングは完了となります。

設定した内容を保存(ファイル->保存)します。

実行ボタンをクリックし、これらの内容を適用します。

プロセスが正常に完了したことを確認し、OKボタンをクリックします。
Server ExplorerにもExampleというディメンションが作成されていることが表示されます。

Exampleディメンションをダブルクリックして内容を確認します。

■データソースとしてTM1キューブビューを使用
以下では、TM1キューブビューよりデータソースとして指定する手順について説明します。
ここではSDataサーバを利用します。

IBM Cognos TM1を選択し、「データ・ソース・タイプ」ボックスで「キューブ・ビュー」を選択すると、「データ・ソース名」フィールドが表示されます。
データ・ソース名の参照ボタンをクリックします。

「サーバー・キューブ・ビューの参照」ダイアログボックスが表示されるので、インポートするデータを持つキューブとビューを選択します。
ここでは、キューブSData:SalesPriorCubeのビューexample1を選択し、OKボタンをクリックします。
「保存」ボタンをクリックし、これらの内容を保存します。

プロセスに名前をつけて保存することを求められるので、任意の名前(ここではtest1)を入力します。

Server Explorer ビューにおいて、プロセスにtest1が作成されていることが確認できます。
■キューブの作成
以下では、データからキューブを作成する方法について説明します。
Turbo Integratorウィンドウが開くので、データソースをテキスト、データソースにTM1_dataの「newcube.csv」を選択します。
C:Program Filesibmcognostm1samplestm1TI_Datanewcube.csv

区切り記号の種類を区切り付き、区切り記号をコンマ、小数点記号を . (ピリオド)、桁区切り記号を , (コンマ)に設定し、
プレビューでデータが出力されていることを確認します。

変数タブを選択します。
変数にはVn(nは整数)と入っているものと、データの最初のレコードの値が入っているものが混在しています。

編集しやすくするために、変数を全て以下のようにVn(nは整数)とします。
また、変数の型、コンテンツのデータの種類を以下のように設定します。
ここでコンテンツの種類として「データ」「要素」「集約」がありますが、それぞれ以下のような意味があります。
データ…変数が要素の値であることを示します。
要素…ディメンションの一項目であることを示します。
集約…要素を子として持つディメンションの一項目であることを示します。

このようにして作成した変数をキューブにマッピングします。
マップタブをクリックし、キューブサブタブを選択します。
キューブの操作でキューブの作成を選択し、キューブ名にNewCubeを入力します。

ディメンションサブタブを選択します。
変数の設定時に「要素」を持つと識別した変数を、cubeのディメンションとして設定します。
要素変数ごとに、以下のようにディメンションおよび操作、要素の型を入力します。

データサブタブをクリックします。
データ変数V1、V2、V3について、それぞれweight、conversion、piecesを変数マッピング先の要素として入力します。

集約サブタブを選択します。
変数の設定時に「集約」を持つと識別した変数に対し、cubeのディメンションおよび子の変数を設定します。
以下のようにディメンション名、子の変数を設定します。

以上で新しいキューブに対し、ディメンションを設定し、そのディメンションに要素と集約を挿入し、マッピングが完了しました。
このプロセスを保存します。
実行ボタンをクリックすると、プロセス名の入力を求められるので、任意の名前(ここではcreate_newcube)を入力し、OKボタンをクリックします。
プロセスを実行し、プロセスが正常に完了したことを確認し、OKボタンをクリックします。
Server ExplorerにてキューブNewCubeが作成されていることが確認できます。

■ ODBCソースからのデータインポート
以下では、TM1サンプルのMS AccessDBにODBC経由でアクセスを行い、Turbo IntegratorでMS AccessDBのデータを元にキューブ･ディメンションを作成します。
「コントロールパネル」⇒「管理ツール」から「データソース(ODBC)」をダブルクリックします。

「システム DSN」タブを選択し「追加」から、データソースの新規作成画面で「Microsoft Access Driver (*.mdb)」を選択し「完了」します。
データソース名として「TM1_sample_data」と記載します。
「選択」をクリックし、以下のフォルダから「Sales.mdb」を選択し、「OK」をクリックします。
C:Program FilesIBMcognostm1samplestm1PDataRelationalData

「OK」を選択します。

ODBC データソースアドミニストレータ画面で「TM1_sample_data」が追加されている事を確認し「OK」をクリックします。
サーバー・エクスプローラーのPlanning Sampleで、プロセスを右クリックし「新規プロセスの作成」を選択します。

データ・ソース・タイプとして「ODBC」を選択し、データ・ソース名にTM1_sample_dataを参照から選択します。
クエリーに select * from sales; と記載して、「プレビュー」をクリックし、サンプルデータが表示される事を確認します。

「変数」タブで、以下の画面の通りに変更します。
変数名 6番を「vTime」に変更
変数の型の1番を「文字列」に変更
コンテンツ列を画面の通りに変更

「マップ」の「キューブ」タブで「キューブの作成」をチェックし、キューブ名に「ODBC_TEST」と記載
「マップ」の「ディメンション」タブでディメンション・キューブ内の順序・操作を、以下の通り変更する。

「詳細」タブで、「パラメーター」から「エピローグ」の全てのタブをクリックする。
TM1の仕様により、順番にタブを選択しなくてはODBCでのインポートにてエラーが発生するため、このような処理を実施します。
「保存」をクリックして、名前に「ODBC_Import」と記載し「OK」を選択します。
プロセスを実行します。
正常完了を確認し、「OK」を選択します。

サーバー・エクスプローラーで「ODBC_TEST」が作成されている事を確認し、ダブルクリックでCube Viewerを開きます。
下記のようにタイトル・列・行を並び替えて、再計算を実行します。
※Turbo Integratorのデータのプレビューの1行目で表示されていたデータがImportされて表示される事がわかります。

14 tm1 turbointegrator

More Related Content

More from Shinsuke Yamamoto

14 tm1 turbointegrator