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

1. 前提条件

2. Databridgeの詳細

3. Databridgeの設定手順

3.1.  Qntrl連携の設定

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

3.2. Databridgeの設定 

1. ［Databridge］（［運用］）に移動します。
   
2. 一覧から必要なOSとバージョン（例：macOS - 64ビット）をクリックします。Databridgeパッケージがzipファイル形式でシステムにダウンロードされます。Databridgeのインストール手順に従って社内サービスやデータベースにアクセスできるマシンにインストールします。

   
   

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

3. インストールが完了すると、Databridgeは［Databridge］セクションの一覧ページに追加されます。
   
   
   
   

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

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

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

メモ：インストーラーでは、画面の案内に従って操作できます。zip方式は、スクリプトによる導入やヘッドレス環境での導入に適しており、コマンドラインから実行します。

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

• プロキシ設定：サーバーがプロキシ経由でインターネットに接続する場合は、プロキシのユーザー名、パスワード、ホスト、ポートを入力します。それ以外の場合は、この手順をスキップするか、プロキシを無効にします。
• 外部Postgres設定：Databridgeで外部Postgresデータベースを使用する場合は、そのホスト、ポート、ユーザー名、パスワードを入力します。それ以外の場合は、同梱のPostgresが使用されます。
• サービスユーザーアカウント：Databridgeを実行する非rootのローカルユーザーアカウントです。このアカウントには管理者権限を付与せず、事前にサーバー上で作成しておく必要があります。zipインストーラーで入力を求められた時点でユーザーが存在しない場合は、サービスの実行に必要な権限のみを持つユーザーを作成できます。

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

1. CreatorからDatabridgeエージェントのzipをダウンロードします。
   
2. 管理者権限のPowerShellウィンドウを開き（［管理者として実行］）、エージェントのzipを展開します。
   # エージェントのzipを展開 Expand-Archive-Force Bridge.zip 'C:\Bridge'

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

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

# インストールスクリプトを実行cmd.exe /c 'C:\Bridge\bin\bridge.bat install'

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

• ［はい］ - プロキシのユーザー名、パスワード、ホスト、ポートを入力してプロキシを設定します。
• ［いいえ］ - プロキシを無効にします。
• ［スキップ］ - プロキシ設定を変更しません。

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

• ［はい］ - ホスト、ポート、ユーザー名、パスワードを入力して外部Postgresを設定します。
• ［いいえ］ - 外部Postgresを無効にし、同梱のPostgresを使用します。
• ［スキップ］ - Postgres設定を変更しません。

6. ［サービスユーザー］のプロンプトで、システム上の非rootユーザー名を入力します。ユーザー名が存在しない場合は、ユーザー作成プロンプトで、サービスの実行に必要な権限のみを持つユーザーを作成できます。
7. Databridgeが正常に起動したことを確認します。
   

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

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

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

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

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

# インストールスクリプトを実行 sudo sh/Bridge/bin/bridge.sh install

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

• ［はい］ - プロキシのユーザー名、パスワード、ホスト、ポートを入力してプロキシを設定します。
• ［いいえ］ - プロキシを無効にします。
• ［スキップ］ - プロキシ設定を変更しません。

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

• ［Yes］ - ホスト、ポート、ユーザー名、パスワードを入力して、外部Postgresを設定します。
• ［No］ - 外部Postgresを無効にし、バンドル版Postgresを使用します。
• ［Skip］ - Postgres設定を変更しません。

6. ［サービスユーザー］のプロンプトで、システム上のroot以外のユーザー名を入力します。ユーザー名が存在しない場合は、［create-user］プロンプトで、サービスの実行に必要な権限のみを持つユーザーを作成できます。
7. Databridgeが正常に起動したことを確認します。

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

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

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

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

# インストールスクリプトを実行 sudo sh/Library/Bridge/bin/bridge.sh install

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

• ［Yes］ - プロキシのユーザー名、パスワード、ホスト、ポートを入力して、プロキシを設定します。
• ［No］ - プロキシを無効にします。
• ［Skip］ - プロキシ設定を変更しません。

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

• ［Yes］ - ホスト、ポート、ユーザー名、パスワードを入力して、外部Postgresを設定します。
• ［No］ - 外部Postgresを無効にし、バンドル版Postgresを使用します。
• ［Skip］ - Postgres設定を変更しません。

