Aracılığıyla paylaş


init komut

Yeni bir Data API builder yapılandırma dosyası başlatın. Elde edilen JSON veri kaynağı ayrıntılarını, etkin uç noktaları (REST, GraphQL, MCP), kimlik doğrulamasını ve çalışma zamanı davranışlarını yakalar.

Sözdizimi

dab init [options]

Hedef yapılandırma dosyası zaten varsa, komut dosyanın üzerine yazar. Birleştirme yok. Önceki dosyayı korumanız gerekiyorsa sürüm denetimini veya yedeklemeleri kullanın.

Hızlı bakış

Seçenek Özet
-c, --config Çıkış yapılandırma dosyası adı (varsayılan dab-config.json)

Authentication

Seçenek Özet
--auth.audience JWT hedef kitle talebi
--auth.issuer JWT veren talebi
--auth.provider Kimlik sağlayıcısı (varsayılan StaticWebApps)

Veri Kaynağı

Seçenek Özet
--connection-string Veritabanı bağlantı dizesi (destekler @env())
--cosmosdb_nosql-container Cosmos DB NoSQL kapsayıcı adı (isteğe bağlı)
--cosmosdb_nosql-database Cosmos DB NoSQL veritabanı adı (cosmosdb_nosql için gereklidir)
--database-type Veritabanı türü: mssql, mysql, postgresql, cosmosdb_postgresql, cosmosdb_nosql
--set-session-context SQL Server oturum bağlamı etkinleştir (yalnızca mssql)

GraphQL

Seçenek Özet
--graphql.disabled Deprecated. GraphQL'i devre dışı bırakır (kullanın --graphql.enabled false)
--graphql.enabled GraphQL'i etkinleştirme (varsayılan true)
--graphql.multiple-create.enabled Birden çok mutasyon oluşturmasına izin ver (varsayılan false)
--graphql.path GraphQL uç nokta ön eki (varsayılan /graphql)
--graphql-schema GraphQL şeması yolu (cosmosdb_nosql için gereklidir)

Konak ve kimlik doğrulaması

Seçenek Özet
--host-mode Konak modu: Geliştirme veya Üretim (varsayılan Üretim)
--cors-origin İzin verilen çıkış noktaları listesi (virgülle ayrılmış)
--runtime.base-route Tüm uç noktalar için genel ön ek

MCP

Seçenek Özet
--mcp.disabled Deprecated. MCP'yi devre dışı bırakır (kullanın --mcp.enabled false)
--mcp.enabled MCP'yi etkinleştirme (varsayılan true)
--mcp.path MCP uç nokta ön eki (varsayılan /mcp)

Uyarı

MCP özelliği sürüm 1.7'nin bir parçası olacaktır.

REST

Seçenek Özet
--rest.disabled Deprecated. REST'i devre dışı bırakır (kullanın --rest.enabled false)
--rest.enabled REST'i etkinleştirme (varsayılan true, tercih yerine --rest.disabled)
--rest.path REST uç nokta ön eki (varsayılan /api, cosmosdb_nosql için yoksayılır)
--rest.request-body-strict Katı istek gövdesi doğrulamasını zorunlu kılma (varsayılan true, cosmosdb_nosql için yoksayılır)

Önemli

Yeni --*.enabled bayrakları ve aynı alt sistemin eski --*.disabled bayraklarını aynı komutta karıştırmayın. Deseni --*.enabled tercih edin; --rest.disabled, --graphql.disabledve --mcp.disabled seçenekleri uyarıları günlüğe kaydeder ve gelecek sürümlerde kaldırılır.

-c, --config

Çıkış yapılandırma dosyası adı. Varsayılan dab-config.json değeridir.

Example

dab init --database-type mssql --config dab-config.local.json

Sonuçta elde edilen yapılandırma

{
  "data-source": {
    "database-type": "mssql",
    "connection-string": "@env('MSSQL_CONNECTION_STRING')"
  }
}

--auth.audience

JWT hedef kitle talebi.

Example

dab init --database-type mssql --auth.audience "https://example.com/api"

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "authentication": {
      "audience": "https://example.com/api"
    }
  }
}

--auth.issuer

JWT veren talebi.

Example

dab init --database-type mssql --auth.issuer "https://login.microsoftonline.com/{tenant-id}/v2.0"

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "authentication": {
      "issuer": "https://login.microsoftonline.com/{tenant-id}/v2.0"
    }
  }
}

--auth.provider

Kimlik sağlayıcısı. Varsayılan StaticWebApps değeridir.

Example

dab init --database-type mssql --auth.provider AzureAD

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "authentication": {
      "provider": "AzureAD"
    }
  }
}

--connection-string

Veritabanı bağlantı dizesi. destekler @env().

Example

dab init --database-type mssql --connection-string "@env('MSSQL_CONNECTION_STRING')"

Sonuçta elde edilen yapılandırma

