Search

機能

Version 26.1.9516

機能

CData Sync は、あらゆるデータソースをあらゆるデータベースやデータウェアハウスなどにレプリケートするパワフルな機能を提供します。このドキュメントでは、次の機能について簡単に説明します。

  • 差分レプリケーション

  • 同期間隔（データの整合性）

  • 削除キャプチャ（データとレコード）

  • データ型

  • データ変換

  • API 接続

  • ファイアウォールトラバーサル

  • スキーマの変更

初期レプリケーション

初めてジョブを実行すると、CData Sync はデータソースの履歴データ全体を処理します。このデータには膨大な量の情報が含まれています。そのため、Sync は、いくつかの戦略を用いて、効率、パフォーマンス、整合性を最大化します。またSync には、特定のデータセットに対して同期戦略を最適化するために使用できるユーザー制御のオプションも用意されています。

次のオプションを使用して、Sync が初期レプリケーションを処理する方法を制御できます。（これらのオプションは、ジョブを開いたときに表示されるジョブ設定カテゴリの高度な設定タブで利用できます。）

  • レプリケート開始値：Sync はデータソースの最小日付または自動インクリメントカラムの最小整数値（つまり、データソースの利用可能な最も古いレコード）から、データのレプリケーションを開始します。API によっては、エンティティの最小日付やint 値をリクエストする方法を提供していないものがあります。最小値を利用できない場合は、次の手順に従って手動で設定できます。

    1. ジョブ設定でテーブルタブをクリックします。次に、タブに表示されたテーブルをクリックして、［タスク設定］モーダルを開きます。

    2. モーダル内の高度な設定タブをクリックします。

    3. レプリケート開始値オプションを見つけます。yyyy-mm-dd またはyyyy-mm-dd hh:mm:ss のいずれかの形式で日付を追加し、手動で最小開始日 / int 値を設定します。

    開始日を指定しない場合、Sync はデータソースに対してクエリを実行し、1回のリクエストですべてのレコードを取得します。しかしながら、データソーステーブルが非常に大きい場合、この処理によって問題が発生する可能性があります。エラーが発生すると、Sync がクエリをデータの先頭から再実行するためです。

  • レプリケート間隔：Sync が最小開始日を決定した後、アプリケーションはデータの終わりに達するまで、指定した間隔で残りのデータを移動します。以下のオプションを使用して間隔を定義します。ジョブ設定ページの高度な設定タブでも利用可能です。

    • レプリケート間隔：このオプションをレプリケート間隔の単位と組み合わせて使用すると、データ取得中にデータを分割する時間間隔を設定できます。Sync は、この間隔を使用して更新をバッチ処理し、障害が発生したりレプリケーションが中断された場合に、前回の実行が終了したところから実行を開始できるようにします。デフォルトでは、Sync は180日間隔を使用します。しかし、データ量やどの程度データ間に時間的な間隔を置きたいかによって間隔を調整できます。

    • レプリケート間隔の単位：レプリケート間隔と組み合わせてこのオプションを使用すると、データ取得中にデータを分割する時間間隔を設定できます。使用できる値は、minutes、hours、days、weeks、months、years です。

差分レプリケーション

初期レプリケーション後、CData Sync は差分レプリケーションでデータを移動します。Sync は、毎回すべてのデータをクエリする代わりに、最後のジョブ実行時から追加、変更されたデータだけをクエリします。そして、Sync はそのデータをデータウェアハウスにマージします。この機能により作業負荷が大幅に軽減し、特に大きなデータセットを扱う場合に帯域幅の使用と同期の遅延が最小限に抑えられます。

多くのクラウドシステムはAPI を使用しており、それらのAPI からデータウェアハウスに完全なデータをプルすることは、多くの場合処理に時間がかかります。また、多くのAPI では1日単位でクオータが設定されており、毎日すべてのデータを取得したくてもできず、毎時や毎15分は不可能です。Sync はデータを差分ごとに移動させることで、遅いAPI や毎日のクオータに対処する際、非常に高い柔軟性を発揮します。

