Funcionalidade de previsualización: Requisitos de Azure Cosmos DB para o fornecedor de datos da API de SQL

Este tema describe os requisitos para o fornecedor de datos da API de SQL de Azure Cosmos DB, así como para configurar e recomendar as prácticas recomendadas ao utilizar o fornecedor de datos da API de SQL de Azure Cosmos DB con táboas virtuais.

Importante

• As funcionalidades de vista previa non se deseñaron para uso de produción e poden ter funcionalidade restrinxida. Estas funcionalidades están dispoñibles antes da versión oficial para que os clientes poidan obter acceso a elas rápido e fornecer comentarios.
• Espérase que esta funcionalidade se modifique, así que non debería usala en produción. Úsea só en ambientes de desenvolvemento e proba.
• Microsoft non fornece soporte para esta funcionalidade de previsualización. Soporte técnico para Microsoft Dynamics 365 non poderá axudalo con problemas nin preguntas. As funcionalidades de previsualización non son para usalas en produción e están suxeitas a diferentes condicións de uso adicionais.

Que é Azure Cosmos DB?

Azure Cosmos DB é o servizo de da base de datos de varios modelos distribuído por Microsoft globalmente para aplicacións esenciais para as misións. Fornece posibilidades de consulta coñecidas e enriquecidas con latencias coherentes baixas en datos de JSON sen esquema. Máis información: Presentación de Azure Cosmos DB: API de SQL

Requisitos

• Subscrición de Azure que inclúe Azure Cosmos DB.
• Unha colección de API SQL de Azure Cosmos DB.
• O tipo de base de datos de Azure Cosmos DB debe ser SQL.

Asignación de tipos de datos

Supoña que ten un documento de Azure Cosmos DB nunha colección chamada Pedidos que ten a estrutura de JSON seguinte.

Esta táboa indica as asignacións do tipo de datos para o documento da API de SQL na colección Pedidos con Microsoft Dataverse.

Datos de API de SQL	Dataverse
id	Clave principal
name	Liña única de texto
quantity	Número enteiro
orderid	Liña única de texto
ordertype	Opción
amount	Número decimal ou moeda
delivered	Si/Non
datetimeoffset	Data e hora

Nota

• Atributos cun prefixo con guión baixo (_) xerados pola API de SQL.
• Os atributos que están configurados como opcionais no documento da API de SQL e asignados en Dataverse como Necesario para o negocio causará un erro de tempo de execución.
• Os valores de atributo de identificador deben ser GUID.
• Para obter máis información acerca do uso de datas na API de SQL, consulte Traballar con datas en Azure Cosmos DB.

Filtraxe de consultas de SQL compatibles

A f iltraxe de consultas de SQL admite os operadores seguintes.

• Operadores de comparación:<,>,<=, >=,!=
• Operadores lóxicos: and, or
• Operadores de definición: in, not in
• Operadores de cadea: like, contains, begins with, ends with

Nota

O uso do operador like tradúcese aos operadores contains/begins with/ends with equivalentes. A API de SQL non admite os argumentos de padrón segundo se describe no tema Like (Transact-SQL). A Azure Cosmos DB para o fornecedor de datos da API de SQL pode traducir o caso especial único Like('[aA]%') a BeginsWith('a') OU BeginsWith('A'). Teña en conta que a comparación de cadeas na API de SQL diferencia maiúsculas de minúsculas.

Engadir unha orixe de datos usando Azure Cosmos DB para o fornecedor de datos da API de SQL

1. Vaia a AppSource, seleccione OBTER AGORA e siga as instrucións para engadir a aplicación ao seu ambiente usando v9x ou unha versión posterior.

2. Despois de instalar a solución, inicie sesión no ambiente e vaia a Configuración > Administración > Orixes de datos da entidade virtual.

3. Na barra de ferramentas Accións, seleccione NOVA e, na caixa de diálogo Seleccionar fornecedor de datos, seleccione Azure Cosmos DB para o fornecedor de datos da API de SQL e, a continuación, seleccione Aceptar.

4. Introduza a seguinte información e, a seguir, seleccione GARDAR E PECHAR.

   Column	Descripción
   Nome	Escriba un nome para describir a orixe de datos.
   Nome da colección	Nome da base de datos de Azure Cosmos DB que contén a colección que desexa que apareza nunha táboa virtual.
   Clave de autorización	A clave principal ou secundaria da conta Azure Cosmos DB. Pode localizar a clave do portal de administración de Azure na configuración Claves na súa conta Azure Cosmos DB.
   URI	URI do grupo de recursos onde está localizada a colección de Azure Cosmos DB. O URL fórmase de xeito semellante a https://contoso/documents.azure.com:443. Pode localizar a URI do portal de administración de Azure na configuración Claves da conta Azure Cosmos DB.
   Tempo de espera en segundos	Introduza o número de segundos que se debe esperar unha resposta do servizo Azure Cosmos DB antes de esgotar o tempo de espera dunha solicitude de datos. Por exemplo, introduza 30 para esperar un máximo de trinta segundos antes de que se esgote o tempo de espera. O tempo de espera predefinido é 120 segundos.

   

Recomendacións e limitacións

• Teña en conta o seguinte ao utilizar Azure Cosmos DB como unha orixe de datos:
  • Cada orixe de datos de Azure Cosmos DB só pode estar asociada cunha única táboa virtual.
  • Pode conectar varias orixes de datos á mesma colección en Azure Cosmos DB.
• Non se poden segmentar os datos dunha colección por táboa.
• As bases de datos de Azure Cosmos DB non requiren un esquema; non obstante, os datos de Azure Cosmos DB deben estar estruturados utilizando un esquema predicible.
• Aínda que a Azure Cosmos DB para o fornecedor de datos da API de SQL implementa a tradución de consulta da proxección, a filtraxe, e os operadores de ordenación, non admite operacións de unión.
• Só pode filtrar por unha única columna coa API de SQL.

Consulte tamén

Crear e editar táboas virtuais que conteñen datos desde unha orixe de datos externa

Nota

Pode indicarnos as súas preferencias para o idioma da documentación? Realice unha enquisa breve. (teña en conta que esa enquisa está en inglés)

Esta enquisa durará sete minutos aproximadamente. Non se recompilarán datos persoais (declaración de privacidade).