configure komut

Var olan bir Data API builder yapılandırma dosyasında varlığa özgü olmayan çalışma zamanı ve veri kaynağı özelliklerini yapılandırın. Belirtilmeyen seçenekler var olan değerleri değiştirmeden bırakır. Sağlanan seçeneklerden biri geçersizse güncelleştirmenin tamamı başarısız olur (tümü veya hiçbiri).

Bu başvuruda kullanılan kısaltmalar: Model Bağlam Protokolü (MCP), veri işleme dili (DML), yaşam süresi (TTL), JSON Web Belirteci (JWT), yayın adayı (RC), veri toplama kuralı (DCR) ve veri toplama uç noktası (DCE).

Uyarı

Bu komut bölümü değiştirmez entities . Varlık değişiklikleri için kullanın dab update .

Sözdizimi

dab configure [options]

Önemli

OpenTelemetry ve Application Insights ayarları ile dab add-telemetrydeğil ile dab configureyapılandırılır. Bkz. concept/monitor/open-telemetry.md ve concept/monitor/application-insights.md.

Hızlı bakış

Seçenek Özet
-c, --config Yapılandırma dosyasının yolu (varsayılan dab-config.json).

Veri kaynağı bölümü

Seçenek Özet
--data-source.database-type Veritabanı türünü ayarlayın.
--data-source.connection-string Veritabanı bağlantı dizesini ayarlayın.
--data-source.options.database NoSql için Cosmos DB veritabanı adı.
--data-source.options.container NoSql için Cosmos DB kapsayıcı adı.
--data-source.options.schema NoSql için Cosmos DB şema yolu.
--data-source.options.set-session-context Oturum bağlamı'nı etkinleştirin veya devre dışı bırakın. Varsayılan: false.
--data-source.health.enabled Veri kaynağı sistem durumu denetimini etkinleştirin veya devre dışı bırakın.
--data-source.health.name Durum denetimi raporundaki veri kaynağının tanımlayıcısı.
--data-source.health.threshold-ms Milisaniye cinsinden sistem durumu denetimi sorgu eşiği.
--data-source.user-delegated-auth.enabled OBO kullanıcı temsilcisi kimlik doğrulamasını etkinleştirin.
--data-source.user-delegated-auth.provider OBO kimlik sağlayıcısını ayarlayın.
--data-source.user-delegated-auth.database-audience Aşağı akış SQL belirteci için hedef kitle.
--data-source-files Ek veri kaynağı yapılandırma dosyalarına başvurun.

GraphQL bölümü

Seçenek Özet
--runtime.graphql.depth-limit Maksimum sorgu derinliğini sınırlayın.
--runtime.graphql.enabled GraphQL uç noktasını etkinleştirin veya devre dışı bırakın.
--runtime.graphql.path GraphQL uç nokta yolunu özelleştirin.
--runtime.graphql.allow-introspection GraphQL introspection'a izin verme veya reddetme.
--runtime.graphql.multiple-mutations.create.enabled Çoklu değişimleri etkinleştir.

REST bölümü

Seçenek Özet
--runtime.rest.enabled REST uç noktasını etkinleştirin veya devre dışı bırakın.
--runtime.rest.path REST uç nokta yolunu özelleştirin.
--runtime.rest.request-body-strict Katı REST isteği gövdesi doğrulamayı zorunlu kılma.

Sayfalandırma bölümü

Seçenek Özet
--runtime.pagination.max-page-size Sayfalandırılmış sonuçlar için en büyük sayfa boyutu.
--runtime.pagination.default-page-size Sayfalandırılmış sonuçlar için varsayılan sayfa boyutu.
--runtime.pagination.next-link-relative REST sayfalandırma sonraki bağlantılarında göreli URL'leri kullanın.

MCP bölümü

Seçenek Özet
--runtime.mcp.enabled MCP uç noktasını etkinleştirin veya devre dışı bırakın.
--runtime.mcp.path MCP uç noktası yolunu özelleştirin.
--runtime.mcp.description MCP sunucusu açıklamasını ayarlayın.
--runtime.mcp.dml-tools Tüm MCP DML araçlarını etkinleştirin veya devre dışı bırakın.
--runtime.mcp.dml-tools.describe-entities Describe-entities aracını etkinleştirin veya devre dışı bırakın.
--runtime.mcp.dml-tools.create-record Kayıt oluşturma aracını etkinleştirin veya devre dışı bırakın.
--runtime.mcp.dml-tools.read-records Okuma kayıtları aracını etkinleştirin veya devre dışı bırakın.
--runtime.mcp.dml-tools.update-record Güncelleştirme kaydı aracını etkinleştirin veya devre dışı bırakın.
--runtime.mcp.dml-tools.delete-record Kayıt silme aracını etkinleştirin veya devre dışı bırakın.
--runtime.mcp.dml-tools.execute-entity Execute-entity aracını etkinleştirin veya devre dışı bırakın.
--runtime.mcp.dml-tools.aggregate-records Toplama kayıtları aracını etkinleştirin veya devre dışı bırakın.
--runtime.mcp.dml-tools.aggregate-records.query-timeout Toplama kayıtları için saniyeler içinde yürütme zaman aşımı.

