start komut

Data API builder çalışma zamanını mevcut bir yapılandırma dosyasıyla başlatın.

Sözdizimi

dab start [options]

Hızlı bakış

Seçenek Özet
-c, --config Belirli bir yapılandırma dosyası kullanın (varsa varsayılan olarak dab-config.json veya ortama özgü dosya)

Baş bölüm

Seçenek Özet
--LogLevel <level> Günlük düzeyini sağlanan değer olarak belirtir.
--mcp-stdio (Model Bağlam Protokolü (MCP)) DAB'yi HTTP yerine standart giriş ve çıkış (STDIO) kullanan bir MCP sunucusu olarak başlatır. Yapılandırmada gerektirir mcp.enabled: true .
--no-https-redirect Otomatik HTTP→HTTPS yeniden yönlendirmesini devre dışı bırakır
--verbose Günlüğe kaydetme düzeyini Bilgilendiren olarak ayarlar
--help Yardım ekranını görüntüleyin.
--version Sürüm bilgilerini görüntüleme.

-c, --config

Yapılandırma dosyasının yolu. Varsayılan olarakdab-config.json, ortam değişkeni olduğu dab-config.<DAB_ENVIRONMENT>.json sürece DAB_ENVIRONMENT olarak ayarlanır.

Example

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

--LogLevel <level>

Günlük düzeyini sağlanan değer olarak belirtir. Olası değerler için bkz . Günlük düzeyleri.

Example

dab start \
  --LogLevel Warning

--no-https-redirect

Otomatik HTTP→HTTPS yeniden yönlendirmesini devre dışı bırakır.

Example

dab start \
  --no-https-redirect

--mcp-stdio

Uyarı

Bu seçenek, sürüm ve sonraki sürümlerde 1.7 kullanılabilen bir Model Bağlam Protokolü (MCP) özelliğidir. bu, öğesinin dab-config.jsonbölümünde gereklidir."mcp": { "enabled": true }runtime TAM MCP yapılandırma ayrıntıları için bkz. SQL MCP Server'a genel bakış.

Data API builder'ı BIR HTTP bağlantı noktasına bağlamak yerine standart giriş ve çıkış kullanan bir MCP sunucusu olarak başlatır. Bu modda DAB, Bir MCP istemcisiyle (GitHub Copilot, Visual Studio (VS) Code veya MCP uyumlu herhangi bir yapay zeka aracısı gibi) tamamen ve stdinstdoutModel Bağlam Protokolü kullanarak iletişim kurar. Hiçbir HTTP sunucusu veya ağ bağlantı noktası kullanıma sunulmaz.

Bu bayrak, tüm MCP araç çağrılarının yürütüldiği DAB izin rolünü belirten isteğe bağlı bir konumsal role:<role-name> bağımsız değişken de kabul eder. Rol, varlık yapılandırmanızın bölümünde tanımlanan permissions bir adla eşleşmelidir. Eksik bırakılırsa, rol varsayılan olarak anonymous olur.

Etkin olduğunda --mcp-stdio , yapılandırma dosyası ayarlarınızdan bağımsız olarak aşağıdaki davranışlar otomatik olarak uygulanır:

  • Kodlama: Konsol girişi/çıkışı, standart üzerinden temiz JSON giriş/çıkış iletişimi için bayt sipariş işareti (BOM) olmadan UTF-8'e zorlanır.
  • Kimlik doğrulaması: Kimlik doğrulama sağlayıcısı, gerçek bir JSON Web Belirteci (JWT) veya kimlik sağlayıcısı gerektirmeden belirtilen rolü etkinleştirerek Simülatör moduna zorlanır.
  • HTTP ana bilgisayarı yok: DAB herhangi bir İletim Denetimi Protokolü (TCP) bağlantı noktasına bağlanmaz. MCP sunucusu tamamen stdin/stdout üzerinde çalışır.

Önemli

Ön role:<name> ek gereklidir. Rol adı varlık izinlerinde tanımlanan bir rolle eşleşmiyorsa, MCP araç çağrıları reddedilir.

Gerekli yapılandırma

kullanmadan önce --mcp-stdioMCP'nin cihazınızda dab-config.json etkinleştirilmesi gerekir:

"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 istemci yapılandırması

DAB standart giriş ve çıkış üzerinden iletişim kuran bir alt işlem olarak çalıştığından, MCP istemcinizin DAB'yi alt işlem ve kanal ve olarak başlatması stdinstdoutgerekir. Visual Studio (VS) Kodu veya uyumlu bir aracı için tipik bir MCP istemci yapılandırması şöyle görünür:

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

Tam bir izlenecek yol için bkz. SQL MCP Server için standart giriş ve çıkış aktarımı.

--verbose

Günlük düzeyini Bilgilendirildi olarak ayarlar. Bu, ile --LogLevel Informationeşdeğer bir kolaylık bayrağıdır.

Example

dab start \
  --verbose

--help

Yardım ekranını görüntüleyin.

Example

dab start --help

--version

Sürüm bilgilerini görüntüleme.

Example

dab start --version