{
  "data-source": {
    "connection-string": "@env('MSSQL_CONNECTION_STRING')"
  }
}

--cors-origin

İzin verilen çıkış noktalarının virgülle ayrılmış listesi.

Example

dab init --database-type mssql --cors-origin "https://app.example.com,https://admin.example.com"

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "cors": {
      "origins": [ "https://app.example.com", "https://admin.example.com" ]
    }
  }
}

--cosmosdb_nosql-container

Cosmos DB NoSQL kapsayıcı adı.

Example

dab init --database-type cosmosdb_nosql --cosmosdb_nosql-container MyContainer

Sonuçta elde edilen yapılandırma

{
  "data-source": {
    "database-type": "cosmosdb_nosql",
    "options": {
      "container": "MyContainer"
    }
  }
}

--cosmosdb_nosql-database

Cosmos DB NoSQL veritabanı adı. için cosmosdb_nosqlgereklidir.

Example

dab init --database-type cosmosdb_nosql --cosmosdb_nosql-database MyDb

Sonuçta elde edilen yapılandırma

{
  "data-source": {
    "database-type": "cosmosdb_nosql",
    "options": {
      "database": "MyDb"
    }
  }
}

--database-type

Hedef veritabanı altyapısını belirtir. Desteklenen değerler: mssql, mysql, postgresql, cosmosdb_postgresql, cosmosdb_nosql.

Example

dab init --database-type mssql

Sonuçta elde edilen yapılandırma

{
  "data-source": {
    "database-type": "mssql"
  }
}

--graphql.disabled

Deprecated. GraphQL'i devre dışı bırakır. tercih edin --graphql.enabled false.

--graphql.enabled

GraphQL uç noktasını etkinleştirin. Varsayılan true değeridir.

Example

dab init --database-type mssql --graphql.enabled false

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "graphql": {
      "enabled": false
    }
  }
}

--graphql.multiple-create.enabled

Tek bir mutasyonda birden çok satır oluşturmaya izin verir. Varsayılan false değeridir.

Example

dab init --database-type mssql --graphql.multiple-create.enabled true

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "graphql": {
      "multiple-create": { "enabled": true }
    }
  }
}

--graphql.path

GraphQL uç nokta ön eki. Varsayılan /graphql değeridir.

Example

dab init --database-type mssql --graphql.path /gql

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "graphql": {
      "path": "/gql"
    }
  }
}

--graphql-schema

GraphQL şema dosyasının yolu. için cosmosdb_nosqlgereklidir.

Example

dab init --database-type cosmosdb_nosql --graphql-schema ./schema.gql

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "graphql": {
      "schema": "./schema.gql"
    }
  }
}

--host-mode

Konak modu. Varsayılan Production değeridir.

Geçerli değerler: Development, Production.

Example

dab init --database-type mssql --host-mode development

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "host": {
      "mode": "development"
    }
  }
}

--mcp.disabled

Deprecated. MCP'yi devre dışı bırakır. tercih edin --mcp.enabled false.

--mcp.enabled

MCP uç noktasını etkinleştirin. Varsayılan true değeridir.

Example

dab init --database-type mssql --mcp.enabled false

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "mcp": {
      "enabled": false
    }
  }
}

--mcp.path

MCP uç nokta ön eki. Varsayılan /mcp değeridir.

Example

dab init --database-type mssql --mcp.path /model

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "mcp": {
      "path": "/model"
    }
  }
}

--rest.disabled

Deprecated. REST'i devre dışı bırakır. tercih edin --rest.enabled false.

--rest.enabled

REST uç noktasını etkinleştirin. Varsayılan true değeridir.

Example

dab init --database-type mssql --rest.enabled false

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "rest": {
      "enabled": false
    }
  }
}

--rest.path

REST uç nokta ön eki. Varsayılan /api değeridir.

Uyarı

için cosmosdb_nosqlyoksayıldı.

Example

dab init --database-type mssql --rest.path /rest

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "rest": {
      "path": "/rest"
    }
  }
}

--rest.request-body-strict

İstek gövdelerindeki ek alanların işlenmesini denetler. Varsayılan true değeridir.

  • true: Fazlalık alanları reddeder (HTTP 400).
  • false: Ek alanları yoksayar.

Uyarı

için cosmosdb_nosqlyoksayıldı.

Example

dab init --database-type mssql --rest.request-body-strict false

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "rest": {
      "request-body-strict": false
    }
  }
}

--runtime.base-route

Genel ön ek tüm uç noktalara eklenir. ile /başlamalıdır.

Example

dab init --database-type mssql --runtime.base-route /v1

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "base-route": "/v1"
  }
}

--set-session-context

Oturum bağlamı kullanarak SQL Server'a veri göndermeyi etkinleştirin. Yalnızca için mssqlgeçerlidir. Varsayılan false değeridir.

Example

dab init --database-type mssql --set-session-context true

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "mssql": {
      "set-session-context": true
    }
  }
}