databridgeの設定

databridgeの設定

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

このページの内容
このページでは、Zoho CreatorでDatabridgeを設定し、アプリケーションを社内ネットワーク内でホストされているサービスやデータベースに接続する方法について説明します。続行する前に、Databridgeの仕組みをご確認ください。
利用条件

1. 前提条件

プライベートネットワークでDatabridgeを設定するには、すべてのシステム要件を満たしていることを確認してください。詳細はこちら

2. Databridgeの詳細

項目

詳細

対応OS

Windows、Mac、Linux

通信モード

アウトバウンド接続

対応コネクター

MySQL、PostgreSQL、Oracle、MS SQL、有効 Zen、SAP Hana。

セキュリティ

暗号化されたメッセージベースの通信


3. Databridgeの設定手順

3.1. Qntrl連携の設定

Databridgeを設定する前に、Zoho Creatorの［システム連携］でQntrlを設定する必要があります。これにより、Creatorとプライベートサービス間の安全な通信が有効になります。
特権管理者は、［Databridge］（［操作］内）からもQntrlを設定できます。

3.2. Databridgeの設定

システム連携でQntrlを設定した後、

  1. ［Databridge］（［操作］内）に移動します。
  2. 一覧から必要なOSとバージョン（たとえば、［macOS - 64ビット］）をクリックします。Databridgeパッケージがzipファイル形式でシステムにダウンロードされます。

    Notesメモ：ダウンロードパッケージにアクセスできるのは15日間のみです。

  1. Databridgeは、社内サービスまたはデータベースにアクセスできるマシンにインストールします。インストールが完了すると、Databridgeの一覧ページに表示されます。

    Info
    ヒント：インストール後、DatabridgeがDatabridgeセクションに表示されていることを確認します。Databridgeが有効であることを確認してください。

3.3. サーバーへのDatabridgeのインストール

Databridgeは、OSやインストールの管理方法に応じて、2種類のパッケージ形式のいずれかでインストールできます。

OS

Zip

Windows

セクション3.3.1

Linux

セクション3.3.2

Mac

セクション3.3.3
Notes
メモ：インストーラーでは、案内付きのUIフローに沿ってプロンプトが表示されます。zip方式は、スクリプトによるデプロイやヘッドレスデプロイに適しており、コマンドラインから実行します。

インストール中に、プロキシ設定、外部Postgres設定、サービスユーザーアカウントの入力を求められます。動作はOS間で共通です。

  • プロキシ設定：サーバーがプロキシ経由でインターネットに接続する場合は、プロキシのユーザー名、パスワード、ホスト、ポートを入力します。それ以外の場合は、この手順をスキップするか、プロキシを無効にします。

  • 外部Postgres設定：Databridgeで外部Postgresデータベースを使用する場合は、そのホスト、ポート、ユーザー名、パスワードを入力します。それ以外の場合は、同梱のPostgresが使用されます。

  • サービスユーザーアカウント：Databridgeの実行に使用する、root以外のローカルユーザーアカウントです。このアカウントには管理者権限を付与せず、事前にサーバー上で作成しておく必要があります。zipインストーラーで求められた時点でユーザーが存在しない場合は、サービスの実行に必要な権限のみを持つユーザーを作成するオプションが表示されます。

3.3.1. zipを使用したWindowsへのインストール（管理者PowerShellのみ）  

  1. CreatorからDatabridgeエージェントのzipをダウンロードします。
  2. 管理者権限のPowerShellウィンドウ（管理者として実行）を開き、エージェントのzipを展開します。

powershell

   Expand-Archive- Force Bridge.zip 'C:\Bridge'

Bridge.zipを、実際にダウンロードしたzipのパスに置き換えてください。 

  1. 管理者権限でインストールスクリプトを実行し、インストールを開始します。

powershell

cmd.exe /c 'C:\Bridge\bin\bridge.bat install'

  1. ［プロキシ設定］プロンプトで、次のいずれかを選択します。

    • ［はい］-プロキシのユーザー名、パスワード、ホスト、ポートを入力してプロキシを設定します。

    • ［いいえ］-プロキシを無効にします。

    • ［スキップ］-プロキシ設定を変更しません。

  1. ［Postgres設定］プロンプトで、次のいずれかを選択します。

    • ［はい］-ホスト、ポート、ユーザー名、パスワードを入力して外部Postgresを設定します。

    • ［いいえ］-外部Postgresを無効にし、同梱のPostgresを使用します。

    • ［スキップ］-Postgres設定を変更しません。

  1. ［サービスユーザー］プロンプトで、システム上のroot以外のユーザー名を入力します。ユーザー名が存在しない場合、ユーザー作成プロンプトで、サービスの実行に必要な権限のみを持つユーザーを作成できます。

  2. Databridgeが正常に起動したことを確認します。

