Qlik Replicateでのタスクの定義と管理

© 2019 QlikTech International AB. All rights reserved.
Qlik Replicateでの
タスクの定義と管理
クリックテック・ジャパン株式会社

2
タスクの定義と管理
ンソールの使用
ここでは、レプリケーションタスクの設計方法について説明します。タスクを設計するには、まず、少なくとも 1つのソースエンドポイント
と1つのターゲットエンドポイントをQlik Replicateと連携するように構成しておく必要があります。
※ タスク構成 (レプリケートされるテーブルの数など)、ソーステーブルのサイズ、Replicateサーバーマシンのハードウェア構成などの
複数の要素が1つのReplicateサーバーで実行できるタスクの量に影響します。
※ このことを念頭に置いて、1つのレプリケートサーバーで同時に実行するタスクの数は100を超えないようにしてください。 (前
述の要素などに応じて、可能な同時実行数が少なくなる場合があります)。
※ ベストプラクティスは、本番環境に移行する前にテスト環境でロードテストを実行することです。

3
タスクの概要
• ソースエンドポイントとターゲットエンドポイント
• 同期して保持するソーステーブルとターゲットテーブル
• 関連するソーステーブルの列
• (オプション）1 つ以上のソース列の値に対するとのフィルター条件
(SQLite構文で記述)
• (オプション）ターゲット表の列。それらはデータ型と値(SQL構文の式また
は関数が利用可能)を含みます。指定しない場合、Replicateはソース
テーブルと同じ列名と値を使用し、ソース DBMS データ型をターゲット
DBMSデータ型にデフォルトでマッピングします。
タスクが定義されると、すぐにアクティブ化できます。レプリケートは、必要なメタ
データ定義を含むターゲットテーブルを自動的に作成してロードし、CDC をア
クティブにします。Qlik レプリケートコンソールを使用すると、レプリケーションプロ
セスを監視、停止、または再開できます。
タスクは、ブラウザを通じてQlik Replicateコンソールを使用して定義します。タスクを定義する際には、以下を指定します。

4
複数タスクの利用
複数のレプリケーションタスクを一度に定義してアクティブ化できます。これは、以下のようなケースのタスクの場合に最適です：
• 異なるソーステーブルを持つ
• いくつかのソーステーブルを共有するが、ソース行で異なるフィルター条件を持つ
• 異なるターゲット表を更新する
※ 同じターゲット表および行を2つの異なるレプリケーション・タスクで更新すると予測不能な結果を招く可能性があります。
異なるタスクは独立して動作し、同時に実行できます。それぞれに独自の初期ロード、CDC、およびログリーダープロセスがあります。

6
タスクの追加
タスクを追加するには:
1.[Tasks] ビューで、[New Task] をクリックします。
2. タスクの名前を入力します。この名前は、タスクの目的を示すわ
かりやすい名前にする必要があります。名前は32 文字以下で
、英数字以外の文字や|¥ / : * ?“ < >の文字は含めること
ができません。
3. 必要に応じて、タスクの説明を[Description]に入力します。
タスクに必要な機能の設計を開始する前に、まずタスクの既定の動作を定義する必要があります。

7
タスクの追加
4. 次のいずれかのレプリケーションプロファイルを選択します。
• Unidirectional (単方向) - 単方向の目的でエンドポイント間でレプリケートすることを選択します。
• Bidirectional (双方向) - 2 つのエンドポイント間でレコードを同期するように選択します。
• Log Stream Staging (ログストリームステージング)- ログストリームステージングを使用すると、専用のレプリケートタスクで
、単一のソースデータベースのトランザクションログからデータの変更を保存し、ターゲットごとにログを読み取るオーバーヘッドを発生さ
せずに複数のターゲットに適用できます。
• Qlik Cloud Landing(Qlikクラウドランディング)- このプロファイルは、Qlikのハイブリッドデータ配信サービスのデータをランドす
るタスクに使用します。ハイブリッドデータ配信サービスは、Qlik Cloud Data Serviceの一部です。

8
タスクの追加
5. タスクオプションを選択します:
• Full Load: Full Loadが有効な場合、Qlik Replicateは、初期ソースデータをターゲットエンドポイントに読み込みます。
• Apply Changes: このオプションが有効になっている場合、Qlik レプリケートによって変更が処理
(INSERT/UPDATE/DELETE/DDL)されます。
※ Bidirectionalが選択されている場合、変更のApply Changesオプションを無効にすることはできません。
• Store Change: このオプションが有効な場合、変更が変更テーブル(Change Table)または監査テーブル(Audit Table)に格
納されます。
6. [OK] をクリックして [New Task] ダイアログボックスを閉じ、設定を保存します。

9
タスク説明の編集と表示
特定のタスクの説明を入力し、必要に応じてその説明を簡単に表示または編集できます。
タスクの説明を表示または編集するには、
1. 目的のタスクを開きます。
2. [Description]ツールバー・ボタンをクリックします。
3. 説明を入力します。
4. [OK] をクリックします。

10
エンドポイントの定義と管理

11
エンドポイントの定義
タスクの設計を開始する前に、レプリケートサーバーにエンドポイントを追加する必要があります。レプリケートサーバーにエンドポイントを追加
する場合は、接続情報と適切なユーザー資格情報を指定する必要があります。
エンドポイントを追加するには:
1. [Tasks]ビューで、[Manage Endpoint
Connections] をクリックします。
2. [New Endpoint] をクリックします。
3. 使用しているエンドポイントの種類を選択します。入
力する必要がある情報は、選択するエンドポイントに
よって異なります。
※ エンドポイントの名前は32 文字以下で、英数字以外の文字や|¥ / : * ?“ < >の文字は含めることができません。
※ サポートされるデータベースの一覧については、「サポートされるプラットフォームとエンドポイント」を参照してください。

12
タスクへのソースエンドポイントとターゲットエンドポイントの追加
エンドポイントを追加したら、タスクを設計できます。このプロセスの最初の手順では、データが現在格納されているソースエンドポイントと、データをレ
プリケートするターゲットエンドポイントを定義します。これを行うには、エンドポイントのいずれかをタスクマップにドラッグします(Designerモード)。
ソース・ターゲットエンドポイントをタスクに追加するには：
1. 新しいタスクを作成します。左側のペインに使用可能なエンドポイント
が表示された状態で、タスクマップが表示されます。
2. ソースエンドポイントを、タスクマップの上部の円にドラッグします。
3. ターゲットエンドポイントを、タスクマップの下のにドラッグします。
4. [Save]をクリックします。
※ 円にエンドポイントをドラッグできない場合は、使用しているエンドポイントがソースもしくはターゲットエンドポイントとして定義されていることを確認してください。

13
テーブルまたはビューの選択

14
レプリケーションのテーブルまたはビューの選択
レプリケートするソーステーブルまたはビューを選択する方法について説明します。
• テーブル：サポートされている全てのエンドポイントで選択できます
• ビュー：次のエンドポイントでのみ選択できます。太字を除き、Full Loadのみタスクでのみサポートされます。また、ビューはテーブルとして
ターゲットエンドポイントにレプリケートされます。
• Teradata
• Amazon Redshift
• PostgreSQL
• MySQL
• SAP Sybase ASE
• IBM DB2 for LUW
• IBM DB2 for z/OS
• Oracle
• Microsoft SQL Server
• ODBC with CDC
• ODBC
※ビューをレプリケートする場合、対応するテーブルは主キーなしで作成されます。これは、ターゲットテーブルに主キーを持たさせる必要がある変更の適用タスクに関する問題を提示します。した
がって、(上記の CDC 対応エンドポイントのいずれかを使用して) 変更の適用タスクも実行している場合は、変換を使用してターゲットテーブルごとに 1 つ以上の主キーを定義する必要が
あります。
※CDC および Teradata ソースエンドポイントで ODBC を操作する場合、レプリケートするビューとテーブルは同じコンテキストフィールドを持つ必要があります。ビューだけをレプリケートする
場合は、すべてのビューに同じコンテキストフィールドが必要です。

15
テーブル/ビューを選択するには:
1. タスクを開き、Designerモードで、右側の [Table Selection] をクリックします。
 テーブル/ビューを選択したら、タスクを実行できます。ただし、必要に応じてターゲットエンドポイントのフィルタリングテーブル構
造の変換を行うこともできます。

16
[Table Selection]によって開くウインドウは、データソースがビューをサポートしているかによって異なります。
テーブル・ビューがサポートされている場合
テーブルのみの場合
検索の対象が選択可能

17
レプリケーションのテーブルまたはビューの検索
レプリケーションタスクに含める準備として、特定のテーブル/ビューを検索する方法について説明します。最初に、特定の条件に一致するテーブルを検索しま
す。次に、必要なテーブル/ビューを検索結果から選択し、タスクに含めます。
テーブル/ビューを検索するには、次の手順を実行します。
1. Designerモードで、[Table Selection] をクリックします。
2. ソースエンドポイントがビュー選択をサポートしている場合は、検索対象をAll、
Tables、Viewsから選択することができます。
3. [Schemas] ドロップダウンリストから、テーブル/ビュースキーマを選択します。
4. 必要に応じて、 [Table] フィールドに、をレプリケートするテーブル/ビューの名前ま
たは名前の一部を入力します。これを行わない場合、選択したスキーマ内のすべて
のテーブル/ビューが検索されます。
5. [Search] をクリックして、テーブル/ビューの一覧を表示します。[Results]フィー
ルドには、指定した検索条件に一致するテーブル/ビューが表示されます。
6. レプリケートの対象とするテーブルを選択して、右側の[Selected Tables]に追
加します。
7. [OK] をクリックします。

18
テーブル/ビュー選択パターンの作成
以下のようなワイルドカード文字を利用してパターンを作成し、条件に合致するテーブル/ビューのみを選択することができます。
% : ワイルドカード文字（複数文字）
_ : ワイルドカード文字（一文字)
ワイルドカード文字は、標準文字として解釈されないようにエスケープする必要があります。エスケープ文字の規則はデータベースによって異なっているため、サ
ポートされているエスケープ文字に関するガイダンスについては、データベースのヘルプを参照してください。例 (_がワイルドカード文字) は次のとおりです。
• MySQL and PostgreSQL - _
• Microsoft SQL Server - [_]
• Oracle - Oracle の場合は、エスケープ文字内部パラメータを使用してカスタムエスケープ文字を定義します。
例) NorthwindスキーマのメンバーであるNorthwind. customer% テーブルを除くすべてのテーブルをレプリケートするパターンを次の例に示します。
Include Northwind.%
Exclude Northwind.customer%

