FTPサーバーからの増分データのインポート

FTPサーバーからの増分データのインポート

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


インクリメンタルデータフェッチは、前回の同期以降にデータ元から追加された新しいファイルをインポートする手法です。Zoho DataPrep では、Zoho Databridge を利用して FTP サーバーからインクリメンタルデータをインポートできます。

DataPrep では、FTP から CSV、TSV、JSON、XML、TXT など様々なファイルタイプをインクリメンタルにインポートできます。

 FTP サーバーからファイルをインクリメンタルにインポートする方法

1. ワークスペースを作成するか、既存のワークスペースを開きます。こちらをクリックして、ワークスペースの作成方法をご覧いただけます。

 

2. 選択する your data データ元セクションからFTPオプションを選択するか、左側のペインにあるFilesカテゴリーから選択します。

 

 

Notesメモ: 以前にFTP接続を追加済みの場合は、FTP servers Saved 外部連携 セクションから既存の接続を選択し、そのままインポートを続行できます。Saved data 外部連携の詳細については、こちらをクリックしてください。

 

 

3. FTPサーバーからローカルファイルを段階的にインポートしたい場合は、インポートする 差出人 local networkのトグルを有効にしてください。

 

Info
情報: FTPからファイルをインポートするためには、ご利用のマシンにZoho Databridgeがインストールされていることをご確認ください。Zoho Databridgeのダウンロードおよびインストール方法については、こちらをクリックしてください。

 

3. 有効なDatabridgeを選択してください。

 

4. サーバーに接続しファイルを取得するためのFTP接続を設定してください。

 

5. FTP server 種類のドロップダウンから、以下のいずれかの設定を選択します。

  • FTP - ファイル転送

  • FTPS - Implicit TLS/SSL を使用したファイル転送

  • FTPS - Explicit TLS/SSL を使用したファイル転送

  • SFTP - SSH ファイル転送プロトコル

 

 

6. FTP server hostを入力します。サーバーのIPアドレスまたはFQDN(完全修飾ドメイン名)も指定できます。

 

7. 認証が必要な場合は、ユーザー名パスワードを入力してください。


Notes
メモ: 接続設定は、今後のデータインポートのために保存されます。認証情報は安全に暗号化・保存されます。

 

8. Connection 名前テキストボックスに、接続の名前を入力します。

 

9. 接続ボタンをクリックし、以下の詳細を入力します。

フォルダパス:ファイルを検索する場所となるフォルダパスを指定します。例:/srv/ftp/filesfortest/

Info
情報:フォルダパスは大文字と小文字が区別されます。

含めるサブフォルダ:ファイル検索時にサブフォルダも対象にしたい場合、このチェックボックスを選択できます。

ファイルパターン:指定した場所のファイル名を照合する際に使用するパターンです。正規表現によるマッチングもサポートしています。すべてのファイルを対象としたい場合は '.*' のパターンも利用できます。

例えば、次のようなファイル名Sales_2022。csv , Sales_2023。csv , Sales_2024。csvを取得したい場合は、パターンとしてSales_.* を入力します。

同様に、PublicData1。csv , PublicData2。csv , PublicData3。csvなどのファイルを取得したい場合は公開する.*

特定の拡張子、たとえばcsvファイル(file1。csv , file2。csv , file3。csvなど)をインポートする場合は、.*.csvを使用します。

単一のファイルをインポートしたい場合は、正確なファイル名でパターンを指定してください。
例:leads_jan_2022.*

Info
情報: ファイルパターンは大文字と小文字を区別します。

ファイルの解析形式: ファイルを解析するために必須の拡張子を選択してください。ファイル形式が一般的に利用されているものと異なる場合、このオプションを利用し、データを読み取り可能な形式でインポートする前に、次のいずれかの形式に変換できます。利用可能な形式はCSV、TSV、JSON、XML、TXTです。

更新日時に基づく新規ファイルの取得: 各スケジュールインポートまたは更新 (データソースからのデータの更新)時に新規ファイルを段階的に取得したい場合は、このチェックボックスを選択してください。DataPrepは、前回インポートしたファイルの更新日時以降に更新されたファイルパターンに一致するファイルを取得します。
Notesメモ: 増分インポート中にデータソースに新規ファイルがない場合:

チェックボックスがオフの場合: 最後に取得したファイルが再度インポートされます。
チェックボックスがオンの場合: 更新やスケジュールはスキップされ、ファイルはインポートされません。

ファイルを結合してインポート - 指定したパターンに一致するすべてのファイルを結合し、1つのデータセットとしてインポートします。
Info
情報: このオプションでは、一度に最大5ファイルまで結合できます。
Notesメモ: このチェックボックスがオフの場合、1度に取得できるファイルは1つのみです。

例として、FTPサーバーのパスに10個のファイルがある場合、最初の5ファイルが1つのデータセットに統合されてインポートされます。次回の更新時に、残りの5ファイルが統合されてインポートされます。

