メイン コンテンツをスキップする 補完的コンテンツへスキップ

IBM Cognos Framework Manager (FM) for ReportNet - インポート

Availability-note AWS

ブリッジの要件

このブリッジ:
  • Microsoft Windowsではサポートされていません。

ブリッジの仕様

ベンダー IBM
ツール名 Cognos Framework Manager
ツールバージョン ReportNet 1.1~Cognos 8.0
ツールのWebサイト http://www.ibm.com/software/analytics/cognos/
サポートされている方法論 [ビジネスインテリジェンス] XMLファイル経由のBIデザイン(RDBMSソース、OLAPソース、ディメンショナルターゲット、変換来歴、式解析)
データプロファイリング
増分収集
マルチモデル収集
モデル選択のためのリモートリポジトリーの参照

仕様
ツール: XMLファイル経由のIBM / Cognos Framework ManagerバージョンReportNet 1.1〜Cognos 8.0
http://www.ibm.com/software/analytics/cognos/をご覧ください。
メタデータ: [ビジネスインテリジェンス] BIデザイン(RDBMSソース、OLAPソース、ディメンショナルターゲット、変換来歴、式解析)
コンポーネント: CognosRnFrameworkManager1バージョン11.2.0

概要
このブリッジは、Cognos ReportNet FrameworkマネージャーモデルをXML形式でインポートします。

要件
該当なし

よくある質問
該当なし

制限事項
現在判明している一般的な制限事項は、MIMB Known Limitationsか、バンドルされているDocumentation/ReadMe/MIMBKnownLimitations.htmlをご覧ください。

Cognos式にはCognos専用のマクロ言語が使用される場合があり、この言語の構文はサポートされていません(解析済み)。そのため、このようなマクロを使うと履歴が不完全になることがあります。

サポート
デバッグログを伴うトラブルシューティングパッケージを提供します。デバッグログは、UIかconf/conf.propertiesでMIR_LOG_LEVEL=6を使って設定できます。


ブリッジパラメーター

パラメーター名 説明 タイプ デフォルト 範囲
ファイル ブリッジは、IBM Cognos Framework ManagerからのネイティブXMLファイルを使用します:

省略記号ボタン(...)を使って、インポートするプロジェクトのディレクトリーに移動し、model.xmlファイルを選択します。
ファイル *.xml   必須
フォルダー表現 IBM Cognos Framework Managerからのフォルダーをどのように表現するかを選択します。
[無視]
フォルダーは無視されます。

[フラット]
フォルダーは図として表現されます。その階層は保持されません。

[階層]
フォルダーは図として表現され、その階層ストラクチャーが保持されます。
ENUMERATED
無視
フラット
階層
無視  
パッケージ表現 IBM Cognos Framework Managerからのフォルダーをどのように表現するかを選択します。
[無視]
サブジェクトエリアを無視します。

[サブジェクトエリア]
パッケージをサブジェクトエリアとして表現します。
ENUMERATED
無視
サブジェクトエリア
無視  
テーブルデザインレベル このオプションは、インポートしたテーブルのデザインレベルを制御します。これは、モデルの2つのビュー(論理ビューと物理ビュー)をサポートしているターゲットツールにメタデータをエクスポートする場合に特に重要です。データモデリングツールの中には、この概念をサポートしているものがあり、テーブルが物理テーブルとしても論理エンティティとしても表示されるかどうかを決めることができます。ビジネスインテリジェンスツールの中にはこの概念をサポートするものもあり、テーブルが物理モデルとモデルのビジネスビューの両方に表示されるかどうかを決めることができます。
[論理および物理]
テーブルはモデルの論理ビューと物理ビューの両方に表示されます。

[物理]
テーブルはモデルの物理ビューにのみ表示されます。
ENUMERATED
物理
論理および物理
物理  
使用状況プロパティを無視 queryItemの使用状況プロパティを使用するかどうかを指定します。

