Novedades de Data API Builder, versión 1.7 (marzo de 2026)

Data API Builder 1.7 se centra en flujos de trabajo controlados por inteligencia artificial y herramientas, metadatos más claros, configuración de entidad más sencilla y mejoras de confiabilidad en tiempo de ejecución.

Presentación: SQL MCP Server

SQL MCP Server es la implementación de "Data API Builder" para proporcionar compatibilidad con el Protocolo de Contexto de Modelo (MCP). Instale Data API Builder 1.7 o posterior y habilite las funcionalidades de MCP y tenga SQL MCP Server. Primero, un MCP de Microsoft SQL. SQL MCP Server también admite todos los orígenes de datos de backend compatibles con Data API Builder, incluidos Cosmos DB, PostgreSQL y MySQL.

Obtenga más información sobre SQL MCP Server.

Funcionalidad y herramientas de MCP

• Herramientas del lenguaje de manipulación de datos (DML) de MCP para interactuar con entidades configuradas.
• Compatibilidad con la entrada y salida estándar de MCP para escenarios locales y gestionados por el host.

Comportamiento compatible con permisos

Los comportamientos de MCP se alinean con la autorización DAB, incluidas las operaciones permitidas explícitas y el comportamiento mejorado con reconocimiento de roles integrado en el generador de API de datos.

Presentación: para entidades

Las nuevas entidades de propiedad reemplazan los patrones anteriores y, simplificando la configuración del campo de entidad e introduciendo para cada campo, lo que es importante para el éxito de MCP.

{
  "entities": {
    "Products": {
      "description": "Product catalog with pricing information",
      "source": {
        "object": "dbo.Products",
        "type": "table"
      },
      "fields": [ // new array
        {
          "name": "ProductID",
          "description": "Unique identifier for each product",
          "primary-key": true
        },
        {
          "name": "ProductName",
          "description": "Display name of the product"
        },
        {
          "name": "UnitPrice",
          "description": "Retail price per unit in USD"
        }
      ]
    }
  }
}

Línea de comandos

dab add Products 
    --source dbo.Products 
    --source.type table 
    --permissions "anonymous:*" 
    --description "Product catalog with pricing information"

dab update Products 
    --fields.name ProductID   
    --fields.description "Unique identifier for each product" 
    --fields.primary-key true
dab update Products 
    --fields.name ProductName 
    --fields.description "Display name of the product"       
    --fields.primary-key false
dab update Products 
    --fields.name UnitPrice   
    --fields.description "Retail price per unit in USD"     
    --fields.primary-key false

Presentación: para procedimientos almacenados

La nueva propiedad para procedimientos almacenados simplifica la configuración de parámetros y agrega para cada parámetro, lo que mejora la claridad y las interacciones controladas por MCP.

{
  "entities": {
    "GetOrdersByDateRange": {
      "description": "Retrieves orders",
      "source": {
        "object": "dbo.GetOrdersByDateRange",
        "type": "stored-procedure",
        "parameters": [ // new array
          {
            "name": "StartDate",
            "description": "Beginning of date range (inclusive)",
            "required": true
          },
          {
            "name": "EndDate",
            "description": "End of date range (inclusive)",
            "required": true
          },
          {
            "name": "CustomerID",
            "description": "Optional customer ID filter",
            "required": false,
            "default": null
          }
        ]
      }
    }
  }
}

Línea de comandos

dab add GetOrdersByDateRange \
  --source dbo.GetOrdersByDateRange \
  --source.type stored-procedure \
  --permissions "authenticated:execute" \
  --description "Retrieves orders" \
  --parameters.name "StartDate,EndDate,CustomerID" \
  --parameters.description "StartDate desc,EndDate desc,CustomerID desc" \
  --parameters.required "true,true,false" \
  --parameters.default ",,null"

Introducción: compatibilidad con Azure Key Vault (AKV)

Esta versión agrega compatibilidad opcional con Azure Key Vault (AKV) para facilitar la sustitución de valores en el archivo de configuración DAB. El uso de Key Vault es una opción importante para administrar de forma segura los secretos y otros valores de configuración confidenciales.

{
    "my-config-property": "@akv('secret-value')"
}

Mejoras generales y correcciones de errores

• Se ha mejorado el comportamiento de error orientado al usuario para escenarios de columna de agregado sin nombre
• Mejoras de limpieza de ejecución de procedimientos almacenados después de la finalización de la solicitud
• Se han corregido errores de paginación de entidades anidadas en consultas GraphQL.
• Se habilitó la configuración de propiedades booleanas a través de variables de entorno.