19
テーブル/ビュー選択パターンを作成するには:
1. Designerビューの [Select Tables] ダイアログボックスで、次のいずれかの操作を行います。
• [Schema] ドロップダウンリストからスキーマを選択します。
• [Table] フィールドに、テーブル/ビューの名前または名前の一部を入力します。
2.選択のアクションを以下のいずれかから選択します。
1.[Include]をクリックすると、選択基準に一致するすべてのテーブル/ビューが含まれます。
2.[Exclude]をクリックすると、選択基準に一致するテーブル/ビューが除外されます。
3.[OK] をクリックして[Select Tables]ダイアログボックスを閉じます。

20
テーブル/ビュー選択パターンの対象テーブルを確認するには:
• テーブル選択パターンを使用するときに含まれるすべてのテーブル/ビューを表示するには、Designerビューの [Full Table List] タブをクリックします。
• [Full Table List]には、定義したテーブルパターンに含まれるすべてのテーブル/ビューと、明示的に選択したすべてのテーブル/ビューが一覧表示されます。

21
読み込み順序の設定
選択した各テーブルの読み込み順序を設定できます。たとえば、選択したテーブルリストに異なるサイズのテーブルが含まれ、大きなテーブルの前に小さいテー
ブルをロードする場合に便利です。テーブルのグループが同じロード順序で設定されている場合、レプリケートはテーブル ID に従ってテーブルをロードします。
ロード順序は、以下の場所で設定および変更できます：
• [Table Selection]のウインドウ上
• コンソールの右側にある[Patterns and Selected Tables]およ
び[Full Table List]の一覧
読み込み順序を設定するには、次の手順を実行します：
1. 一覧からテーブルを選択します。
2. [Load Order] ドロップダウンリストから、使用可能な優先度レベ
ル(Lowest Priority, Low Priority, Normal Priority, High
Priority, Highest Priority) のいずれかを選択します。
※ 初期ロード実行後にテーブルを追加する場合などを除いて、アルファベット順にロードされます。
※ テーブルに数値が含まれる場合、Table1>Table2>Table21>Table3 という順になります。
※ タスクの実行中は、読み込み順序を変更できません。ロード順序を変更する場合は、まずタスク
を停止し、必要に応じてロード順序を変更し、最後にターゲットをリロードします。
※ [Exclude]パターンに対して読み込み順序を設定することはできません。