[True]
使用状況属性のQueryItemはディメンション属性として表現されます。使用状況ファクトのqueryItemはメジャーとして表現されます。

[False]
クエリー項目を無視します。
BOOLEAN
False
True
True  
マクロ値ファイル ファイル defining list of macro replacement values:
macro1=value1
macro2=value2
...
macroN=valueN

For example:
$machine=localhost
$runLocale=en
sq($runLocale)='en'
dq('Column ' + $runLocale)="Column en"
$Language_lookup{$runLocale}=EN
prompt('CountryName')=France
'[NAMESPACE].[QUERYSUBJECT].[QUERYITEM_'+$Language_lookup{$runLocale}+']'=[NAMESPACE].[QUERYSUBJECT].[QUERYITEM_EN]

FrameworkManagerモデル may use macros to parameterize SQL statements.
実行時にのみ定義されるダイナミックプロンプトがマクロに含まれることがあります。
そのような場合、インポートブリッジはマクロの値を決定できなかったという警告をログに出力し、結果モデルには何も代入せずにそのマクロをそのままにします。
正しいマクロ置換値を決定できるよう、インポートブリッジは、そのマクロと代入する正しい値が記述されているマクロ値ファイルを読み取ります。
ファイル *.*    
Miscellaneous はじめに
ダッシュで始まるMiscellaneousオプションを指定し、必要であればその後にパラメーターを追加できます。例:
- connection.cast MyDatabase1="MICROSOFT SQL SERVER"
該当する場合は複数回使用できるオプションもあります。例:
- connection.rename NewConnection1=OldConnection1 -connection.rename NewConnection2=OldConnection2;
オプションのリストは長い文字列になるため、${MODEL_BRIDGE_HOME}\data\MIMB\parametersにあり拡張子が.txtであるファイルからロードすることもできます。その場合、オプションはすべて、このパラメーターの唯一の値としてそのファイル内で定義されることが必要です。例:
ETL/Miscellaneous.txt

JAVA環境のオプション
-java.memory <Javaメモリの最大サイズ> (以前の-m)

64ビットJREではデフォルトで1G、またはconf/conf.properties内の設定に従います。例:
-java.memory 8G
-java.memory 8000M

-java.parameters <Javaランタイム環境コマンドラインオプション> (以前の-j)


