Partilhar via

comando

Inicie o tempo de execução do construtor da API de dados com um arquivo de configuração existente.

Sintaxe

dab start [options]

Visão rápida

Opção Resumo
-c, --config Use um arquivo de configuração específico (padrão para ou arquivo específico do ambiente, se houver)
--LogLevel <level> Especifica o nível de registo como valor fornecido.
--mcp-stdio (Protocolo de Contexto do Modelo (MCP)) Inicia o DAB como um servidor padrão MCP de entrada/saída (stdio) em vez de um servidor HTTP. Requer na configuração.
--no-https-redirect Desabilita o redirecionamento automático HTTP→HTTPS
--verbose Define o nível de log como Informações
--help Mostra o ecrã de ajuda.
--version Mostrar a informação da versão.

-c, --config

Caminho para o arquivo de configuração. Por defeito, a menos que exista, onde é uma variável de ambiente.

Example

  • Bash
  • Prompt de comando 
dab start \
  --config ./settings/dab-config.json

--LogLevel <level>

Especifica o nível de registo como valor fornecido. Para valores possíveis, veja Níveis logarítmicos.

Example

  • Bash
  • Prompt de comando 
dab start \
  --LogLevel Warning

--no-https-redirect

Desabilita o redirecionamento automático HTTP→HTTPS.

Example

  • Bash
  • Prompt de comando 
dab start \
  --no-https-redirect

--verbose

Define o nível mínimo de log como .

Example

  • Bash
  • Prompt de comando 
dab start \
  --verbose

--mcp-stdio

Observação

Esta opção é uma funcionalidade do Model Context Protocol (MCP) que foi introduzida na versão 1.7. Requer na secção do seu arquivo . Para detalhes completos da configuração do MCP, consulte a visão geral do SQL MCP Server.

Inicia o Data API Builder como um servidor padrão MCP de entrada/saída (stdio) em vez de se ligar a uma porta HTTP. Neste modo, o DAB comunica com um cliente MCP (como GitHub Copilot, Visual Studio (VS) Code ou qualquer agente de IA compatível com MCP) inteiramente através de entrada/saída padrão (stdin/stdout) usando o Model Context Protocol. Nenhum servidor HTTP ou porta de rede está exposta.

Este flag também aceita um argumento posicional opcional que especifica o papel de permissão DAB sob o qual todas as chamadas de ferramenta MCP são executadas. O papel deve corresponder a um nome definido na secção da configuração da sua entidade. Se for omitido, o papel passa por defeito a .

Quando está ativa, os seguintes comportamentos são aplicados automaticamente independentemente das definições do ficheiro de configuração:

  • Codificação: A entrada/saída da consola é forçada a UTF-8 sem marca de ordem de bytes (BOM) para comunicação limpa JSON sobre entrada/saída padrão.
  • Autenticação: O fornecedor de autenticação é forçado a entrar em modo Simulador , permitindo o papel especificado sem exigir um verdadeiro JSON Web Token (JWT) ou fornecedor de identidade.
  • Sem host HTTP: O DAB não se liga a nenhuma porta do Protocolo de Controlo de Transmissão (TCP). O servidor MCP corre inteiramente sobre stdin/stdout.

Importante

O prefixo é obrigatório. Se o nome da função não corresponder a uma função definida nas permissões da sua entidade, as chamadas à ferramenta MCP são negadas.

Configuração necessária

O MCP deve estar ativado em your 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
  • Prompt de comando 
# 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

Configuração do cliente MCP

Como o DAB funciona como um subprocesso que comunica através de entrada/saída padrão (stdio), o seu cliente MCP tem de lançar o DAB como um processo filho e canalizar o seu stdin/stdout. Uma configuração típica de cliente MCP para Visual Studio (VS) Code ou um agente compatível é a seguinte:

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

Para um guia completo, consulte o transporte padrão de entrada/saída (stdio) para SQL MCP Server.

--help

Mostra o ecrã de ajuda.

Example

  • Bash
  • Prompt de comando 
dab start --help

--version

Mostrar a informação da versão.

Example

  • Bash
  • Prompt de comando 
dab start --version
  • Last updated on