Jak nakonfigurovat Dataverse v aktivitě kopírování

Tento článek popisuje, jak pomocí aktivity kopírování v datovém kanálu kopírovat data z a do Dataverse.

Důležité

Microsoft Fabric je v současné době ve verzi PREVIEW. Tyto informace se týkají předběžné verze produktu, který může být před vydáním podstatně změněn. Společnost Microsoft neposkytuje na zde uvedené informace žádné záruky, vyjádřené ani předpokládané. Projděte si dokumentaci Azure Data Factory pro službu v Azure.

Požadavky

Pokud chcete tento konektor použít s Azure AD ověřováním instančního objektu, musíte nastavit ověřování server-to-server (S2S) v Dataverse. Nejprve zaregistrujte uživatele aplikace (instanční objekt) v Azure Active Directory. Postup najdete tady. Během registrace aplikace budete muset tohoto uživatele vytvořit v Dataverse a udělit oprávnění. Tato oprávnění je možné udělit buď přímo, nebo nepřímo přidáním uživatele aplikace do týmu, který má udělená oprávnění v Dataverse. Další informace o tom, jak nastavit uživatele aplikace pro ověřování pomocí Dataverse, najdete tady.

Podporovaná konfigurace

Informace o konfiguraci jednotlivých karet v části Aktivita kopírování najdete v následujících částech.

• Obecné
• Zdroj
• Cíl
• Mapování
• Nastavení

Obecné

V části Konfigurace karty Obecné přejděte na Obecné nastavení.

Zdroj

Přejděte na kartu Zdroj a nakonfigurujte zdroj aktivity kopírování. Podrobnou konfiguraci najdete v následujícím obsahu.

Vyžadují se následující vlastnosti:

• Typ úložiště dat: Vyberte Externí.
• Připojení: V seznamu připojení vyberte existující připojení Dataverse. Pokud žádné připojení neexistuje, vytvořte nové připojení Dataverse výběrem možnosti Nové.
• Typ připojení: Vyberte Dataverse.
• Použít dotaz: Určete způsob čtení dat. Pokud chcete číst data pomocí názvu entity, můžete zvolit Název entity , nebo Dotaz , který ke čtení dat použije dotaz.

  • Název entity: Vyberte název entity z rozevíracího seznamu nebo vyberte Upravit a zadejte ho ručně. Jedná se o logický název entity, která se má načíst.

  • Dotaz: Čtení dat z Dataverse pomocí FetchXML FetchXML je proprietární dotazovací jazyk, který se používá v Dynamics Online a v místním prostředí. Prohlédněte si následující příklad. Další informace najdete v tématu Vytváření dotazů pomocí FetchXML.

    Ukázkový dotaz 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>
    

V části Upřesnit můžete zadat následující pole:

• Další sloupce: Přidejte další sloupce dat pro uložení relativní cesty ke zdrojovým souborům nebo statické hodnoty. Výraz se podporuje pro druhou možnost. Další informace najdete v tématu Přidání dalších sloupců během kopírování.

Cíl

Přejděte na kartu Cíl a nakonfigurujte cíl aktivity kopírování. Podrobnou konfiguraci najdete v následujícím obsahu.

Vyžadují se následující vlastnosti:

• Typ úložiště dat: Vyberte Externí.
• Připojení: V seznamu připojení vyberte existující připojení Dataverse. Pokud žádné připojení neexistuje, vytvořte nové připojení Dataverse výběrem možnosti Nové.
• Typ připojení: Vyberte Dataverse.
• Název entity: Zadejte název entity pro zápis dat. Vyberte název entity z rozevíracího seznamu nebo vyberte Upravit a zadejte ho ručně. Toto je logický název entity, která se má načíst.

V části Upřesnit můžete zadat následující pole:

• Chování zápisu: Chování operace při zápisu. Tato vlastnost je povinná a musíte vybrat upsert. Pokud použijete možnost Přidat dynamický obsah, zadejte hodnotu upsert.
• Alternativní název klíče: Zadejte alternativní název klíče definovaný ve vaší entitě pro upsert záznamů.
• Ignorovat hodnoty null: Určuje, jestli se mají ignorovat hodnoty null ze vstupních dat během operace zápisu. Ve výchozím nastavení je vybraná.
  • Když je vybraná: Při provádění operace upsert/update nechejte data v cílovém objektu beze změny a při operaci vložení vložte definovanou výchozí hodnotu.
  • Pokud není vybraná: Aktualizujte data v cílovém objektu na hodnotu NULL při operaci upsert/update a při operaci vložení vložte hodnotu NULL.