Önbellek bölümü

Seçenek Özet
--runtime.cache.enabled Genel önbelleği etkinleştirin veya devre dışı bırakın.
--runtime.cache.ttl-seconds Saniyeler içinde genel önbellek TTL'si.
--runtime.compression.level HTTP yanıt sıkıştırma düzeyini ayarlayın.

Konak bölümü

Seçenek Özet
--runtime.host.mode Konak modunu ayarlama: Geliştirme veya Üretim.
--runtime.host.max-response-size-mb Megabayt cinsinden maksimum yanıt boyutu.
--runtime.host.cors.origins İzin verilen CORS kaynakları.
--runtime.host.cors.allow-credentials CORS allow-credentials'i ayarlayın.
--runtime.host.authentication.provider Kimlik doğrulama sağlayıcısı.
--runtime.host.authentication.jwt.audience JWT hedef kitle talebi.
--runtime.host.authentication.jwt.issuer JWT veren talebi.

Sistem durumu bölümü

Seçenek Özet
--runtime.health.enabled Genel sistem durumu uç noktasını etkinleştirin veya devre dışı bırakın.
--runtime.health.cache-ttl-seconds Sistem durumu denetimi raporları için TTL'i önbelleğe alın.
--runtime.health.max-query-parallelism En fazla eşzamanlı sistem durumu denetimi sorgusu.
--runtime.health.roles Rollerin kapsamlı sistem durumu sonuçlarını görüntülemesine izin verilir.

Etkili izinler

Seçenek Özet
--show-effective-permissions Tüm varlıklar için çözümlenmiş izinleri görüntüleyin.

Key Vault bölümü

Seçenek Özet
--azure-key-vault.endpoint Azure Key Vault temel uç noktası.
--azure-key-vault.retry-policy.mode İlke modunu yeniden deneyin.
--azure-key-vault.retry-policy.max-count En fazla yeniden deneme denemesi.
--azure-key-vault.retry-policy.delay-seconds Yeniden denemeler arasındaki gecikme.
--azure-key-vault.retry-policy.max-delay-seconds Üstel yeniden denemeler için maksimum gecikme.
--azure-key-vault.retry-policy.network-timeout-seconds Ağ çağrıları için zaman aşımı.

Telemetri bölümü

Seçenek Özet
--runtime.telemetry.log-level Günlüğe kaydetme ayrıntı düzeyini ad alanına göre yapılandırın.
--runtime.telemetry.azure-log-analytics.enabled Azure Log Analytics telemetrisini etkinleştirin.
--runtime.telemetry.azure-log-analytics.dab-identifier Günlük kaynağını ayırt edin.
--runtime.telemetry.azure-log-analytics.flush-interval-seconds Tempoyu saniyeler içinde boşalt.
--runtime.telemetry.azure-log-analytics.auth.custom-table-name Özel tablo adı.
--runtime.telemetry.azure-log-analytics.auth.dcr-immutable-id Veri Toplama Kuralı Kimliği.
--runtime.telemetry.azure-log-analytics.auth.dce-endpoint Veri Toplama Uç Noktası.
--runtime.telemetry.file.enabled Dosya havuzu telemetrisini etkinleştirin.
--runtime.telemetry.file.path Günlük dosyasının yolu.
--runtime.telemetry.file.rolling-interval Sıralı aralık.
--runtime.telemetry.file.retained-file-count-limit Tutulan en fazla dosya sayısı.
--runtime.telemetry.file.file-size-limit-bytes Döndürmeden önce dosya başına en büyük boyut.

-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 configure \
  --config ./dab-config.json \
  --runtime.rest.enabled true

--data-source.database-type

Veritabanı türü.

İzin verilen değerler:

  • MSSQL
  • DWSQL
  • PostgreSQL
  • CosmosDB_PostgreSQL
  • CosmosDB_NoSQL
  • MySQL

Example

dab configure \
  --data-source.database-type PostgreSQL

Sonuçta elde edilen yapılandırma

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

--data-source.connection-string

Veri kaynağı için bağlantı dizesi.

Example