同様に、FTPサーバーに8個のファイルがある場合、最初の5つがまとめて最初に取得され、その後、残りの3つが取得されます。

10. インポートするをクリックして、FTPサーバーからZoho DataPrepへデータをアップロードします。

 

11. データのインポートが完了すると、データセットが開き、すぐにデータの準備を開始できます。

 

12. データセットの準備ができたら、次回の更新前に必須の宛先へエクスポートしてください。

 

Notesメモ:Schedule インポートする」オプションを利用し、ワークスペース内のデータセットやDataPrep Studioページ上部のインポートするメニューからインポートのスケジュール設定が可能です。こちらをクリックして詳細をご覧ください。

 

パイプラインの複雑さに応じてデータセットのスケジュールを設定してください。インポート、データ処理、エクスポートに十分な時間を確保しましょう。

インクリメンタル同期の仕組み 

13. データセットがインポートのスケジュールに設定されると、インポートした時刻または最後にスケジュールされた時刻が記録されます。最初は最も古いファイルのみが取得されます。以降の同期が成功するたびに、最後の同期日時が新しい値で更新され、同期時刻以降に作成または更新されたファイルがインポートされます。指定された場所に新規または更新済みファイルが存在しない場合は、データはインポートされません。データが同期されなかった場合でも、試行したため同期時刻が更新されます。次回以降は、この同期時刻以降に作成または更新されたファイルが取得されます。

Notesメモ: 必ずエクスポート先のスケジュールをデータセットに対して設定してください。設定しない場合、データは継続的にインポートされますが、エクスポートしないとデータが失われる可能性があります。

ファイルから取得されたデータ数はOperations 履歴パネルのSync ステータスページで確認できます。


Operations 履歴アイコンを各 sync ステータスの横でクリックすると、データセットやその過去の状態、インポート・エクスポートスケジュールの変更内容をタイムラインで表示・追跡できます。


「Processing 履歴」パネルで、頻度同期における処理済みデータの認証も可能です。Processing 履歴 」オプションをクリックすると、サイドパネルが開き、データセットで利用可能なすべての処理済みデータIDと作成日時が一覧表示されます。


また、データ上にカーソルを合わせた際に表示されるアイコンをクリックすることで、処理済みデータのダウンロードや認証も行えます。

 Manual 更新する 

14. 最後の同期日時以降の次のファイルを手動で取得するには、更新する data 差出人 データ元オプションを使用します。

DataPrep studio」ページで、上部のメニューバーにあるインポートメニューを選択し、「更新する data 差出人 データ元」をクリックします。このオプションを利用すると、データ元からデータを再読み込みし、最新のファイルでデータセットを更新できます。

手動で更新する際は、最後の同期日時以降に新たに追加または更新されたファイルのみがデータセットにインポートされます。

Notes
メモ: 新規追加または更新されたファイルは、グリニッジ標準時(GMT)/ UTCを基準にインクリメンタルで取得されます。

ケース1:途中のファイルをスキップしたい場合
  

例えば、FTPサーバーパスに合計で10個のファイルがあるとします。ユーザーは3から5のファイルをスキップしたいと考えています。以下は、インクリメンタル取得時に特定のファイルをスキップする手順です。



インクリメンタル取得時に途中のファイルをスキップするには、下記の手順に従ってください。

 

1) 一般的なファイルパターンを使用してファイルをインポートします。例:テスト-.*




2) 最初は最も古いファイルのみが取得されます。例:テスト-1_csv。csv。

同期が正常に完了すると、最後の同期日時が新しい値で更新され、その時間以降に作成または更新されたファイルがインポートされます。



3) データのインポート後、エクスポートする nowオプションをエクスポートするメニューからDataPrep Studioページ上でクリックし、必須の保存先へエクスポートしてください。再読み込み前にこの操作を行わないとデータが失われます。



4) DataPrep studioページで、上部の棒グラフからインポートするメニューを選択し、更新する data 差出人 データ元をクリックします。 

 



5) 次のファイル、つまりテスト-2_csv.csvは段階的に取得されます。再度、必須の保存先にエクスポートしてください。再読み込み前にこの操作を行わないとデータが失われます。


6) rulesetアイコンをDataPrep Studioページ右上でクリックし、Rulesetペインを表示します。




7) Rulesetペインで、data データ元設定アイコンをクリックして、Data データ元詳細ページを開きます。



8) data データ元 詳細ページで、次にインポートしたい特定のファイルパターン差出人をFile pattern項目に入力します。「更新する」をクリックします。例:テスト-6_csv。csv.*


9) DataPrep studioページに移動し、上部の棒グラフ内にあるインポートするメニューを選択し、「更新する data 差出人 データ元」をクリックします。

ファイル「テスト-3」「テスト-4」「テスト-5」はスキップ済みとなり、「テスト-6」は取得済みとなります。更新済み時間も記録されます。

このファイルを必須の宛先へエクスポートします。




 