Sync は、主に2つの手法（差分チェックカラムと変更データキャプチャ）を使用して差分レプリケーションを取得します。これらの手法について、次のセクションで説明します。

差分チェックカラム

差分チェックカラムは、データを同期する際に新規または変更されたレコードを識別するためにSync が使用する、datetime またはinteger ベースのカラムです。データソースにレコードが追加または更新されるたびに、このカラムの値が増加します。Sync は抽出時にこのカラムを基準として使用し、新規または変更されたレコードのみが返されるようにします。その後、Sync はカラムの新しい最大値を保存し、次のレプリケーションで使用できるようにします。

差分チェックカラムを使用して行われるレプリケーションは、2種類の異なるデータ型を使用して実行できます。

  • DateTime 差分チェックカラム—レコードが最後に更新された日時を表すLast Modified またはDate Updated カラム。

  • 整数ベースの差分チェックカラム—レコードが追加または更新されるたびに増分する自動インクリメントId または行のバージョンタイプ。

変更データキャプチャ

一部のデータソースでは変更データキャプチャ（CDC）をサポートしており、データソースはログファイルを使用して、データベースに変更を加えるイベント（挿入、更新、または削除）をログに記録します。Sync は、データソーステーブルに変更をクエリするのではなくログファイルを読み込んで変更イベントを確認します。次に、アプリケーションはレプリケーションのためのそれらの変更を抽出し、次回のレプリケーション用に現在のログを保存します。

CDC 機能をサポートするソースの一覧については、変更データキャプチャを参照してください。

時間ベースの差分フィルタリング関数

CData Sync は時間ベースの差分レプリケーション用に以下の2つの特別な関数をサポートしています：

  • REPLICATE_LASTMODTIME()—ステータステーブルに保存された最後の値を返します。値が存在しない場合は、Sync はレプリケーション開始日（ReplicateStartDate）をデフォルト値として使用します。

  • REPLICATE_NEXTINTERVAL()—ReplicateInterval およびReplicateIntervalUnit パラメータに基づいて、次の値を返します。これらのパラメータが設定されていない場合は、Sync はエラーを生成します。

これらの関数は、データソース（例：Workday RaaS）が複数の日付プロンプトでフィルタリングを必要とする場合に便利です。以下に例を示します：

WHERE from_date_prompt = REPLICATE_LASTMODTIME()
  AND to_date_prompt = REPLICATE_NEXTINTERVAL()

これらの関数は、複数のカラムにわたって使用できます。REPLICATE_LASTMODTIME() 関数は単独で使用できますが、REPLICATE_NEXTINTERVAL() 関数は、間隔オプションとREPLICATE_LASTMODTIME() の両方が同じクエリ内に必要です。

レプリケーションの実行後、Sync はフィルタカラムを次のように処理します：

  • すべてのフィルタカラムが関数を使用している場合、Sync はREPLICATE_NEXTINTERVAL() の値を保存します。

  • すべてのフィルタカラムが通常のカラムの場合、Sync は返される最大値を保存します。

  • フィルタカラムが混在している場合、Sync はREPLICATE_NEXTINTERVAL() の値を保存します。

これらの関数は、標準の差分レプリケーション戦略と統合されており、すべてのデータソースでサポートされています。

並列処理

CData Sync ジョブが並列処理を使用するように設定できます。これは、アプリケーションが1つのジョブを処理するために複数のワーカースレッドを使用することを意味します。並列処理により、Sync はワークロードを複数のプロセスに分割し、複数のテーブルを同時に移動できるようにします。その結果、より少ない時間でより多くのデータが移動され、ジョブ効率が大幅に向上します。Sync では、ジョブ単位で必要な数のワーカーを割り当てることができます。

並列処理を有効化するには：

  1. 実行するジョブをクリックします（Sync のジョブページから）。このアクションによりジョブ/任意のジョブ名ページが開きます。

  2. 概要タブの設定カテゴリで、設定を編集アイコン（）をクリックします。これにより、設定を編集ダイアログボックスが開きます。

  3. 並列処理プロパティで有効化を選択します。

  4. ジョブに割り当てるワーカー数をワーカープールフィールドに入力します。この値は、一度に並列に実行できるタスクの数を制御します。

  5. 変更を保存（ジョブ設定ヘッダーバー右上）をクリックします。

