Zoho DataPrep向けZoho Analyticsコネクタ
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。
DataPrepは、Zoho Analyticsコネクターを使用したZoho Analyticsからのデータのインポートに対応しています。Zoho Analyticsは、データを視覚的に分析し、優れたデータ可視化を作成し、データに隠れたインサイトを発見できるセルフサービスBI／データ分析ソフトウェアです。このコネクターを使用すると、ETLワークフローを効率化し、データの移動をスムーズに行い、Zoho AnalyticsとZoho DataPrep間のデータ連携を簡素化できます。
Zoho Analyticsからのデータのインポート
1.既存のパイプラインを開くか、パイプラインを作成します。作成は、［ホーム］ページ、［パイプライン］タブ、または［ワークスペース］タブで行えます。その後、［データを追加］オプションをクリックします。
情報：パイプラインビルダーの上部にある［データのインポート］
2. 左ペインで［Zoho Apps］カテゴリーを選択し、［Zoho Analytics］をクリックします。検索ボックスでこの項目を直接検索することもできます。
3. ［組織を選択］ドロップダウンから組織を選択し、［ワークスペースを選択］ドロップダウンから利用可能なワークスペースのいずれかを選択します。
4. チェックボックスを選択して、DataPrepにインポートするテーブルを選択します。ワークスペース内にあるクエリーテーブルを含むすべてのテーブルが、初期設定で表示されます。検索アイコンの横にある［フィルター］メニューを使用して、テーブルとクエリーテーブルを絞り込めます。
クエリーテーブルは、レポート作成や分析を簡単に行えるようにデータを準備するためのZoho Analyticsの機能です。データベース内の1つ以上のテーブルのデータを組み合わせて、レポート作成を容易にできます。クエリーテーブルの詳細については、こちらをクリックしてください。
5. ［インポート］ボタンをクリックします。
6. データのインポートが完了すると、パイプラインビルダーページが開き、ETLパイプラインへの変換の適用を開始できます。また、ステージを右クリックして［データの準備］オプションを選択すると、DataPrep Studioページでデータを準備できます。こちらをクリックして、変換の詳細をご確認ください。
7. データフローの作成とステージでの必要な変換の適用が完了したら、ステージを右クリックして連携先を追加し、データフローを完了できます。
7. データフローの作成とステージでの必要な変換の適用が完了したら、ステージを右クリックして連携先を追加し、データフローを完了できます。
スケジュール
スケジュールオプションを使用して、パイプラインのスケジュールを設定できます。スケジュール設定時に、Creatorアプリケーションから増分データをインポートすることもできます。増分データのインポートとは、前回の同期後に新規作成または変更されたデータをインポートする方法です。
スケジュール設定
1. パイプラインビルダーで［スケジュール］オプションを選択します。
2. ［繰り返し］方法（毎時、毎日、毎週、毎月）を選択し、［実行間隔］ドロップダウンで頻度を設定します。［実行間隔］ドロップダウンの選択肢は、繰り返し方法によって変わります。詳細については、［こちらをクリック］してください。
3. ソース内の新しいデータをインポートする時刻（GMT）を選択します。初期設定では、ローカルタイムゾーンが選択されます。
4.［指定回数失敗後のスケジュールの一時停止］：このオプションでは、n回失敗した後にスケジュールを一時停止するよう設定できます。
情報：範囲は2～100です。初期値は2です。
Zoho Analyticsのインポート設定
どの種類の実行でも、パイプライン内のすべてのソースに対してインポート設定を必ず行う必要があります。インポート設定オプションを使用すると、Zoho Analyticsから増分データをインポートおよび取得する方法を設定できます。
メモ：インポート設定を行わないと、どの種類の実行も保存できません。
1. パイプラインビルダーの［スケジュール］ドロップダウンから実行対象を選択し、インポート設定を行うには［こちらをクリック］のリンクを選択します。
2. ［ソースからデータをインポートする方法？］ドロップダウンから必要なオプションを選択します。このオプションでは、すべてのデータ、変更済みデータと新規データ、新規データのみのいずれかをインポートできます。
すべてのデータのインポート
このオプションでは、実行ごとにソースから利用可能なすべてのデータをインポートします。
増分データの取得
増分データのインポートとは、特定のデータ間隔内の新規または変更されたデータをインポートする方法です。
変更済みデータと新規データのみ
指定したデータ間隔内で変更済みデータと新規データを増分インポートするには、ドロップダウンから［変更済みデータと新規データのみ］オプションを選択します。新規または変更されたデータを増分取得するために使用する日時列名を入力します。Zoho Analyticsでは、日時列は常にGMTで表示されます。
タイムゾーン付きの日時列をZoho Analyticsにインポートする場合、時刻はGMT+00:00に調整されます。
たとえば：Nov 24, 2014 10:00 GMT+9:00（または）Nov 24, 2014 10:00 JSTは、Nov 24, 2014 01:00 GMTとして保存されます。
タイムゾーンが指定されていない場合、初期設定では値はGMTとして扱われます。
たとえば：Nov 24, 2014 10:00 GMT+9:00（または）Nov 24, 2014 10:00 JSTは、Nov 24, 2014 01:00 GMTとして保存されます。
タイムゾーンが指定されていない場合、初期設定では値はGMTとして扱われます。
［新しいデータがない場合は既存データを使用］：
増分インポート中、
- チェックボックスをオンにした場合：ソースに新しいデータがないとき、最後に取得されたデータが再度インポートされます。
- チェックボックスをオフにした場合：ソースに新しいデータがないとき、インポートは失敗し、ファイルはインポートされません。その結果、パイプラインジョブ全体が失敗します。
データをインポートしない設定
データは一度だけインポートされます。2回目以降は、同じデータにルールが適用され、エクスポートされます。
10. インポート設定を保存するには、［保存］をクリックします。
Zoho Analyticsへのデータのエクスポート
2. Pipeline Builderページで、データフローの作成とステージで必要な変換の適用が完了したら、ステージを右クリックし、［エクスポート先を追加］を選択します。
3. ［すべてのエクスポート先］タブでZoho Analyticsを検索するか、［Zohoアプリ］カテゴリーで絞り込み、クリックします。
4. データのエクスポート先となるZoho Analyticsの［組織］と［ワークスペース］を選択します。
5. 新しいテーブルを作成する場合は、［新しいテーブル］を選択します。必要な［組織］、［ワークスペース］を選択し、［エクスポート］をクリックします。
6. 既存のテーブルにデータをエクスポートする場合は、［既存のテーブル］を選択します。Zoho Analyticsで利用可能なテーブルの一覧から選択します。
メモ：システムテーブルへのデータのエクスポートには対応していません。
7. Zoho Analyticsにエクスポートするデータの処理方法を決定するには、次のいずれかのオプションを選択します。
- ［末尾に行を追加］- このオプションでは、新しくインポートされたデータのみをZoho Analytics内のデータの末尾に追加できます。
- ［既存の行を削除して追加］- このオプションでは、テーブル内の既存のデータを削除し、新しいデータを追加します。
- ［行を追加し、すでに存在する場合は置換］- このオプションでは、選択した列と一致するデータを更新し、一致しないデータを挿入できます。
メモ：既存のデータと照合する列を選択できるのは、［行を追加し、すでに存在する場合は置換］オプションを選択した場合のみです。
8. ［個人データを含む列を含める］チェックボックスを選択すると、個人データを含む列を含めることができます。
9. ［エクスポート先の設定を保存］します。
パイプライン実行前のターゲット照合の確認
Zoho Analyticsがエクスポート先として設定されているステージのDataPrep Studioページに移動します。
右上のターゲット照合アイコン 
をクリックし、［ターゲットを表示］を選択します。エクスポート失敗を回避するため、ターゲット照合が完了していることを確認してください。こちらでターゲット照合の詳細を確認できます。
ターゲット照合を確認したら、まず手動実行でパイプラインを実行してみることをお勧めします。手動実行が正常に動作することを確認した後、スケジュールを設定してパイプラインを自動化できます。各種実行についてはこちらをご参照ください。
情報：各実行はジョブとして保存されます。パイプラインを実行すると、データソースから取得したデータは、各ステージで適用した一連の変換を使用して加工され、その後、データがエクスポート先にエクスポートされます。この一連の処理は、［ジョブ］ページに記録されます。
メモ：
1. 値がそれぞれのデータ型と一致する行がエクスポートされます。
2. データ型が一致しない行はエクスポートされず、エラーの詳細がメールおよび通知パネルで通知されます。
3. 無効なデータを含むパイプラインは、Zoho Analyticsにエクスポートできません。スケジュールを設定する前に、Zoho Analyticsをエクスポート先として設定したステージに有効な値が含まれていることを確認してください。
10. 手動実行がエラーなく成功すると、データは正常にエクスポートされます。手動実行が失敗し、以下のターゲット照合エラーが表示された場合は、ターゲット照合の手順を完了することで修正できます。
ターゲット照合は、データモデルの不一致によるエラーが原因で発生するエクスポートの失敗を防ぐ、DataPrepの便利な機能です。
Zoho Analyticsへのエクスポート時のターゲット照合
ターゲット照合は、データがエクスポート先にエクスポートされる前に実行されます。ターゲット照合は、データモデルの不一致によるエラーが原因で発生するエクスポートの失敗を防ぐ、DataPrepの便利な機能です。ターゲット照合を使用すると、Zoho Analytics内の必要なテーブルをターゲットとして設定し、ソースデータセットの列をターゲットテーブルに合わせて調整できます。これにより、高品質なデータをZoho Analyticsへスムーズにエクスポートできます。
メモ：ターゲット照合の失敗は、エクスポートの失敗ではありません。ターゲット照合は、データが実際にエクスポート先へエクスポートされる前に実行されます。これにより、エクスポートの失敗につながる可能性のあるスキーマやデータモデルのエラーを事前に検出し、エクスポートの失敗を防げます。
ターゲット照合チェック失敗時の対応
1. エクスポート中にターゲット照合チェックが失敗した場合は、DataPrep Studio ページに移動し、右上のターゲット照合アイコン
をクリックして、［ターゲットを表示］オプションを選択します。ターゲットのデータモデルが既存のソースデータセットの上に表示されます。一致する列が見つかった場合、ソースデータセット内の列はターゲットデータセット内の列に合わせて自動的に配置されます。
ターゲット照合では、一致している列と一致していない列に対して、さまざまなアイコンや提案が表示されます。これらの提案をクリックすると、既存の列をターゲット列に合わせるための変更をすばやく行えます。エラーを修正しやすくするため、Zoho Analytics内の［ターゲット］タブがデータのターゲットとして関連付けられます。DataPrep Studioページでは、データとテーブルの対応関係を確認でき、不一致がある箇所にはエラーも表示されます。エラーアイコンにカーソルを合わせると問題の内容を確認でき、アイコンをクリックすると各エラーを解決できます。
メモ：初期設定では、すべての列がグリッドに表示されます。ただし、［すべての列］リンクをクリックすると、必要なオプションで絞り込めます。
2. ターゲット照合エラーの概要を表示するには、［概要を表示］リンクをクリックします。概要には、さまざまなモデル照合エラーと、各エラーに関連付けられている列数が表示されます。必要なエラー列をクリックし、［適用］をクリックすると、特定のエラー列を絞り込めます。
ターゲット照合エラーの概要
- ［ターゲット照合エラー］セクションには、エラーと各エラーに関連付けられている列数が表示されます。
- 上部のセクションには、エラーのカテゴリーと各カテゴリー内のエラー数が一覧表示されます。
- 各カテゴリーをクリックすると、パネル内でそのカテゴリーに関連するエラーを絞り込めます。
- 初期表示では、すべての列が表示されます。ただし、任意のエラーカテゴリーをクリックすると列の詳細を確認できます。また、［エラーのみを表示］チェックボックスを選択すると、エラー列のみを表示できます。
- ターゲット照合エラーの概要での絞り込みの選択内容は、DataPrep Studioページのグリッドにも適用されます。
ターゲット照合エラー
ターゲット照合のエラーについて、以下で説明します。
-
［一致しない列］：このオプションでは、ソースとターゲットで一致しないすべての列が表示されます。
メモ：
- ターゲット内の必須ではない列は、利用可能なソース列と照合するか、無視できます。
- ターゲットに存在しないソース内の列は、エクスポートを続行するために照合するか削除する必要があります。
［一致しない列］オプションを使用する場合は、［必須列のみを表示］オプションを切り替えて、必須列（ターゲットで必須として設定されている列）があるかどうかを確認し、それらを含めることができます。必須列のみを修正して、エクスポートに進むこともできます。
- ［データ型の不一致］：このオプションでは、ターゲット内の列とデータ型が一致しないソースの列が表示されます。
- ［データ形式の不一致］：このオプションでは、ターゲットと日付、日時、時刻の形式が異なるソースの列が表示されます。
- ［制約の不一致］：このオプションでは、ターゲット内の列のデータ型制約と一致しない列が表示されます。列に制約を追加する方法については、こちらをクリックしてください。
-
［必須列の不一致］：このオプションでは、ターゲットで必須として設定されているが、ソースでは必須として設定されていない列が表示されます。
メモ：必須列は、照合され、必須として設定されていない限り、エクスポート先にエクスポートできません。列の上にあるアイコンをクリックすると、必須として設定できます。また、データ型の変更変換の下にある［必須（null不可）に設定］チェックボックスを使用して、列を必須として設定することもできます。
- ［データサイズ超過の警告］：このオプションでは、ターゲットで許可されている最大サイズを超えるデータを含む列が絞り込まれます。
制限事項
1. 一度にインポートできるデータは最大1,000万件です。
2. 一度にエクスポートできるデータは最大1,000万件です。
よくある質問
1. Zoho Analyticsへのエクスポート中にターゲットの照合に失敗した場合の対処方法
パイプラインの実行がターゲット照合エラーにより失敗した場合は、次の手順で修正してください。
- ジョブの概要ページで、右上の［パイプラインを編集］オプションをクリックします。パイプラインビルダーページが表示されます。
メモ：スクリーンショットでは説明のためにZoho CRMを表示しています。同じ内容がすべてのコネクターに適用されます。
b. Zoho Analyticsを出力先として追加した最後のステージを右クリックし、［データの準備］オプションを選択します。DataPrep Studioページが開きます。
c. データグリッドのすぐ上、右上にあるターゲット照合アイコン 
をクリックします。
d. ［ターゲットを表示］オプションを選択します。これにより、［Zoho Analytics］タブがターゲットとして表示され、ソース列をそれに合わせて調整できます。エラーと警告は、赤色と黄色のアイコンで強調表示されます。
e. ［すべての列］ドロップダウンをクリックし、［エラー列］オプションを選択します。次に、赤色または黄色のアイコンをクリックして、ステージ列を［Zoho CRM］タブの項目と照合します。
これにより、ステージ列に必要なデータ型と制約が追加され、Zoho Analyticsのターゲット列と一致するようになります。
メモ：Analyticsのターゲット列にはAPI名に基づく名前が付けられています。そのため、ステージ列にも同じ名前を付けてください。これは、API標準に従ってシステムが列を検出し、Analyticsの項目に正しく関連付けるために必要です。
ターゲットの関連付けが正常に完了し、エラー列がなくなったら、パイプラインの実行に進めます。
2. ターゲット照合中に表示される各アイコンの意味
ターゲット照合中に表示されるアイコンは、列の関連付けと検証の状態を示します。
-
グレーのアイコン→ ソースに存在する追加の列は、エクスポート対象に含まれません。
-
黄色のアイコン（ソース列とターゲット列が一致している場合）→ この列には、ターゲットのサイズ制限を超える値が含まれる可能性があります。クリックして制約を更新してください。
-
黄色のアイコン（ターゲットには列があるがソースにはない場合）→ これはターゲット内の必須列ではありません。利用可能な場合はこの列をソース列と照合するか、この警告を無視できます。
-
赤色のアイコン→ これはターゲットの必須列ですが、照合できるソース列が残っていません。データ内に一致する列が必要です。
-
緑色のアイコン→ ターゲット照合済みです。
関連項目