dab configure \
  --data-source.connection-string "Server=myserver;Database=mydb;User Id=myuser;Password=mypassword;"

Sonuçta elde edilen yapılandırma

{
  "data-source": {
    "connection-string": "Server=myserver;Database=mydb;User Id=myuser;Password=mypassword;"
  }
}

--data-source-files

Kök yapılandırma dosyasından ek veri kaynağı yapılandırma dosyalarına başvurun.

Example

dab configure \
  --data-source-files ./dab-config.sales.json

Sonuçta elde edilen yapılandırma

{
  "data-source-files": [
    "./dab-config.sales.json"
  ]
}

--data-source.options.database

NoSql için Cosmos DB veritabanı adı.

Example

dab configure \
  --data-source.options.database MyCosmosDatabase

Sonuçta elde edilen yapılandırma

{
  "data-source": {
    "options": {
      "database": "MyCosmosDatabase"
    }
  }
}

--data-source.options.container

NoSql için Cosmos DB kapsayıcı adı.

Example

dab configure \
  --data-source.options.container MyCosmosContainer

Sonuçta elde edilen yapılandırma

{
  "data-source": {
    "options": {
      "container": "MyCosmosContainer"
    }
  }
}

--data-source.options.schema

NoSql için Cosmos DB şema yolu.

Example

dab configure \
  --data-source.options.schema ./schema.gql

Sonuçta elde edilen yapılandırma

{
  "data-source": {
    "options": {
      "schema": "./schema.gql"
    }
  }
}

--data-source.options.set-session-context

Oturum bağlamı'nı etkinleştirin.

İzin verilen değerler:

  • true
  • false (varsayılan)

Example

dab configure \
  --data-source.options.set-session-context false

Sonuçta elde edilen yapılandırma

{
  "data-source": {
    "options": {
      "set-session-context": false
    }
  }
}

--data-source.health.enabled

Veri kaynağı için sistem durumu denetimini etkinleştirin veya devre dışı bırakın. Varsayılan true değeridir.

Example

dab configure \
  --data-source.health.enabled false

Sonuçta elde edilen yapılandırma

{
  "data-source": {
    "health": {
      "enabled": false
    }
  }
}

--data-source.health.name

Durum denetimi raporundaki veri kaynağının tanımlayıcısı.

Example

dab configure \
  --data-source.health.name my-sql-health

Sonuçta elde edilen yapılandırma

{
  "data-source": {
    "health": {
      "name": "my-sql-health"
    }
  }
}

--data-source.health.threshold-ms

Veri kaynağı sistem durumu denetimi sorgusu için milisaniye cinsinden en uzun süre. Varsayılan 1000 değeridir.

Example

dab configure \
  --data-source.health.threshold-ms 750

Sonuçta elde edilen yapılandırma

{
  "data-source": {
    "health": {
      "threshold-ms": 750
    }
  }
}

--data-source.user-delegated-auth.enabled

Behalf-Of (OBO) kullanıcı tarafından atanan kimlik doğrulamasını etkinleştirin veya devre dışı bırakın. Yalnızca veri kaynakları için mssql desteklenir.

Uyarı

Bu bölümde açıklanan Veri API oluşturucusu 2.0 işlevselliği şu anda önizleme aşamasındadır ve genel kullanılabilirlik öncesinde değişebilir. Daha fazla bilgi için bkz. Sürüm 2.0'daki yenilikler.

Example

dab configure \
  --data-source.user-delegated-auth.enabled true

Sonuçta elde edilen yapılandırma

{
  "data-source": {
    "user-delegated-auth": {
      "enabled": true
    }
  }
}

--data-source.user-delegated-auth.provider

Behalf-Of (OBO) kullanıcı tarafından atanan kimlik doğrulaması için kimlik sağlayıcısını ayarlayın. Şu anda yalnızca EntraId desteklenmektedir.

Uyarı

Bu bölümde açıklanan Veri API oluşturucusu 2.0 işlevselliği şu anda önizleme aşamasındadır ve genel kullanılabilirlik öncesinde değişebilir. Daha fazla bilgi için bkz. Sürüm 2.0'daki yenilikler.

Example

dab configure \
  --data-source.user-delegated-auth.provider EntraId

Sonuçta elde edilen yapılandırma

{
  "data-source": {
    "user-delegated-auth": {
      "provider": "EntraId"
    }
  }
}

--data-source.user-delegated-auth.database-audience

OBO etkinleştirildiğinde aşağı akış SQL belirtecinin hedef hedef kitlesini ayarlayın.

Example

dab configure \
  --data-source.user-delegated-auth.database-audience "https://database.windows.net"

Sonuçta elde edilen yapılandırma