これらの変更を保存すると、ジョブの実行時に並列処理が使用されます。

メタデータキャッシュ

CData Sync におけるメタデータキャッシュは、データソーステーブルと同期先テーブルの構造情報を保存し、システムがそれらをジョブ間で再利用できるようにするメカニズムです。メタデータキャッシュは、Sync がデータソースや同期先に対して継続的にクエリしてテーブル構造を取得する必要をなくすことにより、パフォーマンスを向上させます。メタデータをメモリやローカルストレージですぐに利用できるようにしておくことで、キャッシュ機能は、特にストレージが低速であったり、ネットワーク応答時間が遅い外部データソースや同期先への繰り返しクエリを減らし、パフォーマンスを向上させます。この機能により、ファイルアクセスの高速化、データ取得の迅速化、システム全体の応答性の向上が実現されます。

Sync アプリケーションでは、コネクタ単位でメタデータキャッシュを有効化します。メタデータキャッシュをサポートするデータソースまたは同期先コネクタを設定する際はいつでも、下図に示すようにコネクタの新規接続ページの設定タブの下部でそのプロパティを設定できます：

リフレッシュ間隔リストから以下のオプションを選択できます：

  • なし：メタデータはリフレッシュされません。

  • ジョブの開始時：ジョブの開始時にメタデータがリフレッシュされます。

  • 毎時（デフォルト）：1時間経過後にメタデータがリフレッシュされます。

  • 毎日：1日経過後にメタデータがリフレッシュされます。

コネクタがメタデータキャッシュをサポートしていない場合、メタデータキャッシュセクションにその旨を示すメモが表示されます。

Note：キャッシュされたメタデータは、すべてのスキーマ変更をリアルタイムで自動検出するわけではないため、データソースまたは同期先テーブルの構造が変更された際は、Sync ジョブでキャッシュをリフレッシュする必要があります。例えば、カラムの追加、削除、またはデータ型の変更が行われた場合は、リフレッシュボタン（）をクリックしてキャッシュを更新し、Sync がスキーマの最新の状態を把握できるようにしてください。この方法により、レプリケーションエラーを防ぎ、変換、マッピング、検証が正確に適用されることを確実にします。

ジョブの自動再試行

CData Sync は、タスクエラーやネットワークの問題などで、1つ以上のタスクが失敗した場合にジョブの再試行を試みるジョブの自動再試行機能を提供します。ジョブの自動再試行処理は、ジョブ内の失敗したタスクにのみ適用されます。例えば、1つのタスクが失敗した場合、プロセスはその1つのタスクのみを再試行します。

このプロセスはすべての失敗したジョブ（キャンセルされたジョブを除く）に対して機能しますが、再試行が行われるのはそのようなジョブに対して一度のみです。

ジョブの自動再試行機能を有効にするには：

  1. ジョブページでジョブの名前をクリック（または… > 編集を選択）して、YourJobName の設定ページを開きます。

  2. 概要タブの設定カテゴリで、設定を編集アイコン（）をクリックします。これにより、設定を編集ダイアログボックスが開きます。

  3. ジョブの自動再試行設定の有効化チェックボックスを選択します。次に、保存をクリックして設定の更新を保存します。

失敗したジョブに対してジョブの自動再試行処理が実行されたら、ジョブの詳細（… > 実行の詳細 > タスク）で再試行に関する情報を確認することができます。

  • 再試行に成功すると、再試行に成功しましたというメッセージが、失敗していたタスクの最後の実行カラムに表示されます。

  • 再試行に失敗すると、再試行に失敗しましたというメッセージが、失敗したタスクの横の最後の実行カラムに表示されます。さらに、失敗した各タスクには詳細を表示リンクが表示されます。詳細を表示の左側にある下矢印をクリックすると、以下の例に示すように、失敗の詳細を含むエラーメッセージが表示されます：

同期間隔（データの整合性）

