Disponibilidade de recursos para o construtor de API de Dados

Essas tabelas listam os recursos disponíveis no DAB (Construtor de API de Dados).

Versão do banco de dados

Database	Abreviação	Min. Versão
SQL Server	Família SQL	Versão 2016
SQL do Azure	Família SQL	N/A (PaaS)
Microsoft Fabric SQL	Família SQL	N/A (PaaS)
Azure Cosmos DB for NoSQL	Cosmos DB	N/A (PaaS)
PostgreSQL	PGSQL	Versão 11
MySQL	MySQL	Versão 8
Azure Synapse Analytics (pool de SQL dedicado)	SQLDW¹	N/A (PaaS)

Ambientes de nuvem e hospedagem

A chave para essa tabela é que o construtor de API de Dados pode ser executado em qualquer ambiente com suporte de contêiner.

Ambiente	Suportado
Microsoft Azure	✅ Sim
Amazon Web Services (AWS)	✅ Sim
GCP (Google Cloud Platform)	✅ Sim
Oracle Cloud Infrastructure (OCI)	✅ Sim
IBM Cloud	✅ Sim
Alibaba Cloud	✅ Sim
Local	✅ Sim

GraphQL

Feature	Família SQL	Cosmos DB	PGSQL	MySQL	SQLDW¹
Paginação	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim
Throttling	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim
Filtragem	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim
Agregação	✅ Sim	✖️ Não	✖️ Não	✖️ Não	✅ Sim
Classificação	✅ Sim	✖️ Não	✅ Sim	✅ Sim	✅ Sim
Seleção	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim
Tipo de consulta	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim
Tipo de mutação	✅ Sim	⚠️ Parcial	✅ Sim	✅ Sim	✅ Sim
Multi-Mutation	✅ Sim	✖️ Não	✖️ Não	✖️ Não	✖️ Não
GroupBy Avançado	✅ Sim	✖️ Não	✖️ Não	✖️ Não	✅ Sim
Avançado tendo	✅ Sim	✖️ Não	✖️ Não	✖️ Não	✅ Sim
Geração de esquema	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim
Atributo de esquema (@model)	✖️ Não	✖️ Não	✖️ Não	✖️ Não	✖️ Não
Atributo de esquema (@authorize)	✖️ Não	✖️ Não	✖️ Não	✖️ Não	✖️ Não
Esquema fornecido pelo usuário	✖️ Não	✅ Sim	✖️ Não	✖️ Não	✖️ Não
Subscription	✖️ Não	✖️ Não	✖️ Não	✖️ Não	✖️ Não
Nitro	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim
Cabeçalhos de cache	✅ Sim	✖️ Não	✅ Sim	✅ Sim	✅ Sim
Cache de Nível 1: Memória	✅ Sim	✖️ Não	✅ Sim	✅ Sim	✅ Sim
Cache de Nível 2: Redis	✅ Sim	✖️ Não	✅ Sim	✅ Sim	✅ Sim

Navegação de relação do GraphQL

Feature	Família SQL	Cosmos DB	PGSQL	MySQL	SQLDW¹
One-To-Many/Query	✅ Sim	✖️ Não	✅ Sim	✅ Sim	✅ Sim
One-To-Many/Mutação	✅ Sim	✖️ Não	✖️ Não	✖️ Não	✅ Sim
Muitos-To-Many/Consulta	✅ Sim	✖️ Não	✅ Sim	✅ Sim	✅ Sim
MuitasTo-Many/Mutação	✅ Sim	✖️ Não	✖️ Não	✖️ Não	✅ Sim
Relações entre fontes	✖️ Não	✖️ Não	✖️ Não	✖️ Não	✖️ Não
Junções entre fontes	✖️ Não	✖️ Não	✖️ Não	✖️ Não	✖️ Não

REST