{
  "data-source": {
    "user-delegated-auth": {
      "database-audience": "https://database.windows.net"
    }
  }
}

--runtime.graphql.depth-limit

İç içe sorgunun izin verilen maksimum derinliği.

İzin verilen değerler:

  • $(0,2147483647]$ (dahil)
  • -1 sınırı kaldırmak için

Example

dab configure \
  --runtime.graphql.depth-limit 3

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "graphql": {
      "depth-limit": 3
    }
  }
}

--runtime.graphql.enabled

DAB'nin GraphQL uç noktasını etkinleştirin.

Example

dab configure \
  --runtime.graphql.enabled false

Sonuçta elde edilen yapılandırma

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

--runtime.graphql.path

DAB'nin GraphQL uç nokta yolunu özelleştirin. ile /ön ek yolu.

Example

dab configure \
  --runtime.graphql.path /graphql

Sonuçta elde edilen yapılandırma

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

--runtime.graphql.allow-introspection

GraphQL introspection isteklerine izin verin veya reddedin.

Example

dab configure \
  --runtime.graphql.allow-introspection false

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "graphql": {
      "allow-introspection": false
    }
  }
}

--runtime.graphql.multiple-mutations.create.enabled

Oluşturulan GraphQL şemasında çoklu mutasyon oluşturma işlemlerini etkinleştirin veya devre dışı bırakın.

Example

dab configure \
  --runtime.graphql.multiple-mutations.create.enabled true

Sonuçta elde edilen yapılandırma

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

--runtime.rest.enabled

DAB'nin REST uç noktasını etkinleştirin.

Example

dab configure \
  --runtime.rest.enabled false

Sonuçta elde edilen yapılandırma

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

--runtime.rest.path

DAB'ın REST uç nokta yolunu özelleştirin. ile /ön ek yolu.

Example

dab configure \
  --runtime.rest.path /myapi

Sonuçta elde edilen yapılandırma

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

--runtime.rest.request-body-strict

Gereksiz REST isteği gövde alanlarını yasakla.

Example

dab configure \
  --runtime.rest.request-body-strict true

Sonuçta elde edilen yapılandırma

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

--runtime.pagination.max-page-size

Sayfalandırılmış sonuçlar için en büyük sayfa boyutu. Varsayılan 100000 değeridir. En az değeridir 1.

Example

dab configure \
  --runtime.pagination.max-page-size 50000

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "pagination": {
      "max-page-size": 50000
    }
  }
}

--runtime.pagination.default-page-size

Sayfalandırılmış sonuçlar için varsayılan sayfa boyutu. Varsayılan 100 değeridir. En az değeridir 1.

Example

dab configure \
  --runtime.pagination.default-page-size 50

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "pagination": {
      "default-page-size": 50
    }
  }
}

--runtime.pagination.next-link-relative

REST sayfalandırma nextLink değerlerinde mutlak URL'ler yerine göreli URL'ler kullanın. Varsayılan false değeridir.

Example

dab configure \
  --runtime.pagination.next-link-relative true

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "pagination": {
      "next-link-relative": true
    }
  }
}

--runtime.mcp.enabled

DAB'nin MCP uç noktasını etkinleştirin.

Uyarı

Bu seçenek, Veri API oluşturucusu 2.0 önizleme CLI'sında kullanılabilir. ile dotnet tool install microsoft.dataapibuilder --prereleaseen son ön sürümü yükleyin.

Example

dab configure \
  --runtime.mcp.enabled false

Sonuçta elde edilen yapılandırma

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

--runtime.mcp.path

DAB'ın MCP uç nokta yolunu özelleştirin. ile /ön ek yolu.

Uyarı

Bu seçenek, Veri API oluşturucusu 2.0 önizleme CLI'sında kullanılabilir. ile dotnet tool install microsoft.dataapibuilder --prereleaseen son ön sürümü yükleyin.

Example

dab configure \
  --runtime.mcp.path /mcp2

Sonuçta elde edilen yapılandırma

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

--runtime.mcp.description

Başlatılan yanıtta kullanıma sunulacak MCP sunucu açıklamasını ayarlayın.

Uyarı

Bu seçenek, Veri API oluşturucusu 2.0 önizleme CLI'sında kullanılabilir. ile dotnet tool install microsoft.dataapibuilder --prereleaseen son ön sürümü yükleyin.

Example

dab configure \
  --runtime.mcp.description "My MCP Server"

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "mcp": {
      "description": "My MCP Server"
    }
  }
}

--runtime.mcp.dml-tools

DAB'nin MCP DML araçları uç noktasını etkinleştirin.

Uyarı

