Udostępnij przez


Konfigurowanie usługi Dataverse w działaniu kopiowania

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

Wymagania wstępne

Aby użyć tego łącznika z uwierzytelnianiem konta usługi Microsoft Entra, należy skonfigurować uwierzytelnianie między serwerami (S2S) w Dataverse. Najpierw zarejestruj użytkownika aplikacji (jednostkę usługi) w usłudze Microsoft Entra. Aby uzyskać więcej informacji, zobacz Create a Microsoft Entra application and service principal that can access resources (Tworzenie aplikacji i jednostki usługi Firmy Microsoft, która może uzyskiwać dostęp do zasobów).

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óry otrzymał uprawnienia w usłudze Dataverse. Aby uzyskać więcej informacji na temat konfigurowania użytkownika aplikacji do uwierzytelniania w usłudze Dataverse, zobacz Use single-tenant server-to-server authentication (Używanie uwierzytelniania między serwerami z jedną dzierżawą).

Obsługiwana konfiguracja

W przypadku konfiguracji każdej zakładki podczas czynności kopiowania przejdź odpowiednio do poniższych sekcji.

General

Aby skonfigurować kartę Ogólne, przejdź do Ustawień ogólnych.

Źródło

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

Wymaganenastępujące właściwości:

  • 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 odczytu danych. Możesz wybrać nazwę jednostki , aby odczytać dane przy użyciu nazwy jednostki lub zapytania , aby użyć zapytania do odczytu danych.
    • Nazwa jednostki: wybierz nazwę jednostki z listy rozwijanej lub wybierz pozycję Edytuj , aby wprowadzić ją ręcznie. Jest to nazwa logiczna obiektu 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żna 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 dla tego ostatniego przypadku. Aby uzyskać więcej informacji, zobacz Dodawanie dodatkowych kolumn podczas kopiowania.

Destynacja

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

Wymaganenastępujące właściwości:

  • 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 zapisu danych. Wybierz nazwę jednostki z listy rozwijanej lub wybierz pozycję Edytuj , aby wprowadzić ją ręcznie. Jest to logiczna nazwa jednostki do pobrania.

W obszarze Zaawansowane można 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.
  • Alternatywna nazwa klucza: określ nazwę klucza alternatywnego zdefiniowaną w jednostce na rekordy 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

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

Informacje źródłowe

Name Description Wartość Wymagane Właściwość skryptu JSON
Połączenie Twoje połączenie ze źródłem Dataverse. < połączenie > Tak połączenie
Connection type (Typ połączenia) Typ połączenia. Dataverse Tak typ (pod typeProperties ->source ->datasetSettings):
Common Data Service dla Aplikacji - Jednostka
Użyj zapytania Sposób odczytywania danych z usługi Dataverse *Tabele
*Zapytanie
Tak /
Nazwa jednostki Nazwa logiczna jednostki do pobrania. < nazwa jednostki > Tak entityName
Zapytanie Odczytywanie danych z usługi Dataverse za pomocą narzędzia FetchXML. FetchXML to zastrzeżony język zapytań używany w usłudze Dynamics online i lokalnie. Aby dowiedzieć się więcej, zobacz Kompilowanie zapytań za pomocą narzędzia FetchXML. < zapytanie > Tak kwerenda
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 dla tego ostatniego przypadku. Aby uzyskać więcej informacji, zobacz Dodawanie dodatkowych kolumn podczas kopiowania. *Nazwa
*Wartość
Nie. dodatkoweKolumny:
*nazwa
*wartość

Informacje o lokalizacji docelowej

Name Description Wartość Wymagane Właściwość skryptu JSON
Połączenie Połączenie z docelową usługą Dataverse. < połączenie > Tak połączenie
Connection type (Typ połączenia) Typ połączenia. Dataverse Tak typ (pod typeProperties ->sink ->datasetSettings):
Common Data Service dla Aplikacji - Jednostka
Nazwa jednostki Nazwa logiczna jednostki do pobrania. < twoja jednostka > Tak entityName
Zachowanie podczas zapisu Zachowanie zapisu operacji. Wartość musi być upsert. Upsert Tak Zachowanie zapisu: upsert
Nazwa alternatywnego klucza Alternatywna nazwa klucza zdefiniowana w encji do operacji upsert rekordów. < nazwa alternatywnego klucza > Nie. alternateKeyName
Ignoruj wartości null Wskazuje, czy podczas operacji zapisu mają być ignorowane wartości null z danych wejściowych.
- Wybrane (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 do wartości NULL podczas wykonywania operacji upsert/update i wstaw wartość NULL podczas wykonywania operacji wstawiania.
wybrane lub niezaznaczone (ustawienie domyślne) Nie. ignoreNullValues:
true lub false (wartość domyślna)
rozmiar partii zapisu Liczba wierszy zapisanych danych w usłudze Dataverse w każdej partii. < rozmiar partii zapisu >
Wartość domyślna to 10
Nie. writeBatchSize
maksymalna liczba współbieżnych połączeń Górny limit nawiązywanych jednocześnie połączeń z magazynem danych podczas wykonywania działania. Określ wartość tylko wtedy, gdy chcesz ograniczyć połączenia współbieżne. < maksymalna liczba połączeń współbieżnych > Nie. maxConcurrentConnections