Jak skonfigurować usługę Dataverse w działaniu kopiowania

W tym artykule opisano sposób używania działania kopiowania w potoku danych do kopiowania danych z i do usługi Dataverse.

Ważne

Usługa Microsoft Fabric jest obecnie dostępna w wersji zapoznawczej. Te informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed jego wydaniem. Firma Microsoft nie udziela żadnych gwarancji, wyrażonych ani domniemanych, w odniesieniu do informacji podanych tutaj. Zapoznaj się z dokumentacją Azure Data Factory dotyczącą usługi na platformie Azure.

Wymagania wstępne

Aby użyć tego łącznika z uwierzytelnianiem jednostki usługi Azure AD, należy skonfigurować uwierzytelnianie między serwerami (S2S) w usłudze Dataverse. Najpierw zarejestruj użytkownika aplikacji (jednostkę usługi) w usłudze Azure Active Directory. Możesz dowiedzieć się, jak to zrobić tutaj. Podczas rejestracji aplikacji należy utworzyć tego użytkownika w usłudze Dataverse i udzielić uprawnień. Te uprawnienia można udzielić bezpośrednio lub pośrednio, dodając użytkownika aplikacji do zespołu, któremu udzielono uprawnień w usłudze Dataverse. Więcej informacji na temat konfigurowania użytkownika aplikacji do uwierzytelniania za pomocą usługi Dataverse można znaleźć tutaj.

Obsługiwana konfiguracja

W przypadku konfiguracji każdej karty w działaniu kopiowania przejdź odpowiednio do poniższych sekcji.

• Ogólne
• Element źródłowy
• Element docelowy
• Mapowania
• Ustawienia

Ogólne

W obszarze Konfiguracja karty Ogólne przejdź do pozycji Ustawienia ogólne.

Element źródłowy

Przejdź do karty Źródło , aby skonfigurować źródło działania kopiowania. Zobacz następującą zawartość, aby uzyskać szczegółową konfigurację.

Wymagane są następujące właściwości:

• Typ magazynu danych: wybierz pozycję Zewnętrzne.
• Połączenie: wybierz istniejące połączenie usługi Dataverse z listy połączeń. Jeśli połączenie nie istnieje, utwórz nowe połączenie usługi Dataverse, wybierając pozycję Nowy.
• Typ połączenia: wybierz pozycję Dataverse.
• Użyj zapytania: określ sposób odczytywania danych. Możesz wybrać nazwę jednostki do odczytywania danych przy użyciu nazwy jednostki lub zapytania , aby użyć zapytania do odczytywania danych.

  • Nazwa jednostki: wybierz nazwę jednostki z listy rozwijanej lub wybierz pozycję Edytuj , aby wprowadzić ją ręcznie. Jest to nazwa logiczna jednostki do pobrania.

  • Zapytanie: odczytywanie danych z usługi Dataverse przy użyciu narzędzia FetchXML. FetchXML to zastrzeżony język zapytań używany w usłudze Dynamics Online i lokalnie. Zobacz poniższy przykład. Aby dowiedzieć się więcej, zobacz Kompilowanie zapytań za pomocą narzędzia FetchXML.

    Przykładowe zapytanie 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>
    

W obszarze Zaawansowane możesz określić następujące pola:

• Dodatkowe kolumny: Dodaj dodatkowe kolumny danych, aby przechowywać ścieżkę względną plików źródłowych lub wartość statyczną. Wyrażenie jest obsługiwane w przypadku tych ostatnich. Aby uzyskać więcej informacji, zobacz Dodawanie dodatkowych kolumn podczas kopiowania.

Element docelowy

Przejdź do karty Miejsce docelowe , aby skonfigurować miejsce docelowe działania kopiowania. Zobacz następującą zawartość, aby uzyskać szczegółową konfigurację.

Wymagane są następujące właściwości:

• Typ magazynu danych: wybierz pozycję Zewnętrzne.
• Połączenie: wybierz istniejące połączenie usługi Dataverse z listy połączeń. Jeśli połączenie nie istnieje, utwórz nowe połączenie usługi Dataverse, wybierając pozycję Nowy.
• Typ połączenia: wybierz pozycję Dataverse.
• Nazwa jednostki: określ nazwę jednostki do zapisywania danych. Wybierz nazwę jednostki z listy rozwijanej lub wybierz pozycję Edytuj , aby wprowadzić ją ręcznie. Jest to nazwa logiczna jednostki do pobrania.

W obszarze Zaawansowane możesz określić następujące pola:

• Zachowanie zapisu: zachowanie zapisu operacji. Ta właściwość jest wymagana i musisz wybrać pozycję Upsert. Jeśli używasz opcji Dodaj zawartość dynamiczną, określ wartość upsert.
• Nazwa klucza alternatywnego: określ nazwę klucza alternatywnego zdefiniowaną w jednostce na potrzeby rekordów upsert.
• Ignoruj wartości null: wskazuje, czy podczas operacji zapisu ignorować wartości null z danych wejściowych. Jest ona domyślnie zaznaczona.
  • Po wybraniu: pozostaw dane w obiekcie docelowym bez zmian podczas wykonywania operacji upsert/update i wstaw zdefiniowaną wartość domyślną podczas wykonywania operacji wstawiania.
  • Gdy jest on niezaznaczony: zaktualizuj dane w obiekcie docelowym na wartość NULL podczas wykonywania operacji upsert/update i wstaw wartość NULL podczas wykonywania operacji wstawiania.