6. ［サービスユーザー］のプロンプトで、システム上のroot以外のユーザー名を入力します。ユーザー名が存在しない場合は、［create-user］プロンプトで、サービスの実行に必要な権限のみを持つユーザーを作成できます。
7. Databridgeが正常に起動したことを確認します。
   

3.4. Databridge のインストール後

1. Creatorアカウントで［操作］の［Databridge］に移動します。一覧から必要なDatabridgeをクリックして開きます。
   
2. Databridge詳細ページで、［接続を追加］をクリックします。
   
3. プライベートホスト型コネクターの一覧からコネクターを選択し、必要に応じて接続を作成します。コネクターの一覧は、プライベートホスト型コネクターのみが表示されるように事前に絞り込まれます。
   
4. 
   
   接続を追加ポップアップでは、Databridgeが自動的に選択されます。残りの詳細を入力して必要な設定を完了し、［作成して認証］をクリックします。接続の作成と認証の詳細はこちら
   
   
5. アカウントのリンクポップアップが表示されます。ユーザー名、パスワード、ホスト、ポート、サービス名を入力します。［認証］をクリックして接続を完了します。
   
6. 作成したプライベートホスト型コネクターについて、［マイクロサービス］セクションでアプリケーションからの接続アクセスを有効にします。
   
   

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

 メモ：

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

4. Databridgeの管理

4.1. Databridge詳細ページ

• ［ホスト］- Databridgeがインストールされているサーバーのホスト名です。
  
• ［ホストOS］- ホストサーバーのオペレーティングシステム（Windows、Mac OS X、Linux）です。
• ［ポート］- Databridgeがリッスンしているポートです。
• ［最新のポーリング時刻］- CreatorがDatabridgeのポーリングに最後に成功した時刻です。
• ［ステータス］- 有効またはDownです。
  

• 有効- Databridgeが起動し、Creatorに接続されており、データ操作を処理できる状態です。
  
• Down- 現在、CreatorからDatabridgeに到達できません。サービスが停止している、ホストサーバーがオフラインになっている、またはネットワークの問題がある場合に発生します。
  

• ［Databridgeをテスト］- CreatorとこのDatabridge間のチャネルを検証する［テスト］ボタンです。
• ［追加者］- このDatabridgeを追加したユーザーです。
• ［追加日］- Databridgeが追加された日付です。

4.1.1. Databridgeのテスト  

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

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

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

4.2 Databridgeでの操作

• ［停止］
  
• ［参照の表示］
• ［削除とアンインストール］
  

4.2.1. 停止

1. 対象のDatabridgeの横にある省略記号（3点）をクリックし、［停止］をクリックします。
   
2. 続いて表示されるポップアップで［Databridgeを停止］をクリックします。
   

4.2.2. 参照の表示   

1. 対象のDatabridgeの横にある省略記号（3点）をクリックします。
   

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

3. ［参照］をクリックして、Databridgeが使用されている場所を確認します。［表示］をクリックすると、アプリケーション内で接続が開きます。

4.2.3. 削除とアンインストール

1. 対象のDatabridgeの横にある省略記号（3点）をクリックします。
   

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

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

Databridgeのアンインストール

1. 管理者権限のPowerShellを開きます。
2. Databridgeを停止します：cmd.exe /c 'C:\Bridge\bin\bridge.bat' stop
3. Databridgeサービスをアンインストールします：cmd.exe /c 'C:\Bridge\bin\bridge.bat' uninstall
4. Databridgeファイルを削除します：Remove-Item 'C:\Bridge' -Force -Recurse
   

1. ターミナルを開きます。
   
2. 次のコマンドでBridgeを停止します：sudo sh /Library/Bridge/bin/bridge.sh stop
   
3. 次のコマンドでBridgeサービスをアンインストールします：sudo sh /Library/Bridge/bin/bridge.sh uninstall

4. 次のコマンドで、システムからBridgeファイルを削除します：sudo rm -rf /Library/Bridge
   

1. ターミナルを開きます。
   
2. 次のコマンドでBridgeを停止します：sudo sh /Library/Bridge/bin/bridge.sh stop
   
3. 次のコマンドでBridgeサービスをアンインストールします：sudo sh /Library/Bridge/bin/bridge.sh uninstall

4. 次のコマンドで、システムからBridgeファイルを削除します：sudo rm -rf /Bridge

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

6. 注意事項

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

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

7. 用語集

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

8. 関連リンク

• Databridgeについて
  
• 接続について
  
• 接続の作成と認証