• Velikost dávky zápisu: Zadejte počet řádků dat zapsaných do Dataverse v každé dávce.
• Maximální počet souběžných připojení: Horní limit souběžných připojení vytvořených k úložišti dat během spuštění aktivity. Hodnotu zadejte pouze v případech, kdy chcete omezit souběžná připojení.

Mapování

Informace o konfiguraci karty Mapování najdete v části Konfigurace mapování na kartě Mapování. Pokud jako formát souboru zvolíte Binary, mapování nebude podporováno.

Nastavení

Konfiguraci karty Nastavení najdete v části Konfigurace dalších nastavení na kartě Nastavení.

Souhrn tabulky

V následující tabulce najdete souhrn a další informace o aktivitě kopírování Dataverse.

Informace o zdroji

Název	Description	Hodnota	Vyžadováno	Vlastnost skriptu JSON
Typ úložiště dat	Typ vašeho úložiště dat.	Externí	Yes	/
Připojení	Vaše připojení ke zdrojové službě Dataverse.	< vaše připojení >	Yes	připojení
Typ připojení:	Váš typ připojení.	Dataverse	Yes	type (v části typeProperties ->source ->datasetSettings): CommonDataServiceForAppsEntity
Použití dotazu	Způsob čtení dat z Dataverse	•Tabulky •Dotazu	Yes	/
Název entity	Logický název entity, která se má načíst.	< název vaší entity >	Yes	entityName
Dotaz	Ke čtení dat z Dataverse použijte FetchXML. FetchXML je proprietární dotazovací jazyk, který se používá v Dynamics Online a v místním prostředí. Další informace najdete v tématu Vytváření dotazů pomocí FetchXML.	< váš dotaz >	Yes	query
Další sloupce	Přidejte další sloupce dat pro uložení relativní cesty nebo statické hodnoty zdrojových souborů. Výraz je podporovaný pro druhý. Další informace najdete v článku Přidání dalších sloupců během kopírování.	•Jméno •Hodnotu	No	additionalColumns: •Jméno •Hodnotu

Informace o cíli

Název	Description	Hodnota	Vyžadováno	Vlastnost skriptu JSON
Typ úložiště dat	Typ úložiště dat.	Externí	Yes	/
Připojení	Vaše připojení k cílové službě Dataverse.	< vaše připojení >	Yes	připojení
Typ připojení:	Váš typ připojení.	Dataverse	Yes	type (v části typeProperties ->sink ->datasetSettings): CommonDataServiceForAppsEntity
Název entity	Logický název entity, která se má načíst.	< vaše entita >	Yes	entityName
Chování při zápisu	Chování operace zápisu. Hodnota musí být Upsert.	Upsert	Yes	writeBehavior: upsert
Alternativní název klíče	Alternativní název klíče definovaný ve vaší entitě pro upsert záznamů.	< alternativní název klíče >	No	alternateKeyName
Ignorovat hodnoty null	Určuje, zda se mají ignorovat hodnoty null ze vstupních dat během operace zápisu. - Vybráno (true): Při operaci upsert/update ponechte data v cílovém objektu beze změny a při operaci vložení vložte definovanou výchozí hodnotu. – Nevybrané (false): Při operaci upsert/update aktualizujte data v cílovém objektu na HODNOTU NULL a při operaci vložení vložte hodnotu NULL.	vybrané nebo nevybrané (výchozí)	No	ignoreNullValues: true nebo false (výchozí)
Velikost dávky zápisu	Počet řádků dat zapsaných do Dataverse v každé dávce.	< velikost dávky zápisu > Výchozí hodnota je 10.	No	writeBatchSize
Maximální počet souběžných připojení	Horní limit souběžných připojení vytvořených k úložišti dat během spuštění aktivity Hodnotu zadejte pouze v případech, kdy chcete omezit souběžná připojení.	< maximální počet souběžných připojení >	No	maxConcurrentConnections

Další kroky

Přehled konektoru Dataverse