Поделиться через

Настройка Dataverse в действии копирования

  • Статья

В этой статье описывается, как использовать действие копирования в конвейере данных для копирования данных из и в Dataverse.

Необходимые компоненты

Чтобы использовать этот соединитель с проверкой подлинности субъекта-службы Microsoft Entra, необходимо настроить проверку подлинности на сервере (S2S) в Dataverse. Сначала зарегистрируйте пользователя приложения (субъект-службу) в Microsoft Entra. Дополнительные сведения см. в статье "Создание приложения Microsoft Entra и субъекта-службы" с доступом к ресурсам.

Во время регистрации приложения необходимо создать этого пользователя в Dataverse и предоставить разрешения. Эти разрешения можно предоставить напрямую или косвенно, добавив пользователя приложения в команду, которая была предоставлена разрешения в Dataverse. Дополнительные сведения о настройке пользователя приложения для проверки подлинности с помощью Dataverse см. в разделе "Использование однотенантной проверки подлинности между серверами и серверами".

Поддерживаемая конфигурация

Для настройки каждой вкладки в действии копирования перейдите к следующим разделам соответственно.

Общие

Для настройки вкладки "Общие" перейдите к общим параметрам.

Оригинал

Перейдите на вкладку "Источник" , чтобы настроить источник действия копирования. См. следующее содержимое для подробной конфигурации.

Screenshot showing source tab and the list of properties.

Требуются следующие свойства:

  • Тип хранилища данных: выберите "Внешний".
  • Подключение. Выберите существующее подключение Dataverse из списка подключений. Если подключение не существует, создайте новое подключение Dataverse, нажав кнопку "Создать".
  • тип Подключение ion: select Dataverse.
  • Используйте запрос: укажите способ, используемый для чтения данных. Вы можете выбрать имя сущности для чтения данных с помощью имени сущности или запроса для чтения данных.

    • Имя сущности: выберите имя сущности из раскрывающегося списка или нажмите кнопку "Изменить ", чтобы ввести ее вручную. Это логическое имя извлекаемой сущности.

    • Запрос. Использование FetchXML для чтения данных из Dataverse. FetchXML — это защищаемый язык запросов, используемый в Dynamics Online и локальной версии Dynamics. См. следующий пример. Дополнительные сведения см. в разделе Создание запросов с помощью FetchXML.

      Пример запроса 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>

В разделе "Дополнительно" можно указать следующие поля:

Назначение

Перейдите на вкладку "Назначение" , чтобы настроить назначение действия копирования. См. следующее содержимое для подробной конфигурации.

Screenshot showing destination tab and the list of properties.

Требуются следующие свойства:

  • Тип хранилища данных: выберите "Внешний".
  • Подключение. Выберите существующее подключение Dataverse из списка подключений. Если подключение не существует, создайте новое подключение Dataverse, нажав кнопку "Создать".
  • тип Подключение ion: select Dataverse.
  • Имя сущности: укажите имя сущности для записи данных. Выберите имя сущности в раскрывающемся списке или нажмите кнопку "Изменить ", чтобы ввести ее вручную. Это логическое имя извлекаемой сущности.

В разделе "Дополнительно" можно указать следующие поля:

  • Поведение записи: поведение записи операции. Это свойство необходимо, и необходимо выбрать Upsert. Если вы используете добавление динамического содержимого, укажите значение Upsert.
  • Альтернативное имя ключа: укажите альтернативное имя ключа, определенное для сущности, для записей upsert.
  • Игнорировать значения NULL: указывает, следует ли игнорировать значения NULL из входных данных во время операции записи. Он выбран по умолчанию.
    • При выборе: оставьте данные в целевом объекте без изменений при выполнении операции upsert/update и вставьте определенное значение по умолчанию при выполнении операции вставки.
    • Если он не выбран: обновите данные в целевом объекте до NULL при выполнении операции upsert/update и вставьте значение NULL при выполнении операции вставки.
  • Размер пакета записи: укажите количество строк, записанных в Dataverse в каждом пакете.
  • Максимальное число одновременных подключений: верхний предел одновременных подключений, установленных в хранилище данных во время выполнения действия. Указывайте значение только при необходимости ограничить количество одновременных подключений.

Сопоставление

Чтобы настроить конфигурацию вкладки "Сопоставление ", перейдите к разделу "Настройка сопоставлений" на вкладке сопоставления. Если в качестве формата файла выбран двоичный файл, сопоставление не будет поддерживаться.

Настройки

Для конфигурации вкладки Параметры перейдите к разделу "Настройка других параметров" на вкладке "Параметры".

Сводка таблицы

Дополнительные сведения о действии копирования Dataverse см. в следующей таблице.

Сведения об источнике

Имя Описание Значение Обязательное поле Свойство скрипта JSON
Тип хранилища данных Тип хранилища данных. Внешняя. Да /
Соединение Подключение к источнику Dataverse. < подключение > Да подключение
Тип подключения Тип подключения. Dataverse Да type (under typeProperties ->source ->datasetSettings):
CommonDataServiceForAppsEntity
Использование запроса Способ чтения данных из Dataverse *Таблицы
*Запроса		 Да /
имя сущности, Логическое имя сущности, которое требуется получить. < имя сущности > Да entityName
Запрос Используйте FetchXML для чтения данных из Dataverse. FetchXML — это защищаемый язык запросов, используемый в Dynamics Online и локальной версии Dynamics. Дополнительные сведения см. в разделе Создание запросов с помощью FetchXML. < запрос > Да query
Дополнительные столбцы Добавьте дополнительные столбцы данных для хранения относительного пути или статического значения исходных файлов. Выражение поддерживается для последнего. Дополнительные сведения см. в описании "Добавление дополнительных столбцов во время копирования". *Имя
*Значение		 No additionalColumns:
*Имя
*Значение

Сведения о назначении

Имя Описание Значение Обязательное поле Свойство скрипта JSON
Тип хранилища данных Тип хранилища данных. Внешняя. Да /
Соединение Подключение к целевому Dataverse. < подключение > Да подключение
Тип подключения Тип подключения. Dataverse Да type (under typeProperties ->sink ->datasetSettings):
CommonDataServiceForAppsEntity
имя сущности, Логическое имя сущности, которое требуется получить. < сущность > Да entityName
Поведение записи Поведение операции при записи. Значение должно быть Upsert. Upsert Да writeBehavior: upsert
Альтернативное имя ключа Альтернативное имя ключа, определенное в сущности для записей upsert. < альтернативное имя ключа > No alternateKeyName
Игнорировать значения NULL Указывает, следует ли игнорировать значения NULL из входных данных во время операции записи.
— Выбрано (true): оставьте данные в целевом объекте без изменений при выполнении операции upsert/update и вставьте определенное значение по умолчанию при выполнении операции вставки.
— Unselected (false): обновите данные в целевом объекте до NULL при выполнении операции upsert/update и вставьте значение NULL при выполнении операции вставки.		 выбран или не выбран (по умолчанию) No ignoreNullValues:
true или false (по умолчанию)
Размер пакета записи Количество строк, записанных в Dataverse в каждом пакете. < размер пакета записи >
Значение по умолчанию — 10		 No writeBatchSize
Максимальное число одновременных подключений Верхний предел одновременных подключений, установленных для хранилища данных при выполнении действия. Указывайте значение только при необходимости ограничить количество одновременных подключений. < максимальное число одновременных подключений > No maxConcurrentConnections

Связанный контент