次の方法で共有


start コマンド

既存の構成ファイルを使用して、データ API ビルダー ランタイムを開始します。

構文

dab start [options]

チラッ

Option 概要
-c, --config 特定の構成ファイルを使用する (既定では、 dab-config.json または環境固有のファイルが存在する場合)

ヘッド セクション

Option 概要
--LogLevel <level> 指定された値としてログ 記録レベルを指定します。
--mcp-stdio (モデル コンテキスト プロトコル (MCP)) DAB を、HTTP ではなく標準の入出力 (STDIO) を使用する MCP サーバーとして起動します。 構成に mcp.enabled: true が必要です。
--no-https-redirect HTTP→HTTPS リダイレクトの自動無効化
--verbose ログ 記録レベルを Informational に設定します。
--help ヘルプ画面を表示します。
--version バージョン情報を表示します。

-c, --config

構成ファイルへのパス。 dab-config.jsonが存在しない限り、既定値は dab-config.<DAB_ENVIRONMENT>.json で、DAB_ENVIRONMENTは環境変数です。

Example

dab start \
  --config ./settings/dab-config.json

--LogLevel <level>

指定された値としてログ 記録レベルを指定します。 使用可能な値については、「 ログ レベル」を参照してください。

Example

dab start \
  --LogLevel Warning

--no-https-redirect

HTTP→HTTPS の自動リダイレクトを無効にします。

Example

dab start \
  --no-https-redirect

--mcp-stdio

このオプションは、リリース 1.7 以降で使用できるモデル コンテキスト プロトコル (MCP) 機能です。 dab-config.jsonruntime セクションで"mcp": { "enabled": true }する必要があります。 MCP 構成の詳細については、 SQL MCP サーバーの概要を参照してください。

HTTP ポートにバインドするのではなく、標準の入力と出力を使用する MCP サーバーとしてデータ API ビルダーを起動します。 このモードでは、DAB は、モデル コンテキスト プロトコルを使用して、MCP クライアント (GitHub Copilot、Visual Studio (VS) Code、または MCP と互換性のある AI エージェントなど) と完全にstdinおよびstdout経由で通信します。 HTTP サーバーまたはネットワーク ポートは公開されません。

このフラグは、すべての MCP ツール呼び出しが実行される DAB アクセス許可ロールを指定するオプションの位置指定 role:<role-name> 引数も受け入れます。 ロールは、エンティティ構成の permissions セクションで定義されている名前と一致する必要があります。 省略すると、ロールは既定で anonymousされます。

--mcp-stdioがアクティブな場合、構成ファイルの設定に関係なく、次の動作が自動的に適用されます。

  • エンコード: JSON の過剰な標準入力/出力通信を行うために、コンソールの入力/出力はバイト オーダー マーク (BOM) なしで UTF-8 に強制されます。
  • 認証: 認証プロバイダーは シミュレーター モードに強制され、実際の JSON Web トークン (JWT) または ID プロバイダーを必要とせずに、指定されたロールを有効にします。
  • HTTP ホストなし: DAB はどの伝送制御プロトコル (TCP) ポートにもバインドされません。 MCP サーバーは、stdin/stdout 経由で完全に実行されます。

Important

role:<name> プレフィックスが必要です。 ロール名がエンティティのアクセス許可で定義されているロールと一致しない場合、MCP ツールの呼び出しは拒否されます。

必須の構成

--mcp-stdioを使用する前に、dab-config.jsonで MCP を有効にする必要があります。

"runtime": {
  "mcp": {
    "enabled": true,
    "path": "/mcp",
    "dml-tools": {
      "create-record": true,
      "read-records": true,
      "update-record": true,
      "delete-record": true
    }
  }
}

Example

# Default anonymous role
dab start \
  --mcp-stdio \
  --config ./dab-config.json

# Specific role
dab start \
  --mcp-stdio role:authenticated \
  --config ./dab-config.json

# With logging
dab start \
  --mcp-stdio role:api-reader \
  --config ./dab-config.json \
  --LogLevel Information

MCP クライアントの構成

DAB は標準の入力と出力を介して通信するサブプロセスとして実行されるため、MCP クライアントは子プロセスとして DAB を起動し、 stdinstdoutパイプする必要があります。 Visual Studio (VS) コードまたは互換性のあるエージェントの一般的な MCP クライアント構成は次のようになります。

{
  "servers": {
    "my-database": {
      "type": "stdio",
      "command": "dab",
      "args": [
        "start",
        "--mcp-stdio",
        "role:anonymous",
        "--config",
        "./dab-config.json"
      ]
    }
  }
}

完全なチュートリアルについては、 SQL MCP Server の標準の入力および出力トランスポートに関する記事を参照してください

--verbose

ログ 記録レベルを Informational に設定します。 これは、 --LogLevel Informationと同等の便利なフラグです。

Example

dab start \
  --verbose

--help

ヘルプ画面を表示します。

Example

dab start --help

--version

バージョン情報を表示します。

Example

dab start --version