データ統合戦略の一環として、元となるデータソースと同期先の間で、データの整合性を確保することが重要です。データパイプラインでエラーが発生した場合、またはジョブが中断された場合、データパイプラインプロセスを停止したところから再開する必要があります。この動作により、更新間やエラー発生時にデータが失われないことが保証されます。データ読み込みのための複雑なスクリプトやプロセスを設定することなく、CData Sync が自動的にそのアクションを管理します。

Sync は同期間隔に従ってデータを処理します。つまり、データをすべて一度に移動するのではなく、Sync がデータを扱いやすい間隔（またはデータの「チャンク」）に分割して、一度に1間隔ずつ処理します。この機能によって性能が大幅に向上し、エラーの際にもSync のデータの整合性が保たれます。Sync はデータソーステーブルと同期先テーブルを一致させます。エラーが起きた場合には、Sync は現在の間隔のデータをすべて捨ててその時点から処理を再開できます。

例えば、大規模な同期ジョブの完了間近にエラーが起きたとしましょう。Sync は最初からジョブ全体を開始するのではなく、最後に処理が完了した間隔から再開するので、時間とリソースを節約できます。

Note：API によっては、一定期間内にアクセスできる回数を制限するアクセス制限を設けているものがあります。これらの制限により、エラーが発生することがあります。このようなエラーが発生した場合、Sync は不完全な同期レコードを破棄し、次にスケジュールされたジョブでその時点から再開します。間隔の大きさを設定し、各間隔で取得するデータ量を決定し、エラーが発生した場合に移動する必要があるデータ量を制限することができます。

削除キャプチャ

CData Sync は削除されたレコードを自動でキャプチャして、同期先データの精度を保ちます。Sync はAPI 呼び出しや変更の追跡機能を使用して、削除されたレコードのリストをデータソースから取得します。

データソースがSync に対して削除されたデータの検出を許可している場合は、高度なジョブオプションで説明するように、削除の挙動オプションを使用してSync による削除の処理方法を制御できます。

  • Hard Delete（デフォルトパラメータ）：データソースで削除が検出されると、Sync は同期先のテーブルからそのレコードを削除します。

  • Soft Delete：Sync は同期先テーブルに_cdata_deleted カラムを追加します。データソースで削除が検出されると、Sync は同期先の値をtrue に設定します。

  • Skip Delete：Sync はデータソースで削除されたレコードを無視します。

Note： データソース情報に記載されているとおり、API によっては削除されたレコードの検出をSync に許可しません。このようなケースでは、削除の挙動は無視されます。

データ型

CData Sync は多くのデータ型を認識し、データ型が厳密に定義できない場合には、Sync はデータに基づいてデータ型を推論します。Sync は次のデータ型を認識します。

  • Boolean
  • Date
  • Time
  • TimeStamp
  • Decimal
  • Float
  • Double
  • SmallInt
  • Integer
  • Long
  • Binary
  • Varchar
  • GUID

既知のデータ型

多くのデータソースについて — そのほとんどがリレーショナルデータベースで、いくつかはAPI（SQL Server、Oracle など）ですが — Sync は自動的にスキーマ用のデータ型を検出します。データソースのカラムのデータ型が既知の場合、Sync は自動で一致するデータ型を同期先に作成します。

推論されたデータ型

データ型が指定されていない場合、Sync はカラムのデータ型を決定するためにデータの最初の数行を解析して、データ型を推論できます。

Sync が不明なカラムサイズの文字列型を検出した場合、カラムのデフォルトサイズは2000となります。SQL Server のようなリレーショナルデータベースでは、Sync はこの型用にvarchar(2000) フィールドを作成します。

データ型が厳密に定義されていないフィールドの場合、Sync は最初の行を読み取り、各カラムの最小のデータ型を自動的に選択します。その後、アプリケーションは次の行を読み取り、データが選択したデータ型で格納できるかを確認します。データが収まらない場合、Sync はデータ型のサイズを増やします。Sync は、これを行スキャンの深度（RowScanDepth - 50または100行）まで実行します。これが終了すると、Sync はデータ型を持っています。

例えば、CSV のようなデータソースでは、Sync はRowScan を使用してファイルの最初の数行を読み取り、動的に各カラムのデータ型を決定します。

