Dela via

start kommando

Starta Data API Builder-körningen med en befintlig konfigurationsfil.

Syntax

dab start [options]

Snabbblick

Option Sammanfattning
-c, --config Använd en specifik konfigurationsfil (standard för dab-config.json eller miljöspecifik fil om den finns)

Huvudsektion

Option Sammanfattning
--LogLevel <level> Anger loggningsnivå som angivet värde.
--mcp-stdio (McP (Model Context Protocol)) Startar DAB som en MCP-server som använder standardindata och utdata (STDIO) i stället för HTTP. Kräver mcp.enabled: true i konfiguration.
--no-https-redirect Inaktiverar automatisk HTTP→HTTPS-omdirigering
--verbose Anger loggningsnivå till Information
--help Visa hjälpskärmen.
--version Visa versionsinformation.

-c, --config

Sökväg till konfigurationsfilen. Standardvärdet dab-config.json är om det inte dab-config.<DAB_ENVIRONMENT>.json finns, där DAB_ENVIRONMENT är en miljövariabel.

Example

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

--LogLevel <level>

Anger loggningsnivå som angivet värde. Möjliga värden finns i Loggnivåer.

Example

dab start \
  --LogLevel Warning

--no-https-redirect

Inaktiverar automatisk HTTP→HTTPS-omdirigering.

Example

dab start \
  --no-https-redirect

--mcp-stdio

Anmärkning

Det här alternativet är en MCP-funktion (Model Context Protocol) som är tillgänglig i versionen 1.7 och senare. Det kräver "mcp": { "enabled": true } i runtime avsnittet i din dab-config.json. Fullständig MCP-konfigurationsinformation finns i Översikt över SQL MCP Server.

Startar Data API Builder som en MCP-server som använder standardindata och utdata i stället för att binda till en HTTP-port. I det här läget kommunicerar DAB med en MCP-klient (till exempel GitHub Copilot, Visual Studio (VS) Code eller någon MCP-kompatibel AI-agent) helt över stdin och stdout med hjälp av Model Context Protocol. Ingen HTTP-server eller nätverksport exponeras.

Den här flaggan accepterar också ett valfritt positionsargument role:<role-name> som anger den DAB-behörighetsroll under vilken alla MCP-verktygsanrop körs. Rollen måste matcha ett namn som definierats i avsnittet i permissions entitetskonfigurationen. Om den utelämnas, blir rollen som standard anonymous.

När --mcp-stdio är aktiv tillämpas följande beteenden automatiskt oavsett inställningarna för konfigurationsfilen:

  • Kodning: Konsolens indata/utdata tvingas till UTF-8 utan byteordningsmärke (BOM) för ren JSON-över-standard-indata-/utdatakommunikation.
  • Autentisering: Autentiseringsprovidern tvingas till simulatorläge , vilket aktiverar den angivna rollen utan att kräva en riktig JSON-webbtoken (JWT) eller identitetsprovider.
  • Ingen HTTP-värd: DAB binder inte till någon TCP-port (Transmission Control Protocol). MCP-servern körs helt över stdin/stdout.

Viktigt!

Prefixet role:<name> krävs. Om rollnamnet inte matchar en roll som definierats i dina entitetsbehörigheter nekas MCP-verktygsanrop.

Nödvändig konfiguration

MCP måste vara aktiverat i din dab-config.json innan du använder --mcp-stdio:

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

Eftersom DAB körs som en underprocess som kommunicerar via standardindata och utdata måste MCP-klienten starta DAB som en underordnad process och pipe stdin och stdout. En typisk MCP-klientkonfiguration för Visual Studio -kod (VS) eller en kompatibel agent ser ut så här:

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

En fullständig genomgång finns i Standardindata- och utdatatransport för SQL MCP Server.

--verbose

Anger loggningsnivån till Informational. Det här är en bekvämlighetsflagga som motsvarar --LogLevel Information.

Example

dab start \
  --verbose

--help

Visa hjälpskärmen.

Example

dab start --help

--version

Visa versionsinformation.

Example

dab start --version
  • Last updated on