Создание первого приложения Microsoft Graph Data Connect

Microsoft Graph Data Connect (Data Connect) дополняет интерфейсы API транзакций интеллектуальным способом доступа к расширенным данным в большом масштабе. Data Connect идеально подходит для приложений больших данных и машинного обучения, так как позволяет разрабатывать приложения для аналитики, аналитики и оптимизации бизнес-процессов путем расширения данных Microsoft 365 в Microsoft Azure. Благодаря этому предложению вы сможете воспользоваться преимуществами обширного набора вычислительных ресурсов и хранилища в Azure, сохраняя при этом соответствие отраслевым стандартам и обеспечивая безопасность данных.

Data Connect использует Microsoft Fabric, Azure Synapse или Фабрика данных Azure для копирования данных Microsoft 365 в хранилище приложения с настраиваемыми интервалами. Он также предоставляет набор средств для упрощения доставки этих данных в Azure, позволяя получить доступ к наиболее применимым средствам разработки и размещения.

Подключение к данным также предоставляет более детальную модель управления и согласия: вы можете управлять данными, видеть, кто к ним обращается, и запрашивать определенные свойства объекта. Это улучшает модель Microsoft Graph, которая предоставляет или запрещает приложениям доступ ко всем объектам.

Кроме того, вы можете использовать Data Connect для включения сценариев машинного обучения в организации. В этих сценариях можно создавать приложения, которые предоставляют ценные сведения заинтересованным лицам, обучают модели машинного обучения и даже выполняют прогнозирование на основе больших объемов полученных данных.

Начало работы

В этом руководстве вы создадите первое однотенантное приложение Data Connect. В следующем общем потоке объясняется процесс подключения Data Connect.

1. Администратор включает Data Connect. Первым шагом в подключении является включение Data Connect глобальным администратором.

2. Разработчик создает новое приложение Microsoft Entra. Сначала необходимо создать новое приложение Microsoft Entra.

3. Разработчик регистрирует приложение в Data Connect: После создания приложения Microsoft Entra разработчику необходимо зарегистрировать его в Data Connect с помощью нового портала регистрации приложений Microsoft Graph Data Connect. На этом шаге разработчик указывает, какие данные требуются для приложения.

4. Администратор утверждает приложение. После того как разработчик зарегистрировал свое приложение в Data Connect, глобальный администратор может использовать новый портал для получения согласия приложения Data Connect, чтобы проверить зарегистрированное приложение и утвердить его.

5. Разработчик запускает конвейеры: После согласия администратора на приложение разработчик может запустить свои конвейеры без каких-либо остановок для получения согласия среды выполнения. Создание и запуск конвейера с помощью Фабрика данных Azure или Azure Synapse остается прежним.

Предварительные условия

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

• В этом руководстве настоятельно рекомендуется использовать клиент разработчика Microsoft 365.
• Клиенты Microsoft 365 и Azure должны находиться в одном Microsoft Entra клиенте.
• Подписка Azure должна находиться в том же клиенте, что и клиент Microsoft 365.
• У одного пользователя в клиенте Microsoft 365 включена роль глобального администратора . В дальнейшем в этом руководстве этот пользователь называется администратором. Только пользователь с правами администратора может утвердить тестовое приложение.
• Другой пользователь в клиенте Microsoft 365 с ролью администратора приложений или разработчика приложений . В дальнейшем в этом руководстве этот пользователь называется разработчиком. Большую часть этого руководства выполняет пользователь-разработчик.

1. Клиент Microsoft 365

   • Если у вас нет клиента Microsoft 365, вы можете претендовать на него в рамках Программы разработчиков Microsoft 365. Дополнительные сведения см. в разделе Вопросы и ответы. Кроме того, вы можете зарегистрироваться для получения бесплатной пробной версии на 1 месяц или приобрести план Microsoft 365.

   Примечание.

   Вы не можете утвердить собственное тестовое приложение с помощью той же учетной записи. Убедитесь, что в вашем клиенте есть другой участник (или учетная запись), который выступает в качестве администратора.