変換

データパイプラインにおいて変換は、レポーティングやデータ分析を容易にするためにデータを加工、整形、集計する方法の1つです。Sync は、データパイプラインを構築する際にデータ変換を管理する2つの一般的な手法をサポートしています。

  • ETL： ETL（extract（抽出）、transform（変換）、load（ロード））処理は数十年にわたってアナリティクスの伝統的な手法となっています。ETL は、歴史的に市場を席巻してきたリレーショナルデータベースでの使用を想定して考案されました。ETL では、レプリケーション処理の前に変換を行う必要があります。データはデータソースから抽出され、ステージングエリアに格納されます。データは整形、修飾、変換されてデータウェアハウスにロードされます。ETL についての詳細は、In-Flight ETL を参照してください。

  • ELT： （extract（抽出）、load（ロード）、transform（変換））処理は、変換などのデータの変更がレプリケーション処理後に行われるデータ抽出の手法です。現代のクラウドデータウェアハウスは膨大なストレージとスケーラビリティを備えているため、データすべてを移動して、その後修正を加えることができます。

    ELT 変換はデータの同期先で実行されるSQL スクリプトです。変換はデータウェアハウスの処理能力を使って、アナリティクスとレポーティング面でのニーズに基づき素早くデータを集計、結合、整形します。データを変換とマッピングで整理することで、パイプラインの移動に合わせてデータを最も役立つ形式で取得できます。ジョブ同様、変換はセミコロン（;）で区切られた複数のクエリをサポートし、スケジュールに従って実行し、変換の完了後にE メールアラートが送信されます。ELT についての詳細は、Post-Job ELT を参照してください。

ETL とELT の主な違いは、手順を実行する順序です。

個人情報のマスキング

個人情報（PII）のマスキングは、データベースやデータテーブル内の機密情報のプライバシーとセキュリティを強化するデータ保護技術です。PII には、名前、住所、社会保障番号、その他個人を特定できるデータが含まれます。

マスキングは、PII を含む特定のカラム内の実際のデータを非表示にすることで、そのカラムへのアクセスを制限します。Sync においては、マスキングはポイントアンドクリックの変換オプションです。Sync でデータをマスクすると、データの各文字はアスタリスク（*）に置き換えられます。マスキングは一方向の操作です。つまり、一度マスキングを適用すると、データを以前の状態に戻すことはできません。マスキングは、EU 一般データ保護規則（GDPR）、US 医療保険の相互運用性と説明責任に関する法律（HIPAA）など、個人情報や機密情報の安全な取り扱いを義務付けるデータ保護規制を遵守するために重要です。

マスキングおよびその他の変換オプションの詳細については、SQL Transformation の適用を参照してください。

ヒストリーモード

CData Sync のヒストリーモードは、データソース内の履歴データを分析するための方法を提供します。ヒストリーモードは、データウェアハウスの比較的静的なデータ（現在および履歴）を保存および管理するslowly changing dimensionです。そのデータは、時間の経過とともにゆっくりと（しかし予測不可能に）変化することがあります。

CData では、ヒストリーモード（ヒストリーモードプロパティ）を使用してデータ行（レコード）の変更履歴を追跡し、データが時間の経過とともにどのように変化するかを確認できます。ヒストリーモードは、データソース接続が差分レプリケーションをサポートしている場合、すべてのCDC と標準ジョブで利用可能です。

CData は、履歴データを分析するための複合アプローチをサポートしています。つまり、ヒストリーモードプロパティは、監査のための堅牢な追跡と時系列分析の両方を提供します。

ヒストリーモードはテーブル単位で機能します。そのため、どのテーブルを分析するかを決定し、それらのテーブルに対してのみオプションを有効にできます。

標準（個別設定）モードでは、Sync は既存の行をマージして更新しますが、ヒストリーモードでは、Sync は更新された行をデータベースのテーブルに追加します。

ヒストリーモードの種類

