다음을 통해 공유

start 명령

기존 구성 파일을 사용하여 Data API Builder 런타임을 시작합니다.

Syntax

dab start [options]

한눈에 보기

Option 요약
-c, --config 특정 구성 파일 사용(기본값 또는 dab-config.json 환경별 파일(있는 경우)

헤드 섹션

Option 요약
--LogLevel <level> 로깅 수준을 제공된 값으로 지정합니다.
--mcp-stdio (MCP(모델 컨텍스트 프로토콜)) DAB를 HTTP 대신 STDIO(표준 입력 및 출력)를 사용하는 MCP 서버로 시작합니다. 구성에 mcp.enabled: true 필요합니다.
--no-https-redirect 자동 HTTP→HTTPS 리디렉션을 사용하지 않도록 설정
--verbose 로깅 수준을 Informational로 설정
--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

비고

이 옵션은 릴리스 1.7 이상에서 사용할 수 있는 MCP(모델 컨텍스트 프로토콜) 기능입니다. 의 섹션dab-config.json에 runtime 필요합니다"mcp": { "enabled": true }. 전체 MCP 구성 세부 정보는 SQL MCP Server 개요를 참조하세요.

데이터 API 작성기를 HTTP 포트에 바인딩하는 대신 표준 입력 및 출력을 사용하는 MCP 서버로 시작합니다. 이 모드에서 DAB는 모델 컨텍스트 프로토콜을 사용하여 MCP 클라이언트(예: GitHub Copilot, VS(Visual Studio) 코드 또는 MCP 호환 AI 에이전트)와 stdout 완전히 stdin 통신합니다. HTTP 서버 또는 네트워크 포트가 노출되지 않습니다.

또한 이 플래그는 모든 MCP 도구 호출이 실행되는 DAB 권한 역할을 지정하는 선택적 위치 role:<role-name> 인수를 허용합니다. 역할은 엔터티 구성 섹션에 permissions 정의된 이름과 일치해야 합니다. 생략하면 역할은 기본적으로 anonymous로 설정됩니다.

활성 상태이면 --mcp-stdio 구성 파일 설정에 관계없이 다음 동작이 자동으로 적용됩니다.

  • 인코딩: 콘솔 입력/출력은 깨끗한 JSON-over-standard 입력/출력 통신을 위해 BOM(바이트 순서 표시) 없이 UTF-8로 강제 적용됩니다.
  • 인증: 인증 공급자는 실제 JWT(JSON 웹 토큰) 또는 ID 공급자를 요구하지 않고 지정된 역할을 사용하도록 설정하여 시뮬레이터 모드로 강제 적용됩니다.
  • HTTP 호스트 없음: DAB는 TCP(Transmission Control Protocol) 포트에 바인딩하지 않습니다. MCP 서버는 완전히 stdin/stdout을 통해 실행됩니다.

중요합니다

role:<name> 접두사는 필수입니다. 역할 이름이 엔터티 권한에 정의된 역할과 일치하지 않으면 MCP 도구 호출이 거부됩니다.

필수 구성

다음을 사용하기 --mcp-stdio전에 MCP를 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 클라이언트는 자식 프로세스 및 파이프 stdinstdout로 DAB를 시작해야 합니다. VS(Visual Studio) 코드 또는 호환되는 에이전트에 대한 일반적인 MCP 클라이언트 구성은 다음과 같습니다.

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

전체 연습은 SQL MCP Server에 대한 표준 입력 및 출력 전송을 참조하세요.

--verbose

로깅 수준을 Informational로 설정합니다. 이 플래그는 .에 해당하는 편리한 플래그입니다 --LogLevel Information.

Example

dab start \
  --verbose

--help

도움말 화면을 표시합니다.

Example

dab start --help

--version

버전 정보를 표시합니다.

Example

dab start --version
  • Last updated on