QlikViewファイル - インポート
ブリッジの要件
このブリッジ:Microsoft Windowsではサポートされていません。
そのSDKにアクセスするためにはツールのインストールが必要です。
ブリッジの仕様
| ベンダー | QlikTech |
| ツール名 | QlikView |
| ツールバージョン | 11.2〜12.x |
| ツールのWebサイト | http://www.qlik.com/us/products/qlikview |
| サポートされている方法論 | [ビジネスインテリジェンス] BIレポート(リレーショナルソース、式解析、レポートストラクチャー) via COM API on QVW or QVD ファイル |
| データプロファイリング |  |
| 増分収集 | |
| マルチモデル収集 | |
| モデル選択のためのリモートリポジトリーの参照 | |
仕様
ツール: QVWファイルまたはQVDファイルでのCOM API経由のQlikTech / QlikViewバージョン11.2〜12.x
http://www.qlik.com/us/products/qlikviewをご覧ください。
メタデータ: [ビジネスインテリジェンス] BIレポート(リレーショナルソース、式解析、レポートストラクチャー)
コンポーネント: QlikView バージョン11.2.0
概要
このブリッジは、QlikView Working (QVW)ドキュメントまたはQlikView Data (QVD)ファイルからBusiness Intelligence (BI)レポーティングメタデータをインポートします。
警告: このブリッジはWindowsベースのツールクライアントやSDKのCOM APIを使用します。このCOM APIは、(a) 正しくインストールされていること、(b) このツールを実行できるWindowsユーザーに代わってライセンスされていること、(c) ツールサーバーコンテンツにアクセスできることが必要です。追加事項:
(1) ツールベンダーによって推奨されているように、COM APIの場合も含めてリソース競合の恐れがあるため、ツールクライアント(およびブリッジ)がインストールまたは実行されているマシンにツールサーバーをインストールしたり共存させてはなりません。
(2) Windows COM APIベースのツールは度重なる失敗やシステムリソースの不足が発生すると不安定になるため、Windowsを再起動してツールのCOM APIを再び正しく動作させる必要があります。
(3) このブリッジがアプリケーションとして実行されている場合は、上記のWindowsユーザーと同じユーザーでログインする必要があります。
ブリッジがWindowsのサービスとして動作している場合は、WindowsのサービスマネージャーでMIMB Application Serverサービスを右クリックし、ログオンタブに移動して、サービスを実行するアカウントを名前で定義します。
- QlikViewソフトウェアがインストールされていること:
ブリッジの要件として、このブリッジを実行しているマシンにQlikViewソフトウェアとそのCOM/OLE APIがインストールされている必要があります。
- QlikViewソフトウェアが実行されない:
APIへの接続はCOMベースの自動化経由で行われるため、必ずQlikViewインスタンスをすべて閉じ、タスクマネージャーをチェックして、実行中のQlikViewプロセスがないことを確かめてください。このブリッジの起動に干渉するおそれがあるためです。
- QlikView実行ログが利用可能:
一部の重要なメタデータ(例: 来歴用の正確なソースデータストアテーブル)は、動的なアスペクト(例: ループ、サブルーチン、変数定義の使用)が原因でQlikスクリプトから直接抽出できません。そのため、このブリッジはQlikドキュメント実行ログを必要とします。
実行ログはQVWドキュメントの横(同じディレクトリー内)にあると想定されます。
よくある質問
Q: What should I do if this bridge appears to stop processing for a long time with no log messages after 'Connected to QlikView バージョン xx.xx.xxxxx.x'?
A: ポップアップダイアログの問題: APIへの接続はCOMベースの自動化によって行われるため、ダイアログメッセージがQlikViewによって生成され、レスポンスを待っていることからインポートがブロックされる場合があります。この問題に対処するためには、ユーザーの注意を必要とするダイアログであるウィンドウをバックグラウンドで探す必要があります。たとえばこのブリッジがアプリケーションとして直接ではなくサービスとして実行されている場合は、このメッセージを必ず確認できるよう、このブリッジをサービスではなくフルアプリケーションとして再実行する必要があります。
Q: このブリッジによって使用される実行ログファイルを作成する方法は?
A: 実行ログファイルは、QVWドキュメントスクリプトの実行時にQlikViewによって生成されます。QlikViewメニューの[設定] / [ドキュメントプロパティ] / [一般] / [ログファイルの生成]で、ログファイルの生成を有効にします。次に、QVWドキュメントスクリプトを実行します。
Q: 実行ログファイルの生成はいつ必要ですか?
A: 実行ログファイルには、このブリッジがスクリプトの式を理解するために役立つ情報が含まれています。スクリプトに変数、ループ、ダイナミックスクリプトのステートメントが含まれている場合は、常に実行ログファイルが役に立ちます。
Q: 別々のプロジェクトで同じ名前のテーブルをインポートすると、インポート結果が正しくなくなるのはなぜですか?
A: たとえば、ドキュメントはXテーブルとYテーブルからZテーブルにデータをロードします。次に、Zテーブルのデータをabc123.qvdに格納します。次にZ軸をドロップします。
そして、YテーブルとWテーブルからZテーブルにデータをロードしてqwe123.qvdを格納します。次にZ軸をドロップします。
そして、TテーブルとXテーブルからZテーブルにデータをロードしてasd123.qvdを格納します。
このドキュメントでは、3つの異なるSQL SELECT文で同じテーブル名Zを再利用しています。(SELECT > STORE > DROP)
来歴を維持するためには、上述の3つのテーブルをすべて作成しなければなりませんが、同じ名前で3つのテーブルを作成することはできません。そのため、ブリッジはドロップされたテーブルを一時テーブルとして検出し、一意の名前にします。この名前の形式は: name_Md5(application id)_removedTableNumberとなります。
制限事項
現在判明している一般的な制限事項は、https://www.metaintegration.com/Products/MIMB/Help/#!Documents/mimbknownlimitations.htmlをご覧ください。
サポート
デバッグログを伴うトラブルシューティングパッケージを提供します。デバッグログは、UIかconf/conf.propertiesでMIR_LOG_LEVEL=6を使って設定できます。
Q: サポートチームが問題を再現できるよう、どのように情報を提供すればよいですか?
A: 関連するファイル(QVW、QVD、実行ログ、外部スクリプト)のアーカイブを提供します。これらのファイルから機密データを削除したい場合は、そのためのスクリプトをリクエストしてください。
ブリッジパラメーター
| パラメーター名 | 説明 | タイプ | 値 | デフォルト | 範囲 | ||
| ファイル | QlikView Working (QVW)ドキュメントまたはQlikView Data(QVD)ファイル QVWドキュメントの場合、その実行ログは横(同じディレクトリー内)に配置される必要があります。 |
ファイル |
|
必須 | |||
| ユーザーID | QlikViewドキュメントを保護するためにセクションアクセスで指定されているユーザーID。 ユーザーIDが正しくないと、正しいユーザーIDを待機するQlikViewポップアップウィンドウのためにブリッジはハングします。 |
STRING | |||||
| パスワード | QlikViewドキュメントを保護するためにセクションアクセスで指定するユーザーIDのパスワード。 | パスワード | |||||
| 実行後の終了 | ドキュメントのインポート後にQlikViewアプリケーションを閉じます。 [False] アプリケーションはブリッジの実行後もデスクトップで開いたままとなります。 [True] アプリケーションはブリッジの実行後に閉じます。 アプリケーションはこのブリッジが実行されているマシンで起動します。 リモートサーバー上でこのブリッジをリモートで実行する場合、このパラメーターは[True]に設定する必要があります。そうしないと、アプリケーションはサーバー上で実行されたままになります。 |
BOOLEAN | True | ||||
| Miscellaneous | -database.type <接続データベースタイプのリスト> ジェネリックODBC接続を介してデータベースにアクセスしている場合は、そのデータベースに固有の来歴用SQL構文を適切に解析できるよう、正確なデータベースタイプを知っておくことが極めて重要です。 接続データベースタイプのリストは、カンマ区切りの値ペアで指定する必要があります: <接続名>=<データベースタイプ> SQL解析用にサポートされているデータベースタイプは以下のとおりです: ACCESS CASSANDRA DB2 DENODO HIVE MYSQL NETEZZA ORACLE POSTGRESQL PRESTO REDSHIFT SALESFORCE SAP HANA SNOWFLAKE SQL SERVER SYBASE TERADATA VECTORWISE VERTICA 接続名を使わずにデフォルトのデータベース接続を指定します。例: -database.type ORACLE 複数のデータベース接続が使われている場合は、関連する接続名を使用して各データベースタイプを指定します。例: -database.type MyConnectionName=ORACLE デフォルトのデータベースタイプを複数の接続データベースタイプと混合させることができます。例: -database.type ORACLE -database.type MyConnectionName1=TERADATA -database.type MyConnectionName2=DB2 QLIKのオプション -directory <ステートメント> 以降のLOADステートメントのディレクトリーパスを設定するために、QlikドキュメントのDIRECTORYステートメントが使われます。 このディレクトリーにアクセスできない場合は、DIRECTORYステートメントを使って別のディレクトリーにリダイレクトします。そのためには、DIRECTORYステートメントをQlikドキュメント実行ログからコピーし、= を追加して別のディレクトリーへのパスを指定します。次の場合は、c:\folderフォルダーがd:\folder2フォルダーにリダイレクトされます。例: -directory [c:\folder1]=[d:\folder2] DIRECTORYステートメントの後のパスが空である場合は、すべてのDIRECTORYステートメントが指定されたディレクトリーにリダイレクトされます。例: -directory []=[d:\folder2] -file.path <ファイルディレクトリー> Qlikドキュメントには、ファイルパスと連携するInclude、 Store、Loadといったステートメントが含まれていることがあります。元のファイルパスがこのインポートブリッジによってはアクセスできない場合、次のようなエラーが記録されます: -「次のファイルを開くことができません: '\\inaccessible\scripts\include.txt」 -「ソースドキュメントである\\inaccessible\QVDs\file.qvdがアクセス不可能であるため、依存項目を処理できませんでした」 このようなエラーは、アクセスできないファイルをアクセス可能なパスにコピーすることで解決できます。 必要なファイルが\\inaccessible\folder", then copy them to C:\accessible\folderにある場合は、それをC:\accessible\foldeにコピーし、新しい場所から読み取るようインポートブリッジに指示してください。例: -file.path [\\inaccessible]=[c:\accessible] file.pathオプションでは、複数のfile.pathオプションを指定することで元のファイルパスの一部を新しいものと置換できます。例: -file.path [\\inaccessible]=[c:\accessible], [\\inaccessible2]=[c:\accessible2] インポートブリッジは、複数の-file.pathオプションを指定された順番に適用します。 -file.path [\\a]=[c:\a], [\\aa]=[c:\aa] - 正しくない方法 -file.path [\\aa]=[c:\aa], [\\a]=[c:\a] - 正しい方法 file.pathの指定は、インポートするQlikViewドキュメントがあるディレクトリーパスの外側では行わないようにしてください。 -log.notavailable 一部の重要なメタデータ(例: 来歴用の正確なソースデータストアテーブル)は、動的なアスペクト (例: ループ、サブルーチン、変数定義の使用)が原因でQlikスクリプトから直接抽出できないため、Qlikドキュメント実行ログを必要とします。 このオプションによって、実行ログが利用できない場合(来歴用の一部の重要なメタデータが欠けているなど)でもインポートできるようになります。 -qvd.as.file このパラメーターを指定すると、ブリッジは、LOADステートメントとSTOREステートメントからのQVDファイルを通常のファイル(CSVやTXTなど)としてインポートします。 QVDファイルはアクセス不可にすることができるので、-file.pathを使ってアクセス不可のQVDファイルのパッチをオーバーライドする必要はありません。 このパラメーターが指定されていない場合、ブリッジはQVDファイルをOLAPモデルとしてインポートします。 QVDファイルはこのインポートブリッジによってアクセス可能であることが必要です(詳細は-file.pathをご覧ください。)。 |
STRING |
ブリッジのマッピング
| Meta Integration Repository (MIR) メタモデル (OMG CWM標準に基づく) |
"QlikView ファイル" メタモデル QlikView (QVW) |
マッピングのコメント |
| 属性 | ソースカラム | |
| コメント | コメント | |
| 説明 | 定義 | |
| DesignLevel | デザインレベル | |
| InitialValue | 初期値 | |
| 名前 | 名前 | |
| NativeId | ネイティブID | |
| オプション | Null可能 | |
| PhysicalName | 物理名 | |
| 位置 | 位置 | |
| クラス | ソーステーブル | |
| 名前 | 名前 | |
| ConnectionPackage | 接続スキーマ | |
| 名前 | 名前 | |
| DesignPackage | テーブル | |
| 名前 | 名前 | |
| ディメンション | テーブル | |
| 説明 | 説明 | |
| 名前 | 名前 | |
| NativeId | ネイティブID | |
| NativeType | ネイティブタイプ | |
| DimensionAttribute | カラム | |
| コメント | コメント | |
| 説明 | 定義 | |
| DesignLevel | デザインレベル | |
| InitialValue | 初期値 | |
| 名前 | 名前 | |
| NativeId | ネイティブID | |
| オプション | Null可能 | |
| PhysicalName | 物理名 | |
| 位置 | 位置 | |
| [Filter] (フィルター) | 条件 | |
| 名前 | 名前 | |
| メジャー | メジャー | |
| コメント | コメント | |
| 説明 | 定義 | |
| DesignLevel | デザインレベル | |
| InitialValue | 初期値 | |
| 名前 | 名前 | |
| NativeId | ネイティブID | |
| オプション | Null可能 | |
| PhysicalName | 物理名 | |
| 位置 | 位置 | |
| レポート | [Document] (ドキュメント) | |
| 名前 | 名前 | |
| ReportAttribute | フィールド、グループ、システム変数、変数、式、システムフィールド | |
| 名前 | 名前 | |
| ReportAxis | 軸 | |
| 説明 | 定義 | |
| 名前 | 名前 | |
| NativeId | ネイティブID | |
| 位置 | 位置 | |
| ReportChart | スライダー、チャート | |
| 説明 | 定義 | |
| 名前 | 名前 | |
| NativeId | ネイティブID | |
| 位置 | 位置 | |
| ReportDataSet | 変数、フィールド、グループ、システム変数、式、システムフィールド | |
| 名前 | 名前 | |
| ReportField | テキストフィールド、ボタンフィールド | |
| 説明 | 定義 | |
| 名前 | 名前 | |
| NativeId | ネイティブID | |
| 位置 | 位置 | |
| ReportList | リストボックス | |
| 説明 | 定義 | |
| 名前 | 名前 | |
| NativeId | ネイティブID | |
| 位置 | 位置 | |
| ReportMatrix | ピボットテーブル | |
| 説明 | 定義 | |
| 名前 | 名前 | |
| NativeId | ネイティブID | |
| 位置 | 位置 | |
| ReportPage | シート | |
| 説明 | 定義 | |
| 名前 | 名前 | |
| NativeId | ネイティブID | |
| 位置 | 位置 | |
| ReportTable | ストレートテーブル、統計ボックス、テーブルボックス、検索オブジェクト、入力ボックス、マルチボックス | |
| 説明 | 定義 | |
| 名前 | 名前 | |
| NativeId | ネイティブID | |
| 位置 | 位置 | |
| ReportText | テキストボックス、ボタンのテキスト | |
| 説明 | 定義 | |
| 名前 | 名前 | |
| NativeId | ネイティブID | |
| 位置 | 位置 | |
| 値 | 値 | |
| StoreConnection | 接続 | |
| 名前 | 名前 | |
| StoreType | 保管タイプ | |
| SystemMajorバージョン | システムのメジャーバージョン | |
| SystemMinorバージョン | システムのマイナーバージョン | |
| SystemReleaseバージョン | システムのリリースバージョン | |
| SystemType | システムタイプ | |
| StoreModel | QVWモデル | |
| 名前 | 名前 | |
| StoreType | 保管タイプ | |
| SystemMajorバージョン | システムのメジャーバージョン | |
| SystemMinorバージョン | システムのマイナーバージョン | |
| SystemReleaseバージョン | システムのリリースバージョン | |
| SystemType | システムタイプ |