Configurare Dataverse in un'attività di copia
Questo articolo illustra come usare l'attività di copia in una pipeline di dati per copiare i dati da e verso Dataverse.
Prerequisiti
Per usare questo connettore con l'autenticazione dell'entità servizio Microsoft Entra, è necessario configurare l'autenticazione da server a server (S2S) in Dataverse. Registrare prima l'utente dell'applicazione (entità servizio) in Microsoft Entra. Per altre informazioni, vedere Creare un'applicazione Microsoft Entra e un'entità servizio in grado di accedere alle risorse.
Durante la registrazione dell'applicazione, sarà necessario creare l'utente in Dataverse e concedere le autorizzazioni. Queste autorizzazioni possono essere concesse direttamente o indirettamente aggiungendo l'utente dell'applicazione a un team a cui sono state concesse le autorizzazioni in Dataverse. Per altre informazioni su come configurare un utente dell'applicazione per l'autenticazione con Dataverse, vedere Usare l'autenticazione da server a server con singolo tenant.
Configurazione supportata
Per la configurazione di ogni scheda nell'attività di copia, passare rispettivamente alle sezioni seguenti.
Generali
Per configurazione della scheda Generale, passare a Impostazioni generali.
Origine
Passare alla scheda Origine per configurare l'origine dell'attività di copia. Per la configurazione dettagliata, vedere il contenuto seguente.
Per ogni oggetto sono necessarie le proprietà seguenti:
- Tipo di archivio dati: selezionare Esterno.
- Connessioni: seleziona una connessione Dataverse esistente dall’elenco connessioni. Se non esiste alcuna connessione, creare una nuova connessione Dataverse selezionando Nuovo.
- Tipo di connessione: selezionare Dataverse.
- Usare query: specificare il modo usato per leggere i dati. È possibile scegliere Nome entità per leggere i dati usando il nome dell'entità o Query per usare la query per leggere i dati.
Nome entità: selezionare il nome dell'entità dall'elenco a discesa oppure selezionare Modifica per immetterlo manualmente. È il nome logico dell'entità da richiamare.
Query: uso di FetchXML per leggere i dati da Dataverse. FetchXML è un linguaggio di query proprietario usato in Dynamics online e locale. Vedi l'esempio seguente. Per altre informazioni, vedere Creare query con FetchXML.
Esempio di query FetchXML:
<fetch> <entity name="account"> <attribute name="accountid" /> <attribute name="name" /> <attribute name="marketingonly" /> <attribute name="modifiedon" /> <order attribute="modifiedon" descending="false" /> <filter type="and"> <condition attribute ="modifiedon" operator="between"> <value>2017-03-10 18:40:00z</value> <value>2017-03-12 20:40:00z</value> </condition> </filter> </entity> </fetch>
Sotto Avanzate, è possibile specificare i campi seguenti:
- Colonne aggiuntive: aggiungere altre colonne di dati per archiviare il percorso relativo o il valore statico dei file di origine. L'espressione è supportata per quest'ultima. Per altre informazioni, vedere Aggiungere altre colonne durante la copia.
Destinazione
Passare alla scheda Destinazione per configurare la destinazione dell'attività di copia. Per la configurazione dettagliata, vedere il contenuto seguente.
Per ogni oggetto sono necessarie le proprietà seguenti:
- Tipo di archivio dati: selezionare Esterno.
- Connessioni: seleziona una connessione Dataverse esistente dall’elenco connessioni. Se non esiste alcuna connessione, creare una nuova connessione Dataverse selezionando Nuovo.
- Tipo di connessione: selezionare Dataverse.
- Nome entità: specificare il nome dell'entità per scrivere i dati. Selezionare il nome dell'entità dall'elenco a discesa oppure selezionare Modifica per immetterlo manualmente. Questo è il nome logico dell'entità da richiamare.
Sotto Avanzate, è possibile specificare i campi seguenti:
- Comportamento di scrittura: comportamento dell'azione di scrittura dell'operazione. Questa proprietà è obbligatoria ed è necessario selezionare Upsert. Se si usa Aggiungi contenuto dinamico, specificare il valore di Upsert.
- Nome chiave alternativo: specificare il nome di chiave alternativo definito nell'entità per eseguire l'upsert dei record.
- Ignora valori nulli: indica se ignorare i valori null dai dati di input durante l'operazione di scrittura. È selezionato per impostazione predefinita.
- Quando è selezionato: lascia invariati i dati nell'oggetto di destinazione durante l'operazione di upsert/aggiornamento e inserisce il valore predefinito durante l'operazione di inserimento.
- Quando non è selezionato: aggiorna i dati nell'oggetto di destinazione impostandoli su NULL durante l'operazione di upsert/aggiornamento e inserisce il valore NULL durante l'operazione di inserimento.
- Dimensioni batch di scrittura: specificare il numero di righe dei dati scritti in Dataverse in ogni batch.
- Connessioni massime simultanee: il limite massimo di connessioni simultanee stabilite all'archivio dati durante l'esecuzione dell'attività. Specificare un valore solo quando si desidera limitare le connessioni simultanee.
Mapping
Per la configurazione della scheda Mapping, passare a Configurare i mapping nella scheda Mapping. Se si sceglie Binary come formato di file, il mapping non sarà supportato.
Impostazione
Per la configurazione della scheda Impostazioni, vedere Configurare le altre impostazioni nella scheda Impostazioni.
Tabella di riepilogo
Vedere la tabella seguente per il riepilogo e altre informazioni sull'attività di copia di Dataverse.
Informazioni sull'origine
| Nome | Descrizione | valore | Richiesto | Proprietà script JSON |
|---|---|---|---|---|
| Tipo di archivio dati | Tipo di archivio dati. | Esterno | Sì | / |
| Connessione | Connessione all'origine Dataverse. | < Connessione personale > | Sì | connection |
| Tipo di connessione | Il tuo tipo di connessione. | Dataverse | Sì | tipo (in typeProperties ->source ->datasetSettings):CommonDataServiceForAppsEntity |
| Usa query | Modalità di lettura dei dati da Dataverse | * Tabelle * Query |
Sì | / |
| Nome entità | Il nome logico dell'entità da recuperare. | < nome entità > | Sì | entityName |
| Query | Usare FetchXML per leggere i dati da Dataverse. FetchXML è un linguaggio di query proprietario usato in Dynamics online e locale. Per altre informazioni, vedere Creare query con FetchXML. | < query > | Sì | query |
| Colonne aggiuntive | Aggiungere altre colonne di dati per archiviare il percorso relativo o il valore statico dei file di origine. L'espressione è supportata per quest'ultima. Per altre informazioni, vedere Aggiungere altre colonne durante la copia. | * Name * Valore |
No | additionalColumns: * name * valore |
Informazioni sulla destinazione
| Nome | Descrizione | valore | Richiesto | Proprietà script JSON |
|---|---|---|---|---|
| Tipo di archivio dati | Tipo di archivio dati. | Esterno | Sì | / |
| Connessione | Connessione a Dataverse di destinazione. | < Connessione personale > | Sì | connection |
| Tipo di connessione | Il tuo tipo di connessione. | Dataverse | Sì | tipo (in typeProperties ->sink ->datasetSettings):CommonDataServiceForAppsEntity |
| Nome entità | Il nome logico dell'entità da recuperare. | < entità > | Sì | entityName |
| Comportamento di scrittura | Comportamento dell'azione di scrittura dell'operazione. Il valore deve essere Upsert. | Upsert | Sì | writeBehavior: upsert |
| Nome chiave alternativa | Il nome della chiave alternativa definito nell'entità per eseguire l'upsert dei record. | < nome chiave alternativa > | No | alternateKeyName |
| Ignora i valori Null | Indica se ignorare i valori null dai dati di input durante l'operazione di scrittura. - Selezionato (true): lascia invariati i dati nell'oggetto di destinazione durante l'operazione di upsert/aggiornamento e inserisce il valore predefinito durante l'operazione di inserimento. - Non selezionato (falso): aggiorna i dati nell'oggetto di destinazione impostandoli su NULL durante l'operazione di upsert/aggiornamento e inserisce il valore NULL durante l'operazione di inserimento. |
selezionato o non selezionato (impostazione predefinita) | No | ignoreNullValues: true o false (valore predefinito) |
| Dimensioni batch di scrittura | Conteggio delle righe di dati scritti da Dataverse in ogni batch. | < dimensioni batch di scrittura > Il valore predefinito è 10 |
No | writeBatchSize |
| Numero massimo di connessioni simultanee | Limite massimo di connessioni simultanee stabilite all'archivio dati durante l'esecuzione dell'attività. Specificare un valore solo quando si desidera limitare le connessioni simultanee. | < numero massimo di connessioni simultanee > | No | maxConcurrentConnections |