Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
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
}
}
}