CData Sync offers history mode as well as two options (History Mode - Append Only and History Mode - Include Before Update) that you can use with the mode.どちらのオプションも履歴データを保持しますが、以前のバージョンのレコードをどのように扱うかが異なります。The following list explains how history mode and the two options handle record versions:

  • ヒストリーモード：このモードは、変更されたレコードの新しいバージョンを追加し、以前のバージョンのメタデータを更新して非アクティブとしてマークします。つまり、Sync はソースデータベーステーブルの各データレコードに対するデータ変更の完全な履歴を保持し、それらの変更バージョンを同期先データベーステーブルの対応するテーブルに記録します。

  • ヒストリーモード – 追記専用：このオプションは、変更されたレコードの新しいバージョンを追加しますが、以前のバージョンやメタデータは更新しません。同期先の古い行は変更されません。ヒストリーモード - 追記専用は、Avro、CSV、Parquet の同期先で自動的に有効になります。他のすべての同期先では、手動で有効にする必要があります。

  • History Mode - Include Before Update: When you enable this option, Sync captures the “before update” image of a row. Then, the application writes an additional record to the destination for each update. This option must be used in conjunction with History Mode - Append Only.

次の表は、ヒストリーモードとそれに関連するオプションの違いをまとめたものです：

機能 ヒストリーモード ヒストリーモード – 追記専用 ヒストリーモード - Include Before Update
変更されたレコードの新しいバージョンを追加 ✓ ✓ ✓
古いバージョンのメタデータを更新 ✓ ✗ ✓
以前のバージョンを変更しない ✗ ✓ ✓

ヒストリーモード機能を実現するために、Sync には同期先テーブルにシステムカラムを5つまで追加することができます。標準（個別設定）ジョブは3つのカラムを使用しますが、変更データキャプチャ（CDC）ジョブには5つすべてが含まれます。ヒストリーモード - 追記専用オプションは3つのカラムを使用し、ヒストリーモード - Include Before Update は2つのカラムを使用します。

これらのカラムは次のテーブルで定義されています。

カラム名 カラム型 説明 カラムを使用するモードとオプション
_cdatasync_active Boolean レコードがアクティブかどうかを指定します。 標準（個別設定）モード、ヒストリーモード
_cdatasync_start Datetime データレコードがアクティブになった時点の差分チェックカラムのdatetime 値を指定します。この値は、データ更新ごとに増加するタイムスタンプに基づいて、データソーステーブルでレコードが作成または修正された日時を示します。 標準（個別設定）モード、ヒストリーモード、ヒストリーモード - 追記専用、ヒストリーモード - Include Before Update
_cdatasync_end Datetime データレコードが非アクティブになった時点の差分チェックカラムのdatetime 値を指定します。このカラムのNull 値は、レコードがアクティブであることを示します。 標準（個別設定）モード、ヒストリーモード
_cdatasync_operation Varchar 使用するオペレーションを指定します：Insert (I)、Update (U)、またはDelete (D)。Note：このカラムは、変更データキャプチャ（CDC）を使用する場合にのみ適用されます。 ヒストリーモード、ヒストリーモード - 追記専用、ヒストリーモード - Include Before Update
_cdatasync_version Varchar(100) CSRS テーブルに保存されるフォーマットの変更ごとにバージョンを指定します。Note：このカラムは、CDC を使用する場合にのみ適用されます。 ヒストリーモード - 追記専用

制限事項

ヒストリーモードでは次の制約が適用されます。

  • データソーステーブルは差分チェックカラムをサポートしている必要があります。

  • ソーステーブルに主キーが含まれている必要があります。（ヒストリーモード - 追記専用の場合、主キーは必須ではありません。）

  • 差分チェックカラムがタイムスタンプ（datetime）カラムである必要があります。

  • 疑似カラムはレスポンスに値を持たず条件としてのみ使用されるため、差分チェックカラムを疑似カラムにすることはできません。

  • 同期先テーブルは存在できません。（ヒストリーモードがアクティブな場合、高度な設定タブのテーブルを削除設定を使用してテーブルを再作成します。）

ジョブおよびタスクのヒストリーモードを有効化する