2. Подписка на Microsoft Azure.

   • Если у вас нет подписки Microsoft Azure, перейдите по следующей ссылке, чтобы получить ее (бесплатно): Создайте бесплатную учетную запись Azure.
   • Ваша подписка Azure должна находиться в том же клиенте, что и клиент Microsoft 365, и обе должны находиться в одном Microsoft Entra клиенте.
   • Если ваша подписка Azure не в том же клиенте, что и клиент Microsoft 365, вы можете связать свою подписку с Microsoft Entra ID в клиенте Microsoft 365, выполнив действия, описанные в разделе Связывание или добавление подписки Azure в клиент Microsoft Entra.

   Примечание.

   Снимки экрана и примеры, используемые в этом руководстве, приведены из клиента разработчика Microsoft 365 с примером электронной почты от тестовых пользователей. Для выполнения аналогичных действий можно использовать собственный клиент Microsoft 365. Данные не записываются в Microsoft 365. Копия данных электронной почты извлекается из всех пользователей в клиенте Microsoft 365 и копируется в учетную запись Хранилище BLOB-объектов Azure. Вы контролируете доступ к данным в Хранилище BLOB-объектов Azure.

Настройка клиента Microsoft 365 и включение Microsoft Graph Data Connect

Прежде чем использовать Microsoft Graph Data Connect (Data Connect) в первый раз, обратитесь к администратору клиента Microsoft 365, чтобы включить службу Data Connect для вашего клиента.

В этом руководстве убедитесь, что у вас есть учетная запись с правами администратора. Этот шаг необходимо выполнить, чтобы настроить первый конвейер. Рекомендуется иметь по крайней мере двух пользователей в клиенте Microsoft 365 с включенной ролью глобального администратора .

• Встроенная роль глобального администратора.
• Повышение прав доступа для получения роли глобального администратора.

Включение Microsoft Graph Data Connect в клиенте Microsoft 365

Настройте клиент Microsoft 365, чтобы включить использование Microsoft Graph Data Connect.

1. Откройте браузер, перейдите на портал администрирования Microsoft 365 и войдите с помощью администратора .

2. Выберите Параметры > Параметры Параметры Организации. Возможно, вам потребуется выбрать Показать все , прежде чем вы сможете просматривать параметры.

3. На вкладке Службы (которая должна быть выбрана по умолчанию) выберите Microsoft Graph Data Connect.

4. Установите флажок Включить или отключить Microsoft Graph Data Connect для всей организации и нажмите кнопку Сохранить.

   

Поздравляем, вы только что включили Microsoft Graph Data Connect для вашей организации!

Настройка приложения Microsoft Entra

В этом упражнении вы узнаете, как создать приложение Microsoft Entra. Он служит субъектом безопасности для запуска процесса извлечения данных с помощью Microsoft Graph Data Connect.

1. Войдите в Центр администрирования Microsoft Entra по крайней мере с ролью "Администратор приложений" или"Разработчик приложений".

2. Разверните меню >Удостоверение, выберите Приложения>Регистрация приложений>Новая регистрация.

3. Используйте следующие значения, чтобы создать приложение Microsoft Entra и выбрать Зарегистрировать.

   • Имя: Передача данных Microsoft Graph Data Connect (укажите имя по своему выбору).
   • Поддерживаемые типы учетных записей: учетные записи только в этом каталоге организации.
   • URI перенаправления. Оставьте значения по умолчанию.

   

4. Найдите идентификатор приложения (клиента) и скопируйте его по мере необходимости далее в этом руководстве. В дальнейшем это называется идентификатором субъекта-службы.

5. Найдите идентификатор каталога (клиента) и скопируйте его по мере необходимости далее в этом руководстве. В дальнейшем это называется идентификатором клиента.

   

6. В области навигации слева выберите Сертификаты & секреты в разделе Управление.

7. Нажмите кнопку Новый секрет клиента. В раскрывающемся списке задайте для параметра Описание любое имя, в раскрывающемся списке задайте для параметра Expires любое значение и нажмите кнопку Добавить.

   

   • После создания секрета клиента убедитесь, что вы сохранили значение в безопасном месте, так как оно больше не будет доступно позже. В противном случае потребуется создать новый.
   • В дальнейшем секрет клиента называется ключом субъекта-службы.

8. В левой области навигации для приложения выберите Владельцы.

9. Убедитесь, что ваша учетная запись (если вы используете клиент разработчика, использующий учетную запись глобального администратора) соответствует следующим требованиям, чтобы быть владельцем приложения:

   • Ваша учетная запись соответствует допустимому пользователю в клиенте, который не является именем субъекта-службы.
   • Вашей учетной записи должна быть назначена лицензия на Exchange Online (должен быть почтовый ящик).
   • Наряду с лицензией Exchange Online ваша учетная запись также должна иметь рабочую подписку или лицензию E5.

10. Убедитесь, что ваша учетная запись указана в качестве владельца приложения. Если это не так, добавьте его в список.

    