Notesメモ：Windowsでのzipインストールは、管理者権限のPowerShellから実行する必要があります。標準のPowerShellセッションには、必要な権限がありません。 

3.3.2. zipを使用したLinuxへのインストール  

  1. CreatorからDatabridgeエージェントのzipをダウンロードします。
  2. ターミナルを開き、エージェントのzipを展開します。

bash

   sudo unzip-d /Bridge Bridge.zip

Bridge.zipを、実際にダウンロードしたzipのパスに置き換えてください。 

  1. root権限でインストールスクリプトを実行し、インストールを開始します。

bash

   sudo sh/Bridge/bin/bridge.sh install

  1. ［プロキシ設定］プロンプトで、次のいずれかを選択します。

    • はい：プロキシのユーザー名、パスワード、ホスト、ポートを入力して、プロキシを設定します。

    • いいえ：プロキシを無効にします。

    • スキップ：プロキシ設定を変更しません。

  1. Postgres設定のプロンプトで、次のいずれかを選択します。

    • はい：ホスト、ポート、ユーザー名、パスワードを入力して、外部Postgresを設定します。

    • いいえ：外部Postgresを無効にし、同梱のPostgresを使用します。

    • スキップ：Postgres設定を変更しません。

  1. サービスユーザーのプロンプトで、システム上のroot以外のユーザー名を入力します。ユーザー名が存在しない場合は、create-userプロンプトで、サービスの実行に必要な権限のみを持つユーザーを作成できます。

  2. Databridgeが正常に起動したことを確認します。

3.3.3. zipを使用したMacへのインストール  

  1. CreatorからDatabridgeエージェントのzipをダウンロードします。
  2. ターミナルを開き、エージェントのzipを展開します。

bash

    sudo unzip -d /Library/Bridge Bridge.zip

Bridge.zipを、実際にダウンロードしたzipのパスに置き換えます。 

  1. root権限でインストールスクリプトを実行し、インストールを開始します。

bash

   sudo sh/Library/Bridge/bin/bridge.sh install

  1. プロキシ設定のプロンプトで、次のいずれかを選択します。

    • はい：プロキシのユーザー名、パスワード、ホスト、ポートを入力して、プロキシを設定します。

    • いいえ：プロキシを無効にします。

    • スキップ：プロキシ設定を変更しません。

  1. Postgres設定のプロンプトで、次のいずれかを選択します。

    • はい：ホスト、ポート、ユーザー名、パスワードを入力して、外部Postgresを設定します。

    • いいえ：外部Postgresを無効にし、同梱のPostgresを使用します。

    • スキップ：Postgres設定を変更しません。

  1. サービスユーザーのプロンプトで、システム上のroot以外のユーザー名を入力します。ユーザー名が存在しない場合は、create-userプロンプトで、サービスの実行に必要な権限のみを持つユーザーを作成できます。

  2. Databridgeが正常に起動したことを確認します。

3.4. Databridgeのインストール後

  1. Databridgeの一覧ページから、対象のDatabridgeを開きます。Databridgeの詳細ページで、［接続を追加］をクリックします。

  2. プライベートホスト型コネクターの一覧からコネクターを選択し、必要に応じて接続を作成します。

  3. ［マイクロサービス］セクションから、アプリケーションへの接続アクセスを有効にします。

Notesメモ：管理者はDatabridgeと関連する接続を設定します。アプリケーションへのアクセスを許可するには、管理者が［マイクロサービス］セクションに移動し、該当するアプリケーションのアクセスを有効にする必要があります。

設定が完了すると、CreatorアプリケーションからDatabridgeを通じて、プライベートホスト型サービスに安全にアクセスできます。Databridgeの詳細ページの［接続］タブから、さらに接続を追加できます。また、［マイクロサービス］配下の［接続］タブからも追加できます。
Notes

 メモ：

  1. 接続を機能させるには、Databridgeを有効な状態のままにしておく必要があります。無効の場合、アプリケーションは内部システムのデータにアクセスできません。
  2. 1つのアカウントに追加できるDatabridgeは最大20件です。
  3. 同時に有効に接続できるDatabridgeは最大5件です。
  4. Databridgeには、インストール先のマシンからのアウトバウンドインターネット接続が必要です。常時電源が入っている専用サーバーにインストールしてください。マシンがスリープまたは再起動すると、関連するすべてのワークフローが中断されます。

4. Databridgeの管理

Databridgeをインストールすると、［操作］配下の［Databridge］セクションから管理および監視できます。一覧ページには、アカウント内のすべてのDatabridgeと、そのホスト名、ポート、ステータスが表示されます。

4.1. Databridgeの詳細ページ

