Compartilhar via

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 MSSQL Versão 2016
Banco de Dados SQL do Azure MSSQL N/A (PaaS)
Instância Gerenciada de SQL do Azure MSSQL N/A (PaaS)
SQL Server em VMs do Azure MSSQL Versão 2016
SQL Server habilitado para Arc MSSQL Versão 2016
Banco de dados SQL no Fabric MSSQL N/A (PaaS)
Azure Cosmos DB for NoSQL COSMOSDB N/A (PaaS)
PostgreSQL PGSQL Versão 11
Servidor Flexível de Banco de Dados Azure para PostgreSQL PGSQL Versão 11
MySQL MySQL Versão 8
Azure Banco de Dados para MySQL - Servidor Flexível MySQL Versão 5.7
Azure Synapse Analytics (pool de SQL dedicado) DWSQL¹ N/A (PaaS)

Níveis de isolamento de transação padrão

O construtor de API de dados usa os seguintes níveis de isolamento de transação padrão.

Tipo de banco de dados Nível de isolamento Mais informações
Microsoft SQL Leitura Confirmada Azure SQL
PostgreSQL Leitura Confirmada PostgreSQL
MySQL Leitura repetida MySQL

Ambientes de nuvem e hospedagem

O construtor de API de dados é executado em qualquer ambiente com suporte de contêiner. Veja a seguir os destinos comuns de implantação de nuvem:

Ambiente Suportado
Microsoft Azure ✅ Sim
Serviços Web da Amazon (AWS) ✅ Sim
GCP (Google Cloud Platform) ✅ Sim
Qualquer outro provedor de nuvem ✅ Sim
Local ✅ Sim

GraphQL

Feature MSSQL Cosmos PGSQL MySQL DWSQL¹
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 MSSQL Cosmos PGSQL MySQL DWSQL¹
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 MSSQL Cosmos² PGSQL MySQL DWSQL¹
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
OpenAPI com reconhecimento de permissão ✅ Sim ✖️ Não ✅ Sim ✅ Sim ✅ Sim
Caminhos REST avançados ✅ Sim ✖️ Não ✅ Sim ✅ Sim ✅ Sim
PUT e PATCH sem chave ✅ 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 MSSQL Cosmos PGSQL MySQL DWSQL¹
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 MSSQL Cosmos PGSQL MySQL DWSQL¹
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 MSSQL Cosmos PGSQL MySQL DWSQL¹
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 MSSQL Cosmos PGSQL MySQL DWSQL¹
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
Em Nome De (OBO) ✅ Sim ✖️ Não ✖️ Não ✖️ Não ✖️ Não
Provedor não autenticado ✅ Sim ✅ Sim ✅ Sim ✅ Sim ✅ Sim
Herança de função ✅ Sim ✅ Sim ✅ Sim ✅ Sim ✅ Sim
Segurança de chave de API ✖️ Não ✖️ Não ✖️ Não ✖️ Não ✖️ Não

Outros recursos

Feature MSSQL Cosmos PGSQL MySQL DWSQL¹
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
Configuração Automática ✅ Sim ✖️ Não ✖️ Não ✖️ Não ✖️ Não
Compactação de resposta HTTP ✅ Sim ✅ Sim ✅ Sim ✅ Sim ✅ Sim
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 MSSQL Cosmos PGSQL MySQL DWSQL¹
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
Ferramentas mcp personalizadas ✅ 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

Plataformas de orquestração de contêineres

O construtor de API de dados é executado em qualquer plataforma de orquestração ou runtime de contêiner. As plataformas comuns incluem:

Plataforma Suportado
ACA (Aplicativos de Contêiner do Azure) ✅ Sim
Instâncias de Contêiner do Azure (ACI) ✅ Sim
AKS (Serviço de Kubernetes do Azure) ✅ Sim
ECS (Serviço de Contêiner Elástico) do AWS ✅ Sim
EKS (Serviço de Kubernetes Elástico) do AWS ✅ Sim
Mecanismo do Kubernetes do Google (GKE) ✅ Sim
Kubernetes (qualquer distribuição) ✅ Sim
Docker ✅ Sim
Qualquer outro runtime de contêiner ✅ Sim

Serviços de implantação do Azure

Feature MSSQL Cosmos PGSQL MySQL DWSQL¹
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.

Microsoft SQL

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.
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.
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é

¹ DWSQL 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 no DAB por meio do GraphQL. O DAB não gera pontos de extremidade REST para o Cosmos 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.

  • Last updated on