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

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

Предпосылки

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

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

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

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

• Общие сведения
• Источник
• Назначение
• Картирование
• Settings

General

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

Исходный материал

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

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

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

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

  • Запрос. Использование FetchXML для чтения данных из Dataverse. FetchXML — это собственный язык запросов, используемый в Dynamics Online и локальной среде. См. следующий пример. Дополнительные сведения см. в статье "Создание запросов с помощью 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>
    

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

• Дополнительные столбцы: добавьте дополнительные столбцы данных для хранения относительного пути или статического значения исходных файлов. Выражение поддерживается для последнего варианта. Дополнительные сведения см. в разделе Добавление дополнительных столбцов во время копирования.

Место назначения

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

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

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

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

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

Картирование

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

Settings

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

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

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

Исходная информация

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

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

• Общие сведения о соединителе Dataverse