一覧ページでDatabridgeをクリックすると、詳細ページが開きます。左側の詳細パネルには、次の情報が表示されます。
  • ［ホスト］ - Databridgeがインストールされているサーバーのホスト名です。

  • ［ホストOS］ - ホストサーバーのOS（Windows、Mac OS X、Linux）です。

  • ［ポート］ - Databridgeが待ち受けているポートです。

  • ［最新のポーリング日時］ - CreatorがDatabridgeのポーリングに最後に成功した日時です。

  • ［ステータス］ - 有効またはDownです。

    • 有効 - Databridgeは稼働中でCreatorに接続されており、データ操作を処理できます。

    • Down - Databridgeは現在Creatorから到達できません。サービスが停止している、ホストサーバーがオフラインになっている、またはネットワークの問題がある場合に発生します。

  • ［Databridgeのテスト］ - CreatorとこのDatabridge間のチャネルを検証する［テスト］ボタンです。

  • ［追加者］ - このDatabridgeを追加したユーザーです。

  • ［追加日］ - Databridgeが追加された日付です。

4.1.1. Databridgeのテスト  

詳細パネルの［テスト］ボタン（［Databridgeのテスト］）では、Creatorがセキュアチャネル経由でこのDatabridgeに到達できるかどうかを確認できます。
Databridgeをテストするには、次の手順を実行します。

  1. 一覧ページからDatabridgeを開き、［テスト］（［Databridgeのテスト］）を詳細ページでクリックします。

    • Databridgeは有効です - CreatorはDatabridgeに到達できました。Databridgeはデータ操作を処理できます。

    • DatabridgeはDownです - CreatorはDatabridgeに到達できませんでした。ホストサーバーでDatabridgeサービスが実行されていることを確認し、サーバーからのアウトバウンドネットワーク接続を確認して、 トラブルシューティングの手順を参照してください。

Notesメモ：テストでは、CreatorからDatabridgeへのチャネルのみを検証します。Databridgeと内部サービスまたはデータベース間の接続はテストされません。

4.2 Databridgeでの操作

Databridgeの横にある省略記号（3点）をクリックすると、次の操作を実行できます。

4.2.1. 停止

ステータスが有効の場合、Databridgeを停止できます。
  1. 対象のDatabridgeの横にある省略記号（3点）をクリックします。［停止］をクリックします。

  2. 表示されるポップアップで［Databridgeを停止］をクリックします。

停止すると、DatabridgeのステータスはDownに変わります。Databridgeを停止すると、Creatorアプリケーションを介したプライベートサービスとの通信が中断されます。

4.2.2. 参照元の表示   

Databridgeの参照元を表示するには、次の手順を実行します。
  1. 対象のDatabridgeの横にある省略記号（3点）をクリックします。

  2. ［参照元の表示］をクリックします。このDatabridgeを使用している関連する接続がポップアップに一覧表示されます。

  3. このDatabridgeの使用場所を確認するには、［参照元］をクリックします。アプリケーション内で接続を開くには、［表示］をクリックします。 

4.2.3. 削除

ステータスがDownの場合のみ、Databridgeを削除できます。
  1. 対象のDatabridgeの横にある省略記号（3点）をクリックします。

  2. ポップアップで［削除］をクリックします。その前にこのDatabridgeを参照している一覧表示された接続を確認してください。

Notesメモ：有効な接続があるDatabridgeは削除できません。接続を別のDatabridgeに切り替えるか、それらの接続を削除してから、もう一度お試しください。


5. トラブルシューティング

問題

解決策

Databridgeが表示されない

ホストサーバーでインストールが正常に完了していることを確認します。サービスが実行中であることを確認し、サーバーからインターネットへのアウトバウンド接続が可能であることを確認します。

Databridgeのステータスがダウン

ホストサーバーでDatabridgeサービスを再起動します。サーバーの電源が入っており、ネットワーク上で到達可能であることを確認します。その後、Creatorの［テスト］操作を使用して到達可能性を確認します。

データが読み込まれない

組み込みの［テスト］オプションを使用して接続を確認します。Databridgeのステータスが有効であり、基盤となるサービスまたはデータベースにホストサーバーから到達可能であることを確認します。

6. 注意点

  • Databridgeを使用するには、インストール先のマシンからインターネットへのアウトバウンド接続が可能である必要があります。Databridgeは、常時電源が入っている専用サーバーにインストールしてください。マシンがスリープまたは再起動すると、関連するすべてのワークフローが中断されます。
  • ダウンロードしたDatabridgeパッケージの有効期限は15日間です。

  • 同時にアクティブに接続できるDatabridgeは最大5件です。

7. 用語集

  • Databridge：Zoho Creatorと、非公開でホストされているネットワーク内のデータソースとの間で、安全な通信を可能にする軽量エージェントです。
  • アウトバウンド接続：ネットワーク内から外部サービスに対して開始される接続です。インバウンドのファイアウォールアクセスは不要です。

8. 関連リンク