MacOSにおけるZohoデータブリッジのインストール

MacOSにおけるZohoデータブリッジのインストール

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

Zoho Databridgeは、オンプレミスのデータ元とZohoアプリケーションを接続し、データをインポートするための軽量かつ独立したユーティリティです。つまり、内部ネットワーク内のローカルファイルやローカルデータベースを、迅速かつ安全にZohoアプリケーションへ転送することが可能です。


Zoho DataPrepでは、Zoho Databridgeを使用して、ローカルデータベース（MySQL、MS SQL Server、Oracle、PostgreSQLなど）からデータのインポートを有効にできます。また、FTPサーバーやローカルファイルからも、段階的にデータをインポートすることが可能です。

Zoho Databridgeは、お客様のローカルネットワークからZoho DataPrepへのデータ転送のみを行います。ローカルネットワークへデータを戻すことはなく、セキュリティ上のリスクもありません。



Databridgeのダウンロードとネットワークへの追加


下記の手順に従い、ローカルマシンにDatabridgeをインストールしてください。

前提条件


Mac

RAM - 3GB

ディスク空き容量 - 最低3GB

Processor 種類 - 64ビット

処理速度 - 64ビット

動作確認済みバージョン - macOS Sonoma バージョン 14.3.1

パッケージ配布形式 - .appファイル内にJRE、JavaFXランタイム、JAR、lib、設定ファイルが含まれます


Databridgeインストーラーのダウンロード

a) インポートする 設定から:

インポートする 設定からDatabridgeインストーラーをダウンロードできます。

1. Databases または クリック Files または FTP を選択する a Datasourceボックスから選択し、インポートする from local networkトグルを有効にします。Databridge がまだインストールされていない場合は、Databridge の紹介画面が表示されます。


2. ダウンロードするボタンをクリックして、ダウンロードするZoho Databridgeページへリダイレクトされます。

DatabridgeをインストールするマシンのOSに応じて、Macインストーラーをダウンロードしてください。

US、IN、JP、EU、AU、CA、SA データセンター:


  MacOS用Databridgeインストーラー

      

CN データセンター:

      MacOS用Databridgeインストーラー




Notes
メモ:
既にDatabridgeがインストールされていて、それが無効になっている場合は、データベースのインポート設定ページまたはFTPやファイルのローカルネットワークからインポート画面のDatabridgeドロップダウンで追加する Databridgeボタンをクリックすることで、新規Databridgeを追加できます。


b) 設定ページから:

Databridgeインストーラーは設定ページからもダウンロード可能です。

1. 設定ページで、サイドパネルからDatabridgeを選択し、追加する Databridgeをクリックして新しいdatabridgeを追加します。





2. Databridge をインストールするマシンのOSに応じて、Macインストーラーをダウンロードしてください。

US、IN、JP、EU、AU、CA、SA DC：


             MacOS 用 Databridge インストーラー


CN DC：

    

         MacOS 用 Databridge インストーラー




MacOS向け特別手順

以下の手順に従って、MacOSにDatabridgeをインストールしてください。

  1. 下記リンクのいずれかをクリックして、Databridgeインストーラーをダウンロードします。

    Databridgeインストーラー - US、IN、JP、EU、AU DC向け
    Databridgeインストーラー - CN DC向け

  2. 郵便番号ファイルを標準の場所にあるフォルダーに解凍します。

  3. フォルダーを右クリックし、新規ターミナルをフォルダーで開くを選択、またはターミナルでcdコマンドを使用してDatabridgeフォルダーの場所に移動し、下記コマンドを入力します。
     

chmod +x ZohoDatabridge.app/Contents/MacOS/ZohoDatabridge


  1. 抽出したファイルを開きます。下図のようなポップアップが表示されます。



  2. 「キャンセルする」をクリックします。

  3. System 各種設定 -> Security & Privacy -> 一般 に移動し、「開く Anyway」をクリックします。




  4. 下図のようなポップアップが表示されます。




  5. 「開く」をクリックすると、Zoho Databridge 設定が開きます。


ネットワークにおける Databridge のインストール



Notes

メモ:

1. Databridge を常時オンかつインターネット接続済みのコンピューターにインストールしてください。データ転送の速度と信頼性を高めるため、有線ネットワークの利用が標準です。
2. データベースに必須となるJDBC jarファイルは、'~Zoho Databridge 2.0/lib/jars/<.jar>' フォルダに配置してください。


