Настроить Microsoft 365 в задаче копирования

Конвейеры Microsoft Fabric интегрируются с Microsoft Graph Data Connect, что позволяет перенести богатые организационные данные в клиенте Microsoft 365 в Fabric и Azure в масштабируемый способ и создавать приложения аналитики и извлекать аналитические сведения на основе этих ценных ресурсов данных. Интеграция с управлением привилегированным доступом обеспечивает защищенный контроль доступа для ценных курированных данных в Microsoft 365. Пожалуйста, смотрите эту ссылку для обзора подключения к данным Microsoft Graph.

В этой статье описывается, как использовать действие копирования в конвейере для копирования данных из Microsoft 365. Теперь в рамках одного действия копирования можно получать данные из Microsoft 365 в таблицу Microsoft Fabric Lakehouse, хранилище BLOB-объектов Azure, Azure Data Lake Storage 1-го поколения и Azure Data Lake Storage 2-го поколения. Поддерживаемый формат данных — Avro, разделенный текст, JSON, ORC и Parquet.

Предпосылки

Чтобы скопировать данные из Microsoft 365, необходимо выполнить следующие необходимые действия:

  • Администратор клиента Microsoft 365 должен выполнить действия по подключению, как описано здесь.
  • Создайте и настройте веб-приложение Microsoft Entra в идентификаторе Microsoft Entra. Инструкции см. в статье "Создание приложения Microsoft Entra".
  • Запишите следующие значения, которые используются для определения подключения для Microsoft 365: идентификатор клиента. Инструкции см. в разделе "Получить идентификатор клиента".
  • Идентификатор приложения и ключ приложения. Инструкции см. в разделе "Получение идентификатора приложения и ключа проверки подлинности". Добавьте удостоверение пользователя, который будет запрашивать доступ к данным, в качестве владельца веб-приложения Microsoft Entra (в Microsoft Entra веб-приложении >Настройки>Владельцы>Добавить владельца).
  • Удостоверение пользователя должно находиться в организации Microsoft 365, из которую вы получаете данные и не должны быть гостевым пользователем.

Утверждение новых запросов на доступ к данным

Если вы запрашиваете данные для этого контекста впервые (сочетание таблицы данных, которая используется, целевой учетной записи, в которую загружаются данные, и идентичности пользователя, выполняющего запрос на доступ к данным), состояние действия копирования отображается как Выполняется. Только если выбрать ссылку "Сведения" в разделе "Действия", состояние будет отображаться как RequestingConsent. Участник группы утверждающего доступа к данным должен утвердить запрос в службе "Управление привилегированным доступом", прежде чем извлечение данных может продолжиться.

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

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

General

Для конфигурации вкладки "Общие " перейдите к разделу "Общие".

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

Следующие свойства поддерживаются для Microsoft 365 на вкладке "Источник " действия копирования.

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

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

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

  • Область: Вы можете выбрать всех пользователей или группы в клиенте Microsoft 365 или выбрать группы из клиента Microsoft 365.

    При выборе всех пользователей или групп в клиенте Microsoft 365 отображается фильтр области.

    Снимок экрана: фильтр области.

    • Фильтр области: можно использовать выражение предиката, которое применяется ко всему клиенту для фильтрации определенных строк для извлечения из Microsoft 365. Формат предиката должен соответствовать формату запросов API Microsoft Graph, например https://graph.microsoft.com/v1.0/users?$filter=Department eq 'Finance'.

    Если выбрать группы из клиента Microsoft 365, можно выбрать " Добавить группы пользователей ", чтобы выбрать группы из клиента Microsoft 365. Используйте это свойство для выбора до 10 групп пользователей, для которых извлекаются данные. Если группы не указаны, данные возвращаются для всей организации.

    Снимок экрана: сведения о группе.

  • Фильтр даты: укажите имя столбца фильтра DateTime. Это свойство позволяет ограничить диапазон времени, для которого извлекаются данные Microsoft 365. Если в наборе данных есть один или несколько столбцов DateTime, необходимо указать здесь столбец. Ознакомьтесь с фильтром для списка наборов данных, требующих этого фильтра DateTime.

    Укажите время начала (UTC) и время окончания (UTC) для фильтрации при выборе столбца фильтра DateTime.

    Снимок экрана: фильтр данных.

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

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

Settings

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

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

В следующих таблицах содержатся дополнительные сведения о действии копирования в Microsoft 365.

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

Имя Description Ценность Обязательно Свойство скрипта JSON
Подключение Ваше подключение к исходному хранилищу данных. <подключение> Да connection
таблица Имя таблицы, извлекаемой из Microsoft 365. <таблица> Да table
Объем Если группа пользователей не указана, можно использовать выражение предиката, которое применяется ко всему клиенту для фильтрации определенных строк для извлечения из Microsoft 365. Формат предиката должен соответствовать формату запросов API Microsoft Graph, например https://graph.microsoft.com/v1.0/users?$filter=Department eq 'Finance'. <ваша сфера ответственности> Да scope
Фильтр области Если свойство allowedGroups не указано, можно использовать выражение предиката, которое применяется ко всему тенанту для фильтрации определенных строк, чтобы извлечь их из Microsoft 365. Формат предиката должен соответствовать формату запросов API Microsoft Graph, например https://graph.microsoft.com/v1.0/users?$filter=Department eq 'Finance'. <Фильтр области> нет userScopeFilterUri
Идентификатор группы Предикат выбора группы. Используйте это свойство для выбора до 10 групп пользователей, для которых извлекаются данные. Если группы не указаны, данные возвращаются для всей организации. <идентификатор группы> нет allowedGroups
Фильтр даты
(Имя столбца)
Имя столбца фильтра DateTime. Это свойство позволяет ограничить диапазон времени, для которого извлекаются данные Microsoft 365. <ваш столбец фильтра DateTime> Да, если данные имеют один или несколько столбцов DateTime. dateFilterColumn
Время начала (UTC) Запустите значение DateTime для фильтрации. <время начала> Да, если dateFilterColumn задано startTime
Время окончания (UTC) Значение End DateTime для фильтрации. <время окончания> Да, если dateFilterColumn задано endTime