start comando

Avviare il runtime di Generatore API dati con un file di configurazione esistente.

Sintassi

dab start [options]

Sguardo rapido

Sezione head

-c, --config

Percorso del file di configurazione. Per impostazione predefinita, a dab-config.json meno che non dab-config.<DAB_ENVIRONMENT>.json esista, dove DAB_ENVIRONMENT è una variabile di ambiente.

Example

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

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

--LogLevel <level>

Specifica il livello di registrazione come valore specificato. Per i valori possibili, vedere Livelli di log.

Example

dab start \
  --LogLevel Warning

dab start ^
  --LogLevel Warning

--no-https-redirect

Disabilita il reindirizzamento HTTP→HTTPS automatico.

Example

dab start \
  --no-https-redirect

dab start ^
  --no-https-redirect

--mcp-stdio

Avvia Generatore API dati come server MCP che usa input e output standard invece di eseguire il binding a una porta HTTP. In questa modalità, DAB comunica con un client MCP (ad esempio GitHub Copilot, Visual Studio (VS) Code o qualsiasi agente di intelligenza artificiale compatibile con MCP interamente stdin e stdout usando il protocollo di contesto del modello. Non viene esposto alcun server HTTP o porta di rete.

Questo flag accetta anche un argomento posizionale role:<role-name> facoltativo che specifica il ruolo di autorizzazione DAB in cui vengono eseguite tutte le chiamate allo strumento MCP. Il ruolo deve corrispondere a un nome definito nella permissions sezione della configurazione dell'entità. Se omesso, per impostazione predefinita il ruolo è anonymous.

Quando --mcp-stdio è attivo, i comportamenti seguenti vengono applicati automaticamente indipendentemente dalle impostazioni del file di configurazione:

• Codifica: l'input/output della console viene forzato a UTF-8 senza un indicatore di ordine dei byte (BOM) per la comunicazione di input/output JSON-over-standard.
• Autenticazione: il provider di autenticazione viene forzato alla modalità simulatore , abilitando il ruolo specificato senza richiedere un vero token JSON Web (JWT) o un provider di identità.
• Nessun host HTTP: DAB non è associato a alcuna porta TCP (Transmission Control Protocol). Il server MCP viene eseguito interamente su stdin/stdout.

Configurazione richiesta

McP deve essere abilitato in dab-config.json prima di usare --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

:: 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

Configurazione del client MCP

Poiché DAB viene eseguito come sottoprocesso che comunica tramite input e output standard, il client MCP deve avviare DAB come processo figlio e pipe stdin e stdout. Una configurazione client MCP tipica per Visual Studio (VS) Code o un agente compatibile ha un aspetto simile al seguente:

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

Per una procedura dettagliata completa, vedere Trasporto standard di input e output per SQL MCP Server.

--verbose

Imposta il livello di registrazione su Informativo. Si tratta di un flag di praticità equivalente a --LogLevel Information.

Example

dab start \
  --verbose

dab start ^
  --verbose

--help

Visualizzare la schermata della Guida.

Example

dab start --help

dab start --help

--version

Visualizzare le informazioni sulla versione.

Example

dab start --version

dab start --version