Partager via


Commande start

Démarrez le runtime du générateur d’API de données avec un fichier de configuration existant.

Syntaxe

dab start [options]

Aperçu rapide

Choix Résumé
-c, --config Utiliser un fichier de configuration spécifique (par défaut ou un fichier spécifique à dab-config.json l’environnement s’il est présent)

Section de la tête

Choix Résumé
--LogLevel <level> Spécifie le niveau de journalisation comme valeur fournie.
--mcp-stdio (Modèle Context Protocol (MCP)) Démarre DAB en tant que serveur MCP qui utilise l’entrée et la sortie standard (STDIO) au lieu de HTTP. Nécessite mcp.enabled: true une configuration.
--no-https-redirect Désactive la redirection HTTP automatique→HTTPS
--verbose Définit le niveau de journalisation sur Informational
--help Affichez l’écran d’aide.
--version Affichez les informations de version.

-c, --config

Chemin d’accès au fichier de configuration. Par défaut, dab-config.json sauf dab-config.<DAB_ENVIRONMENT>.json s’il existe, où DAB_ENVIRONMENT est une variable d’environnement.

Example

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

--LogLevel <level>

Spécifie le niveau de journalisation comme valeur fournie. Pour connaître les valeurs possibles, consultez les niveaux de journal.

Example

dab start \
  --LogLevel Warning

--no-https-redirect

Désactive la redirection HTTP→HTTPS automatique.

Example

dab start \
  --no-https-redirect

--mcp-stdio

Note

Cette option est une fonctionnalité MCP (Model Context Protocol) disponible dans la version 1.7 et ultérieure. Elle nécessite "mcp": { "enabled": true } dans la runtime section de votre dab-config.json. Pour plus d’informations sur la configuration MCP complète, consultez la vue d’ensemble de SQL MCP Server.

Démarre le générateur d’API de données en tant que serveur MCP qui utilise une entrée et une sortie standard au lieu de la liaison à un port HTTP. Dans ce mode, DAB communique avec un client MCP (tel que GitHub Copilot, Visual Studio (VS) Code ou tout agent IA compatible MCP) entièrement sur stdin et stdout à l’aide du protocole Model Context Protocol. Aucun serveur HTTP ou port réseau n’est exposé.

Cet indicateur accepte également un argument positionnel role:<role-name> facultatif qui spécifie le rôle d’autorisation DAB sous lequel tous les appels d’outil MCP s’exécutent. Le rôle doit correspondre à un nom défini dans la permissions section de votre configuration d’entité. S’il est omis, le rôle est défini par défaut sur anonymous.

Lorsqu’il --mcp-stdio est actif, les comportements suivants sont appliqués automatiquement, quel que soit les paramètres de votre fichier de configuration :

  • Encodage : l’entrée/sortie de la console est forcée à UTF-8 sans marque d’ordre d’octet (BOM) pour nettoyer la communication d’entrée/sortie JSON-over-standard.
  • Authentification : le fournisseur d’authentification est forcé en mode Simulateur , en activant le rôle spécifié sans nécessiter un véritable jeton web JSON (JWT) ou un fournisseur d’identité.
  • Aucun hôte HTTP : DAB ne se lie à aucun port TCP (Transmission Control Protocol). Le serveur MCP s’exécute entièrement sur stdin/stdout.

Important

Le role:<name> préfixe est requis. Si le nom du rôle ne correspond pas à un rôle défini dans les autorisations de votre entité, les appels d’outils MCP sont refusés.

Configuration requise

MCP doit être activé dans votre dab-config.json application avant d’utiliser --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

Configuration du client MCP

Étant donné que DAB s’exécute en tant que sous-processus qui communique sur les entrées et sorties standard, votre client MCP doit lancer DAB en tant que processus enfant et canal stdin et stdout. Une configuration de client MCP classique pour Visual Studio (VS) Code ou un agent compatible ressemble à ceci :

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

Pour obtenir une procédure pas à pas complète, consultez le transport d’entrée et de sortie standard pour SQL MCP Server.

--verbose

Définit le niveau de journalisation sur Informational. Il s’agit d’un indicateur de commodité équivalent à --LogLevel Information.

Example

dab start \
  --verbose

--help

Affichez l’écran d’aide.

Example

dab start --help

--version

Affichez les informations de version.

Example

dab start --version