Feature	Família SQL	Cosmos DB²	PGSQL	MySQL	SQLDW¹
PUT	✅ Sim	✖️ Não	✅ Sim	✅ Sim	✅ Sim
POST	✅ Sim	✖️ Não	✅ Sim	✅ Sim	✅ Sim
PATCH	✅ Sim	✖️ Não	✅ Sim	✅ Sim	✅ Sim
DELETE	✅ Sim	✖️ Não	✅ Sim	✅ Sim	✅ Sim
GET	✅ Sim	✖️ Não	✅ Sim	✅ Sim	✅ Sim
Paginação	✅ Sim	✖️ Não	✅ Sim	✅ Sim	✅ Sim
Semelhante a OData $Select	✅ Sim	✖️ Não	✅ Sim	✅ Sim	✅ Sim
Semelhante a OData $Filter	✅ Sim	✖️ Não	✅ Sim	✅ Sim	✅ Sim
Semelhante a OData $Count	✖️ Não	✖️ Não	✖️ Não	✖️ Não	✖️ Não
Semelhante a OData $OrderBy	✅ Sim	✖️ Não	✅ Sim	✅ Sim	✅ Sim
Semelhante a OData $First	✅ Sim	✖️ Não	✅ Sim	✅ Sim	✅ Sim
$After (Paginação do cursor)	✅ Sim	✖️ Não	✅ Sim	✅ Sim	✅ Sim
Documento OpenAPI	✅ Sim	✖️ Não	✅ Sim	✅ Sim	✅ Sim
Interface do usuário do Swagger	✅ Sim	✖️ Não	✅ Sim	✅ Sim	✅ Sim
Cabeçalhos de cache	✅ Sim	✖️ Não	✅ Sim	✅ Sim	✅ Sim
Cache de Nível 1: Memória	✅ Sim	✖️ Não	✅ Sim	✅ Sim	✅ Sim
Cache de Nível 2: Redis	✅ Sim	✖️ Não	✅ Sim	✅ Sim	✅ Sim
Conteúdo pronto para POCO	✅ Sim	✖️ Não	✅ Sim	✅ Sim	✅ Sim
OpenAPIReference	✖️ Não	✖️ Não	✖️ Não	✖️ Não	✖️ Não

Objetos de banco de dados com suporte

Feature	Família SQL	Cosmos DB	PGSQL	MySQL	SQLDW¹
Tables	✅ Sim	✖️ Não	✅ Sim	✅ Sim	✅ Sim
Views	✅ Sim	✖️ Não	✅ Sim	✖️ Não	✅ Sim
Procedimentos armazenados	✅ Sim	✖️ Não	✖️ Não	✖️ Não	✅ Sim
Parâmetros proc	✅ Sim	✖️ Não	✖️ Não	✖️ Não	✅ Sim
Functions	✖️ Não	✖️ Não	✖️ Não	✖️ Não	✖️ Não
Collections	✖️ Não	✅ Sim	✖️ Não	✖️ Não	✖️ Não
Mapeamento de campo	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim

Permissões de entidade

Feature	Família SQL	Cosmos DB	PGSQL	MySQL	SQLDW¹
Create	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim
REad	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim
UPdate	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim
Delete	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim
Execute	✅ Sim	✖️ Não	✖️ Não	✖️ Não	✅ Sim
Incluir Campos	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim
Excluir Campos	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim

Política de Banco de Dados

Feature	Família SQL	Cosmos DB	PGSQL	MySQL	SQLDW¹
Create	✅ Sim	✖️ Não	✖️ Não	✖️ Não	✅ Sim
REad	✅ Sim	✖️ Não	✅ Sim	✅ Sim	✅ Sim
UPdate	✅ Sim	✖️ Não	✅ Sim	✅ Sim	✅ Sim
Delete	✅ Sim	✖️ Não	✅ Sim	✅ Sim	✅ Sim
Execute	✖️ Não	✖️ Não	✖️ Não	✖️ Não	✖️ Não
Políticas deSingle-Table	✅ Sim	✖️ Não	✖️ Não	✖️ Não	✅ Sim
Políticas de várias tabelas	✖️ Não	✖️ Não	✖️ Não	✖️ Não	✖️ Não
Política de Solicitação	✖️ Não	✖️ Não	✖️ Não	✖️ Não	✖️ Não

Recursos de autenticação

Feature	Família SQL	Cosmos DB	PGSQL	MySQL	SQLDW¹
UAMI (ID do Entra)⁴	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim
SAMI (ID do Entra)⁴	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim
Azure EasyAuth	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim
Segurança de passagem	✖️ Não	✖️ Não	✖️ Não	✖️ Não	✖️ Não
Segurança de chave de API	✖️ Não	✖️ Não	✖️ Não	✖️ Não	✖️ Não

Outros recursos

Feature	Família SQL	Cosmos DB	PGSQL	MySQL	SQLDW¹
Suporte ao JSON nativo	✖️ Não	✖️ Não	✖️ Não	✖️ Não	✖️ Não
Suporte a XML nativo	✖️ Não	✖️ Não	✖️ Não	✖️ Não	✖️ Não
Suporte a vetores nativos	✖️ Não	✖️ Não	✖️ Não	✖️ Não	✖️ Não
Application Insights	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim
Análise de Logs	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim
Registro em log de arquivos	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim
Contexto da sessão	✅ Sim	✖️ Não	✖️ Não	✖️ Não	✖️ Não
Várias fontes de dados	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim
Junção entre fontes	✖️ Não	✖️ Não	✖️ Não	✖️ Não	✖️ Não
OpenTelemetry	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim
Pontos de extremidade de integridade	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim
Níveis de log personalizados	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim
.NET Aspire	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim
MCPó	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim

Servidor MCP

Observação

Os recursos do SERVIDOR MCP exigem o Construtor de API de Dados versão 1.7 ou posterior.