7) 再度、data データ元 詳細ページに移動し、ファイルパターンを汎用的な形式に変更します。例:テスト-.*



8)データのインポートするおよびエクスポートするをスケジュールして、パイプラインを設定します。

9)インポートするをスケジュールするには、

a. Schedule インポートするリンクをクリックします。

b. Schedule configセクションで、繰り返し方法(頻度「N」時間、頻度 day、毎週1回、毎月1回)を選択します。Perform 頻度オプションで繰り返しの時間(すなわち頻度)を選びます。

タイムゾーンを選択してデータのエクスポートを行います。初期設定では、ご利用のローカルタイムゾーンが選択されています。

c. インポートする 新規 columns found in the データ元 dataを希望する場合は、チェックボックスを選択します。

d. 保存をクリックして、データセットのインポートするをスケジュールします。


10)インポートするのスケジュール後、エクスポートするのスケジュールもデータセットに対して設定してください。設定しない場合、インポートするは継続的に完了しますが、エクスポートするが設定されていないとデータが失われる可能性があります。

11)スケジュール後、同じパターンの新規ファイルは、最後に同期した時間を基準に段階的に取得されます。例:テスト-7、テスト-8 などが段階的にインポートされ、通常の間隔でエクスポートされます。

 

 

 ケース2:途中からファイルをインポートする場合 


例えば、FTPローカルパスにファイルが合計10個あります。ユーザーは6番目からファイルをインポートしたいと考えています。増分取得時に特定のファイルからインポートを開始する手順は以下の通りです。


 

インクリメンタルフェッチ中にファイルをインポートするには、以下の手順に従ってください。

 

1) 特定のファイルパターンを使ってファイルをインポートします。
例:テスト-6_csv。csv.*


 

2. 最初は、指定したファイル(テスト-6_csv。csv)のみが取得されます。





同期が正常に完了すると、最後の同期日時が新しい値に更新され、同期時間以降に作成または更新されたファイルがインポートされます。

3. データをインポートした後、今すぐエクスポートオプションをエクスポートメニューからDataPrep Studioページでクリックし、再読み込みする前に必須の保存先へエクスポートしてください。そうしないとデータが失われます。



4. 画面右上のルールセットアイコンをクリックして、DataPrep Studioページでルールセットペインを表示します。




5. Ruleset ペインで、data データ元設定アイコンをクリックします。し、Data データ元 詳細ページを開きます。


6. data データ元 詳細ページで、インポートしたい次のファイルパターンを汎用的に入力します。File pattern項目に入力し、更新するをクリックします。例:テスト-.*





7. データのインポートおよびエクスポートをスケジュールして、パイプラインを設定します。

インポートをスケジュールするには、

a) Schedule インポートするリンクをクリックします。

b) Schedule config セクションで、繰り返し メソッド(頻度'N'時間、頻度 日、週1回、月1回)を選択します。
繰り返しの時間(頻度の設定)を
Perform 頻度 オプションで設定します。


データのエクスポートに使用するタイムゾーン を選択します。初期設定では、ローカルタイムゾーンが選択されています。

c) データ元データで新たに見つかった列をインポートしたい場合は、チェックボックスを選択します。

d) 保存をクリックして、データセットのインポートスケジュールを保存します。



8. インポートするのスケジューリング後、エクスポートするのスケジューリングを行い、データセットのエクスポート先を設定してください。設定しない場合、インポートするは継続的に完了しますが、エクスポートするが行われない場合、データが失われます。

9. スケジューリング後は、同じパターンの新規ファイルが、最後に同期された時間をもとに増分で取得済みとなります。例:テスト-7、テスト-8 など。すべての新規ファイルは増分インポートされ、通常の間隔でエクスポート済みとなります。

 

Notesメモ:データを変更すると、エクスポート先で複製するデータが発生する可能性があります。そのため、データの変更は推奨しておりません。

関連情報

ローカルファイルからデータをインポートする方法

FTPサーバーからデータをインポートする方法

FTPサーバーへデータのエクスポート方法

スケジュールインポートするについての詳細はこちら

スケジュールエクスポートするについての詳細はこちら


    Zoho CRM 管理者向けトレーニング

    「導入したばかりで基本操作や設定に不安がある」、「短期間で集中的に運用開始できる状態にしたい」、「運用を開始しているが再度学び直したい」 といった課題を抱えられているユーザーさまに向けた少人数制のオンライントレーニングです。

    日々の営業活動を効率的に管理し、導入効果を高めるための方法を学びましょう。

    Zoho CRM Training



            Zoho Campaigns Resources

              Zoho WorkDrive Resources




                • Desk Community Learning Series


                • Digest


                • Functions


                • Meetups


                • Kbase


                • Resources


                • Glossary


                • Desk Marketplace


                • MVP Corner


                • Word of the Day


                • Ask the Experts









                                Resources

                                Videos

                                Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.



                                eBooks

                                Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.



                                Webinars

                                Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.



                                CRM Tips

                                Make the most of Zoho CRM with these useful tips.