start parancs

Indítsa el a Data API Builder-futtatókörnyezetet egy meglévő konfigurációs fájllal.

Szemantika

dab start [options]

Gyors áttekintés

Lehetőség Összefoglalás
-c, --config Használjon egy adott konfigurációs fájlt (alapértelmezés szerint a fájlhoz dab-config.json vagy környezetspecifikus fájlhoz, ha van ilyen)

Fejszakasz

Lehetőség Összefoglalás
--LogLevel <level> Megadott értékként adja meg a naplózási szintet.
--mcp-stdio (Model Context Protocol (MCP)) A DAB-t OLYAN MCP-kiszolgálóként indítja el, amely a HTTP helyett standard bemenetet és kimenetet (STDIO) használ. Konfigurációban szükséges mcp.enabled: true .
--no-https-redirect Letiltja az automatikus HTTP→HTTPS-átirányítást
--verbose Naplózási szint beállítása tájékoztató értékre
--help A súgóképernyő megjelenítése.
--version Verzióinformációk megjelenítése.

-c, --config

A konfigurációs fájl elérési útja. Alapértelmezett érték, dab-config.json ha dab-config.<DAB_ENVIRONMENT>.json nem létezik, ahol DAB_ENVIRONMENT környezeti változó van.

Example

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

--LogLevel <level>

Megadott értékként adja meg a naplózási szintet. A lehetséges értékekért tekintse meg a naplószinteket.

Example

dab start \
  --LogLevel Warning

--no-https-redirect

Letiltja az automatikus HTTP→HTTPS-átirányítást.

Example

dab start \
  --no-https-redirect

--mcp-stdio

Megjegyzés:

Ez a lehetőség egy modellkörnyezeti protokoll (MCP) funkció , amely a kiadásban és a későbbi verziókban 1.7 érhető el. Ehhez az runtime Ön dab-config.jsonszakaszában van szükség"mcp": { "enabled": true }. Az MCP konfigurációjának teljes részleteiért tekintse meg az SQL MCP Server áttekintését.

A Data API Buildert mcp-kiszolgálóként indítja el, amely a HTTP-porthoz való kötés helyett szabványos bemenetet és kimenetet használ. Ebben a módban a DAB teljes egészében stdin és stdout a Model Context Protocol használatával kommunikál egy MCP-ügyféllel (például GitHub Copilot, Visual Studio (VS) Code vagy bármely MCP-kompatibilis AI-ügynökkel. Nincs közzétéve HTTP-kiszolgáló vagy hálózati port.

Ez a jelző egy opcionális pozícióargumentumot role:<role-name> is elfogad, amely meghatározza azt a DAB-jogosultsági szerepkört, amely alatt az összes MCP-eszköz hívása fut. A szerepkörnek meg kell egyeznie az permissions entitáskonfiguráció szakaszában meghatározott névvel. Ha nincs megadva, a szerepkör alapértelmezés szerint a következő lesz anonymous: .

Ha --mcp-stdio aktív, a konfigurációs fájl beállításaitól függetlenül a következő viselkedések lesznek automatikusan alkalmazva:

  • Kódolás: A konzol bemenete/kimenete az UTF-8-ra van kényszerítve bájtsorrendjel (BOM) nélkül a tiszta JSON-over-standard bemeneti/kimeneti kommunikációhoz.
  • Hitelesítés: A hitelesítési szolgáltató szimulátor módba van kényszerítve, így a megadott szerepkört anélkül engedélyezi, hogy valódi JSON-webjogkivonatot (JWT) vagy identitásszolgáltatót kellene igényelnie.
  • Nincs HTTP-gazdagép: A DAB nem kapcsolódik semmilyen TCP-porthoz. Az MCP-kiszolgáló teljes egészében stdin/stdout protokollon fut.

Fontos

Az role:<name> előtag megadása kötelező. Ha a szerepkör neve nem egyezik az entitásengedélyekben meghatározott szerepkörrel, a rendszer megtagadja az MCP-eszközök hívásait.

Szükséges konfiguráció

Az MCP-t engedélyezni kell a dab-config.json következő használat --mcp-stdioelőtt:

"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-ügyfélkonfiguráció

Mivel a DAB olyan alfolyamatként fut, amely szabványos bemeneten és kimeneten keresztül kommunikál, az MCP-ügyfélnek gyermekfolyamatként és -csőként stdin kell elindítania a DAB-t.stdout A Visual Studio (VS) Code vagy egy kompatibilis ügynök tipikus MCP-ügyfélkonfigurációja a következőképpen néz ki:

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

A teljes útmutatóért tekintse meg az SQL MCP Server szabványos bemeneti és kimeneti átvitelét.

--verbose

A naplózási szintet Informational értékre állítja. Ez egy kényelmi jelző, amely egyenértékű a következővel --LogLevel Information: .

Example

dab start \
  --verbose

--help

A súgóképernyő megjelenítése.

Example

dab start --help

--version

Verzióinformációk megjelenítése.

Example

dab start --version
  • Last updated on