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

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種類のパッケージ形式のいずれかを使用してインストールできます。

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

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

• プロキシ設定：サーバーがプロキシ経由でインターネットに接続する場合は、プロキシのユーザー名、パスワード、ホスト、ポートを入力します。それ以外の場合は、この手順をスキップするか、プロキシを無効にします。
• 外部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設定」プロンプトで、次のいずれかを選択します。

• ［はい］ - ホスト、ポート、ユーザー名、パスワードを入力して外部Postgresを設定します。
• ［いいえ］ - 外部Postgresを無効にし、バンドル版Postgresを使用します。
• ［スキップ］ - 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. 「プロキシ設定」プロンプトで、次のいずれかを選択します。

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

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

• ［はい］ - ホスト、ポート、ユーザー名、パスワードを入力して外部Postgresを設定します。
• ［いいえ］ - 外部Postgresを無効にし、バンドル版Postgresを使用します。
• ［スキップ］ - 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には、インストール先のマシンからのアウトバウンドインターネット接続が必要です。常時電源が入っている専用サーバーにインストールしてください。マシンがスリープまたは再起動すると、関連するすべてのワークフローが中断されます。
   

4. Databridgeの管理

4.1. Databridgeの詳細ページ

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

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

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

4.1.1. Databridgeのテスト  

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

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

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

4.2 Databridgeでの操作

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

4.2.1. 停止

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

4.2.2. 参照の表示   

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

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

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

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

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

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. 注意事項

• データブリッジをインストールしたマシンからインターネットへのアウトバウンド接続が必要です。電源が常に入っている専用サーバーにインストールしてください。マシンがスリープまたは再起動すると、関連するすべてのワークフローが中断されます。
  
• ダウンロードしたデータブリッジパッケージの有効期限は15日間です。
• 一度に有効に接続できるデータブリッジは最大5つです。
  
• データソースを正しく動作させるには、データベースコネクターで、データ識別子として使用する自動増分項目が必要です。

• データブリッジ：プライベートにホストされたネットワーク内のデータソースとZoho Creator間で安全な通信を可能にする軽量エージェントです。
  
• アウトバウンド接続：アウトバウンド接続は、ネットワーク内から外部サービスに対して開始される接続であり、ファイアウォールで受信アクセスを許可する必要がありません。
  

8. 関連リンク

• データブリッジについて
  
• 接続について
  
• 接続の作成と認証