23
タスクの移行
• レプリケーションタスクをファイルにエクスポートできます。
• タスクのインポートとエクスポートは、コマンド・ラインまたはQlik Replicateコンソールを使用して行うことができます。
 コマンドラインを使用してタスクをエクスポートすると、エクスポートされたすべてのタスクは、 <product_dir>/Qlik/Replicate/Data
の下のimports フォルダーに保存されます。
 Qlik レプリケートコンソールを使用してタスクをエクスポートする場合、次のいずれかが発生します (ブラウザーの設定に従います)。
 タスク JSON ファイルは自動的にデフォルトのダウンロード場所にダウンロードされます
 ダウンロード場所の入力を求められます
• エクスポートファイル (*.json) をQlik レプリケートサーバーの別のインスタンスにインポートできます。これにより、Qlik Replicateで作成し
たタスクを別の環境で使用できます。たとえば、開発環境でタスクを作成し、そのタスクを運用環境で使用する場合などです。

24
タスクのエクスポート
Qlik Replicateコンソールを使用してタスクをエクスポートす
るには、次の手順を実行します。
1.次のいずれかの操作を行います。
• [Tasks]タブで、エクスポートするタスクを選択し、
[Export Task] ツールバーボタンをクリックするか、タ
スクを右クリックして [Export Task] を選択します。
• タスクを開いた状態で、 [Export Task]ツールバーボ
タンをクリックします。
2.ブラウザの設定に応じて、次のいずれかが発生します。
• タスク JSON ファイルは自動的にデフォルトのダウンロー
ド場所にダウンロードされます
• ダウンロード場所を指定するように求められます。この場
合は、JSON ファイルを希望の場所に保存します。
Qlik Replicateコンソールまたはコマンドラインを使用してタスクをエクスポートする方法について説明します。

