Udostępnij za pośrednictwem


start polecenie

Uruchom środowisko uruchomieniowe konstruktora interfejsu API danych przy użyciu istniejącego pliku konfiguracji.

Składnia

dab start [options]

Szybki rzut oka

Option Podsumowanie
-c, --config Użyj określonego pliku konfiguracji (domyślnie lub dab-config.json pliku specyficznego dla środowiska, jeśli istnieje)

Sekcja główna

Option Podsumowanie
--LogLevel <level> Określa poziom rejestrowania jako podaną wartość.
--mcp-stdio (Model Context Protocol (MCP)) Uruchamia język DAB jako serwer MCP, który używa standardowych danych wejściowych i wyjściowych (STDIO) zamiast HTTP. Wymaga mcp.enabled: true w konfiguracji.
--no-https-redirect Wyłącza automatyczne przekierowywanie HTTP→HTTPS
--verbose Ustawia poziom rejestrowania na Informational
--help Wyświetl ekran pomocy.
--version Wyświetl informacje o wersji.

-c, --config

Ścieżka do pliku konfiguracji. Wartość domyślna to dab-config.json , chyba że dab-config.<DAB_ENVIRONMENT>.json istnieje, gdzie DAB_ENVIRONMENT jest zmienną środowiskową.

Example

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

--LogLevel <level>

Określa poziom rejestrowania jako podaną wartość. Aby uzyskać możliwe wartości, zobacz Poziomy dziennika.

Example

dab start \
  --LogLevel Warning

--no-https-redirect

Wyłącza automatyczne przekierowywanie HTTP→HTTPS.

Example

dab start \
  --no-https-redirect

--mcp-stdio

Uwaga / Notatka

Ta opcja jest funkcją protokołu MCP (Model Context Protocol) dostępną w wersji 1.7 i nowszych wersjach. Wymaga "mcp": { "enabled": true } to w runtime sekcji pliku dab-config.json. Aby uzyskać szczegółowe informacje o konfiguracji MCP, zobacz Omówienie programu SQL MCP Server.

Uruchamia konstruktora interfejsu API danych jako serwer MCP, który używa standardowych danych wejściowych i wyjściowych zamiast wiązania z portem HTTP. W tym trybie daB komunikuje się z klientem MCP (takim jak GitHub Copilot, Visual Studio (VS) Code lub dowolnym agentem sztucznej inteligencji zgodnym z mcP) w całości stdin i stdout przy użyciu protokołu kontekstowego modelu. Nie uwidoczniony jest żaden serwer HTTP ani port sieciowy.

Ta flaga akceptuje również opcjonalny argument pozycyjny role:<role-name> , który określa rolę uprawnień DAB, w ramach której wykonywane są wszystkie narzędzia MCP. Rola musi być zgodna z nazwą zdefiniowaną w permissions sekcji konfiguracji jednostki. W przypadku pominięcia rola jest domyślnie ustawiona na anonymous.

Gdy --mcp-stdio jest aktywny, następujące zachowania są stosowane automatycznie niezależnie od ustawień pliku konfiguracji:

  • Kodowanie: Dane wejściowe/wyjściowe konsoli są wymuszane do formatu UTF-8 bez znaku kolejności bajtów (BOM) dla czystej komunikacji wejściowej/wyjściowej JSON ponad standard.
  • Uwierzytelnianie: dostawca uwierzytelniania jest zmuszony do trybu symulatora , włączając określoną rolę bez wymagania rzeczywistego tokenu internetowego JSON (JWT) lub dostawcy tożsamości.
  • Brak hosta HTTP: język DAB nie wiąże się z żadnym portem protokołu TCP (Transmission Control Protocol). Serwer MCP działa całkowicie przez stdin/stdout.

Ważna

Prefiks role:<name> jest wymagany. Jeśli nazwa roli nie jest zgodna z rolą zdefiniowaną w uprawnieniach jednostki, wywołania narzędzi MCP zostaną odrzucone.

Wymagana konfiguracja

Program MCP musi być włączony przed dab-config.json użyciem polecenia --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

Konfiguracja klienta MCP

Ponieważ język DAB działa jako podproces, który komunikuje się za pośrednictwem standardowych danych wejściowych i wyjściowych, klient MCP musi uruchomić daB jako proces podrzędny i potok stdin i stdout. Typowa konfiguracja klienta MCP dla programu Visual Studio (VS) Code lub zgodnego agenta wygląda następująco:

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

Aby zapoznać się z kompletnym przewodnikiem, zobacz standardowy transport wejściowy i wyjściowy dla programu SQL MCP Server.

--verbose

Ustawia poziom rejestrowania na Informational. Jest to flaga wygody równoważna .--LogLevel Information

Example

dab start \
  --verbose

--help

Wyświetl ekran pomocy.

Example

dab start --help

--version

Wyświetl informacje o wersji.

Example

dab start --version