> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sync.cdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# はじめてのレプリケーションジョブの設定

サーバーを起動すると、最初のレプリケーションジョブを構成できます。*レプリケーションジョブ*は、データソース接続、同期先接続、タスクのリストで構成されます。次のセクションでは、接続の作成、ジョブの作成、タスクの追加、最初のレプリケーションジョブの設定、ジョブの実行について、順を追って説明します。

## 接続を作成

ログインしたら、使用するデータソースおよび同期先への接続を設定する必要があります。特定のデータソースまたは同期先への接続を確立する方法の詳細は、[接続](https://docs.sync.cdata.com/26.4/ja/connections/connections.md)を参照してください。

接続を作成するには、次の手順に従ってください。

1. ナビゲーションバーの**接続**をクリックして**接続**ページを開きます。

2. **接続を追加**ボタンをクリックします。このアクションにより、**コネクタを選択**ページが開きます。

3. 作成するコネクタの種類に応じて、**データソース**タブもしくは**同期先**タブのいずれかを選択します。

4. 追加したいコネクタに移動して、行の右端にある**コネクタをインストール**アイコン（![コネクタをインストールアイコン](https://mintcdn.com/cdata-sync/88MkaeOw70WElG5o/26.4/images/install-icon.png?fit=max\&auto=format\&n=88MkaeOw70WElG5o\&q=85\&s=5541ce7f5b183df06c39b58dd13c758e)）をクリックします。このアクションにより、**コネクタをインストール**ダイアログボックスが開き、コネクタを自動または手動（ローカルファイルシステムを使用）でインストールできます。

   > [!NOTE]
   >
   > すでにインストールされているコネクタを再構成する必要がある場合は、行末にある**コネクタをアップデート**アイコン（![コネクタをアップデートアイコン](https://mintcdn.com/cdata-sync/88MkaeOw70WElG5o/26.4/images/update-connector-icon.png?fit=max\&auto=format\&n=88MkaeOw70WElG5o\&q=85\&s=a1c772f37f38f90c0c1f2f0e5791aed4)）をクリックします。

5. ダイアログボックスの**コネクタを自動インストール**を選択し、**インストール**をクリックします。

   > [!NOTE]
   >
   > ローカルファイルシステムからコネクタを手動でインストールする必要がある場合（例えば、Sync バンドルにまだ含まれていないコネクタの場合）は、[接続](https://docs.sync.cdata.com/26.4/ja/connections/connections.md)を参照してください。

6. コネクタ行の末尾にある**接続を設定**の矢印（→）をクリックして、**新しい接続**ページを開きます。

7. **新しい接続**ページの**設定**タブで、接続の設定を入力します。
   1. 接続名を入力します。この名前は、ジョブの作成時にこの接続を参照するために使用されます。同じデータソースまたは同期先に複数の接続がある場合、この接続の目的を説明する名前を入力してください。
   2. 認証の詳細および他の接続プロパティを入力します。
   3. **高度な設定**タブで接続の高度な設定を定義します。（ただし、ほとんどの場合これらの設定は必要ありません。）

8. **作成およびテスト**をクリックして、接続の設定が正しいことを確認します。成功した場合、Sync はその旨のメッセージを表示します。テスト接続に失敗した場合は、接続設定が正しかどうかを確認してください。確認後、接続を再テストします。

   接続をテストすると、**作成およびテスト**ボタンは**オプション**メニューと**テスト**ボタンに置き換わります。**オプション**メニューには、以下のオプションが表示されます：

   * **クローン：** 接続をクローンできます。
   * **コネクタをアップデート：** 接続プロパティを更新できます。
   * **移動：** 接続を新しいワークスペースに移動できます。
   * **削除：** 接続を完全に削除します。

9. ページ右上にある**接続**リンクをクリックして（またはブラウザの戻る矢印を使用して）、**接続**ページに戻ります。

## 新しいジョブを追加

必要な[接続を作成](#接続を作成)後、以下の手順に従って最初の[ジョブ](https://docs.sync.cdata.com/26.4/ja/jobs/jobs.md)を追加します。

新しいジョブを追加するには：

1. ナビゲーションバーの**ジョブ**をクリックして、**ジョブ**ページを開きます。

2. **ジョブを追加**（右上隅）をクリックして、メニューから**新しいジョブを追加**を選択します。このアクションにより、ジョブ情報を入力できる**ジョブを追加**ダイアログボックスが開きます。

3. ジョブ名を入力し、データソース接続および同期先接続を選択します。

   > [!NOTE]
   >
   > ジョブ名に不正な文字を含めることはできません。不正な文字を使用した場合、Sync はエラーメッセージを生成します。

   ![ジョブを追加ダイアログボックス](https://mintcdn.com/cdata-sync/4njnJgdQs2eFHAEE/26.4/images/Add-Job.png?fit=max\&auto=format\&n=4njnJgdQs2eFHAEE\&q=85\&s=974b70d8907763420d516180f02ceb05)

4. ジョブの種類を選択します。デフォルト設定は**標準（個別設定）** です。

   * **標準（個別設定）：** この種類を選択すると、Sync は1つ以上のデータソーステーブルをタスクとしてジョブに追加します。各タスクは、デフォルトまたはカスタマイズされた差分チェックカラムのいずれかを使用して、データソース内の新規または更新されたレコードを見つけます。

   * **変更データキャプチャ：** この種類では、各タスクは、データソースのネイティブな変更データキャプチャ（CDC）メカニズムを使用して変更点を取得します。

     > [!NOTE]
     >
     > このテキストボックスは、変更データキャプチャをサポートする次のコネクタでのみ表示されます：Informix (Native), MariaDB, Microsoft Dynamics 365, MySQL, Oracle, PostgreSQL, SQL Server

   * **すべて同期：** このジョブの種類を選択すると、Sync はすべてのデータソーステーブルをタスクとしてジョブに自動的に追加します。

   * **フォルダをロード：** このジョブの種類では、Sync はフォルダやコンテナ内のすべてのファイルを、実行中に単一の同期先テーブルに読み込みます。

     > [!NOTE]
     >
     > このテキストボックスは、**フォルダをロード**処理をサポートする次のコネクタでのみ表示されます：Amazon S3, Azure Blob Storage, Azure Data Lake Storage, Google Cloud Storage, Local File Storage, Microsoft Onelake

5. **ジョブを追加**をクリックして、新しいジョブを作成します。

特定のジョブページから（**ジョブ > *YourJobName***）、ジョブを[スケジュールに従って実行](https://docs.sync.cdata.com/26.4/ja/jobs/scheduling-jobs.md)、[差分レプリケーションを設定](https://docs.sync.cdata.com/26.4/ja/getting-started/configuring-jobs.md#最初のレプリケーションジョブの設定を定義)、および[E メールアラートの作成](https://docs.sync.cdata.com/26.4/ja/jobs/notifications.md)ができます。加えて、[ログとジョブ履歴](https://docs.sync.cdata.com/26.4/ja/jobs/logging-history.md)を表示して、詳細情報を取得したりエラーをトラブルシューティングしたりできます。

## ジョブにタスクを追加

ジョブを追加したら、ジョブに1つ以上のタスクを追加できます。

タスクを追加するには：

1. ジョブを選択して**タスク**タブをクリックします。

2. **タスクを追加**をクリックして、**タスクを追加**ダイアログボックスを開きます。

3. タスクの一覧から、ジョブに追加するタスクを選択します。**検索**フィールドにタスク名を入力して、特定のタスクを見つけることもできます。

   ![タスクを追加ダイアログボックス](https://mintcdn.com/cdata-sync/FaXQgwCWYQjGfVUG/26.4/images/Tasks_adding-a-task_1.png?fit=max\&auto=format\&n=FaXQgwCWYQjGfVUG\&q=85\&s=211bdc60028b3af545cb056d0dfd2e88)

   > [!NOTE]
   >
   > すべてのタスクを含めるには、テーブルの上部にあるジョブ名の横にあるチェックボックスを選択します。

   デフォルトでは、Sync は**タスクを追加**ダイアログボックスにすべてのテーブルとビューを表示します。ただし、タスクリストの上にあるドロップダウンメニューから表示するタイプを選択することで、テーブルのみ、またはビューのみのリストを表示することもできます。

   ![テーブルとビューのフィルタオプションを示すタスクを追加ダイアログボックス](https://mintcdn.com/cdata-sync/FaXQgwCWYQjGfVUG/26.4/images/Tasks_adding-a-task_2.png?fit=max\&auto=format\&n=FaXQgwCWYQjGfVUG\&q=85\&s=87329ad42141ee8f7dc55ef474fc4d84)

   > [!NOTE]
   >
   > **テーブルのみ**または**ビューのみ**を選択して、選択したエンティティのリストが表示されない場合は、次のメッセージが表示されます：

   ![結果が見つかりませんでしたメッセージを示すタスクを追加ダイアログボックス](https://mintcdn.com/cdata-sync/FaXQgwCWYQjGfVUG/26.4/images/Tasks_adding-a-task_3.png?fit=max\&auto=format\&n=FaXQgwCWYQjGfVUG\&q=85\&s=04c01e2d392d41ada612f596e4f2cc78)

4. **タスクを追加**をクリックしてジョブにタスクを追加します。

5. ジョブで実行する個々のタスクの横にあるチェックボックスを選択します（**タスク**タブ）。すべてのタスクを含めるには、テーブルの上部にあるジョブのデータソースおよび同期先の横にあるチェックボックスを選択します。

6. タスクの左側にあるチェックボックスを選択して、必要なタスクを実行します。表示された黒いタスクバーにある**実行**をクリックします。タスク行の最後にある**実行**矢印をクリックして、特定のタスクを実行することもできます。

タスクが正常に実行されると、Sync の**最後の実行**カラムに`成功` というメッセージが表示されます。

**Notes：**

* ジョブの[レプリケーションの種類で**すべて同期**オプション](#新しいジョブを追加)を選択した場合、利用可能なすべてのテーブルとビューが自動でレプリケーションタスクとしてジョブに追加されます。ジョブが実行されるたびに、Sync はまずデータソースの新しいテーブルやビューを検索し、ジョブに追加のレプリケーションタスクを追加して、それらが実行に含まれるようにします。
* 特定のタスクをジョブから除外したい場合は、**タスク**タブからタスクを選択し**除外**をクリックします。この場合、今後のジョブ実行ではこれらのテーブルを無視します。

## 最初のレプリケーションジョブの設定を定義

ジョブを開いたときに表示される**概要**タブで利用可能な特定の設定を使用して、Sync が最初のレプリケーションジョブを処理する方法を制御できます。

これらの設定は、**スナップショット設定**カテゴリの**設定**をクリックすると表示されます。**設定**をクリックすると、**スナップショット設定を編集**ダイアログボックスが開きます。利用可能な設定は、設定するジョブの種類によって異なります：

* **標準（個別設定）**および**すべて同期**ジョブ
* **変更データキャプチャ**ジョブ

### **標準（個別設定）**および**すべて同期**ジョブのスナップショット設定

**標準（個別設定）**および**すべて同期**ジョブの場合、**スナップショット設定を編集**ダイアログボックスには、最初のスナップショットとその後の差分更新の処理方法を定義する以下の設定が含まれます。

これらのジョブタイプの主な設定は**開始値の種類**です。この設定で選択した内容に応じて、Sync はdatetime 値または数値のいずれかに基づく、定義された開始境界からデータのレプリケーションを開始します。この設定で利用可能なオプションは以下のとおりです：

* （デフォルト）**日付ベース：** **開始値の種類**を**日付ベース**に設定すると、**開始日**フィールドから日付を選択できます。ジョブを作成するには日付を指定する必要があります。
* **数値ベース：** **開始値の種類**を**数値ベース**に設定すると、**開始番号**フィールドに数値を指定できます。

開始値の種類として**日付ベース**を選択すると、以下の設定が表示されます：

* **開始日：** この設定は、開始値の種類として**日付ベース**を選択した場合に表示されます。**開始日**設定は、レプリケーションを開始する最小の日付を指定します。ダイアログボックスを終了するには、日付を指定する必要があります。

  ![日付ベースの開始日オプションを示すスナップショット設定を編集ダイアログボックス](https://mintcdn.com/cdata-sync/4njnJgdQs2eFHAEE/26.4/images/Configuring-Your-First-Replication-Job_defining-settings-for-initial-replication_1.png?fit=max\&auto=format\&n=4njnJgdQs2eFHAEE\&q=85\&s=7d3673f5bda6bc39df060a0857ff8d72)

* **スナップショット間隔：** この設定は間隔単位の選択（このフィールドの右端にあるドロップダウンリストから選択可能）と組み合わされ、Sync が新規または更新されたデータを確認する頻度を定義します。Sync はこの間隔を使用して更新をバッチ処理するため、障害が発生したりレプリケーションジョブが中断されたりした場合、次の試行は前回の実行が終了した位置から開始されます。

  デフォルトでは、Sync は180日の間隔を使用します。ただし、保有しているデータ量やデータの変更頻度に応じて、この間隔を調整できます。数値を手動で入力するか、フィールドの上（▲）および下（▼）矢印を使用できます。

ダイアログボックスで**保存**をクリックすると、設定したジョブの**概要**タブの**スナップショット設定**カテゴリに設定内容が表示されます：

![日付ベースの設定を示す概要タブのスナップショット設定](https://mintcdn.com/cdata-sync/4njnJgdQs2eFHAEE/26.4/images/Configuring-Your-First-Replication-Job_defining-settings-for-initial-replication_2.png?fit=max\&auto=format\&n=4njnJgdQs2eFHAEE\&q=85\&s=d0cc7fd234b5b91836d3c8063fe9e42f)

開始値の種類として**数値ベース**を選択すると、以下の設定が表示されます：

* **開始番号：** この設定は、Sync が差分変更を追跡するために使用する数値カラムの最小値を指定します。Sync は、このカラムの値が指定した数値以上であるレコードのレプリケーションを開始します。

  ![数値ベースの開始番号オプションを示すスナップショット設定を編集ダイアログボックス](https://mintcdn.com/cdata-sync/4njnJgdQs2eFHAEE/26.4/images/Configuring-Your-First-Replication-Job_defining-settings-for-initial-replication_3.png?fit=max\&auto=format\&n=4njnJgdQs2eFHAEE\&q=85\&s=d2733a41537ab77e67dc223779008f51)

* **スナップショット間隔：** この設定は**行**間隔単位（この開始値の種類で利用可能な唯一の選択肢）と組み合わされ、Sync がデータを取得する際にデータを分割する行数を定義します。

  デフォルトでは、Sync は行数に0を使用します。ただし、数値を手動で入力するか、フィールドの上（▲）および下（▼）矢印を使用することで、この間隔を調整できます。

ダイアログボックスで**保存**をクリックすると、設定したジョブの**概要**タブの**スナップショット設定**カテゴリに設定内容が表示されます：

![数値ベースの設定を示す概要タブのスナップショット設定](https://mintcdn.com/cdata-sync/4njnJgdQs2eFHAEE/26.4/images/Configuring-Your-First-Replication-Job_defining-settings-for-initial-replication_4.png?fit=max\&auto=format\&n=4njnJgdQs2eFHAEE\&q=85\&s=d694c2f0f248d9f2a3593ad1fd0dfe7f)

### 変更データキャプチャ（CDC）ジョブのスナップショット設定

CDC ジョブ用の**スナップショット設定を編集**ダイアログボックスには、変更データキャプチャが開始される前にスナップショットフェーズをどのように処理するかを制御する、以下の設定が含まれます：

* **スナップショットサイズ：** この設定は、各バッチでスナップショットを取得する行数を指定します。

  デフォルトでは、スナップショットサイズは1,000,000 行です。この値を調整することで、大規模な初期ロードの管理や、スナップショット処理中のトランザクションサイズの制御に役立ちます。数値を手動で入力するか、フィールドの上（▲）および下（▼）矢印を使用することで、この間隔を調整できます。

  ![スナップショットサイズを示すCDC ジョブ用のスナップショット設定を編集ダイアログボックス](https://mintcdn.com/cdata-sync/4njnJgdQs2eFHAEE/26.4/images/Configuring-Your-First-Replication-Job_defining-settings-for-initial-replication_5.png?fit=max\&auto=format\&n=4njnJgdQs2eFHAEE\&q=85\&s=2c6fb8fabf4c3b03cac072cffcabea84)

* **スナップショットをスキップ：** この設定は、既存データの初期スナップショットを実行するかどうかを決定します。

  * （デフォルト）**スナップショットをスキップ**が無効になっている場合、Sync は初期スナップショットを実行してからCDC の変更の処理を続行します。
  * **スナップショットをスキップ**が有効になっている場合、初期スナップショットはスキップされます。最初のジョブ実行では0行が転送され、CDC ストリームからの新しい変更のみが処理されます。

  ![スナップショットをスキップオプションを示すCDC ジョブ用のスナップショット設定を編集ダイアログボックス](https://mintcdn.com/cdata-sync/4njnJgdQs2eFHAEE/26.4/images/Configuring-Your-First-Replication-Job_defining-settings-for-initial-replication_6.png?fit=max\&auto=format\&n=4njnJgdQs2eFHAEE\&q=85\&s=d44acc16bf645fd88e8b7b10e830b93b)

ダイアログボックスで**保存**をクリックすると、設定したジョブの**概要**タブの**スナップショット設定**カテゴリに設定内容が表示されます：

![CDC の設定を示す概要タブのスナップショット設定](https://mintcdn.com/cdata-sync/4njnJgdQs2eFHAEE/26.4/images/Configuring-Your-First-Replication-Job_defining-settings-for-initial-replication_7.png?fit=max\&auto=format\&n=4njnJgdQs2eFHAEE\&q=85\&s=034698df39014e8fa9a976b78bdd4e14)

### パラレルパーティション読み取りによるスナップショットパフォーマンス

大規模なデータセットの場合、*パラレルパーティション読み取り*により、Sync がソーステーブルからデータを並列に読み取れるようになり、スナップショットのパフォーマンスが向上します。システムは、テーブルを順次スキャンする代わりに、データを複数のパーティションに分割して同時に実行します。

パラレルパーティション読み取りは、標準ジョブと変更データキャプチャ（CDC）ジョブの両方で利用できます。

#### パラレルパーティション読み取りの設定

パラレルパーティション読み取りは、タスクレベルの**クエリ**タブでジョブに対して設定します。このタブで、REPLICATE クエリのWITH 句に適切なオプションを追加することで、この機能を有効にします。以下のオプションは、パーティション分割の適用方法を制御します：

* `enableparallelreadpartitioning`： `'true'` に設定すると、パラレルパーティション読み取りを有効にします。デフォルト値は`'false'` です。
* `partitionkey`： Sync がソースデータをパーティションに分割する際に使用するカラムを指定します。このカラムは、datetime または整数カラムである必要があります。
* `partitionsize`： 各パーティションのサイズを定義します。datetime カラムの場合、値は日数を表します。整数カラムの場合、値は単位変換なしでそのまま使用されます。
* `maxparallelpartitions`： 同時に実行できるパーティションの最大数を指定します。デフォルト値は`2` です。

**Example:**

```sql theme={null}
REPLICATE [dest_schema].[DestTable]
WITH maxparallelpartitions = '2',
     partitionkey = 'CreatedDateTime',
     enableparallelreadpartitioning = 'true',
     partitionsize = '180'
SELECT * FROM [src_schema].[SrcTable]
```

#### パラレルパーティション読み取りの動作

パラレルパーティション読み取りを有効にすると、Sync は指定したパーティションキーに基づいてソースデータをパーティションに分割し、それらのパーティションを同時に処理します。このアプローチにより、特に大規模なテーブルにおいて、スナップショットフェーズの完了に必要な合計時間が短縮されます。

実行中にパーティションが失敗した場合、Sync はステータステーブルに進捗状況を記録します。その後、ジョブを再試行すると、Sync はスナップショット全体を再開するのではなく、最後に成功したパーティションから再開します。

#### パラレルパーティション読み取りの要件と制限事項

パラレルパーティション読み取りを使用するには、アプリケーションデータベースが複数の同時接続をサポートしている必要があります。Derby などのファイルベースのアプリケーションデータベースはサポートされていません。これらのデータベースのいずれかを使用している場合、この機能は利用できません。

以下のソースがパラレルパーティション読み取りをサポートしています：

* DB2
* DB2 for i
* Informix
* MariaDB
* Microsoft SQL Server
* MySQL
* Oracle
* PostgreSQL

## ジョブを実行

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

次のいずれかの方法でジョブを実行できます：

* ジョブ名の左側にあるチェックボックスを選択して、**ジョブ**ページ上部の黒いタスクバーにある**実行**をクリックする。

* 以下に示すように、ジョブ行の最後にカーソルを置いたときに表示される**ジョブを実行** (▷) をクリックする。

  ![ジョブページのジョブを実行アイコン](https://mintcdn.com/cdata-sync/FaXQgwCWYQjGfVUG/26.4/images/Run-Job-Method2.png?fit=max\&auto=format\&n=FaXQgwCWYQjGfVUG\&q=85\&s=e20aa43b1a0ac0a49811ebcf2bb704e0)

* 実行するジョブを選択する。次に、[ジョブにタスクを追加](#ジョブにタスクを追加)で説明したように**タスク**タブからジョブを実行する。

ジョブが正常に実行されると、Sync の**最後の実行**カラムに`成功` というメッセージが表示されます。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.