ジョブのヒストリーモードを有効にするには：

  1. ジョブタブをクリックしてジョブページを開きます。

  2. ジョブ名をクリックして概要ページを開きます。次に、高度な設定タブをクリックします。

  3. レプリケートオプションカテゴリで、レプリケートオプションを編集アイコン（）をクリックし、レプリケートオプションを編集ダイアログボックスを開きます。

  4. Scroll to the History Mode option.To enable the History Mode option, select Enable.有効にすると、Sync はデータソースで発生するすべての変更に対してタイムスタンプ付きのエントリを同期先に追加します。(If you want to disable the option, clear the Enable checkbox.)

  5. 保存をクリックします。

タスクのヒストリーモードを有効にするには：

  1. ジョブのタスクタブをクリックします。

  2. 変更するタスクの名前をクリックします。次に、高度な設定タブをクリックします。

  3. レプリケートオプションカテゴリで、編集アイコン（）をクリックし、レプリケートオプションを編集ダイアログボックスを開きます。

  4. Scroll to the History Mode option. Tasks inherit the History Mode status of the associated job.

    • If the statue of History Mode is set to Enabled (Inherited), no change is required unless you want to override that setting.

    • If the status of History Mode is Not Enabled (Inherited) and you want to enable it for this task, scroll to the top of the dialog box and select Override job settings. Then, return to History Mode and select Enable.

    Note：関連するテーブルが差分チェックカラムをサポートしていない場合、タスク設定でヒストリーモードは無効になります。

  5. 保存をクリックします。

ジョブおよびタスクのヒストリーモード - 追記専用を有効化する

To use the History Mode - Append Only option for either a job or a task, you must first enable History Mode and then enable History Mode – Append Only.

ジョブのヒストリーモード - 追記専用**を有効にするには：

  1. ジョブタブをクリックしてジョブページを開きます。

  2. ジョブ名をクリックして概要ページを開きます。次に、高度な設定タブをクリックします。

  3. レプリケートオプションカテゴリで、レプリケートオプションを編集アイコン（）をクリックし、レプリケートオプションを編集ダイアログボックスを開きます。

  4. Scroll to the History Mode option and ensure that it is already enabled (the option label should say Enabled (Inherited)). If it is not enabled, perform the steps to enable History Mode for a job before moving to step 5.

    Note：関連するテーブルが差分チェックカラムをサポートしていない場合、タスク設定でヒストリーモードは無効になります。

  5. Scroll to the Additional Options text box at the bottom of the Edit Replicate Options dialog box and enter the option HistoryModeAppendOnly=true into the Additional Options text box.

  6. 保存をクリックします。

タスクのヒストリーモード - 追記専用**を有効にするには：

  1. ジョブのタスクタブをクリックします。

  2. 設定するタスクの名前をクリックします。次に、高度な設定タブをクリックします。

  3. レプリケートオプションカテゴリで、編集アイコン（）をクリックし、レプリケートオプションを編集ダイアログボックスを開きます。

  4. Scroll to the History Mode option and ensure that it is already enabled (the option label should say Enabled (Inherited)). If it is not enabled, perform the steps to enable History Mode for Jobs and Tasks before moving to step 5.

    Note：関連するテーブルが差分チェックカラムをサポートしていない場合、タスク設定でヒストリーモードは無効になります。

  5. Scroll to the Additional Options text box at the bottom of the Edit Replicate Options dialog box and enter the option HistoryModeAppendOnly=true into the Additional Options text box.

  6. 保存をクリックします。

ジョブおよびタスクのヒストリーモード - Include Before Update を有効化する

You can capture the “before update” image of a row by using the History Mode - Include Before Update option. When you enable this option, Sync writes an additional record to the destination for each update. History Mode - Include Before Update applies only when both of the following criteria are true:

  • You use the History Mode - Append Only mode (HistoryModeAppendOnly=true)

  • The source uses CDC.