Bu seçenek, Veri API oluşturucusu 2.0 önizleme CLI'sında kullanılabilir. ile dotnet tool install microsoft.dataapibuilder --prereleaseen son ön sürümü yükleyin.

MCP DML araçları hakkında daha fazla bilgi için bkz. SQL MCP Server veri işleme dili araçları.

Example

dab configure \
  --runtime.mcp.dml-tools false

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "mcp": {
      "dml-tools": false
    }
  }
}

--runtime.mcp.dml-tools.describe-entities

DAB'nin MCP açık varlık aracını etkinleştirin.

Uyarı

Bu seçenek, Veri API oluşturucusu 2.0 önizleme CLI'sında kullanılabilir. ile dotnet tool install microsoft.dataapibuilder --prereleaseen son ön sürümü yükleyin.

Example

dab configure \
  --runtime.mcp.dml-tools.describe-entities false

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "mcp": {
      "dml-tools": {
        "describe-entities": false
      }
    }
  }
}

--runtime.mcp.dml-tools.create-record

DAB'nin MCP kayıt oluşturma aracını etkinleştirin.

Uyarı

Bu seçenek, Veri API oluşturucusu 2.0 önizleme CLI'sında kullanılabilir. ile dotnet tool install microsoft.dataapibuilder --prereleaseen son ön sürümü yükleyin.

Example

dab configure \
  --runtime.mcp.dml-tools.create-record false

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "mcp": {
      "dml-tools": {
        "create-record": false
      }
    }
  }
}

--runtime.mcp.dml-tools.read-records

DAB'nin MCP okuma kayıt aracını etkinleştirin.

Uyarı

Bu seçenek, Veri API oluşturucusu 2.0 önizleme CLI'sında kullanılabilir. ile dotnet tool install microsoft.dataapibuilder --prereleaseen son ön sürümü yükleyin.

Example

dab configure \
  --runtime.mcp.dml-tools.read-records false

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "mcp": {
      "dml-tools": {
        "read-records": false
      }
    }
  }
}

--runtime.mcp.dml-tools.update-record

DAB'nin MCP güncelleştirme kayıt aracını etkinleştirin.

Uyarı

Bu seçenek, Veri API oluşturucusu 2.0 önizleme CLI'sında kullanılabilir. ile dotnet tool install microsoft.dataapibuilder --prereleaseen son ön sürümü yükleyin.

Example

dab configure \
  --runtime.mcp.dml-tools.update-record false

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "mcp": {
      "dml-tools": {
        "update-record": false
      }
    }
  }
}

--runtime.mcp.dml-tools.delete-record

DAB'nin MCP kayıt silme aracını etkinleştirin.

Uyarı

Bu seçenek, Veri API oluşturucusu 2.0 önizleme CLI'sında kullanılabilir. ile dotnet tool install microsoft.dataapibuilder --prereleaseen son ön sürümü yükleyin.

Example

dab configure \
  --runtime.mcp.dml-tools.delete-record false

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "mcp": {
      "dml-tools": {
        "delete-record": false
      }
    }
  }
}

--runtime.mcp.dml-tools.execute-entity

DAB'nin MCP yürütme varlık aracını etkinleştirin.

Uyarı

Bu seçenek, Veri API oluşturucusu 2.0 önizleme CLI'sında kullanılabilir. ile dotnet tool install microsoft.dataapibuilder --prereleaseen son ön sürümü yükleyin.

Example

dab configure \
  --runtime.mcp.dml-tools.execute-entity false

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "mcp": {
      "dml-tools": {
        "execute-entity": false
      }
    }
  }
}

--runtime.mcp.dml-tools.aggregate-records

DAB'ın MCP toplama kayıtları aracını etkinleştirin.

Uyarı

Bu seçenek, Veri API oluşturucusu 2.0 önizleme CLI'sında kullanılabilir. ile dotnet tool install microsoft.dataapibuilder --prereleaseen son ön sürümü yükleyin.

Example

dab configure \
  --runtime.mcp.dml-tools.aggregate-records false

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "mcp": {
      "dml-tools": {
        "aggregate-records": false
      }
    }
  }
}

--runtime.mcp.dml-tools.aggregate-records.query-timeout

Toplama kayıtları MCP aracının yürütme zaman aşımını saniye olarak ayarlayın.

Varsayılan: 30. Aralık: 1-600.

Uyarı

Bu seçenek, Veri API oluşturucusu 2.0 önizleme CLI'sında kullanılabilir. ile dotnet tool install microsoft.dataapibuilder --prereleaseen son ön sürümü yükleyin.

Example