-java.parameters -Dname=value -Xms1G
のように、-java.parametersの後ろのテキストはすべてそのままJREに渡されるため、このオプションはMiscellaneousパラメーター内の最後に来る必要があります。インターネットへのアクセスにプロキシを使用している場合は、必要なサードパーティのソフトウェアライブラリーをダウンロードできるよう、次のオプションを設定する必要があります(このオプションはhttps://repo.maven.apache.org/maven2/にアクセスするため、そして例外的にいくつかの他のツールサイトにアクセスするために不可欠です)。
注: プロキシは、(会社の)外部トラフィックをHTTPSで暗号化しながら、HTTPでプロキシにアクセスできる内部トラフィックを信頼しているものがほとんどです。この場合、HTTPSリクエストはHTTPでプロキシに到達し、プロキシはそれをHTTPSで暗号化します。
-java.parameters -java.parameters -Dhttp.proxyHost=127.0.0.1 -Dhttp.proxyPort=3128 -Dhttp.proxyUser=user -Dhttp.proxyPassword=pass

モデルインポートのオプション
-model.name <モデル名>

モデル名をオーバーライドをオーバーライドします。例:
-model.name "My Model Name"

-prescript <スクリプト名>

このオプションによって、ブリッジの実行前にスクリプトを実行できるようになります。
スクリプトはbinディレクトリー(またはconf/conf.propertiesのM_SCRIPT_PATHで指定)にあり、拡張子が.batか.shであることが必要です。
スクリプトのパスに親ディレクトリーの記号( .. )を含めることはできません。
スクリプトは、成功した場合は終了コードである0を、失敗した場合は別の値を返します。
例:
-prescript "script.bat arg1 arg2"

-postscript <スクリプト名>

このオプションによって、ブリッジが正しく実行された後にスクリプトを実行できるようになります。
スクリプトはbinディレクトリー(またはconf/conf.propertiesのM_SCRIPT_PATHで指定)にあり、拡張子が.batか.shであることが必要です。
スクリプトのパスに親ディレクトリーの記号( .. )を含めることはできません。
スクリプトは、成功した場合は終了コードである0を、失敗した場合は別の値を返します。
例:
-postscript "script.bat arg1 arg2"

-cache.clear

インポート前にキャッシュをクリアするため、増分収集せずにフルインポートを実行します。

モデルが変更されず、-cache.clearパラメーターが使われていない場合(増分収集)、新しいバージョンは作成されません。
モデルが変更されず、-cache.clearパラメーターが設定されている場合(増分ではなくフルソースインポート)、新しいバージョンが作成されます。

-backup <directory>

このオプションによってブリッジ入力メタデータを保存すれば、将来のトラブルシューティングで活用できます。指定された<directory>は空であることが必要です。

このオプションの主な用途は、データストアインポートブリッジ(特にJDBCベースのデータベースインポートブリッジ)です。

なお、このオプションは次のようなブリッジでは動作しません。
- ファイルベースのインポートブリッジ(入力ファイルで代用可能なため)
- DI/BIリポジトリーインポートブリッジ(ツールのリポジトリーネイティブバックアップで代用可能なため)
- APIベース(COMベースなど)による一部のインポートブリッジ(技術的な理由のため)

データ接続オプション
使用するソースとターゲットのデータストアを参照するよう、通常はETL/DIツールとBIツールのインポートブリッジによってデータ接続が生成されます。これらのデータ接続はメタデータ管理ツールによって実際のデータストア(データベースやファイルシステムなど)への接続(メタデータスティッチング)に使われ、完全なエンドツーエンドのデータフローの来歴とインパクト分析が行われます。各データ接続の名前はインポートモデルごとに一意です。DI/BIデザインツールで使われているデータ接続名を可能な限り使用します。そうでない場合は、データベース/スキーマ名、ファイルシステムのパス、Uniform Resource Identifier (URI)など、短くても意味のある接続名が生成されます。次のオプションを使えば、接続を操作できます。これらのオプションによって、レガシーオプションである-c、-cd、-csが置き換えられます。

-connection.cast ConnectionName=ConnectionType

SQL解析のためにジェネリックデータベース接続(ODBCやJDBCなど)を正確なデータベースタイプ(ORACLEなど)にキャストします。例:
-connection.cast "My Database"="MICROSOFT SQL SERVER"
サポートされているデータストア接続タイプのリストは次のとおりです。
ACCESS
APACHE CASSANDRA
DB2/UDB
DENODO
GOOGLE BIGQUERY
HIVE
MYSQL
NETEZZA
ORACLE
POSTGRESQL
PRESTO
REDSHIFT
SALESFORCE
SAP HANA
SNOWFLAKE
MICROSOFT SQL AZURE
MICROSOFT SQL SERVER
SYBASE SQL SERVER
SYBASE AS ENTERPRISE
TERADATA
VECTORWISE
HP VERTICA

-connection.rename OldConnection=NewConnection

既存の接続を新しい名前に変更します。例:
-connection.rename OldConnectionName=NewConnectionName
既存の複数のデータベース接続の名前を変更し、新しい1つのデータベース接続に統合できます。例:
-connection.rename MySchema1=MyDatabase -connection.rename MySchema2=MyDatabase

-connection.split oldConnection.Schema1=newConnection

データベース接続を1つまたは複数のデータベース接続に分割します。
1つのデータベース接続をスキーマごとの1つの接続に分割できます。例:
-connection.split MyDatabase
すべてのデータベース接続をスキーマごとの1つの接続に分割できます。例:
-connection.split *
データベースにスキーマ名を追加することで、データベース接続を明示的に分割し、新しいデータベース接続を作成できます。例:
-connection.split MyDatabase.schema1=MySchema1

-connection.map SourcePath=DestinationPath

ソースパスをデスティネーションパスにマッピングします。これは、異なるパスが同じオブジェクト(ディレクトリーまたはファイル)をポイントしている場合にファイルシステム接続にとって便利です。
Hadoopでは、あるプロセスがHDFSの完全パスで指定されたCSVファイルに書き込む一方、別のプロセスが、デフォルトのファイル名と拡張子を持つ相対パスで指定されている同じファイルによって実装されたHiveテーブル(外部)から読み取ります。例:
-connection.map /user1/folder=hdfs://host:8020/users/user1/folder/file.csv
Linuxでは、/users/johnや/users/paulといった複数のシンボリックリンクによって、/dataのような特定のディレクトリー(またはファイル)が参照されます。例:
-connection.map /data=/users/John -connection.map /data=/users/paul
Windowsでは、M:やN:といった複数のネットワークドライブによって、C:\dataのような特定のディレクトリーが参照されます。例:
-connection.map C:\data=M:\ -connection.map C:\data=N:\

-connection.casesensitive ConnectionName...

検出されたデータストアのタイプがこの設定(Microsoft SQL ServerやMySqlなど)をサポートしている場合は、指定された接続内のオブジェクト識別子に対し、大文字と小文字を区別しないデフォルトのマッチングルールがオーバーライドされます。例:
-connection.casesensitive "My Database"

-connection.caseinsensitive ConnectionName...

検出されたデータストアのタイプがこの設定(Microsoft SQL ServerやMySqlなど)をサポートしている場合は、指定された接続内のオブジェクト識別子に対し、大文字と小文字を区別するデフォルトのマッチングルールがオーバーライドされます。例:
-connection.caseinsensitive "My Database"

-connection.level AggregationLevel

外部接続の集計レベルを指定します。例: -connection.level catalog
サポートされている値のリスト:
server
catalog
schema (デフォルト)

IBM COGNOS FRAMEWORKMANAGERのオプション
STRING      

 

ブリッジのマッピング

Meta Integration Repository (MIR)
メタモデル
(OMG CWM標準に基づく)
"IBM Cognos Framework Manager (FM) for ReportNet"
メタモデル
Cognos BIレポートing (FrameworkManager)
マッピングのコメント
     
AliasClassifier フィルター - ショートカット  
説明 説明  
名前 名前  
NativeId ネイティブID  
NativeType ネイティブタイプ  
引数 引数  
DefaultValue デフォルト値  
説明 説明  
種類 種類  
名前 名前  
NativeId ネイティブID  
NativeType ネイティブタイプ  
PhysicalName 物理名  
位置 位置  
属性 カラム  
コメント コメント  
説明 定義  
DesignLevel デザインレベル  
InitialValue 初期値  
名前 名前  
NativeId ネイティブID  
オプション Null可能  
PhysicalName 物理名  
位置 位置  
クラス テーブル  
説明 説明  
名前 名前  
NativeId ネイティブID  
NativeType ネイティブタイプ  
Condition 条件フィルター  
説明 説明  
非表示 非表示  
InitialValue 初期値  
名前 名前  
NativeId ネイティブID  
NativeType ネイティブタイプ  
オプション オプション  
PhysicalName 物理名  
位置 位置  
ConnectionPackage ConnectionPackageデータソース  
説明 説明  
名前 名前  
NativeId ネイティブID  
NativeType ネイティブタイプ  
PhysicalName 物理名  
DesignPackage ダイナミックソース、データソース、データソース、フォルダー、ネームスペース  
説明 説明  
名前 名前  
NativeId ネイティブID  
NativeType ネイティブタイプ  
ディメンション 計算 - ショートカット、プロシージャークエリー、データベースクエリー、データベースクエリー - ショートカット、モデルクエリー - ショートカット、メジャーディメンション、メジャーディメンション - ショートカット、計算、ディメンション、ディメンション - ショートカット、モデルクエリー  
説明 説明  
非表示 非表示  
名前 名前  
NativeId ネイティブID  
NativeType ネイティブタイプ  
タイプ タイプ  
DimensionAttribute 属性、DimensionAttributeの計算、クエリー項目、キーレベル属性  
説明 説明  
非表示 非表示  
InitialValue 初期値  
名前 名前  
NativeId ネイティブID  
NativeType ネイティブタイプ  
オプション オプション  
OriginalName 元の名前  
位置 位置  
ソート ソート  
[Filter] (フィルター) [Filter] (フィルター)  
説明 説明  
非表示 非表示  
名前 名前  
NativeId ネイティブID  
NativeType ネイティブタイプ  
階層 階層  
説明 説明  
名前 名前  
NativeId ネイティブID  
NativeType ネイティブタイプ  
PhysicalName 物理名  
タイプ タイプ  
結合 リレーションシップ、スコープリレーションシップ  
説明 説明  
名前 名前  
NativeId ネイティブID  
NativeType ネイティブタイプ  
PhysicalName 物理名  
タイプ タイプ  
[Level](レベル) [Level](レベル)  
説明 説明  
名前 名前  
NativeId ネイティブID  
NativeType ネイティブタイプ  
メジャー メジャー  
DefaultAggregation デフォルトの集計  
説明 説明  
非表示 非表示  
InitialValue 初期値  
名前 名前  
NativeId ネイティブID  
NativeType ネイティブタイプ  
オプション オプション  
位置 位置  
ソート ソート  
OlapSchema OlapSchemaネームスペース  
説明 説明  
名前 名前  
NativeId ネイティブID  
NativeType ネイティブタイプ  
PhysicalName 物理名  
ステレオタイプ ステレオタイプ  
SQLViewAttribute カラムを表示  
コメント コメント  
説明 定義  
DesignLevel デザインレベル  
InitialValue 初期値  
名前 名前  
NativeId ネイティブID  
オプション Null可能  
PhysicalName 物理名  
位置 位置  
SQLViewEntity 表示  
説明 説明  
名前 名前  
NativeId ネイティブID  
NativeType ネイティブタイプ  
StoreConnection StoreConnectionデータソース  
接続 接続  
説明 説明  
名前 名前  
NativeId ネイティブID  
NativeType ネイティブタイプ  
PhysicalName 物理名  
StoreType 保管タイプ  
SystemMajorバージョン システムのメジャーバージョン  
SystemMinorバージョン システムのマイナーバージョン  
SystemReleaseバージョン システムのリリースバージョン  
SystemType システムタイプ  
SystemTypeOld システムタイプ(旧)  
StoreModel FrameworkManagerモデル  
作成者 作成者  
CreationTime 作成日時  
説明 説明  
ModificationTime 変更日時  
変更者 変更者  
名前 名前  
NativeId ネイティブID  
NativeType ネイティブタイプ  
PhysicalName 物理名  
StoreType 保管タイプ  
SystemMajorバージョン システムのメジャーバージョン  
SystemMinorバージョン システムのマイナーバージョン  
SystemReleaseバージョン システムのリリースバージョン  
SystemType システムタイプ  
SystemTypeOld システムタイプ(旧)  
StoredProcedure ファンクション、ストアドプロシージャー  
説明 説明  
名前 名前  
NativeId ネイティブID  
NativeType ネイティブタイプ  
PhysicalName 物理名  
事後条件 事後条件  
事前条件 事前条件  
セマンティクス コード  

このページは役に立ちましたか?

このページまたはコンテンツにタイポ、ステップの省略、技術的エラーなどの問題が見つかった場合はお知らせください。