Zoho DataPrep向けZoho Catalyst Data Storeコネクタ
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。
Zoho Catalyst Data Storeコネクターを使用して、Zoho DataPrepからZoho Catalyst Data Storeにデータをエクスポートできます。Zoho DataPrepでは データクリーンアップ、データ移行、 データバックアップ をさまざまな方法で実行できます。このコネクターにより、ETLワークフローを効率化し、スムーズなデータ移動を実現し、Zoho Catalyst Data StoreとZoho DataPrep間のデータ連携を簡素化できます。
重要：Zoho Catalyst Data StoreからDataPrepへのデータのインポートは、まだサポートされていません。
Zoho Catalyst Data Storeへのデータのエクスポート
2. パイプラインビルダーページで、データフローの作成とステージでの必要な変換の適用が完了したら、ステージを右クリックして［出力先を追加］オプションを選択します。
3. ［すべての出力先］タブで［Zoho Catalyst Data Store］ を検索するか、［Zohoアプリ］ カテゴリーで絞り込み、クリックします。
4. データのエクスポート先として必要な環境を［環境を選択］ドロップダウンから選択します。
環境には次の2種類があります。
本番- 本番環境は、アプリケーションのエンドユーザーがアクセスできるZoho Catalystのライブモードです。開発とテストのフェーズが完了したら、Webコンソールからアプリケーションを開発環境から本番環境にデプロイできます。この環境では、アプリケーションの完成版がホストされ、ユーザー向けのリアルタイム操作がサポートされます。
開発- 開発環境は、Zoho Catalystの分離されたサンドボックスであり、Catalystの機能やコンポーネントを作成、設定、テスト、ホストできます。アプリケーションの開発フェーズでは、ライブ運用に影響を与えることなく、制御された環境で実装を構築し、反復的にテストできます。変更内容の検証が完了したら、本番環境にデプロイできます。
5. データをエクスポートするZoho Catalyst Data Storeの［組織］、［プロジェクト］、［テーブル］ を選択します。
6. データをエクスポートするZoho Catalyst Data Storeの［Stratusバケット］を選択します。Stratusバケットは、Zoho Catalystで任意の形式やサイズのデータをオブジェクトとして保存するために設計された、堅牢で安全かつ拡張性の高いクラウドコンテナーです。
7. Zoho Catalyst Data Storeにエクスポートするデータの処理方法を決めるため、次のいずれかのオプションを選択します。
- ［新しいデータのみ追加］：このオプションを使用すると、新しくインポートされたデータのみをZoho Catalyst Data Storeに追加できます。
- ［既存のデータのみ更新］：このオプションを使用すると、選択した項目と一致するZoho Catalyst Data Store内の既存のデータを更新できます（項目に基づいて照合）。
- ［データの追加と更新の両方］：このオプションでは、指定した選択済みの項目と一致するデータを更新し、選択した項目の値と一致しないデータを挿入します。
メモ：エクスポートにより、Zoho Catalyst Data Storeのデータが変更される場合があります。Zoho Catalyst Data Storeのデータをバックアップしておくことをおすすめします。
- ［既存のデータを削除］：この操作では、DataPrepで削除対象としてマークされたデータを追跡し、対応するZoho Catalyst Data Store内のデータを削除して、プラットフォームを最新の状態に保ちます。この操作は元に戻せません。
Zoho Catalyst Data Storeを出力先として設定したステージに、必須かつ一意の列が含まれていることを確認してください。この列が一致すると、Zoho Catalyst Data Storeのデータが削除されます。
8. ［照合基準の項目］ ドロップダウンから、目的の項目を選択します。項目を必須にするには［IsMandatory］バリデーターを有効にし、［Zoho Catalyst Data Store］タブで重複値を防ぐには［IsUnique］制約を有効にしてください。詳細はこちらをクリックしてください。
9. 出力先の設定を［保存］します。
パイプライン実行前のターゲット照合の確認
1. Zoho Catalyst Data Storeが出力先として設定されているステージのDataPrep Studio ページに移動します。
2. 右上隅にあるターゲット照合アイコン
をクリックし、次に［ターゲットを表示］オプションを選択します。
ターゲット照合を確認したら、まず手動実行でパイプラインを実行してみることをおすすめします。手動実行が正常に動作することを確認した後、スケジュールを設定してパイプラインを自動化できます。実行の種類についてはこちらをご参照ください。
情報：各実行はジョブとして保存されます。パイプラインの実行時には、データソースから取得されたデータが、各ステージに適用した一連の変換を使用して準備され、その後データが出力先にエクスポートされます。この一連の処理はジョブページに記録されます。
12. 手動実行がエラーなく成功すると、データは正常にエクスポートされます。手動実行に失敗し、以下のターゲット照合エラーが表示された場合は、ターゲット照合の手順を完了することで修正できます。
ターゲット照合は、データモデルの不一致によるエラーが原因で発生するエクスポートの失敗を防ぐ、DataPrepの便利な機能です。
Zoho Catalyst Data Storeへのエクスポート時のターゲット照合
ターゲット照合は、データがエクスポート先にエクスポートされる前に行われます。ターゲット照合は、データモデルの不一致によるエラーが原因のエクスポート失敗を防ぐ、DataPrepの便利な機能です。ターゲット照合を使用すると、必要なZoho Catalyst Data Storeタブをターゲットとして設定し、ソースデータの列をターゲットに合わせて整列できます。これにより、高品質なデータをZoho Catalyst Data Storeにスムーズにエクスポートできます。
メモ：ターゲット照合の失敗は、エクスポートの失敗ではありません。ターゲット照合は、データが実際にエクスポート先にエクスポートされる前に行われます。これにより、エクスポート失敗の原因となるスキーマまたはデータモデルのエラーを事前に検出し、エクスポートの失敗を防ぐことができます。
ターゲット照合チェックに失敗した場合
1. エクスポート中にターゲット照合チェックに失敗した場合は、DataPrep Studioページに移動し、右上にあるターゲット照合アイコン
をクリックして、［ターゲットを表示］オプションを選択します。ターゲットのデータモデルが既存のソースデータの上に表示されます。一致する列が見つかった場合、ソースの列はターゲットの列に合わせて自動的に整列されます。
ターゲット照合では、一致した列と一致しない列に対して、さまざまなアイコンと候補が表示されます。これらの候補をクリックすると、既存の列をターゲット列に合わせるための変更をすばやく行えます。エラーを修正しやすくするため、Zoho Catalyst Data Store内のターゲットタブがデータのターゲットとして関連付けられます。DataPrep Studioページでは、データとテーブルのマッピングを確認でき、不一致がある箇所にはエラーも表示されます。エラーアイコンにカーソルを合わせると問題の内容を確認でき、アイコンをクリックすると各エラーを解決できます。
メモ：デフォルトでは、すべての列がグリッドに表示されます。ただし、［すべての列］リンクをクリックすると、必要なオプションで絞り込むことができます。
2. ターゲット照合エラーの概要を表示するには、［概要を表示］リンクをクリックします。概要には、モデル照合エラーの種類と、各エラーに関連付けられている列数が表示されます。必要なエラー列をクリックし、［適用］をクリックすると、特定のエラー列で絞り込むことができます。
ターゲット照合エラーの概要
- ［ターゲット照合エラー］セクションには、エラーと各エラーに関連付けられている列数が表示されます。
- 上部のセクションには、エラーカテゴリーと各カテゴリーのエラー数が一覧表示されます。
- 各カテゴリーに関連するエラーをパネル内で絞り込むには、該当するカテゴリーをクリックします。
- デフォルト表示では、すべての列が表示されます。ただし、任意のエラーカテゴリーをクリックして列を詳しく確認したり、［エラーのみを表示］チェックボックスを選択してエラー列のみを表示したりできます。
- ターゲット照合エラーの概要でのフィルター選択は、DataPrep Studioページのグリッドにも適用されます。
ターゲット照合エラー
ターゲット照合で発生するエラーは以下のとおりです。
-
一致しない列：このオプションでは、ソースとターゲットで一致しないすべての列が表示されます。
メモ：
- ターゲット内の必須ではない列は、対応するソース列がある場合は一致させることも、無視することもできます。
- ソースに存在する追加の列は、デフォルトではエクスポート時に含まれません。ただし、含める場合は、これらの列の名前を変更して一致させることができます。
一致しない列オプションを使用する場合、［必須列のみを表示］オプションを切り替えることで、必須列（ターゲットで必須として設定されている列）があるかどうかを確認し、それらを含めることができます。必須列のみを修正して、エクスポートに進むこともできます。
- データ型の不一致：このオプションでは、ターゲットの列と一致しないデータ型を持つソースの列が表示されます。
- データ形式の不一致：このオプションでは、日付、日時、時刻の形式がターゲットと異なるソースの列が表示されます。
- 制約の不一致：このオプションでは、ターゲットの列のデータ型制約と一致しない列が表示されます。列に制約を追加する方法については、こちらをクリックしてください。
-
必須列の不一致：このオプションでは、ターゲットでは必須として設定されているものの、ソースでは必須として設定されていない列が表示されます。
メモ：必須列は、一致させたうえで必須として設定しない限り、エクスポート先にエクスポートできません。列を必須として設定するには、列の上にあるアイコンをクリックします。また、データ型の変更変換の下にある［必須（null不可）として設定］チェックボックスを使用して、列を必須として設定することもできます。
- データサイズ超過の警告：このオプションでは、ターゲットで許可されている最大サイズを超えるデータを含む列が絞り込まれます。
3. エラーを修正したら、パイプラインビルダーページに移動し、パイプラインを実行してデータをエクスポートできます。手動実行が正常に動作することを確認したら、スケジュールを設定してパイプラインを自動化できます。実行の種類については、こちらをご参照ください。
制限事項
1. DataPrepからCatalystにデータをエクスポートできるのは、特権管理者のみです。他のユーザー（Catalystの管理者ロールを含む）にはエクスポート操作を実行する権限がなく、実行しようとするとアクセスエラーが発生します。
よくある質問
1. Zoho Catalyst Data Storeへのエクスポート時にターゲット照合が失敗した場合の対処方法
パイプラインの実行がターゲット照合エラーによって失敗した場合は、次の手順で修正してください。
- ジョブの概要ページで、右上にある［パイプラインの編集］オプションをクリックします。パイプラインビルダーページが表示されます。
メモ：画像では説明のためにZoho CRMを使用しています。同じ手順はすべてのコネクターに適用できます。
b. 最後のステージ（Zoho Catalyst Data Storeを出力先として追加したステージ）を右クリックし、［データの準備］オプションを選択します。DataPrep Studioページが開きます。
c. データグリッドのすぐ上にある右上のターゲット照合アイコン
をクリックします。
d. ［ターゲットを表示］オプションを選択します。Zoho Catalyst Data Storeのテーブルがターゲットとして表示され、変換元の列をターゲットに合わせて対応付けできます。エラーと警告は、赤色と黄色のアイコンで強調表示されます。
e. ［すべての列］ドロップダウンをクリックし、［エラーのある列］オプションを選択します。次に、赤色または黄色のアイコンをクリックして、ステージの列をZoho Catalyst Data Storeのテーブル項目と対応付けます。
これにより、必要なデータ型と制約がステージ列に追加され、Zoho Catalyst Data Storeのターゲット列と一致するようになります。
メモ：Zoho Catalyst Data Storeのターゲット列にはAPI名に基づいた名前が付けられています。そのため、ステージ列にも同じ名前を付けてください。これは、API標準に従って列を検出し、Catalystの項目に正しく対応付けるために必要です。
エラーのある列がなくなり、ターゲットの対応付けが完了したら、パイプラインを実行できます。
2. ターゲット照合時に表示される各アイコンの意味
ターゲット照合時に表示されるアイコンは、列の対応付けと検証のステータスを示します。
-
グレーのアイコン→変換元に存在する追加の列はエクスポートに含まれません。
-
黄色のアイコン（変換元とターゲットの列が一致）→ターゲットのサイズ制限を超える値を列に格納できます。制約を更新するにはクリックします。
-
黄色のアイコン（ターゲットには列があるが、変換元にはない）→ターゲットの必須列ではありません。該当する変換元の列がある場合は対応付けるか、この警告を無視できます。
-
赤色のアイコン→ターゲットの必須列ですが、対応付けられる変換元の列が残っていません。データ内に対応する列が必要です。
-
緑色のアイコン→ターゲットが一致しています。
関連情報
Zoho CRMに関するよくある質問