To enable the History Mode - Include Before Update for a job:

  1. ジョブタブをクリックしてジョブページを開きます。

  2. ジョブ名をクリックして概要ページを開きます。次に、高度な設定タブをクリックします。

  3. Ensure that History Mode and History Mode - Append Only are enabled by following the steps in the following sections:

    Note: If you set History Mode - Include Before Update to true (HistoryModeIncludeBeforeUpdate=true) but do not enable History Mode - Append Only, Sync generates an error specifying that HistoryModeIncludeBeforeUpdate= can be used only when the HistoryModeAppendOnly=true is enabled.

  4. On the Advanced tab for your job, click the Edit icon () for the Replicate Options category to open the Edit Replicate Options dialog box.

    In the dialog box, verify that both History Mode and History Mode - Append Only are enabled.

  5. Enter the option HistoryModeIncludeBeforeUpdate=true into the Additional Options text box, as shown below:

  6. 保存をクリックします。

To enable History Mode - Include Before Update for a task:

  1. ジョブのタスクタブをクリックします。

  2. 設定するタスクの名前をクリックします。次に、高度な設定タブをクリックします。

  3. Ensure that History Mode and History Mode - Append Only are enabled by following the steps in the following sections:

  4. On the Advanced tab for your job, click the Edit icon () for the Replicate Options category to open the Edit Replicate Options dialog box.

    In the dialog box, verify that both History Mode and History Mode - Append Only are enabled.

  5. Enter the option HistoryModeIncludeBeforeUpdate=true into the Additional Options text box, as shown below:

  6. 保存をクリックします。

データソーステーブルを変更した場合の影響

行を挿入、更新、削除してデータソーステーブルを変更すると、次の表で説明するように、同期先はさまざまな形で影響を受けます。

データソースの変更 同期先の影響
挿入された行 同期先テーブルに行が追加されます。_cdatasync_active はTrue に設定され、 _cdatasync_start は差分チェックカラムの値に設定されます。
更新された行
  • 同期先テーブルの現在の行が更新されます。_cdatasync_active はFalse に設定され、_cdatasync_end は差分チェックカラムの値に設定されます。
  • 同期先テーブルに新しい行が挿入されます。_cdatasync_active はTrue に設定され、_cdatasync_start は差分チェックカラムの値に設定されます。
削除された行 同期先の現在の行が更新されます。_cdatasync_active はFalse に設定されます。

API 接続

CData Sync にはビルトインのREST（representational state transfer） API が含まれており、アプリケーションの柔軟な管理を実現します。管理コンソールのUI で実現できることはすべて、RESTful API コールで実現できます。

Sync は2つのREST API バージョンを提供します：

API 接続についての詳細は、REST-API も参照してください。

In-Network インストール

CData Sync はどこでも実行できるため、クラウド上にあるシステムと社内ネットワーク上にあるシステムを持つユーザーにとって最適なアプリケーションです。Sync をインストールしてネットワーク内で実行できるため、インターネットや開いたファイアウォール経由でポートが公開されたり、VPN 接続を作成したりすることを回避できます。

また、Sync アプリケーションをどこでも実行できることで、遅延を大幅に削減することができます。データソースや同期先の近くでSync を実行できるため、ETL やELT ジョブのパフォーマンスが向上します。

スキーマの変更

データは常に変化していますが、Sync はそれらの変化を常に正確に表すことを保証します。毎実行時、CData Sync はデータソースのスキーマと同期先のスキーマを比較して差分を検出します。Sync が2つのスキーマ間で構造の違いを検出した場合、アプリケーションは同期先のスキーマを変更し、以下で説明するようにデータソースのデータを格納できるようにします。

  • データソーステーブルに同期先テーブルに存在しないカラムが含まれている場合、Sync はカラムを追加することで同期先テーブルを変更します。

  • データソーステーブルのデータ型のサイズが増える場合、Sync はカラムのサイズを更新することで同期先テーブルを変更します。Sync は、文字列カラムのカラムサイズを増やしたり（例：varchar(255) -> varchar(2000)）、非文字列カラムのバイトサイズを増やす（例：smallint -> integer）、といった変更を行います。

Notes：

  • Sync は、カラムがデータソーステーブルから削除されている場合でも、同期先テーブルからはカラムを削除しません。

  • Sync は、データソースでデータ型のサイズが更新された場合でも（varchar(2000) -> varchar(255)）、同期先カラムのサイズは小さくしません。