既存の構成ファイルを使用して、データ 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.jsonのruntime セクションで"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 を起動し、 stdin と stdoutパイプする必要があります。 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