• Rozmiar partii zapisu: określ liczbę wierszy danych zapisanych w usłudze Dataverse w każdej partii.
• Maksymalna liczba współbieżnych połączeń: górny limit połączeń współbieżnych ustanowionych z magazynem danych podczas uruchamiania działania. Określ wartość tylko wtedy, gdy chcesz ograniczyć połączenia współbieżne.

Mapowanie

W obszarze Konfiguracja karty Mapowanie przejdź do tematu Konfigurowanie mapowań na karcie mapowania. Jeśli wybierzesz plik binarny jako format pliku, mapowanie nie będzie obsługiwane.

Ustawienia

W obszarze Konfiguracja karty Ustawienia przejdź do sekcji Konfigurowanie innych ustawień na karcie ustawienia.

Podsumowanie tabeli

Zobacz poniższą tabelę, aby uzyskać podsumowanie i więcej informacji na temat działania kopiowania usługi Dataverse.

Informacje o źródle

Nazwa	Opis	Wartość	Wymagane	Właściwość skryptu JSON
Typ magazynu danych	Typ magazynu danych.	Zewnętrzna	Tak	/
Połączenie	Połączenie ze źródłem Usługi Dataverse.	< połączenie >	Tak	połączenie
Connection type (Typ połączenia)	Typ połączenia.	Dataverse	Tak	typ (pod typeProperties ->source ->datasetSettings): CommonDataServiceForAppsEntity
Korzystanie z zapytania	Sposób odczytywania danych z usługi Dataverse	•Tabel •Kwerendy	Tak	/
Nazwa jednostki	Nazwa logiczna jednostki do pobrania.	< nazwa jednostki >	Tak	entityName
Zapytanie	Użyj narzędzia FetchXML, aby odczytywać dane z usługi Dataverse. FetchXML to zastrzeżony język zapytań używany w usłudze Dynamics Online i lokalnie. Aby dowiedzieć się więcej, zobacz Tworzenie zapytań za pomocą narzędzia FetchXML.	< zapytanie >	Tak	query
Dodatkowe kolumny	Dodaj dodatkowe kolumny danych, aby przechowywać ścieżkę względną plików źródłowych lub wartość statyczną. Wyrażenie jest obsługiwane w przypadku tego ostatniego. Aby uzyskać więcej informacji, zobacz Dodawanie dodatkowych kolumn podczas kopiowania.	•Nazwa •Wartość	Nie	additionalColumns: •Nazwa •Wartość

Informacje o miejscu docelowym

Nazwa	Opis	Wartość	Wymagane	Właściwość skryptu JSON
Typ magazynu danych	Typ magazynu danych.	Zewnętrzna	Tak	/
Połączenie	Połączenie z docelowym elementem Dataverse.	< połączenie >	Tak	połączenie
Connection type (Typ połączenia)	Typ połączenia.	Dataverse	Tak	typ (w obszarze typeProperties ->sink ->datasetSettings): CommonDataServiceForAppsEntity
Nazwa jednostki	Nazwa logiczna jednostki do pobrania.	< jednostka >	Tak	entityName
Zachowanie zapisu	Zachowanie zapisu operacji. Wartość musi być upsert.	Upsert	Tak	writeBehavior: upsert
Nazwa alternatywnego klucza	Nazwa klucza alternatywnego zdefiniowana w jednostce na rekordy upsert.	< nazwa klucza alternatywnego >	Nie	alternateKeyName
Ignoruj wartości null	Wskazuje, czy należy zignorować wartości null z danych wejściowych podczas operacji zapisu. - Zaznaczone (true): pozostaw dane w obiekcie docelowym bez zmian podczas wykonywania operacji upsert/update i wstaw zdefiniowaną wartość domyślną podczas wykonywania operacji wstawiania. - Niezaznaczone (fałsz): zaktualizuj dane w obiekcie docelowym na wartość NULL podczas wykonywania operacji upsert/update i wstaw wartość NULL podczas wykonywania operacji wstawiania.	wybrane lub niezaznaczone (ustawienie domyślne)	Nie	ignoreNullValues: prawda lub fałsz (wartość domyślna)
Rozmiar partii zapisu	Liczba wierszy danych zapisanych w usłudze Dataverse w każdej partii.	< rozmiar partii zapisu > Wartość domyślna to 10	Nie	writeBatchSize
Maksymalna liczba połączeń współbieżnych	Górny limit połączeń współbieżnych ustanowionych z magazynem danych podczas uruchamiania działania. Określ wartość tylko wtedy, gdy chcesz ograniczyć połączenia współbieżne.	< maksymalna liczba połączeń współbieżnych >	Nie	maxConcurrentConnections

Następne kroki

Omówienie łącznika usługi Dataverse