start perintah

Mulai runtime penyusun API Data dengan file konfigurasi yang ada.

Syntax

dab start [options]

Sekilas

Option Ringkasan
-c, --config Gunakan file konfigurasi tertentu (default ke dab-config.json atau file khusus lingkungan jika ada)

Bagian kepala

Option Ringkasan
--LogLevel <level> Menentukan tingkat pengelogan sebagai nilai yang disediakan.
--mcp-stdio (Protokol Konteks Model (MCP)) Memulai DAB sebagai server MCP yang menggunakan input dan output standar (STDIO) alih-alih HTTP. mcp.enabled: true Memerlukan dalam konfigurasi.
--no-https-redirect Menonaktifkan pengalihan HTTP→HTTPS otomatis
--verbose Mengatur tingkat pengelogan ke Informasional
--help Tampilkan layar bantuan.
--version Tampilkan informasi versi.

-c, --config

Jalur ke file konfigurasi. Default ke dab-config.json kecuali dab-config.<DAB_ENVIRONMENT>.json ada, di mana DAB_ENVIRONMENT adalah variabel lingkungan.

Example

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

--LogLevel <level>

Menentukan tingkat pengelogan sebagai nilai yang disediakan. Untuk nilai yang mungkin, lihat Tingkat log.

Example

dab start \
  --LogLevel Warning

--no-https-redirect

Menonaktifkan pengalihan HTTP→HTTPS otomatis.

Example

dab start \
  --no-https-redirect

--mcp-stdio

Nota

Opsi ini adalah fitur Protokol Konteks Model (MCP) yang tersedia dalam rilis 1.7 dan yang lebih baru. Ini diperlukan "mcp": { "enabled": true } di runtime bagian Dari Anda dab-config.json. Untuk detail konfigurasi MCP lengkap, lihat Gambaran umum SQL MCP Server.

Memulai penyusun DATA API sebagai server MCP yang menggunakan input dan output standar alih-alih mengikat ke port HTTP. Dalam mode ini, DAB berkomunikasi dengan klien MCP (seperti GitHub Copilot, Visual Studio (VS) Code, atau agen AI yang kompatibel dengan MCP) sepenuhnya melalui stdin dan stdout dengan menggunakan Protokol Konteks Model. Tidak ada server HTTP atau port jaringan yang terekspos.

Bendera ini juga menerima argumen posisi role:<role-name> opsional yang menentukan peran izin DAB di mana semua panggilan alat MCP dijalankan. Peran harus cocok dengan nama yang ditentukan di bagian permissions konfigurasi entitas Anda. Jika dihilangkan, fungsi menjadi anonymous.

Saat --mcp-stdio aktif, perilaku berikut diterapkan secara otomatis terlepas dari pengaturan file konfigurasi Anda:

  • Pengodean: Input/output konsol dipaksa ke UTF-8 tanpa tanda urutan byte (BOM) untuk komunikasi input/output standar JSON yang bersih.
  • Autentikasi: Penyedia autentikasi dipaksa ke mode Simulator , memungkinkan peran yang ditentukan tanpa memerlukan JSON Web Token (JWT) nyata atau IdP.
  • Tidak ada host HTTP: DAB tidak mengikat port Protokol Kontrol Transmisi (TCP). Server MCP berjalan sepenuhnya melalui stdin/stdout.

Penting

Awalan role:<name> diperlukan. Jika nama peran tidak cocok dengan peran yang ditentukan dalam izin entitas Anda, panggilan alat MCP ditolak.

Konfigurasi yang diperlukan

MCP harus diaktifkan di Anda dab-config.json sebelum menggunakan --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

Konfigurasi klien MCP

Karena DAB berjalan sebagai subproses yang berkomunikasi melalui input dan output standar, klien MCP Anda harus meluncurkan DAB sebagai proses dan pipa stdin anak dan stdout. Konfigurasi klien MCP umum untuk Kode Visual Studio (VS) atau agen yang kompatibel terlihat seperti:

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

Untuk panduan lengkap, lihat transportasi input dan output standar untuk SQL MCP Server.

--verbose

Mengatur tingkat pengelogan ke Informasional. Ini adalah bendera kenyamanan yang setara --LogLevel Informationdengan .

Example

dab start \
  --verbose

--help

Tampilkan layar bantuan.

Example

dab start --help

--version

Tampilkan informasi versi.

Example

dab start --version