Настройка Microsoft 365 в действии копирования
Конвейеры данных Microsoft Fabric интегрируются с Подключение к данным Microsoft Graph, что позволяет перенести богатые организационные данные в клиенте 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 Параметры> Owners>Add owner).
- Удостоверение пользователя должно находиться в организации Microsoft 365, из которую вы получаете данные и не должны быть гостевым пользователем.
Утверждение новых запросов на доступ к данным
Если вы запрашиваете данные для этого контекста в первый раз (сочетание доступа к таблице данных, к которой обращается целевая учетная запись, в которую загружаются данные, и в какой удостоверений пользователя выполняется запрос на доступ к данным), состояние действия копирования отображается как "Выполняется". Только если выбрать ссылку "Сведения" в разделе "Действия", состояние будет отображаться как RequestingConsent. Участник группы лиц, утверждающих доступ к данным, должен утвердить запрос в Privileged Access Management, прежде чем можно будет продолжить извлечение данных.
Ознакомьтесь с часто задаваемыми вопросами о том, как утверждающий может утвердить запрос на доступ к данным. Сведения об интеграции подключения данных с PAM см. в статье о общей интеграции с привилегированным доступом, включая настройку группы утверждающего доступа к данным.
Поддерживаемая конфигурация
Для настройки каждой вкладки в действии копирования перейдите к следующим разделам соответственно.
Общие
Для конфигурации вкладки "Общие" перейдите к разделу "Общие".
Оригинал
Следующие свойства поддерживаются для 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 групп пользователей, для которых извлекаются данные. Если группы не указаны, данные возвращаются для всей организации.
- Фильтр области: можно использовать выражение предиката, которое применяется ко всему клиенту для фильтрации определенных строк для извлечения из Microsoft 365. Формат предиката должен соответствовать формату запросов API Microsoft Graph, например
Фильтр даты: укажите имя столбца фильтра DateTime. Это свойство позволяет ограничить диапазон времени, для которого извлекаются данные Microsoft 365. Если в наборе данных есть один или несколько столбцов DateTime, необходимо указать здесь столбец. Ознакомьтесь с фильтром для списка наборов данных, требующих этого фильтра DateTime.
Укажите время начала (UTC) и время окончания (UTC) для фильтрации при выборе столбца фильтра DateTime.
Сопоставление
Для конфигурации вкладки "Сопоставление" перейдите к разделу "Настройка сопоставлений" на вкладке "Сопоставление".
Настройки
Для конфигурации вкладки Параметры перейдите к разделу "Настройка других параметров" на вкладке "Параметры".
Сводка таблицы
В следующих таблицах содержатся дополнительные сведения о действии копирования в Microsoft 365.
Сведения об источнике
| Имя | Описание | Значение | Обязательное поле | Свойство скрипта JSON |
|---|---|---|---|---|
| Тип хранилища данных | Тип хранилища данных. | Внешний | Да | / |
| Соединение | Подключение к исходному хранилищу данных. | <подключение> | Да | подключение |
| Таблицу | Имя таблицы, извлекаемой из Microsoft 365. | <table> | Да | table |
| Область применения | Если группа пользователей не указана, можно использовать выражение предиката, которое применяется ко всему клиенту для фильтрации определенных строк для извлечения из Microsoft 365. Формат предиката должен соответствовать формату запросов API Microsoft Graph, например https://graph.microsoft.com/v1.0/users?$filter=Department eq 'Finance'. |
<область> | Да | область |
| Фильтр области | allowedGroups Если свойство не указано, можно использовать выражение предиката, которое применяется ко всему клиенту для фильтрации определенных строк для извлечения из Microsoft 365. Формат предиката должен соответствовать формату запросов API Microsoft Graph, например https://graph.microsoft.com/v1.0/users?$filter=Department eq 'Finance'. |
<фильтр область> | No | userScopeFilterUri |
| Идентификатор группы | Предикат выбора группы. Используйте это свойство для выбора до 10 групп пользователей, для которых извлекаются данные. Если группы не указаны, данные возвращаются для всей организации. | <идентификатор группы> | No | allowedGroups |
| Фильтр даты (Имя столбца) |
Имя столбца фильтра даты и времени. Это свойство позволяет ограничить диапазон времени, для которого извлекаются данные Microsoft 365. | <столбец фильтра DateTime> | Да, если данные имеют один или несколько столбцов DateTime. | dateFilterColumn |
| Время начала (UTC) | Начальное значение даты и времени для фильтрации. | <время начала> | Да, если указан dateFilterColumn |
startTime |
| Время окончания (UTC) | Конечное значение даты и времени для фильтрации. | <время окончания> | Да, если указан dateFilterColumn |
endTime |