Característica de visualització prèvia: Requisits del proveïdor de dades de l'Azure Cosmos DB per a l'API de l'SQL

Nota

Vigent a partir del novembre de 2020:

  • S’ha canviat el nom del Common Data Service per Microsoft Dataverse. Més informació
  • S’han actualitzat alguns termes del Microsoft Dataverse. Per exemple, ara entitat s’anomena taula, i el camp ha passat a anomenar-se columna. Més informació

Aquest article s’actualitzarà pròximament per reflectir la terminologia més recent.

En aquest tema es descriuen els requisits de l'Azure Cosmos DB per al proveïdor de dades de l'API de l'SQL, així com la forma de configurar i les pràctiques recomanades quan s'utilitza l'Azure Cosmos DB per al proveïdor de dades de l'API de l'SQL amb taules virtuals.

Important

  • Les característiques de visualització prèvia no estan dissenyades per a un entorn de producció i poden tenir una funcionalitat restringida. Aquestes característiques estan disponibles abans d’un llançament oficial de producte per tal que els clients el puguin utilitzar abans i enviar-nos els seus comentaris.
  • Com que s’esperen canvis en aquesta característica, no la utilitzeu en un entorn de producció. Utilitzeu-la només en entorns de prova i de desenvolupament.
  • Microsoft no proporciona suport per a aquesta característica de visualització prèvia. El suport tècnic del Microsoft Dynamics 365 no us podrà ajudar a solucionar els vostres problemes o preguntes. Les característiques de visualització prèvia no estan dissenyades per a l’ús en un entorn de producció i estan subjectes a les condicions d’ús complementàries.

Què és l'Azure Cosmos DB?

L'Azure Cosmos DB és el servei de base de dades de diversos models de Microsoft distribuït globalment per a aplicacions importants. Proporciona capacitats de consulta SQL enriquides i familiars amb baixes latències consistents sobre dades JSON sense esquema. Més informació: Introducció a l'Azure Cosmos DB: l'API de l'SQL

Requisits

  • Un subscripció a l'Azure que inclogui l'Azure Cosmos DB.
  • Una col·lecció d'API de l'SQL de l'Azure Cosmos DB.
  • La base de dades de l'Azure Cosmos DB ha de ser de tipus SQL.

Assignació de tipus de dades

Suposem que teniu un document de l'Azure Cosmos DB en una col·lecció anomenada Comandes que té l'estructura JSON següent.

Exemple JSON per a documents de l'API de l'SQL.

Aquesta taula indica les assignacions de tipus de dades per al document de l'API de l'SQL de la col·lecció Comandes amb el Microsoft Dataverse.

Dades de l'API d'SQL Dataverse
id Clau principal
name Línia de text única
quantity Nombre enter
orderid Línia de text única
ordertype Elecció
amount Nombre decimal o moneda
delivered Sí/No
datetimeoffset Data i hora

Nota

  • Els atributs amb un prefix de subratllat (_) es generen a partir de l'API d'SQL.
  • Els atributs que es configuren com a opcionals al document de l'API de l'SQL i s'assignen al Dataverse com a Necessari per a l'empresa produiran un error de temps d'execució.
  • els valors de l'atribut id han de ser guids.
  • Per obtenir més informació sobre l'ús de les dates a l'API de l'SQL, vegeu Treballar amb dades a l'Azure Cosmos DB.

Filtres de consulta de l'SQL compatibles

El filtratge de consultes SQL admet els següents operadors.

  • Operadors de comparació: <, >, <=, >= i !=
  • Operadors lògics: and, or
  • Operadors de conjunt: in, not in
  • Operadors de cadena: like, contains, begins with, ends with

Nota

L'ús de l'operador com s'ha traduït a l'equivalent dels operadors contains/begins with/ends with. L'API d'SQL no es compatible amb arguments de patrons de suport com es descriu en aquest tema Like (Transact-SQL). L'Azure Cosmos DB per al proveïdor de dades de l'API de l'SQL pot traduir l'únic cas especial Like('[aA]%') a BeginsWith('a') o BeginsWith('A'). Observeu que la comparació de cadenes a l'API d'SQL distingeix entre majúscules i minúscules.

Afegiu font de dades mitjançant el proveïdor de dades de l'Azure Cosmos DB per a l'API de l'SQL

  1. Aneu a l'AppSource, seleccioneu OBTÉN-HO ARA i seguiu les instruccions per afegir l'aplicació a l'entorn amb v9x o posterior.

  2. Després d'instal·lar la solució, inicieu la sessió a l'entorn i aneu a Configuració > Administració > Fonts de dades de l'entitat virtuals.

  3. A la barra d'eines Accions seleccioneu Crea i al quadre de diàleg Seleccioneu el proveïdor de dades seleccioneu Proveïdor de dades de l'Azure Cosmos DB per a l'API de l'SQL i, a continuació, seleccioneu D'acord. Seleccioneu el proveïdor de dades de l'Azure Cosmos DB per a l'API de l'SQL.

  4. Introduïu la informació següent i seleccioneu Desa i tanca.

    Columnes Descripció
    Nom Escriviu un nom per descriure la font de dades.
    Nom de la col·lecció El nom de la col·lecció de la base de dades de l'Azure Cosmos DB que conté la col·lecció que voleu exposar en una taula virtual.
    Clau d'autorització La clau principal o secundària per al compte de l'Azure Cosmos DB. Podeu trobar la clau des del portal d'administració de l'Azure a la configuració Claus del compte de l'Azure Cosmos DB.
    Uri L'URI del grup de recursos on es troba la col·lecció de l'Azure Cosmos DB. L'URI està format de forma similar al https://contoso/documents.azure.com:443. Per trobar l'URI des del portal d'administració de l'Azure a la configuració Claus del compte de l'Azure Cosmos DB.
    Temps d'espera en segons Introduïu el nombre de segons que heu d'esperar per una resposta del servei de l'Azure Cosmos DB abans del temps d'espera de sol·licitud de dades. Per exemple, introduïu 30 per esperar un màxim de trenta segons abans que es produeixi un temps d'espera. El temps d'espera per defecte és de 120 segons.

    Crear l'origen de les dades amb el proveïdor de dades de l'API de l'SQL.

Recomanacions i limitacions

  • Tingueu en compte el següent quan utilitzeu l'Azure Cosmos DB com una font de dades:
    • Cada font de dades de l'Azure Cosmos DB només es pot associar amb una sola taula virtual.
    • Podeu connectar diverses fonts de dades a la mateixa col·lecció a l'Azure Cosmos DB.
  • No podeu segmentar les dades d'un conjunt per taula.
  • La bases de dades de l'Azure Cosmos DB no necessita cap esquema, però les dades de l'Azure Cosmos DB s'han d'estructurar amb un esquema previsible.
  • Tot i que l'Azure Cosmos DB per al proveïdor de dades de l'API de l'SQL implementa la traducció de consultes dels operadors de projecció, filtratge i classificació, no admet operacions d'unió.
  • Amb l'API d'SQL només podeu filtrar per una única columna.

Consulteu també

Crear i editar taules virtuals que contenen dades des d'una font de dades externa