dab configure \
  --runtime.mcp.dml-tools.aggregate-records.query-timeout 60

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "mcp": {
      "dml-tools": {
        "aggregate-records": {
          "enabled": true,
          "query-timeout": 60
        }
      }
    }
  }
}

--runtime.cache.enabled

DAB önbelleğini genel olarak etkinleştirin. Ayrıca her varlık için önbelleğe almayı etkinleştirmeniz gerekir.

Example

dab configure \
  --runtime.cache.enabled true

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "cache": {
      "enabled": true
    }
  }
}

--runtime.cache.ttl-seconds

DAB önbelleğinin genel varsayılan süresini saniyeler içinde yaşayacak şekilde özelleştirin.

Example

dab configure \
  --runtime.cache.ttl-seconds 30

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "cache": {
      "enabled": false,
      "ttl-seconds": 30
    }
  }
}

--runtime.compression.level

Uyarı

Bu bölümde açıklanan Veri API oluşturucusu 2.0 işlevselliği şu anda önizleme aşamasındadır ve genel kullanılabilirlik öncesinde değişebilir. Daha fazla bilgi için bkz. Sürüm 2.0'daki yenilikler.

HTTP yanıt sıkıştırma düzeyini ayarlayın.

İzin verilen değerler:

  • optimal—sıkıştırma oranını ve hızını dengeler (varsayılan)
  • fastest—sıkıştırma hızını oran üzerinden önceliklendirir
  • none—sıkıştırmayı devre dışı bırakır

Example

dab configure \
  --runtime.compression.level optimal

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "compression": {
      "level": "optimal"
    }
  }
}

--runtime.host.mode

DAB'nin ana bilgisayar çalışma modunu ayarlayın.

İzin verilen değerler:

  • Development
  • Production

Example

dab configure \
  --runtime.host.mode Development

Sonuçta elde edilen yapılandırma

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

--runtime.host.max-response-size-mb

Tek bir sonuçta veritabanı yanıtı için megabayt cinsinden en büyük boyut. Varsayılan 158 değeridir.

Example

dab configure \
  --runtime.host.max-response-size-mb 256

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "host": {
      "max-response-size-mb": 256
    }
  }
}

--runtime.host.cors.origins

CORS'de izin verilen çıkış noktalarının üzerine yazma. Değerleri boşlukla ayrılmış liste olarak sağlayın.

Example

dab configure \
  --runtime.host.cors.origins \
  https://contoso.com \
  https://fabrikam.com

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "host": {
      "cors": {
        "origins": [
          "https://contoso.com",
          "https://fabrikam.com"
        ]
      }
    }
  }
}

--runtime.host.cors.allow-credentials

Üst bilgi için Access-Control-Allow-Credentials değeri ayarlayın.

Example

dab configure \
  --runtime.host.cors.allow-credentials true

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "host": {
      "cors": {
        "allow-credentials": true
      }
    }
  }
}

--runtime.host.authentication.provider

Kimlik doğrulama sağlayıcısının adını yapılandırın.

Example

dab configure \
  --runtime.host.authentication.provider AppService

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "host": {
      "authentication": {
        "provider": "AppService"
      }
    }
  }
}

--runtime.host.authentication.jwt.audience

JWT belirtecinin hedeflenen bir veya daha fazla alıcısını yapılandırın.

Example

dab configure \
  --runtime.host.authentication.jwt.audience api://my-app

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "host": {
      "authentication": {
        "jwt": {
          "audience": "api://my-app"
        }
      }
    }
  }
}

--runtime.host.authentication.jwt.issuer

JWT belirtecini veren varlığı yapılandırın.

Example

dab configure \
  --runtime.host.authentication.jwt.issuer https://login.microsoftonline.com/common/v2.0

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "host": {
      "authentication": {
        "provider": "AppService",
        "jwt": {
          "audience": "api://my-app",
          "issuer": "https://login.microsoftonline.com/common/v2.0"
        }
      }
    }
  }
}

--runtime.health.enabled

Genel sistem durumu uç noktasını etkinleştirin veya devre dışı bırakın. Varsayılan true değeridir.

Example

dab configure \
  --runtime.health.enabled true

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "health": {
      "enabled": true
    }
  }
}

--runtime.health.cache-ttl-seconds

Önbelleğe alınan sistem durumu denetimi raporları için saniyeler içinde yaşam süresi. Varsayılan 5 değeridir. En az değeridir 0.

Example

dab configure \
  --runtime.health.cache-ttl-seconds 10

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "health": {
      "cache-ttl-seconds": 10
    }
  }
}

--runtime.health.max-query-parallelism

En fazla eşzamanlı sistem durumu denetimi sorgusu. Varsayılan 4 değeridir. Değerler, ile 8desteklenen aralığına 1 sıkıştırılır.

