Condividi tramite


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.

Screenshot che mostra la scheda origine e l'elenco delle proprietà.

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.

Screenshot che mostra la scheda di destinazione e l'elenco delle proprietà.

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 /
Connessione Connessione all'origine Dataverse. < Connessione personale > connection
Tipo di connessione Il tuo tipo di connessione. Dataverse tipo (in typeProperties ->source ->datasetSettings):
CommonDataServiceForAppsEntity
Usa query Modalità di lettura dei dati da Dataverse * Tabelle
* Query
/
Nome entità Il nome logico dell'entità da recuperare. < nome entità > 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 > 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 /
Connessione Connessione a Dataverse di destinazione. < Connessione personale > connection
Tipo di connessione Il tuo tipo di connessione. Dataverse tipo (in typeProperties ->sink ->datasetSettings):
CommonDataServiceForAppsEntity
Nome entità Il nome logico dell'entità da recuperare. < entità > entityName
Comportamento di scrittura Comportamento dell'azione di scrittura dell'operazione. Il valore deve essere Upsert. Upsert 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