Freigeben über

start-Befehl

Starten Sie die Daten-API-Generator-Laufzeit mit einer vorhandenen Konfigurationsdatei.

Syntax

dab start [options]

Schnellblick

Option Zusammenfassung
-c, --config Verwenden einer bestimmten Konfigurationsdatei (standardeinstellung für dab-config.json oder umgebungsspezifische Datei, falls vorhanden)

Kopfabschnitt

Option Zusammenfassung
--LogLevel <level> Gibt die Protokollierungsebene als bereitgestellten Wert an.
--mcp-stdio (Model Context Protocol (MCP)) Startet DAB als MCP-Server, der standardmäßige Eingabe und Ausgabe (STDIO) anstelle von HTTP verwendet. In der Konfiguration erforderlich mcp.enabled: true .
--no-https-redirect Deaktiviert die automatische HTTP→HTTPS-Umleitung
--verbose Legt die Protokollierungsebene auf "Informational" fest.
--help Zeigen Sie den Hilfebildschirm an.
--version Versionsinformationen anzeigen.

-c, --config

Pfad zur Konfigurationsdatei. Der Standardwert ist, dab-config.json sofern nicht dab-config.<DAB_ENVIRONMENT>.json vorhanden, wobei DAB_ENVIRONMENT es sich um eine Umgebungsvariable handelt.

Example

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

--LogLevel <level>

Gibt die Protokollierungsebene als bereitgestellten Wert an. Mögliche Werte finden Sie unter Protokollebenen.

Example

dab start \
  --LogLevel Warning

--no-https-redirect

Deaktiviert die automatische HTTP→HTTPS-Umleitung.

Example

dab start \
  --no-https-redirect

--mcp-stdio

Hinweis

Diese Option ist ein MCP-Feature (Model Context Protocol), das in version 1.7 und höher verfügbar ist. Dies ist "mcp": { "enabled": true } im runtime Abschnitt Ihrer dab-config.json. Vollständige MCP-Konfigurationsdetails finden Sie in der SQL MCP Server-Übersicht.

Startet den Daten-API-Generator als MCP-Server, der standardmäßige Eingabe und Ausgabe verwendet, anstatt an einen HTTP-Port zu binden. In diesem Modus kommuniziert DAB vollständig über und mithilfe des Model Context Protocol mit einem MCP-Client (z. B. GitHub Copilot, Visual Studio (VS) Code oder einem MCP-kompatiblen KI-Agent stdinstdout. Es wird kein HTTP-Server oder Netzwerkport verfügbar gemacht.

Dieses Flag akzeptiert auch ein optionales Positionsargument role:<role-name> , das die DAB-Berechtigungsrolle angibt, unter der alle MCP-Toolaufrufe ausgeführt werden. Die Rolle muss mit einem Namen übereinstimmen, der permissions im Abschnitt Ihrer Entitätskonfiguration definiert ist. Wenn ausgelassen, wird die Rolle standardmäßig auf anonymous gesetzt.

Wenn --mcp-stdio sie aktiv ist, werden die folgenden Verhaltensweisen unabhängig von den Konfigurationsdateieinstellungen automatisch angewendet:

  • Codierung: Die Konsoleneingabe/Ausgabe wird gezwungen, UTF-8 ohne Bytereihenfolgezeichen (BOM) für eine saubere JSON-over-Standard-Eingabe-/Ausgabekommunikation zu verwenden.
  • Authentifizierung: Der Authentifizierungsanbieter wird zum Simulatormodus gezwungen, wodurch die angegebene Rolle aktiviert wird, ohne dass ein echter JSON-Webtoken (JWT) oder Identitätsanbieter erforderlich ist.
  • Kein HTTP-Host: DAB bindet nicht an einen TCP-Port (Transmission Control Protocol). Der MCP-Server wird vollständig über stdin/stdout ausgeführt.

Von Bedeutung

Das role:<name> Präfix ist erforderlich. Wenn der Rollenname nicht mit einer in Ihren Entitätsberechtigungen definierten Rolle übereinstimmt, werden MCP-Toolaufrufe verweigert.

Erforderliche Konfiguration

MCP muss in Ihrer dab-config.json Vor der Verwendung --mcp-stdioaktiviert sein:

"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-Clientkonfiguration

Da DAB als Unterprozess ausgeführt wird, der über standardeingaben und -ausgabe kommuniziert, muss der MCP-Client DAB als untergeordneter Prozess und Pipe und als Pipe stdinstdoutstarten. Eine typische MCP-Clientkonfiguration für Visual Studio (VS)-Code oder ein kompatibler Agent sieht wie folgt aus:

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

Eine vollständige exemplarische Vorgehensweise finden Sie unter Standardeingabe- und Ausgabetransport für SQL MCP Server.

--verbose

Legt die Protokollierungsebene auf "Informational" fest. Dies ist eine Komfortkennzeichnung, die entspricht --LogLevel Information.

Example

dab start \
  --verbose

--help

Zeigen Sie den Hilfebildschirm an.

Example

dab start --help

--version

Versionsinformationen anzeigen.

Example

dab start --version
  • Last updated on