Example

dab configure \
  --runtime.health.max-query-parallelism 6

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "health": {
      "max-query-parallelism": 6
    }
  }
}

--runtime.health.roles

Rollerin kapsamlı sistem durumu sonuçlarını görüntülemesine izin verilir. Üretim modunda en az bir rol yapılandırın.

Example

dab configure \
  --runtime.health.roles admin support

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "health": {
      "roles": [ "admin", "support" ]
    }
  }
}

--azure-key-vault.endpoint

Azure Key Vault uç nokta URL'sini yapılandırın.

Example

dab configure \
  --azure-key-vault.endpoint https://my-vault.vault.azure.net

Sonuçta elde edilen yapılandırma

{
  "azure-key-vault": {
    "endpoint": "https://my-vault.vault.azure.net"
  }
}

--azure-key-vault.retry-policy.mode

Yeniden deneme ilkesi modunu yapılandırın.

İzin verilen değerler:

  • fixed
  • exponential

Example

dab configure \
  --azure-key-vault.retry-policy.mode fixed

Sonuçta elde edilen yapılandırma

{
  "azure-key-vault": {
    "retry-policy": {
      "mode": "fixed"
    }
  }
}

--azure-key-vault.retry-policy.max-count

Yeniden deneme denemesi sayısı üst sınırını yapılandırın.

Example

dab configure \
  --azure-key-vault.retry-policy.max-count 5

Sonuçta elde edilen yapılandırma

{
  "azure-key-vault": {
    "retry-policy": {
      "max-count": 5
    }
  }
}

--azure-key-vault.retry-policy.delay-seconds

Yeniden denemeler arasındaki ilk gecikmeyi saniye cinsinden yapılandırın.

Example

dab configure \
  --azure-key-vault.retry-policy.delay-seconds 2

Sonuçta elde edilen yapılandırma

{
  "azure-key-vault": {
    "retry-policy": {
      "delay-seconds": 2
    }
  }
}

--azure-key-vault.retry-policy.max-delay-seconds

Yeniden denemeler arasındaki en uzun gecikmeyi saniye cinsinden yapılandırın (üstel mod için).

Example

dab configure \
  --azure-key-vault.retry-policy.max-delay-seconds 30

Sonuçta elde edilen yapılandırma

{
  "azure-key-vault": {
    "retry-policy": {
      "max-delay-seconds": 30
    }
  }
}

--azure-key-vault.retry-policy.network-timeout-seconds

İstekler için ağ zaman aşımını saniyeler içinde yapılandırın.

Example

dab configure \
  --azure-key-vault.retry-policy.network-timeout-seconds 20

Sonuçta elde edilen yapılandırma

{
  "azure-key-vault": {
    "retry-policy": {
      "mode": "fixed",
      "max-count": 5,
      "delay-seconds": 2,
      "max-delay-seconds": 30,
      "network-timeout-seconds": 20
    }
  }
}

--runtime.telemetry.log-level

Günlüğe kaydetme ayrıntı düzeyini ad alanına göre yapılandırın. Genel geri dönüş düzeyi için kullanın default veya sonrasında --runtime.telemetry.log-level.bir ad alanı veya sınıf adı belirtin.

İzin verilen değerler: Trace, Debug, Information, Warning, , Error, CriticalNone.

Example

dab configure \
  --runtime.telemetry.log-level.default Warning \
  --runtime.telemetry.log-level.Azure.DataApiBuilder.Core Information

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "telemetry": {
      "log-level": {
        "default": "warning",
        "Azure.DataApiBuilder.Core": "information"
      }
    }
  }
}

--runtime.telemetry.azure-log-analytics.enabled

Azure Log Analytics'i etkinleştirin veya devre dışı bırakın.

Example

dab configure \
  --runtime.telemetry.azure-log-analytics.enabled true

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "telemetry": {
      "azure-log-analytics": {
        "enabled": true
      }
    }
  }
}

--runtime.telemetry.azure-log-analytics.dab-identifier

Azure Log Analytics'te kullanılan bir DAB tanımlayıcı dizesini yapılandırın.

Example

dab configure \
  --runtime.telemetry.azure-log-analytics.dab-identifier MyDab

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "telemetry": {
      "azure-log-analytics": {
        "dab-identifier": "MyDab"
      }
    }
  }
}

--runtime.telemetry.azure-log-analytics.flush-interval-seconds

Azure Log Analytics için boşaltma aralığını saniye cinsinden yapılandırın.

Example

dab configure \
  --runtime.telemetry.azure-log-analytics.flush-interval-seconds 10

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "telemetry": {
      "azure-log-analytics": {
        "flush-interval-seconds": 10
      }
    }
  }
}

