Поделиться через


start команда

Запустите среду выполнения построителя данных с существующим файлом конфигурации.

Синтаксис

dab start [options]

Краткий обзор

Вариант Сводка
-c, --config Используйте определенный файл конфигурации (по умолчанию используется dab-config.json или файл, зависящий от среды, если он присутствует)

Раздел "Головка"

Вариант Сводка
--LogLevel <level> Указывает уровень ведения журнала в качестве указанного значения.
--mcp-stdio (Протокол контекста модели (MCP)) Запускает DAB как сервер MCP, использующий стандартные входные и выходные данные (STDIO) вместо HTTP. Требуется mcp.enabled: true в конфигурации.
--no-https-redirect Отключает автоматическое перенаправление HTTP→HTTPS
--verbose Задает уровень ведения журнала информационным
--help Отображение экрана справки.
--version Отображение сведений о версии.

-c, --config

Путь к файлу конфигурации. dab-config.json По умолчанию, если dab-config.<DAB_ENVIRONMENT>.json не существует, где DAB_ENVIRONMENT находится переменная среды.

Example

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

--LogLevel <level>

Указывает уровень ведения журнала в качестве указанного значения. Возможные значения см. в разделе "Уровни журнала".

Example

dab start \
  --LogLevel Warning

--no-https-redirect

Отключает автоматическое перенаправление HTTP→HTTPS.

Example

dab start \
  --no-https-redirect

--mcp-stdio

Замечание

Этот параметр является функцией протокола MCP, доступной в выпуске и более поздних версиях 1.7 . Он требуется "mcp": { "enabled": true }runtime в разделе вашего dab-config.json. Полные сведения о конфигурации MCP см. в обзоре SQL MCP Server.

Запускает построитель API данных в качестве сервера MCP, который использует стандартные входные и выходные данные вместо привязки к HTTP-порту. В этом режиме DAB взаимодействует с клиентом MCP (например, GitHub Copilot, Visual Studio (VS) Code или любым агентом ИИ, совместимым с MCP), полностью и stdinstdout с помощью протокола контекста модели. Http-сервер или сетевой порт не предоставляется.

Этот флаг также принимает необязательный позиционный role:<role-name> аргумент, указывающий роль разрешения DAB, в которой выполняются все вызовы средства MCP. Роль должна соответствовать имени, определенному permissions в разделе конфигурации сущности. Если его не указать, роль по умолчанию будет anonymous.

При --mcp-stdio активном выполнении следующие действия применяются автоматически независимо от параметров файла конфигурации:

  • Кодировка: входные и выходные данные консоли вынуждены использовать UTF-8 без метки порядка байтов (BOM) для очистки входных и выходных данных JSON по стандарту.
  • Проверка подлинности: поставщик проверки подлинности вынужден выполнять режим симулятора , что позволяет включить указанную роль, не требуя реального веб-маркера JSON (JWT) или поставщика удостоверений.
  • Нет узла HTTP: DAB не привязывается к порту TCP. Сервер MCP полностью работает над stdin/stdout.

Это важно

role:<name> Требуется префикс. Если имя роли не соответствует роли, определенной в разрешениях сущности, вызовы инструментов MCP отклоняются.

Необходимая конфигурация

Перед использованием MCP необходимо включить в вашей --mcp-stdioучетной dab-config.json записью:

"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

Конфигурация клиента MCP

Так как DAB выполняется как подпроцесс, который взаимодействует со стандартными входными и выходными данными, клиент MCP должен запустить DAB в качестве дочернего процесса и каналаstdin.stdout Типичная конфигурация клиента MCP для кода Visual Studio (VS) или совместимого агента выглядит следующим образом:

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

Полное пошаговое руководство см. в стандартном транспорте ввода и вывода для SQL MCP Server.

--verbose

Задает уровень ведения журнала информационным. Это удобный флаг, --LogLevel Informationэквивалентный .

Example

dab start \
  --verbose

--help

Отображение экрана справки.

Example

dab start --help

--version

Отображение сведений о версии.

Example

dab start --version