次の方法で共有

Data API Builder バージョン 1.5 の新機能 (2025 年 4 月)

Data API Builder (DAB) バージョン 1.5 のリリース ノートと更新プログラム
リリース 1.5: Azure Database 用データ API ビルダー

紹介: 健康エンドポイント

このリリースでは、DAB がそのランタイム状態を通信する方法が向上します。 以前は、ルート URL から単純な正常性結果が返されました。

{
  "status": "Healthy",
  "version": "1.5.50",
  "app-name": "dab_oss_1.5.50"
}

その応答は、検証 ( dab validateと同様) が実行され、エンジンがアクティブであることを示していますが、データ ソースまたはエンドポイントの実際の正常性は反映されません。

これで、 /health エンドポイントには、基本的な構成の詳細と正常性チェックが含まれています。

{
  "status": "Unhealthy",
  "version": "1.5.50",
  "app-name": "dab_oss_1.5.50",
  "configuration": {
    "rest": true,
    "graphql": true,
    "caching": false,
    "telemetry": false,
    "mode": "Development"
  },
  "checks": []
}

チェックでは、定義したしきい値を使用して、各データ ソースとエンドポイント (REST と GraphQL) の可用性と応答性が検証されます。

エンドポイントの安全性

正常性エンドポイントは、DAB のロールベースのアクセス モデルに従います。 チェックは設定に応じて並列または順番に実行され、応答はキャッシュされ、ポーリングによる負荷が軽減されます。

概要: Azure Cosmos DB for NOSQL のスキーマ推論

この Azure Data API Builder (DAB) の機能強化により、Azure CosmosDB NOSQL API コレクションから直接スキーマを自動的に作成できます。 以前は、ユーザーは schema.gql ファイルを使用してスキーマを手動で定義する必要がありました。 この新機能により、cli を使用してスキーマ生成を処理でき、構成を合理化し、データベース構造に関する事前知識の必要性を減らすことができます。続きを読む

紹介: カスタム Log-Level

DAB では、構成可能なログ レベルがサポートされるようになりました。 グローバルな既定値を設定し、名前空間ごとにオーバーライドできます。

{
  "runtime": {
    "telemetry": {
      "log-level": {
        "default": "trace | debug | information | warning | error | critical | none"
      }
    }
  }
}

名前空間ごとのオーバーライドの場合:

{
  "runtime": {
    "telemetry": {
      "log-level": {
        "default": "warning",
        "Azure.DataApiBuilder.Service": "information",
        "Azure.DataApiBuilder.Engine.Authorization": "error",
        "Microsoft.AspNetCore": "none"
      }
    }
  }
}

productionでは、ホット リロード機能は、log-levelの動的更新をサポートします。 その他の構成の変更は無視されますが、ログ レベルの変更はすぐに適用されます。これは、問題をライブで診断するのに最適です。
もっと。

概要: GraphQL での集計

DAB では、Microsoft SQL Server (MSSQL) の GraphQL クエリでのグループ化および集計操作がサポートされるようになりました。 バックエンド ロジックを追加しなくても、概要と分析情報を生成できます。

機能

  • 集計の種類: SUM、 AVG、 MIN、 MAX
  • GroupBy サポート: フィールド別に結果をグループ化する
  • MSSQL 向けに最適化: 効率的で信頼性の高いクエリ実行
  • 強化されたログ: スキーマ生成と実行の出力をより明確にすること

全体で実装されます。

HTTP キャッシュ ヘッダー

DAB では、次の機能がサポートされるようになりました。

ディレクティブ 意味
no-cache サーバーとの再検証後にのみキャッシュされたデータを使用する
no-store 応答をまったくキャッシュしない
only-if-cached キャッシュされたデータのみを使用する。使用できない場合は失敗する

もっと。

拡張: OpenTelemetry

以前は、DAB は既定の ASP.NET Core スパンのみをサポートしました。 このリリースでは、REST と GraphQL のカスタム スパンとメトリックが追加されます。

メトリック:

  • アクティブな要求: 実行中の要求のリアルタイム数
  • 要求の合計数: 起動後の累積数
  • 合計エラー数: 累積エラーと例外

これらのメトリックにより、ランタイム動作の可視性が向上し、より詳細なテレメトリの基盤が構築されます。

拡張: Entra ID 認証プロバイダー

DAB はもともと、 AzureAd 列挙型を使用して Azure Active Directory を構成しました。 Microsoft はその後、Entra ID に名前を変更しました。

このリリースでは、推奨される値として EntraId が導入されています。 古い列挙型 (AzureAd) は下位互換性のために引き続き機能しますが、 EntraId は現在のブランドに合わせて調整されます。

  • Last updated on