Feature	Família SQL	Cosmos DB	PGSQL	MySQL	SQLDW¹
Ferramenta DML: CREATE	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim
Ferramenta DML: LEIA	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim
Ferramenta DML: UPDATE	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim
Ferramenta DML: DELETE	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim
Ferramenta DML: EXECUTE	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim
DML-tool: DESCRIBE	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim
Procedimento armazenado como ferramenta	✅ Sim	✖️ Não	✖️ Não	✖️ Não	✅ Sim
Instruções do servidor	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim
Metadados de objeto	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim
Metadados de campo	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim
Metadados de parâmetro	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim
LEIA: Paginação	✅ Sim	✖️ Não	✅ Sim	✅ Sim	✅ Sim
LER: $Select	✅ Sim	✖️ Não	✅ Sim	✅ Sim	✅ Sim
LER: $Filter	✅ Sim	✖️ Não	✅ Sim	✅ Sim	✅ Sim
LER: $Count	✖️ Não	✖️ Não	✖️ Não	✖️ Não	✖️ Não
LER: $OrderBy	✅ Sim	✖️ Não	✅ Sim	✅ Sim	✅ Sim
LER: $First	✅ Sim	✖️ Não	✅ Sim	✅ Sim	✅ Sim
LER: $After	✅ Sim	✖️ Não	✅ Sim	✅ Sim	✅ Sim

Suporte do Azure (contêineres)

Feature	Família SQL	Cosmos DB	PGSQL	MySQL	SQLDW¹
Aplicativos de Contêiner do Azure	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim
Instâncias de Contêiner do Azure	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim
Serviços de Kubernetes do Azure	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim
Aplicativo Web para Contêineres do Azure	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim
Red Hat OpenShift no Azure	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim
Aplicativos Spring do Azure	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim
Azure Service Fabric	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim
Máquina Virtual do Azure	✅ Sim	✅ Sim	✅ Sim	✅ Sim	✅ Sim

Tipos de dados sem suporte

O Construtor de API de Dados não dá suporte a alguns tipos de dados para cada plataforma de banco de dados. Normalmente, essas limitações ocorrem devido a restrições de serialização ou falta de suporte nativo no driver de banco de dados subjacente.

SQL Server e SQL do Azure

Tipo de dados	Description
geography	Dados geoespaciais que representam a superfície da Terra.
geometry	Dados espaciais planares usando coordenadas cartesianas.
hierarchyid	Gerenciamento de dados hierárquico.
json	Dados formatados em JSON (atualmente em versão prévia).
rowversion	Controle de versão de linha para controle de simultaneidade.
sql_variant	Valores de vários tipos de dados compatíveis com o SQL Server.
vector	Dados de vetor (atualmente em versão prévia).
xml	Dados formatados em XML.

PostgreSQL

Tipo de dados	Description
bytea	Armazenamento de cadeia de caracteres binária.
date	Datas do calendário (ano, mês, dia).
smalldatetime	Armazenamento de data e hora menos preciso.
datetime2	Não nativo; normalmente manipulado por timestamp.
timestamptz	Datas e horários com fuso horário.
time	Hora do dia sem data.
localtime	Hora atual com base no relógio do sistema.

MySQL

Tipo de dados	Description
UUID	Identificadores universalmente exclusivos.
DATE	Datas do calendário.
SMALLDATETIME	Armazenamento de data e hora menos preciso.
DATETIME2	Não nativo; normalmente manipulado por datetime.
DATETIMEOFFSET	Datas e horários com fuso horário.
TIME	Hora do dia sem data.
LOCALTIME	Hora atual com base no relógio do sistema.

Azure Cosmos DB for NoSQL

O Azure Cosmos DB para NoSQL é independente de esquema, portanto, as restrições de tipo de dados não se aplicam da mesma forma que os bancos de dados relacionais.

Notas de rodapé

¹ SQLDW reflete o suporte somente para pool de SQL dedicado. Não há suporte para o pool de SQL sem servidor.

Há suporte para o ² Cosmos DB no DAB por meio do GraphQL. O DAB não gera pontos de extremidade REST para o Cosmos DB porque a API para NoSQL fornece uma API REST nativa. Para obter mais informações, consulte Azure Cosmos DB: Referência da API REST.

O MCP (Protocolo de Contexto do Modelo) é uma funcionalidade de nível de ponto de extremidade, não específica do banco de dados.

⁴ Suporte a identidade gerenciada usa o Azure DefaultAzureCredential, que dá suporte a identidades gerenciadas de System-Assigned (SAMI) e User-Assigned (UAMI). A interface do usuário requer a configuração da variável de AZURE_CLIENT_ID ambiente.

⚠️ As mutações parciais do Cosmos DB significam que há suporte para operações básicas de criação, atualização e exclusão, mas nem todos os tipos de mutação (como várias mutações) estão disponíveis.