• 日本語

      • MSSQL

      Data source: External SQL ServerStandard Edition+

      概要

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

      メインデータベースとは異なり、外部MSSQLの実際のテーブル構造は、元の業務システム、データベースクライアント、またはマイグレーションスクリプトによって引き続き管理されます。NocoBaseは、構造の読み取り、フィールドメタデータの保存、ページブロック、権限、ワークフロー、APIの設定を担当します。

      設定項目説明
      対応バージョンSQL Server 2014～2019。
      商用版スタンダード版、プロフェッショナル版、エンタープライズ版に対応しています。
      対応プラグイン@nocobase/plugin-data-source-external-mssql。
      接続機能「Encrypt connection」と「Trust server certificate」の設定に対応しています。

      外部MSSQLの利用に適したシナリオ：

      • 既存のERP、MES、WMS、CRMなどの業務システムのSQL Serverデータベースを接続する
      • 履歴データを移行せずに、NocoBaseで管理画面を構築する
      • 既存のテーブルに対して、権限制御、ワークフロー処理、データ修正、レポート表示を行う
      • データベース構造をDBA、マイグレーションスクリプト、または元のシステムで引き続き管理する
      注意

      外部MSSQLはNocoBaseのシステムデータベースではありません。NocoBaseがバックアップ、リストア、マイグレーション、テーブル構造の変更を管理することはありません。

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

      このプラグインは商用プラグインです。詳しいアクティベーション方法については、商用プラグインのアクティベーションガイドを参照してください。

      データソースの追加

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

      20260709210022

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

      設定説明
      Data source nameページブロック、権限、ワークフロー、APIで参照するデータソースの識別名です。作成後は変更できません。
      Data source display name画面に表示されるデータソース名です。たとえば「ERP SQL Server」「財務DB」のように、業務担当者が理解しやすい名前を使用することをおすすめします。
      Host / PortSQL Serverのホストアドレスとポートです。デフォルトポートは通常1433です。
      Database接続するSQL Serverデータベースの名前です。
      Username / PasswordSQL Serverへの接続に使用するアカウントとパスワードです。NocoBaseは、このアカウントにアクセス権限があるオブジェクトのみ読み取ることができ、他のアカウントの非公開オブジェクトに権限を付与したり、読み取ったりすることはありません。
      Table prefixテーブル名のプレフィックスです。設定すると、NocoBaseはこのプレフィックスに一致するテーブルとビューのみを読み取り、NocoBase内ではプレフィックスを除いたデータテーブル名を生成します。
      Encrypt connection暗号化接続を有効にするかどうかを指定します。データベースで暗号化が必須となっている場合や、ネットワーク経路の暗号化が必要な場合に有効にします。
      Trust server certificateサーバー証明書を信頼するかどうかを指定します。テスト環境や自己署名証明書の環境では有効にする必要がある場合があります。本番環境では信頼された証明書を使用することをおすすめします。
      Collections / Add all collections接続範囲を制御します。「Add all collections」を有効にすると、NocoBaseは現在の範囲内にあるすべてのテーブルとビューを接続します。無効にすると、「Collections」で選択したオブジェクトのみを接続します。
      Enabled the data sourceこのデータソースを有効にするかどうかを指定します。無効にすると、データソースの設定は保持されますが、ページブロック、権限、ワークフロー、APIからデータを読み取れなくなります。
      ヒント

      SQL Server内のオブジェクトが多い場合は、Database、Table prefix、「Collections」を使用して、あらかじめ範囲を絞り込んでください。現在のアプリケーションで使用するテーブルとビューのみを接続すると、その後の権限設定、ページ構築、同期メンテナンスが容易になります。

      データテーブルの選択

      接続情報を入力した後、「Load Collections」をクリックすると、SQL Serverで利用可能なデータテーブルとビューを読み込めます。読み込み結果は、接続アカウント、Database、Table prefix、「Collections」の設定に影響されます。

      デフォルトでは「Add all collections」が有効になっており、現在の範囲内にあるすべてのテーブルとビューを接続します。一部のオブジェクトのみを接続する場合は、「Add all collections」を無効にして、リストから必要なデータテーブルまたはビューを選択してください。

      add_new_database_configure_load_collection

      注意

      1つの外部データソースで一度に接続できるデータテーブルまたはビューは、最大500個です。SQL Server内のオブジェクトが多い場合は、Database、Table prefix、または「Collections」を使用して、あらかじめ範囲を絞り込むことをおすすめします。

      フィールドの同期と設定

      外部MSSQLのテーブル構造は、データベース側で管理されます。NocoBaseが外部SQL Server内にフィールドを作成したり、フィールドタイプを変更したり、実際のフィールドを削除したりすることはありません。

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

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

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

      NocoBaseは、SQL Serverのフィールドタイプに基づいて、適切なField typeとField interfaceに自動的にマッピングします。フィールド設定で画面上の表示方法を調整できます。

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

      SQL Server フィールドタイプNocoBase Field type選択可能な Field interface
      BITbitCheckbox、Switch。
      TINYINT、SMALLINTinteger、boolean、sortInteger、Sort、Checkbox、Switch、Select、Radio group。
      INTinteger、unixTimestamp、sortInteger、Sort、Unix timestamp、Select、Radio group。
      BIGINTbigInt、unixTimestamp、sortInteger、Sort、Unix timestamp、Created at、Updated at。
      DECIMAL、MONEY、SMALLMONEYdecimalNumber、Percent、Currency。
      NUMERIC、FLOAT、REALfloatNumber、Percent。
      CHAR、VARCHAR、NCHAR、NVARCHARstring、uuid、nanoidInput、Email、Phone、Password、Color、Icon、Select、Radio group、UUID、Nano ID。
      TEXT、NTEXTtextTextarea、Markdown、Vditor、Rich text、URL。
      DATEdateOnlyDate。
      TIMEtimeTime。
      DATETIME、DATETIME2datetimeNoTzDate、Time、Created at、Updated at。
      DATETIMEOFFSETdatetimeTzDate、Time、Created at、Updated at。
      UNIQUEIDENTIFIERuuid、stringUUID、Input。
      JSONjson、arrayJSON。
      注意

      サポートされていないSQL Serverフィールドタイプは、フィールド設定に個別に表示されます。これらのフィールドをNocoBaseで通常のフィールドとして使用するには、適応対応の開発が必要です。

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

      ページブロックで表示・編集するデータテーブルには、主キーまたは一意フィールドを設定することをおすすめします。NocoBaseは、レコードの一意識別子として主キーを優先的に使用します。

      ビュー、主キーのないテーブル、複合主キーのテーブルを接続する場合は、データテーブル設定で「Record unique key」を手動で設定する必要があります。利用可能な一意識別子がない場合、ページブロックでレコードを正しく表示、編集、削除できないことがあります。

      20260709210154 20260709210214

      関連リンク