25
タスクのエクスポート
コマンドラインを使用してタスクをエクスポートするには：
1. インポートするタスクを定義したQlik Replicateコンピュータから、次の操作を実行してQlik Replicateコマンドラインコンソールを開きます。
Windows の場合: 以下のいずれかを行います。
• [スタート]メニューの [すべてのプログラム] に移動し、[Qlik Replicate] をポイントして[Utilities ]をポイントし、[Qlik
Replicate Command Line] を選択します。
• Windows コマンドラインコンソールを開き、ディレクトリを次のように変更することもできます。
<Qlik レプリケートインストールディレクトリ>bin (デフォルト: C:Program FilesAttunityReplicatebin)
Linux の場合: <Qlik レプリケートインストールパス>binで以下のコマンドを実行します。
source ./arep_login.sh
2. コマンドラインコンソールのプロンプトで、次のように入力します。
repctl -d data-directory exportrepository task=task_name[folder_name=path]
3. 既定では、エクスポートされたタスク設定を含むtask_name>.json <名前のファイルが<product_dir>dataimportsフォルダーに作成
されます。ファイルを別のフォルダーに作成する場合は、コマンドにfolder_name=pathパラメーターを含めます。
※ <product_dir>dataフォルダがインストール中に既定以外の場所にインストールされた場合は、後で既定以外の場所に移動した場合は、
フォルダの場所をレプリケートする必要があります。
• これは、コマンドに-d <data_folder>パラメーターを含めることによって行われます。
例：repctl -d D:Data exportrepository task=mytask

26
タスクのインポート
Qlik Replicateコンソールまたはコマンドラインを使用してタスクをインポートする方法について説明します。
Qlik Replicateコンソールを使用してタスクをインポートする
には、次の手順を実行します。
1. [Tasks]タブで、[Import Task] ツールバーボタンをクリッ
クします。
2. インポートするタスク JSON ファイルを参照し、[Import
Task] をクリックします。タスクがインポートされます。
※ タスクをインポートする前に、移行先サーバー上のインポート対象のタスクが既に存在している場合には実行中か停止していることを確認してください。

27
タスクのインポート
タスクをインポートする Qlik Replicate コンピュータから、Qlik Replicateコマンドラインコンソールを開いて以下のコマンドを実行します。
• タスクのエクスポートと同様の手順でQlik Replicateコマンドラインコンソールを開きます。
• タスクをインポートするには、以下のコマンドを実行します。
importrepository [-d data-directory] json_file=<エクスポートした*.jsonファイルへのフルパス>。
例を示します。
importrepository -d D:MyData json_file=C:Temptables.json
※ インストール時に<product_dir>dataフォルダがデフォルト以外の場所にインストールされていた場合や、後にデフォルト以外の場
所に移動された場合は、Replicateにそのフォルダの場所を伝える必要があります。そのためには、コマンドに -d data_folder パラ
メータを含める必要があります。
例) repctl -d D:MyData importrepository json_file=C:mytask.json
※ コマンドでタスクを別の環境にインポートする場合は、ファイルを2台目のQlik Replicateコンピュータの場所にコピーして、そこからイン
ポートする必要があります。

28
エクスポートされた (json) ファイルの編集
• *.json ファイルは、任意のプレーンテキストエディタで開くことができ、ファイル内のセクションを変更することができます。
• ただし、データは変更するだけで、フィールド名は変更しないようにしてください。
 たとえば、エントリ“name”::DB_Name“について、この場合、 DB_Nameのデータを変更することはできます ”が、メタ
データ (“name”)は変更できません。
• ファイルのインポート後に、Qlik Replicateコンソールを使用してエンドポイント、テーブル、タスク、タスク設定、およびロガー設定
に関する情報を変更する必要があります。

29
タスクのコピー・名前変更を行う場合
タスクのコピーや名前変更を行う場合、エクスポートしたjsonファイルのタスク名を変更してインポートします。

Qlik Replicateでのタスクの定義と管理

More Related Content

What's hot

Similar to Qlik Replicateでのタスクの定義と管理

More from QlikPresalesJapan

Qlik Replicateでのタスクの定義と管理