Característica en versión preliminar: requisitos del proveedor de datos de Azure Cosmos DB para NoSQL

En este tema se describen los requisitos para el proveedor de datos de Azure Cosmos DB para NoSQL y también cómo configurar y las prácticas recomendadas cuando se usa el proveedor de datos de Azure Cosmos DB para NoSQL con tablas virtuales.

Importante

• Las vistas previas de características no se han diseñado para un uso de producción y pueden tener una funcionalidad restringida. Estas características están disponibles antes del lanzamiento oficial para que los clientes puedan tener un acceso anticipado y proporcionar comentarios.
• Se espera que esta característica se modifique, así que no debería usarla en producción. Úsela solo en entornos de desarrollo y prueba.
• Microsoft no ofrece soporte técnico para esta versión preliminar de característica. El soporte técnico de Microsoft Dynamics 365 no podrá ayudarle con los problemas o las preguntas que pueda tener. Las características en vista previa no se han diseñado para su uso en producción y están sujetas a otros términos de uso complementarios.

¿Qué es Azure Cosmos DB?

Azure Cosmos DB es el servicio de la base de datos de varios modelos global distribuido de Microsoft para aplicaciones críticas. Proporciona capacidades de consulta SQL enriquecidas y familiares con latencias bajas homogéneas en datos JSON sin esquema. Más información: Introducción a Azure Cosmos DB: Azure Cosmos DB para NoSQL

Requisitos

• Suscripción de Azure que incluye Azure Cosmos DB.
• Una colección de Azure Cosmos DB para NoSQL.
• El tipo de base de datos Azure Cosmos DB debe ser SQL.

Asignaciones de tipos de datos

Supongamos que tiene un documento Azure Cosmos DB en una colección denominada pedidos que tiene la siguiente estructura JSON.

Esta tabla indica las asignaciones de tipo de datos para el documento de Azure Cosmos DB para NoSQL en la colección Pedidos con Microsoft Dataverse.

Datos de Azure Cosmos DB para NoSQL	Dataverse
id	Primary Key
name	Línea única de texto
quantity	Número entero
orderid	Línea de texto única
ordertype	Opción
amount	Número decimal o divisa
delivered	Sí/No
datetimeoffset	Fecha y hora

Nota

• Los atributos con un prefijo de subrayado (_) se generan mediante Azure Cosmos DB para NoSQL.
• Los atributos que están configurados como opcionales en el documento de Azure Cosmos DB para NoSQL se asocian en Dataverse como Necesario para la empresa generarán un error de tiempo de ejecución.
• los valores de atributo de identificador deben ser guids.

Filtro de consultas SQL admitido

El filtro de consultas SQL admite los siguientes operadores.

• Operadores de comparación:<,>,<=, >=,!=
• Operadores lógicos: and, or
• Operadores de conjuntos: in, not in
• Operadores de cadena: like, contains, begins with, ends with

Nota

El uso del operador like se traduce en el equivalente a los operadores contains/begins with/ends with. Azure Cosmos DB para NoSQL no admite argumentos de patrón como se explica en el tema Like (Transact-SQL). El proveedor de datos de Azure Cosmos DB para NoSQL puede traducir el caso único especial Like('[aA]%') a BeginsWith('a') O BeginsWith('A'). Tenga en cuenta que la comparación de Azure Cosmos DB para NoSQL distingue entre mayúsculas y minúsculas.

Añadir un origen de datos con el proveedor de datos de Azure Cosmos DB para NoSQL

1. Vaya a AppSource, seleccione OBTENERLO AHORA y siga las instrucciones para agregar la aplicación a su entorno usando v9x o una versión posterior.

2. Después de que la solución esté instalada, inicie sesión en en entorno y vaya a Configuración > Administración > Orígenes de datos de entidades virtuales.

3. En la barra de herramientas Acciones, seleccione NUEVO y, en el cuadro de diálogo Seleccionar proveedor de datos, seleccione Azure Cosmos DB para proveedor de datos API SQL y seleccione Aceptar.

4. Especifique la siguiente información y luego seleccione GUARDAR Y CERRAR.

   Columna	Descripción
   Nombre	Escriba un nombre para describir el origen de datos.
   Nombre de recopilación	El nombre de la base de datos de Azure Cosmos DB que contiene la colección que desea que se muestre en una tabla virtual.
   Clave de autorización	La clave principal o secundaria para la cuenta de Azure Cosmos DB. Puede encontrar la clave en el portal de administración de Azure en la opción claves en su cuenta de Azure Cosmos DB.
   Uri	El URI del grupo de recursos donde se encuentra la colección de Azure Cosmos DB. La dirección URI se forma como https://contoso/documents.azure.com:443. Puede encontrar el URI del portal de administración de Azure en la opción claves de la cuenta de Azure Cosmos DB.
   Tiempo de espera en segundos	Escriba la cantidad de segundos que se debe esperar a una respuesta del servicio Azure Cosmos DB antes de agotar el tiempo de espera de una solicitud de datos. Por ejemplo, escriba 30 para esperar un máximo de treinta segundos antes de que se agote el tiempo de espera. El tiempo de espera predeterminado es de 120 segundos.

   

Recomendaciones y limitaciones

• Tenga en cuenta lo siguiente cuando utilice Azure Cosmos DB como origen de datos:
  • Cada origen de datos Azure Cosmos DB solo se puede asociar a una sola tabla virtual.
  • Puede conectar varios orígenes de datos a la misma colección en la instancia de Azure Cosmos DB.
• No se puede segmentar los datos de una colección por tabla.
• Las bases de datos Azure Cosmos DB no requieren un esquema; sin embargo los datos de la Azure Cosmos DB se deben estructurar mediante un esquema predecible.
• Aunque el proveedor de datos de Azure Cosmos DB para NoSQL implementa la traducción de consultas de operadores de proyección, filtro y ordenación, no admite las operaciones join.
• Solo puedes filtrar por una sola columna con Azure Cosmos DB para NoSQL.

Consulte también

Crear y editar tablas virtuales que contienen datos desde un origen de datos externo

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).