Настройка ресурса службы хранилища Azure

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

1. Откройте браузер и перейдите к портал Azure.

2. Войдите в портал Azure с помощью учетной записи с ролью разработчика приложения.

3. На боковой панели навигации выберите Создать ресурс.

4. Найдите тип ресурса учетной записи хранения и используйте следующие значения для его настройки. В полях Производительность, Избыточность и Дополнительно значения этих полей являются примером.

   • Подписка: выберите подписку Azure.
   • Группа ресурсов: mgdc-app-resource (или выберите существующую группу ресурсов).
   • Имя учетной записи хранения: mgdcdemoap (или можно указать имя и выбрать собственную учетную запись хранения).
   • Регион: выберите регион Azure в том же регионе, что и регион Microsoft 365.
   • Производительность: Standard
   • Избыточность: геоизбыточное хранилище
   • Вкладка "Дополнительно":
     • Уровень доступа: горячий

   

5. Настроив значения для вкладок Основные и Дополнительно , оставьте остальные параметры по умолчанию.

   Примечание.

   Убедитесь, что на вкладке Сеть включен параметр Включить общедоступный доступ из всех сетей . Можно также выбрать второй параметр Включить общедоступный доступ из выбранных виртуальных сетей и IP-адресов. однако необходимо выполнить дополнительные действия, не описанные в этом руководстве, которые выделены в разделе IP-адреса.

   

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

7. После создания учетной записи хранения Azure предоставьте приложению Microsoft Entra, созданному ранее, надлежащий доступ к ней.

   1. Выберите учетную запись хранения Azure.
   2. В меню боковой панели выберите Управление доступом (IAM).
   3. Нажмите кнопку Добавить в блоке Добавление назначения ролей .
   4. Предоставьте ранее созданному приложению роль Участник данных BLOB-объектов хранилища .
      1. Выберите Участник данных BLOB-объектов хранилища в качестве роли и нажмите кнопку Далее.
      2. Назначьте доступпользователю, группе или субъекту-службе.
      3. Щелкните + Выбрать участников, а затем в правой области найдите созданное ранее приложение (передача данных Microsoft Graph) и нажмите кнопку Выбрать.
   5. Щелкните Проверить и назначить.

   

8. Создайте контейнер в учетной записи хранения Azure mgdcdemoap .

   1. Выберите учетную запись хранения Azure mgdcdemoapp (или имя учетной записи из шага 4).

   2. В меню боковой панели выберите Контейнеры в разделе Служба хранилища данных .

   3. Нажмите кнопку +Контейнер в верхней части страницы, используйте следующие значения, а затем нажмите кнопку Создать.

      • Имя: m365mails
      • Уровень общедоступного доступа: частный (без анонимного доступа)

      

Регистрация приложения Microsoft Entra в Microsoft Graph Data Connect

В качестве обязательного условия необходимо включить Data Connect в клиенте. Рекомендуется создать приложение Microsoft Entra и целевой ресурс хранилища. Их также можно настроить с помощью мастера. Процесс регистрации приложения в Data Connect включает использование мастера с тремя вкладками: сведения о регистрации, наборы данных и просмотр и создание.

1. Доступ к Microsoft Graph Data Connect в портал Azure. Его можно найти в строке поиска в портал Azure

2. Выберите Добавить или Добавить новое приложение.

   

3. Следуйте указаниям мастера добавления , чтобы указать сведения о проекте для регистрации. После заполнения обязательных полей выберите Далее: Наборы >данных.

   1. Подписка: Выберите подписку, чтобы отфильтровать следующие выбранные элементы:
      • Группа ресурсов: Выберите созданную ранее группу ресурсов.
      • Тип назначения: Выберите Учетная запись хранения Azure.
      • Учетная запись хранения: Выберите учетную запись хранения, созданную ранее.
      • URI учетной записи хранения: Выберите параметр с .blob.core.windows.net
   2. Идентификатор приложения: Выберите существующий клиент Microsoft Entra или создайте новый.
   3. Описание: Введите Мое первое приложение.
   4. Тип публикации:один клиент должен автоматически выбираться в зависимости от Microsoft Entra приложения.

   

4. Выберите Далее: наборы >данных .

5. Выберите BasicDataSet_v0.Message_v1 в раскрывающемся списке Набор данных и в раскрывающемся списке Столбцы выберите All. В новой строке выберите BasicDataSet_v1 в раскрывающемся списке Набор данных , а в раскрывающемся списке Столбцы выберите All.

   

