Funzionalità di anteprima: requisiti del provider di dati Azure Cosmos DB per NoSQL

Questo argomento descrive i requisiti per il provider di dati Azure Cosmos DB per NoSQL nonché la configurazione e le procedure consigliate quando si utilizza il provider di dati Azure Cosmos DB per NoSQL con tabelle virtuali.

Importante

• Le funzionalità di anteprima non sono destinate ad essere utilizzate per la produzione e sono soggette a restrizioni. Queste funzionalità sono disponibili prima di una versione ufficiale in modo che i clienti possano ottenere l'accesso iniziale e fornire dei commenti.
• Sono previste modifiche in questa funzionalità, quindi non utilizzarla nell'ambiente di produzione. Utilizzarla solo in ambiente di prova e di sviluppo.
• Microsoft non offre supporto per questa funzionalità di anteprima. Il supporto tecnico Microsoft Dynamics 365 non sarà in grado di aiutare in caso di problemi o domande. Le funzionalità di anteprima non hanno lo scopo di essere utilizzate per la produzione e sono soggette a distinte condizioni per l'utilizzo supplementari.

Cos'è Azure Cosmos DB?

Azure Cosmos DB è il servizio di database multimodello di Microsoft distribuito globalmente per applicazioni di importanza critica. Fornisce funzionalità di query SQL sofisticate e intuitive con latenze basse coerenti sui dati JSON privi di schema. Ulteriori informazioni: Introduzione a Azure Cosmos DB: Azure Cosmos DB per NoSQL

Requisiti

• La sottoscrizione di Azure che include Azure Cosmos DB.
• Una raccolta Azure Cosmos DB per NoSQL.
• Il tipo di database Azure Cosmos DB deve essere SQL.

Mapping del tipo di dati

Supponi di avere un documento Azure Cosmos DB in una raccolta di Ordini con la seguente struttura di JSON.

Questa tabella indica i mapping dei tipi di dati per il documento Azure Cosmos DB per NoSQL nella raccolta Ordini con Microsoft Dataverse.

Dati di Azure Cosmos DB per NoSQL	Dataverse
id	Primary Key
name	Riga di testo singola
quantity	Numero intero
orderid	Riga di testo singola
ordertype	Scelta
amount	Numero decimale o valuta
delivered	Sì/No
datetimeoffset	Data e ora

Nota

• Gli attributi con un prefisso di sottolineatura (_) vengono generati da Azure Cosmos DB per NoSQL.
• Gli attributi configurati come facoltativi nel documento Azure Cosmos DB per NoSQL e mappati in Dataverse come Obbligatorio per l'azienda causeranno un errore di runtime.
• i valori dell'attributo id devono essere GUID.

Filtro per le query SQL supportati

Il filtro per le query SQL supporta i seguenti operatori.

• Operatori di confronto: <,>,<=, >=,!=
• Operatori logici: and, or
• Operatori Set: in, not in
• Operatori stringa: like``contains, begins with, ends with

Nota

L'utilizzo dell'operatore di similitudine viene tradotto negli operatori contains/begins with/ends with equivalenti. Azure Cosmos DB per NoSQL non supporta argomenti di pattern come descritto nell'argomento Like (Transact-SQL). Il provider di dati Azure Cosmos DB per NoSQL può convertire il singolo caso speciale Like('[aA]%') in BeginsWith('a') O BeginsWith('A'). Nota che Il confronto delle stringhe in Azure Cosmos DB per NoSQL fa la distinzione tra maiuscole e minuscole.

Aggiungere un'origine dati utilizzando il provider di dati Azure Cosmos DB per NoSQL

1. Passare ad AppSource, selezionare OTTIENI SUBITO e seguire le istruzioni per aggiungere l'applicazione all'ambiente in uso utilizzando la versione v9x o successiva.

2. Dopo l'installazione della soluzione accedi all'ambiente e vai a Impostazioni > Amministrazione > Origini dati entità virtuali.

3. Nella barra degli strumenti Azioni seleziona NUOVO e nella finestra di dialogo Seleziona provider dati seleziona Azure Cosmos DB per provider di dati API SQL, quindi seleziona OK.

4. Immetti le informazioni seguenti e seleziona SALVA e CHIUDI.

   Istogramma	Descrizione
   Nome	Digitare un nome che descriva l'origine dati.
   Nome raccolta	Il nome del database di Azure Cosmos DB che contiene la raccolta che desideri presentare in una tabella virtuale.
   Chiave di autorizzazione	Chiave primaria o secondaria per l'account Azure Cosmos DB. Puoi trovare la chiave nel portale di amministrazione di Azure nell'impostazione Chiavi del tuo account Azure Cosmos DB.
   URI	URI del gruppo di risorse in cui è disponibile la raccolta Azure Cosmos DB. Il formato dell'URI è simile a https://contoso/documents.azure.com:443. Puoi trovare l'URI nel portale di amministrazione di Azure nell'impostazione Chiavi del tuo account Azure Cosmos DB.
   Timeout in secondi	Immetti il numero di secondi per attendere una risposta dal servizio Azure Cosmos DB prima di un timeout di richiesta dei dati. Ad esempio, immetti 30 per attendere un massimo di trenta secondi prima che si verifichi un timeout. Il timeout predefinito è 120 secondi.

   

Procedure consigliate e limitazioni

• Nota quanto segue quando utilizzi Azure Cosmos DB come origine dati:
  • Ogni origine dati di Azure Cosmos DB può essere associata solo a una singola tabella virtuale.
  • Puoi collegare più origini dati alla stessa raccolta nell'istanza Azure Cosmos DB.
• Non puoi segmentare i dati in una raccolta in base alla tabella.
• I database di Azure Cosmos DB non richiedono uno schema, ma i dati in Azure Cosmos DB devono essere strutturati con uno schema prevedibile.
• Sebbene il provider di dati Azure Cosmos DB per NoSQL implementi la conversione di query di operatori di proiezione, filtro e ordinamento, non supporta operazioni di join.
• Con Azure Cosmos DB per NoSQL puoi filtrare solo per singola colonna.

Vedi anche

Creare e modificare tabelle virtuali che contengono dati da un'origine dati esterna

Nota

Puoi indicarci le tue preferenze di lingua per la documentazione? Partecipa a un breve sondaggio. (il sondaggio è in inglese)

Il sondaggio richiederà circa sette minuti. Non viene raccolto alcun dato personale (Informativa sulla privacy).