• 日本語

      • Doris

      Data source: External DorisEnterprise Edition+

      概要

      Doris は外部データベースとして NocoBase に接続できます。接続すると、NocoBase は Doris 内のテーブル、フィールド、ビューを読み取り、外部データソース内のデータテーブルとして使用できます。

      Doris は、分析クエリ、ワイドテーブルの明細データ、指標集計、レポート表示に適しています。トランザクション型データベースとは異なり、NocoBase で業務レコードを頻繁に追加、編集、削除するデータソースとしては適していません。

      設定項目説明
      対応バージョンDoris >= 2.1.0。
      商用版Enterprise Edition に対応しています。
      対応プラグイン@nocobase/plugin-data-source-external-doris。
      接続方式Doris の MySQL 互換ポート、つまり FE query_port を使用します。
      利用上の推奨主に表示、絞り込み、集計、レポート表示に使用します。

      外部 Doris の利用に適したシーン：

      • データウェアハウスの明細テーブル、集計テーブル、ワイドテーブル、指標テーブルを接続する
      • NocoBase で運用ダッシュボード、統計レポート、検索ページを構築する
      • 業務担当者に読み取り専用の検索入口を提供し、データベースクライアントへの直接アクセスを減らす
      • 既存の Doris データに対して権限制御と可視化表示を行う
      注意

      NocoBase では、Doris を読み取り専用の分析データソースとして使用することを推奨します。通常の業務テーブルへの書き込みデータソースとして使用せず、ページ上で追加、編集、削除などの操作を設定することも推奨しません。

      プラグインのインストール

      このプラグインは商用プラグインです。詳しい有効化方法については、商用プラグインの有効化ガイドを参照してください。

      データソースの追加

      「データソース管理」で「Add new」をクリックし、Doris を選択して接続情報を入力します。 20260709211333

      一般的な接続設定は次のとおりです：

      設定説明
      Data source nameページブロック、権限、ワークフロー、API から参照するためのデータソース識別名です。作成後は変更できません。
      Data source display name画面に表示されるデータソース名です。「Doris データウェアハウス」「指標データベース」など、業務担当者が理解しやすい名前を使用することを推奨します。
      Host / PortDoris FE のアドレスと MySQL 互換ポート、つまり query_port です。HTTP ポートは入力しないでください。
      Database接続する Doris database の名前です。
      Username / PasswordDoris への接続に使用するアカウントとパスワードです。NocoBase はこのアカウントがアクセス権を持つオブジェクトのみ読み取ることができ、他のアカウントの非公開オブジェクトに権限を付与したり、読み取ったりすることはありません。
      Table prefixテーブル名のプレフィックスです。設定すると、NocoBase はこのプレフィックスに一致するテーブルのみを読み取り、NocoBase ではプレフィックスを除いたテーブル名を生成します。
      Enabled the data sourceこのデータソースを有効にするかどうかを指定します。無効にするとデータソースの設定は保持されますが、ページブロック、権限、ワークフロー、API からそのデータを読み取れなくなります。
      ヒント

      Doris プラグインは MySQL 互換プロトコルを使用して接続します。設定する前に、Doris FE の query_port に NocoBase からアクセスでき、アカウントに対象の database、table、column のメタデータを読み取る権限があることを確認してください。

      接続範囲

      Doris の画面には「Collections」のテーブル選択欄はありません。接続範囲は主に Database、接続アカウントの権限、Table prefix によって制御されます。

      Doris にテーブルが多数ある場合は、NocoBase 専用の database、アカウント、またはテーブルプレフィックスをあらかじめ用意し、現在のアプリケーションで表示・集計する必要があるテーブルのみを公開することを推奨します。

      注意

      1 つの外部データソースで一度に接続できるデータテーブルまたはビューは最大 500 個です。Doris 内のオブジェクトが多い場合は、database、アカウント権限、または Table prefix によって範囲をあらかじめ絞り込むことを推奨します。

      フィールドの同期と設定

      外部 Doris のテーブル構造はデータベース側で管理されます。NocoBase は外部 Doris にフィールドを作成したり、フィールド型を変更したり、実際のフィールドを削除したりしません。

      Doris 側でテーブル構造が変更された場合は、データソースで「Sync from database」を実行して、テーブルとフィールドのメタデータを再読み込みできます。同期によって、NocoBase に保存されているデータテーブル、フィールド、主キー、ユニークキー、フィールド型のマッピング情報が更新されますが、Doris 内の実際のテーブルやデータが削除されることはありません。

      フィールドの同期後、NocoBase でフィールドタイトル、フィールドタイプ（Field type）、フィールドコンポーネント（Field interface）を設定できます。NocoBase のリレーションフィールドを作成する場合も、NocoBase にリレーションメタデータが保存されるだけで、Doris のテーブルに実際の外部キーフィールドが自動的に追加されることはありません。

      フィールドタイプのマッピング

      NocoBase は、MySQL 互換のロジックと Doris 固有の型に基づいて、Doris のフィールドタイプを適切な Field type と Field interface にマッピングします。フィールド設定で画面上の表示方法を調整できます。

      一般的なマッピングは次のとおりです：

      Doris フィールドタイプNocoBase Field type選択可能な Field interface
      TINYINT、SMALLINTinteger、boolean、sortInteger、Sort、Checkbox、Switch、Select、Radio group。
      INT、INTEGERinteger、unixTimestamp、sortInteger、Sort、Unix timestamp、Select、Radio group。
      BIGINTbigInt、unixTimestamp、sortInteger、Sort、Unix timestamp、Created at、Updated at。
      LARGEINTbigIntInteger。
      FLOATfloat、sortNumber、Percent、Sort。
      DOUBLEdouble、sortNumber、Percent、Sort。
      DECIMAL、DECIMALV3decimalNumber、Percent、Currency。
      BOOLEANbooleanCheckbox、Switch。
      CHARstringInput、Email、Phone。
      VARCHARstring、uuid、nanoid、encryptionInput、Email、Phone、Password、Color、Icon、Select、Radio group、UUID、Nano ID。
      TEXT、STRINGtextTextarea、Markdown、Vditor、Rich text、URL。
      DATE、DATEV2dateDate。
      DATETIME、DATETIMEV2datetimeDate、Time、Created at、Updated at。
      JSON、JSONBjsonJSON。
      HLL、BITMAP、QUANTILE_STATE、AGG_STATEjsonJSON。
      VARIANT、ARRAY、MAP、STRUCTjsonJSON。
      IPV4、IPV6stringInput。

      VARIANT は Apache Doris 2.1.0 以降で提供される動的型です。2.1.0 未満の Doris を使用している場合、このタイプのフィールドは接続できません。

      注意

      Doris の集約状態型、半構造化型、複合型は、表示やデバッグには適していますが、フォーム入力フィールドとして適しているとは限りません。複合型を使用する場合は、Doris 側で業務上の閲覧に適したビューまたは明細テーブルを用意してから、NocoBase に接続することを推奨します。

      主キーとレコードの一意識別子

      Doris のデータモデルやキー model は、必ずしも業務上の一意識別子と一致するとは限りません。ページブロックで表示するデータテーブルについては、レコードを一意に特定できるフィールドを用意することを推奨します。

      一意のフィールドを持たないテーブルまたはビューを接続する場合は、データテーブルの設定で「Record unique key」を手動で設定する必要があります。利用可能な一意識別子がない場合、ページブロックでレコードの詳細を正しく表示できない可能性があり、編集や削除操作の設定にも適していません。

      20260709211439 20260709211454

      関連リンク