--runtime.telemetry.azure-log-analytics.auth.custom-table-name

Azure Log Analytics için özel tablo adını yapılandırın.

Example

dab configure \
  --runtime.telemetry.azure-log-analytics.auth.custom-table-name MyDabLogs

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "telemetry": {
      "azure-log-analytics": {
        "auth": {
          "custom-table-name": "MyDabLogs"
        }
      }
    }
  }
}

--runtime.telemetry.azure-log-analytics.auth.dcr-immutable-id

Azure Log Analytics için DCR sabit kimliğini yapılandırın.

Example

dab configure \
  --runtime.telemetry.azure-log-analytics.auth.dcr-immutable-id dcr-123

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "telemetry": {
      "azure-log-analytics": {
        "auth": {
          "dcr-immutable-id": "dcr-123"
        }
      }
    }
  }
}

--runtime.telemetry.azure-log-analytics.auth.dce-endpoint

Azure Log Analytics için DCE uç noktasını yapılandırın.

Example

dab configure \
  --runtime.telemetry.azure-log-analytics.auth.dce-endpoint https://example.eastus-1.ingest.monitor.azure.com

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "telemetry": {
      "azure-log-analytics": {
        "enabled": true,
        "auth": {
          "custom-table-name": "MyDabLogs",
          "dcr-immutable-id": "dcr-123",
          "dce-endpoint": "https://example.eastus-1.ingest.monitor.azure.com"
        },
        "dab-identifier": "MyDab",
        "flush-interval-seconds": 10
      }
    }
  }
}

--runtime.telemetry.file.enabled

Dosya havuzu günlüğünü etkinleştirin veya devre dışı bırakın.

Example

dab configure \
  --runtime.telemetry.file.enabled true

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "telemetry": {
      "file": {
        "enabled": true
      }
    }
  }
}

--runtime.telemetry.file.path

Dosya havuzu günlüğü için yolu yapılandırın.

Example

dab configure \
  --runtime.telemetry.file.path C:\\logs\\dab-log.txt

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "telemetry": {
      "file": {
        "path": "C:\\logs\\dab-log.txt"
      }
    }
  }
}

--runtime.telemetry.file.rolling-interval

Dosya havuzu günlüğü için sıralı aralığı yapılandırın.

İzin verilen değerler:

  • Minute
  • Hour
  • Day
  • Month
  • Year
  • Infinite

Example

dab configure \
  --runtime.telemetry.file.rolling-interval Month

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "telemetry": {
      "file": {
        "rolling-interval": "Month"
      }
    }
  }
}

--runtime.telemetry.file.retained-file-count-limit

En fazla korunan dosya sayısını yapılandırın.

Example

dab configure \
  --runtime.telemetry.file.retained-file-count-limit 5

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "telemetry": {
      "file": {
        "retained-file-count-limit": 5
      }
    }
  }
}

--runtime.telemetry.file.file-size-limit-bytes

Bayt cinsinden dosya boyutu üst sınırını yapılandırın.

Example

dab configure \
  --runtime.telemetry.file.file-size-limit-bytes 2097152

Sonuçta elde edilen yapılandırma

{
  "runtime": {
    "telemetry": {
      "file": {
        "enabled": true,
        "path": "C:\\logs\\dab-log.txt",
        "rolling-interval": "Month",
        "retained-file-count-limit": 5,
        "file-size-limit-bytes": 2097152
      }
    }
  }
}

--show-effective-permissions

Rol devralma uygulandıktan sonra her varlık için çözümlenen izinleri görüntüleyin. Yapılandırmayı el ile yürütmeden her rolün gerçekten neler yapabileceğini görmek için bu seçeneği kullanın.

Uyarı

Bu bölümde açıklanan Veri API oluşturucusu 2.0 işlevselliği şu anda önizleme aşamasındadır ve genel kullanılabilirlik öncesinde değişebilir. Daha fazla bilgi için bkz. Sürüm 2.0'daki yenilikler.

Example

dab configure \
  --show-effective-permissions

dab configure \
  --show-effective-permissions --config my-config.json

dab configure ^
  --show-effective-permissions --config my-config.json

Örnek çıkış

Entity: Book
	Role: anonymous        | Actions: Read
	Role: authenticated    | Actions: Read (inherited from: anonymous)
	Unconfigured roles inherit from: anonymous

Entity: Order
	Role: admin            | Actions: Create, Read, Update, Delete
	Role: anonymous        | Actions: Read
	Role: authenticated    | Actions: Read (inherited from: anonymous)
	Unconfigured roles inherit from: authenticated
  • Last updated on