start příkaz

Spusťte modul runtime Tvůrce dat s existujícím konfiguračním souborem.

Syntaxe

dab start [options]

Rychlý přehled

Možnost Shrnutí
-c, --config Použijte konkrétní konfigurační soubor (výchozí nastavení dab-config.json nebo soubor specifický pro prostředí, pokud je k dispozici).

Oddíl hlavy

Možnost Shrnutí
--LogLevel <level> Určuje úroveň protokolování jako zadanou hodnotu.
--mcp-stdio (Model Context Protocol (MCP)) Spustí DAB jako server MCP, který místo HTTP používá standardní vstup a výstup (STDIO). Vyžaduje mcp.enabled: true konfiguraci.
--no-https-redirect Zakáže automatické přesměrování HTTP→HTTPS.
--verbose Nastaví úroveň protokolování na informační.
--help Zobrazení obrazovky nápovědy
--version Zobrazí informace o verzi.

-c, --config

Cesta ke konfiguračnímu souboru Výchozí hodnota je dab-config.json , pokud dab-config.<DAB_ENVIRONMENT>.json neexistuje, kde DAB_ENVIRONMENT je proměnná prostředí.

Example

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

--LogLevel <level>

Určuje úroveň protokolování jako zadanou hodnotu. Možné hodnoty najdete v tématu Úrovně protokolu.

Example

dab start \
  --LogLevel Warning

--no-https-redirect

Zakáže automatické přesměrování HTTP→HTTPS.

Example

dab start \
  --no-https-redirect

--mcp-stdio

Poznámka:

Tato možnost je funkce PROTOKOLU MCP (Model Context Protocol) dostupná ve verzi 1.7 a novějších verzích. To vyžaduje "mcp": { "enabled": true } v runtime části vašeho dab-config.json. Úplné podrobnosti o konfiguraci MCP najdete v přehledu SQL MCP Serveru.

Spustí Tvůrce rozhraní Data API jako server MCP, který místo vazby na port HTTP používá standardní vstup a výstup. V tomto režimu DAB komunikuje s klientem MCP (jako je GitHub Copilot, Visual Studio (VS) Code nebo jakýkoli agent AI kompatibilní s MCP) zcela přes stdin a stdout pomocí protokolu Context Protocol modelu. Není vystaven žádný server HTTP ani síťový port.

Tento příznak také přijímá volitelný poziční role:<role-name> argument, který určuje roli oprávnění DAB, pod kterou se provádějí všechna volání nástroje MCP. Role se musí shodovat s názvem definovaným v permissions části konfigurace vaší entity. Pokud tento parametr vynecháte, role se ve výchozím nastavení nastaví na anonymous.

Pokud --mcp-stdio je aktivní, použijí se následující chování automaticky bez ohledu na nastavení konfiguračního souboru:

  • Kódování: Vstup/výstup konzoly je nucen do UTF-8 bez značky pořadí bajtů (BOM) pro čistou komunikaci vstupu a výstupu JSON přes standard.
  • Ověřování: Zprostředkovatel ověřování je nucen do režimu simulátoru a povolí zadanou roli bez nutnosti skutečného webového tokenu JSON (JWT) nebo zprostředkovatele identity.
  • Žádný hostitel HTTP: DAB neváže na žádný port TCP (Transmission Control Protocol). Server MCP běží zcela přes stdin/stdout.

Důležité

Předpona je povinná role:<name> . Pokud se název role neshoduje s rolí definovanou v oprávněních vaší entity, volání nástroje MCP se odepře.

Požadovaná konfigurace

Před použitím --mcp-stdiomusí být v dab-config.json programu MCP povolen:

"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

Konfigurace klienta MCP

Protože DAB běží jako podproces, který komunikuje přes standardní vstup a výstup, musí klient MCP spustit DAB jako podřízený proces a kanál stdin a stdout. Typická konfigurace klienta MCP pro Visual Studio (VS) Code nebo kompatibilní agent vypadá takto:

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

Úplný návod najdete v tématu Standardní vstupní a výstupní přenos pro SQL MCP Server.

--verbose

Nastaví úroveň protokolování na informační. Jedná se o příznak pohodlí, který odpovídá .--LogLevel Information

Example

dab start \
  --verbose

--help

Zobrazení obrazovky nápovědy

Example

dab start --help

--version

Zobrazí informace o verzi.

Example

dab start --version