MacOS システムに Databridge をインストールする手順:


  1. databridge*.dmg（MacOS用）をダブルクリックしてインストールウィザードを起動します。

  2. 「次」をクリックして、Zoho Databridge のインストールを開始します。



  3. ライセンス Agreement 条件を読み、承認し、次へをクリックします。



  4. Databridge を初期設定フォルダーにインストールするか、アプリケーションをインストールしたいフォルダーを選択し、
    次へ。

    Info情報: また、復元する 初期設定 Folder オプションを使用して、場所を初期設定フォルダーにリセットすることもできます。




  1. プロキシサーバーを使用する場合は、使用する Proxy Server チェックボックスを選択し、次へをクリックします。



  2. 「Proxy Server ホスト名」、「Proxy server ポート番号」、「ユーザー名」、「パスワード」を入力し、「次へ」をクリックします。



  3. 「Pre-Installation 概要」で構成内容を確認し、「Install」をクリックして続行します。



  4. インストールが完了したら、Zoho Databridge を開始できます。「完了」をクリックして設定を終了します。



  5. 認証手順：

    次の画面が表示されます。URLをコピーし、ブラウザに貼り付けてください。



  6. Zohoアカウントのサインインページにリダイレクトされます。アカウントにサインインしてください。

  7. 次に、Allowをクリックして、Zoho DatabridgeがZohoアカウント内の詳細へアクセスすることを許可します。



    認証が正常に完了したら、認証画面に戻ることができ、ZohoアカウントでZoho Databridgeにログインできます。

  8. 既存の組織ポータルのいずれかを選択してください。



  9. Databridge に 名前 を入力し、Databridge 名前欄に入力後、設定をクリックします。



  10. 設定が完了し、Databridge を使用できる状態になりました。システム再起動時に Databridge を自動開始のチェックボックスが選択されていることを確認してください。 完了をクリックします。



  11. 概要セクションには、Databridge 名前、ステータス、稼働時間、最終起動日時などの詳細が表示されます。



  12. Zoho Databridge のインストールが完了し、Zohoアカウントに登録されました。


Notesメモ: インポートする設定のDatabridgeドロップダウン、または設定メニューのDatabridgeセクションを表示することで、できることや認証状況を確認できます。


Databridge を開始する方法


Databridge が自動的に開始されない場合は、以下のコマンドを入力して Databridge を再開してください。


1. Zoho Databridge2.0 フォルダを右クリックし、ターミナルで開くを選択するか、以下の 'cd' コマンドを使用してターミナルで Zoho Databridge2.0 フォルダへ移動してください。

Quote
cd Zoho Databridge2.0/


2) Databridge をインストールした場所で、以下のコマンドをターミナルに入力し、MacOS で Databridge を再開します。

Quote
sh StartServer.sh

Databridge を停止する方法


1. Zoho Databridge2.0フォルダをRight-クリックし、ターミナルで開くを選択、または下記の 'cd' コマンドを使用してターミナルでZoho Databridge2.0フォルダに移動します。

Quote
cd Zoho Databridge2.0/

2）ターミナルでDatabridgeのインストール場所から、下記コマンドを入力してMacOS上のdatabridgeを停止します。


Quote
sh StopServer.sh -force



Databridgeインストーラーリンク


US、IN、JP、EU、AU DC:


       MacOS用Databridgeインストーラー

       

      

CN DC:


     MacOS用Databridgeインストーラー



トラブルシューティング - よくある質問


1. Databridgeが正常に動作しません。Zoho Databridgeを再インストールする方法を教えてください。

以前に同じマシンにZoho Databridgeをインストールしていた場合は、完全にアンインストールし、既存バージョンを削除してください。その後、新しくダウンロードしたDatabridgeパッケージのインストールを続行できます。


2. MacでDatabridgeをアンインストールする方法

Databridgeをアンインストールするには、まずDatabridgeを閉じてから、マシン内のZoho Databridge2.0フォルダーを削除してください。



3. Zoho AnalyticsからDatabridgeをインストールしましたが、Zoho DataPrepでも同じものを使用できますか？

いいえ、Zoho DataPrep専用のアプリケーションがあります。DataPrepにはZoho Databridge 2.0をご使用ください。


