ターゲットの一致

ターゲットの一致

お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。




ターゲット照合は、データがエクスポート先にエクスポートされる前に行われます。ターゲット照合は、データモデルの不一致によるエクスポートの失敗を防ぐ、DataPrepの便利な機能です。ターゲット照合を使用すると、必要なデータをターゲットとして設定し、ソースデータの列をターゲットタブの項目に合わせて対応付けることができます。これにより、高品質なデータをエクスポート先へスムーズにエクスポートできます。
 

ターゲット照合の実行手順

1. Zoho CRM、Zoho Creator、クラウドデータベースなどのエクスポート先にデータをエクスポートしようとすると、エクスポート先のタブのターゲットが現在のデータに自動的に関連付けられ、ソースがターゲットタブの項目と一致するかどうかが確認されます。ターゲット照合のチェックに合格した場合、パイプラインの実行完了時にデータがエクスポートされます。一方、ターゲット照合のチェックに失敗した場合、パイプラインの実行は失敗し、ジョブの概要ページにターゲット照合エラーが表示されます。ただし、以下の手順に従ってエラーを修正できます。



2. ターゲットのデータモデルは、既存のソースの上に表示されます。ソース内の列は、一致する列がターゲットに見つかった場合、自動的にターゲット内の列に合わせて対応付けられます。



ターゲット照合では、一致した列、未一致の列、エラー列に対して、それぞれ異なるアイコンや候補が表示されます。これらの候補をクリックすると、既存の列をターゲット列に合わせるための変更をすばやく行えます。

3.  [ターゲット照合]アイコンを使用して、ターゲットに対して次の操作を実行することもできます。
 
  1. [ターゲットを更新]- ターゲットに更新があった場合、このオプションを使用してターゲットを更新できます。
  2. [ターゲットを一時停止]- このオプションを使用すると、ターゲットがソースから一時的に削除されます。
  3. [ターゲットを再開]- このオプションを使用すると、一時停止したターゲットを再開できます。
  4. [ターゲットを非表示]- このオプションを使用すると、ソースの下にあるターゲットデータが非表示になります。
  5. [ターゲットを表示]- ターゲットが非表示になっている場合、このオプションを使用して再表示できます。
  6. [ターゲットを削除]- このオプションを使用すると、ターゲットがソースから完全に削除されます。

5. 初期設定では、ソースとターゲットのすべての列がグリッドに表示されます。ただし、[すべての列]ドロップダウンをクリックしてオプションを選択すると、エラー列、未一致列などの特定の列を表示できます。



利用可能なオプションは次のとおりです。

[すべての列]:ソース内のすべての列、一致した列、未一致の列、不一致の列が表示されます。

[エラー列]:このオプションでは、ターゲット照合後にエラーがあるソース内のすべての列が表示されます。

[未一致列]:このオプションでは、ソースとターゲット内の未一致の列がすべて表示されます。

メモ:
  1. ターゲット内の非必須列は、利用可能なソース列と一致させるか、無視できます。
  2. CRM以外のソースからソースデータをインポートした場合、初期設定では、ソース内にある追加の列はエクスポート時に含まれません。ただし、これらの列を含めたい場合は、名前を変更して一致させることができます。
  3. CRMからソースデータをインポートした場合、エクスポートを続行するには、ターゲットに存在しないソース内の列を一致させるか削除する必要があります。ただし、追加の列(システム生成列)はエクスポート時に無視されます。
 

[未一致列]オプションを使用している場合、[必須列のみを表示]オプションを切り替えることで、必須列(ターゲットで必須に設定されている列)があるかどうかを確認し、含めることができます。必須列のみを修正して、エクスポートに進むこともできます。




[データ型の不一致]:このオプションでは、ターゲット内の列とデータ型が一致しないソース内の列が表示されます。

[データ形式の不一致]:このオプションでは、ターゲットと日付、日時、時刻の形式が異なるソース内の列が表示されます。

[制約の不一致]:このオプションでは、ターゲット内の列のデータ型制約と一致しない列が表示されます。列に制約を追加する方法については、こちらをクリックしてください