6. Выберите Просмотр и создание, а затем — Создать.

   

7. Если указаны все обязательные поля, на целевой странице отображается регистрация приложения.

   

Утверждение приложения для Microsoft Graph Data Connect

1. Откройте новое окно браузера в закрытом режиме, перейдите в Центр администрирования Microsoft 365 и войдите в систему с помощью администратора.

1. В области навигации слева выберите Параметры > Параметры Параметры Организации. Для просмотра параметров может потребоваться выбрать Показать все.

2. Перейдите на вкладку Безопасность & конфиденциальности и выберите Приложения Microsoft Graph Data Connect.

   

3. На портале приложений Microsoft Graph Data Connect найдите приложение, зарегистрированное ранее в Data Connect. Он должен иметь состояние предварительного согласия в сводной таблице приложения.

   

4. Выберите приложение, чтобы открыть представление сведений о приложении. Перейдите к мастеру, дважды нажав кнопку Далее , чтобы просмотреть два набора данных.

5. На последнем шаге выберите Утвердить , чтобы предоставить зарегистрированное приложение для доступа к указанным данным.

   

6. Подтвердите перезагрузку сводной таблицы приложения с приложением с состоянием Утверждено.

   

Настройка ресурса Azure с помощью Azure Synapse или Фабрика данных Azure

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

Настройка ресурсов Azure

(Необязательно) Визуализация данных Microsoft Graph Data Connect в Microsoft Power BI

В этом упражнении описывается создание отчета в Microsoft Power BI для визуализации данных Microsoft 365 из Microsoft Graph Data Connect.

Проверка JSON-файла в службе хранилища Azure

1. Откройте браузер и перейдите к портал Azure.
2. В разделе Службы Azure выберите Учетные записи хранения.
3. Выберите учетную запись хранения Azure, созданную ранее в этом руководстве.
4. В области навигации слева выберите Контейнеры.
5. Выберите контейнер m365mails , созданный ранее в этом руководстве.
6. В контейнере должен отобразиться файл с именем GUID.

Настройка Power BI

1. Откройте приложение Power BI Desktop. Если вам нужно скачать Power BI, перейдите в раздел Скачивание средств и приложений Power BI.

2. Выберите Получить данные, Azure и Хранилище BLOB-объектов Azure.

3. Выберите Подключиться, чтобы установить подключение между Power BI и учетной записью Хранилище BLOB-объектов Azure.

   

4. Введите имя учетной записи хранения Azure и имя контейнера для учетной записи Хранилище BLOB-объектов Azure, к которой вы хотите подключиться, а затем нажмите кнопку ОК.

   

   Примечание.

   URL-адрес службы хранилища Azure можно найти в учетной записи хранения Azure. Выполните поиск по контейнерам, выберите контейнер, к которому нужно подключиться, перейдите в контекстное меню (...), выберите Свойства контейнера и скопируйте URL-адрес.

5. Выберите Преобразовать данные и выберите первую строку с двоичным текстом.

   

6. Чтобы получить список со всеми записями, перейдите к переключателю Столбец1, выберите и удерживайте (или щелкните правой кнопкой мыши), чтобы выбрать Преобразование, а затем выберите JSON.

   

7. Загрузите все столбцы, разверните элемент Записи из переключателя Столбец1 и нажмите кнопку ОК.

   

8. Результаты отображаются как Column1.property. Чтобы развернуть столбцы с вложенными данными, выберите переключатель для каждого столбца и нажмите кнопку ОК.

   • Выберите Закрыть & Применить и дождитесь, пока запрос загрузит все столбцы.

   

9. После загрузки всех столбцов можно создавать визуальные элементы с данными.

   • В разделе Данные выберите Запрос1 , чтобы развернуть столбцы и выбрать свойства, которые нужно визуализировать.
   • В разделе Визуализации выберите параметр Ключевые факторы влияния , чтобы визуализировать данные.

   Примечание.

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

   

10. Теперь в отчете Power BI можно просмотреть данные JSON из набора данных Messages_v1 из Microsoft Graph Data Connect.

    Примечание.

    Вы можете выбрать режим подключения к данным (DirectQuery или Импорт) в зависимости от размера данных и требований к запросу. В этом руководстве рекомендуется использовать DirectQuery .

Шаблоны решений, использующие Microsoft Graph Data Connect, встроенные в Power BI, см. в репозитории решений Data Connect в GitHub.

Связанные материалы

• Обзор подключения к данным Microsoft Graph