4. Databridgeが無効の場合はどうすればよいですか？


Databridgeが無効な場合は、再開することができます。



5. Mac OSでDatabridgeを再開する方法


1) Zoho Databridgeを終了します。


2) Zoho Databridge2.0フォルダを右クリックし、Terminalで開くを選択します。もしくは、下記の「cd」コマンドを使ってターミナルからDatabridgeフォルダの場所に移動します。
Quote
cd Zoho Databridge2.0/


3) 下記のコマンドを入力してDatabridgeを再開します。


Quote
sh StartServer.sh




6. Zoho DatabridgeがMacで再開することができませんか？


エンドユーザー監視エージェントがすでに実行中の場合、Zoho Databridgeは再開しません。その場合はDatabridgeを停止し、以下の手順で再度開始してください。

1. Zoho Databridge2.0フォルダを右クリックし、Terminalで開くを選択します。または、下記の「cd」コマンドを使ってターミナルでDatabridgeフォルダの場所へ移動します。

Quote
cd Zoho Databridge2.0/



2. 下記のコマンドを入力してDatabridgeを停止します:

Quote
sh StopServer.sh -force



3. 下記のコマンドを使用してDatabridgeを再開してください。 コマンドです。

Quote
sh StartServer.sh


7. Macでマシンを再起動した後にDatabridgeが開始しない場合はどうすればよいですか？


Databridgeが自動的に再開しない場合、

1. Zoho Databridge2.0フォルダを右クリックし、ターミナルで開くを選択、または下記の 'cd ' コマンドを使いターミナルでDatabridgeフォルダの場所へ移動してください。

Quote
cd Zoho Databridge2.0/



2. できること 手動で下記のコマンドを入力して再開します。

Quote
sh StartServer.sh


8. システムに既にZoho DataPrep Databridgeが存在している場合、Zoho Analytics Databridgeをインストールできますか？

はい、Zoho DataPrep Databridgeと併用してZoho Analytics Databridgeをシステムにインストールできます。


9. Zoho AnalyticsとZoho DataPrep Databridgeを同時に実行できますか？

はい、両方のZoho AnalyticsおよびDataPrep Databridgeを同時に実行できます。


10. Zoho DataPrep用に1台のマシンに複数のZoho Databridgeをインストールできますか？

いいえ、DataPrep組織用に1台のマシンには1つのDatabridgeのみインストールできます。ただし、1つの組織に対して複数のマシンにDatabridgeをインストールすることは可能です。


11. DataPrep 組織からDatabridgeを削除する方法

設定ページでDatabridgesをクリックします。削除アイコンをクリックすると、組織からdatabridgeが完全に削除されます。また、ご利用のマシンからZoho Databridge2.0フォルダーも削除してください。


12. Zoho Databridgeとデータベースの接続問題の解決方法

UI上で適切なエラーを表示し、ユーザーがエラーの種類を把握できるようにしています。ただし、接続に関する問題のデバッグには、Databridgeのインストールフォルダにあるログを活用しています。これにより、どのような問題でデータベースへの接続が妨げられているかを把握できます。しかし、最終的なユーザーにとっては内容が分かりにくい場合もあります。


不明なエラーが発生した場合は、'~/ZohoDatabridge2.0/logs'内にあるログを添付の上、サポート@zohodataprep.comまでご連絡ください。


テストを簡単にするもう一つの方法は、Databridgeと同じマシン上でデータベースクライアントツールを使用し、データベースへ接続してみることです。これにより、問題がデータベースへの接続にあるのか、Databridge自体にあるのかを確認できます。


13. ログおよび設定ファイルの保存場所はどこですか？

Zoho Databridge をインストールしたフォルダーに移動してください。ZohoDatabridge2.0フォルダー内にログファイルおよび設定ファイルが保存されています。

~/ZohoDatabridge2.0/logs/ - ログファイル

~/ZohoDatabridge2.0/conf/ - serveragent.config ファイル

下記のスクリーンショットもご参照ください。
MacOS


Windows OS


Linux OS


関連情報

サイレントインストールの実行方法

Databridgeとは何か、およびDatabridgeを使ってWindowsでデータをインポートする方法

Databridgeとは何か、およびDatabridgeを使ってLinuxでデータをインポートする方法

Databridge を使ってローカルデータベースからデータをインポートする

Databridgeの管理