Compartir a través de

Comando

Inicie el entorno de ejecución de Data API Builder con un archivo de configuración existente.

Syntax

dab start [options]

Vista rápida

Opción Resumen
-c, --config Usar un archivo de configuración específico (el valor predeterminado es o un archivo específico del entorno si está presente)
--LogLevel <level> Especifica el nivel de registro según el valor proporcionado.
--mcp-stdio (Protocolo de contexto de modelo (MCP)) Inicia DAB como un servidor de entrada/salida estándar de MCP (stdio) en lugar de un servidor HTTP. Requiere en la configuración.
--no-https-redirect Deshabilita la redirección automática de HTTP→HTTPS.
--verbose Establece el nivel de registro en Información
--help Muestra la pantalla de ayuda.
--version Mostrar información de versión.

-c, --config

Ruta de acceso al archivo de configuración. El valor predeterminado es a menos que exista, donde es una variable de entorno.

Example

  • Bash
  • Símbolo del sistemaCommand Prompt 
dab start \
  --config ./settings/dab-config.json

--LogLevel <level>

Especifica el nivel de registro según el valor proporcionado. Para conocer los valores posibles, consulte Niveles de registro.

Example

  • Bash
  • Símbolo del sistemaCommand Prompt 
dab start \
  --LogLevel Warning

--no-https-redirect

Deshabilita la redirección automática de HTTP→HTTPS.

Example

  • Bash
  • Símbolo del sistemaCommand Prompt 
dab start \
  --no-https-redirect

--verbose

Establece el nivel de registro mínimo en .

Example

  • Bash
  • Símbolo del sistemaCommand Prompt 
dab start \
  --verbose

--mcp-stdio

Nota:

Esta opción es una característica del Protocolo de contexto de modelo (MCP) que se introdujo en la versión 1.7. Requiere en la sección de . Para obtener información completa sobre la configuración de MCP, consulte Introducción a SQL MCP Server.

Inicia data API Builder como un servidor de entrada/salida estándar (stdio) mcP en lugar de enlazar a un puerto HTTP. En este modo, DAB se comunica con un cliente MCP (como GitHub Copilot, Visual Studio (VS) Code o cualquier agente de IA compatible con MCP) completamente a través de la entrada y salida estándar (stdin/stdout) mediante el protocolo de contexto de Model. No se expone ningún servidor HTTP ni puerto de red.

Esta marca también acepta un argumento posicional opcional que especifica el rol de permiso DAB en el que se ejecutan todas las llamadas a la herramienta MCP. El rol debe coincidir con un nombre definido en la sección de la configuración de la entidad. Si se omite, el rol tiene como valor predeterminado .

Cuando está activo, los comportamientos siguientes se aplican automáticamente independientemente de la configuración del archivo de configuración:

  • Codificación: la entrada y salida de la consola se fuerza a UTF-8 sin una marca de orden de bytes (BOM) para una comunicación de entrada/salida JSON sobre estándar limpia.
  • Autenticación: el proveedor de autenticación se ve obligado al modo simulador , lo que habilita el rol especificado sin necesidad de un token web JSON (JWT) o proveedor de identidades real.
  • Ningún host HTTP: DAB no se enlaza a ningún puerto del Protocolo de control de transmisión (TCP). El servidor MCP se ejecuta completamente a través de stdin/stdout.

Importante

Se requiere el prefijo. Si el nombre del rol no coincide con un rol definido en los permisos de entidad, se deniegan las llamadas a herramientas de MCP.

Configuración necesaria

MCP debe estar habilitado en antes de usar :

"runtime": {
  "mcp": {
    "enabled": true,
    "path": "/mcp",
    "dml-tools": {
      "create-record": true,
      "read-records": true,
      "update-record": true,
      "delete-record": true
    }
  }
}

Example

  • Bash
  • Símbolo del sistemaCommand Prompt 
# 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

Configuración del cliente MCP

Dado que DAB se ejecuta como un subproceso que se comunica a través de la entrada y salida estándar (stdio), el cliente MCP debe iniciar DAB como un proceso secundario y canalizar su stdin/stdout. Una configuración de cliente MCP típica para Visual Studio (VS) Code o un agente compatible tiene el siguiente aspecto:

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

Para ver un tutorial completo, consulte transporte de entrada/salida estándar (stdio) para SQL MCP Server.

--help

Muestra la pantalla de ayuda.

Example

  • Bash
  • Símbolo del sistemaCommand Prompt 
dab start --help

--version

Mostrar información de versión.

Example

  • Bash
  • Símbolo del sistemaCommand Prompt 
dab start --version
  • Last updated on