[必須列の不一致]:このオプションでは、ターゲットでは必須に設定されているものの、ソースでは必須に設定されていない列が表示されます。

メモ:必須列は、一致させて必須に設定しない限り、送信先にエクスポートできません。列の上にあるアイコンをクリックすると、その列を必須に設定できます。また、データ型の変更変換の下にある[必須(null不可)に設定]チェックボックスを使用して、列を必須に設定することもできます。

[データサイズ超過の警告]:このオプションでは、ターゲットで許可されている最大サイズを超えるデータを含む列が表示されます。

Notesメモ:データサイズ超過の警告は、データベースターゲットにのみ適用されます。

6. ターゲットを関連付けると、[概要を表示]オプションが表示されます。未一致列とエラー列のターゲット照合エラーの概要を確認するには、[概要を表示]リンクをクリックします。
  1. ターゲット照合エラーセクションには、エラーと各エラーに関連する列数が表示されます。
  2. 上部のセクションには、エラーのカテゴリーと各カテゴリーのエラー数が一覧表示されます。
  3. それらをクリックすると、パネル内で各カテゴリーに関連するエラーを絞り込めます。
  4. 初期表示では、すべての列が表示されます。ただし、任意のエラーカテゴリーをクリックすると列を詳しく確認できます。また、[エラーのみを表示]チェックボックスを選択すると、エラー列のみを表示できます。
  5. ターゲット照合エラーパネルでのフィルター選択は、DataPrep Studioページのグリッドにも適用されます。



[未一致列]フィルターでは、[必須列のみを表示]チェックボックスを選択して、必須列のみを表示できます。

よくある質問

1. エクスポート中にターゲット照合が失敗した場合の対処方法

ターゲット照合エラーが原因でパイプラインの実行が失敗した場合は、次の手順で修正してください。
  1. ジョブの概要ページで、右上の[パイプラインを編集]オプションをクリックします。これにより、パイプラインビルダーページに移動します。
      

Notes
メモ:スクリーンショットでは説明用にZoho CRMを表示しています。同じ内容は、すべてのコネクターとクラウドデータベースに適用されます。

b. 送信先を追加した最後のステージを右クリックし、[データの準備]オプションを選択します。これにより、DataPrep Studioページが開きます。

      

c. データグリッドのすぐ上の右上にあるターゲット照合アイコンをクリックします。

d. [ターゲットを表示]オプションを選択します。これにより、[送信先]タブがターゲットとして表示され、ソース列をそれに合わせて調整できます。エラーと警告は、赤色と黄色のアイコンで強調表示されます。
      
     
e. [すべての列]ドロップダウンをクリックし、[エラー列]オプションを選択します。次に、赤色または黄色のアイコンをクリックして、ステージの列を[送信先]タブの項目に一致させます。

これにより、必要なデータ型と制約がステージの列に追加され、送信先のターゲット列と一致するようになります。

Info
メモ:送信先のターゲット列には、API名に基づいた名前が付けられます。そのため、ステージの列にも同じ名前を付けてください。これは、システムがAPI標準に従って列を検出し、送信先項目に正しくマッピングするために必要です。

ターゲットが正常にマッピングされ、エラー列がなくなったら、パイプラインの実行に進めます。

2. ターゲット照合中に表示される各アイコンの意味

ターゲット照合中に表示されるアイコンは、列のマッピングと検証の状態を示します。

  • グレーのアイコン→ ソース内の追加列はエクスポートに含まれません。

  • 黄色のアイコン(ソース列とターゲット列が一致)→ その列には、ターゲットのサイズ制限を超える値が含まれている可能性があります。クリックすると制約を更新できます。

  • 黄色のアイコン(ターゲットには列があるがソースにはない)→ これはターゲット内の必須列ではありません。利用可能であれば、この列をソース列と一致させるか、この警告を無視できます。

  • 赤色のアイコン→ これはターゲット内の必須列ですが、一致させるための列がソースに残っていません。データ内に一致する列が必要です。

  • 緑色のアイコン→ ターゲットが一致しています。


関連情報
ターゲット照合を使用したZoho Creatorへのデータのエクスポート