Recurso de visualização: requisitos do Provedor de Dados da API de SQL do Azure Cosmos DB

Este tópico descreve os requisitos do provedor de dados do Azure Cosmos DB para API de SQL e a configuração e as práticas recomendadas quando você usar o Azure Cosmos DB para API de SQL com tabelas virtuais.

Importante

• Os recursos de visualização não foram criados para uso em ambientes de produção e podem ter funcionalidade restrita. Esses recursos são disponibilizados antes de um lançamento oficial para que os clientes possam ter acesso antecipado e fornecer comentários.
• Nós esperamos fazer alterações nesse recurso, por isso, não o use em ambientes de produção. Use-o apenas em ambientes de teste e desenvolvimento.
• A Microsoft não fornece suporte a este recurso de visualização. O suporte técnico do Microsoft Dynamics 365 não poderá ajudar você a resolver problemas ou esclarecer dúvidas. Os recursos de visualização não foram criados para uso em ambientes de produção e estão sujeitos aos termos complementares de uso.

O que é o Azure Cosmos DB?

O Azure Cosmos DB é um serviço do banco de dados da Microsoft de vários modelos distribuído globalmente para aplicativos críticos. Ele fornece recursos de consulta SQL familiares e avançados com latências de consistência baixa em dados do esquema less JSON. Mais informações: Introdução ao Azure Cosmos DB: API de SQL

Requisitos

• Assinatura do Azure que inclui o Azure Cosmos DB.
• Uma coleção de API de SQL do Azure Cosmos DB.
• O tipo de banco de dados do Azure Cosmos DB deve ser SQL.

Mapeamento de tipo de dados

Suponha que você tenha um documento do Azure Cosmos DB em uma coleção com o nome Ordens que tem a seguinte estrutura JSON.

Esta tabela indica os mapeamentos do tipo de dados para o documento da API de SQL na coleção de Ordens com Microsoft Dataverse.

Dados da API de SQL	Dataverse
id	Chave Primária
name	Linha Única de Texto
quantity	Número Inteiro
orderid	Linha única de texto
ordertype	Opção
amount	Número Decimal ou Moeda
delivered	Sim/Não
datetimeoffset	Data e hora

Observação

• Atributos com um prefixo sublinhado (_) são gerados pela API de SQL.
• Atributos que são configurados como opcionais no documento da API de SQL e são mapeados no Dataverse como Requisito Comercial causarão um erro de tempo de execução.
• os valores do atributo id devem ser guids.
• Para obter mais informações sobre como usar datas na API de SQL, consulte Trabalhando com datas no Azure Cosmos DB.

Filtragem de consulta SQL suportada

A filtragem de consulta SQL suporta os seguintes operadores.

• Operadores de comparação:<,>,<=, >=,!=
• Operadores lógicos: and, or
• Operadores de conjunto: in, not in
• Operadores de cadeia de caracteres: like, contains, begins with, ends with

Observação

O uso dos operador Like é traduzido aos operadores contains/begins with/ends with equivalentes. A API de SQL não oferece suporte a argumentos padrão, conforme descrito no tópico Like (Transact-SQL). O provedor de dados do Azure Cosmos DB para API de SQL pode traduzir o caso especial único Like('[aA]%') para BeginsWith('a') OU BeginsWith('A'). Observe que a comparação de cadeia de caracteres na API de SQL diferencia maiúsculas e minúsculas.

Adicionar uma fonte de dados usando o provedor de dados do Azure Cosmos DB para API de SQL

1. Acesse o AppSource, selecione OBTER AGORA e siga as instruções para adicionar o aplicativo ao ambiente usando v9x ou posterior.

2. Depois que a solução for instalada, entre no ambiente e vá para Configurações > Administração > Fontes de Dados da Entidade Virtual.

3. Na barra de ferramentas Ações, selecione NEW e na caixa de diálogo Selecionar Provedor de Dados selecione Provedor de dados do Azure Cosmos DB para API de SQL e clique em OK.

4. Insira as informações a seguir e selecione SALVAR E FECHAR.

   Column	Descrição
   Nome	Digite um nome que descreva a fonte de dados.
   Nome da Coleção	O nome do banco de dados do Azure Cosmos DB que contém a coleção que você deseja exibir em uma tabela virtual.
   Chave de Autorização	A chave primária ou secundária da conta do Azure Cosmos DB. Você pode encontrar a chave do portal administrativo do Azure na configuração de Chaves em sua conta do Azure Cosmos DB.
   Uri	O URI do grupo de recursos no qual a coleção do Azure Cosmos DB está localizada. A URI formada será semelhante a https://contoso/documents.azure.com:443. Você pode localizar o URI do portal administrativo do Azure na configuração de Chaves da conta do Azure Cosmos DB.
   Tempo limite em segundos	Insira o número de segundos para aguardar por uma resposta do serviço Azure Cosmos DB antes do tempo limite de uma solicitação de dados. Por exemplo, insira 30 para aguardar até 30 segundos antes do tempo limite. O tempo limite padrão é de 120 segundos.

   

Limitações e as práticas recomendadas

• Observe o seguinte ao usar o Azure Cosmos DB como uma fonte de dados:
  • Cada fonte de dados do Azure Cosmos DB só pode ser associada a uma única tabela virtual.
  • É possível conectar várias fontes de dados à mesma coleção no Azure Cosmos DB.
• Não é possível segmentar dados em uma coleção por tabela.
• Os bancos de dados do Azure Cosmos DB não exigem um esquema, porém os dados dentro do Azure Cosmos DB devem ser estruturados usando um esquema previsível.
• Embora o provedor de dados do Azure Cosmos DB para API de SQL implemente a tradução de consulta de projeção, filtragem e operadores de classificação, ele não oferece suporte a operações de junção.
• É possível filtrar somente por uma única coluna com a API de SQL.

Consulte também

Criar e editar tabelas virtuais que contenham dados de uma fonte de dados externa

Observação

Você pode nos falar mais sobre suas preferências de idioma para documentação? Faça uma pesquisa rápida. (Observe que esta pesquisa está em inglês)

A pesquisa levará cerca de sete minutos. Nenhum dado pessoal é coletado (política de privacidade).