Журнал карты данных (предварительная версия)

Статья
11/13/2024

Важно!

Сейчас эта функция доступна в предварительной версии. Дополнительные условия использования предварительных версий Microsoft Azure включают дополнительные юридические условия, применимые к функциям Azure, которые находятся в бета-версии, в предварительной версии или еще не выпущены в общедоступной версии.

Когда пользователь обновляет ресурс в Microsoft Purview, журнал карты данных регистрирует изменения и делает информацию доступной на портале Microsoft Purview. Сведения о том, кто добавил или редактировал ресурс, какие изменения были внесены и когда произошло изменение, сохраняются для справки позже. Эти сведения помогают аудиторам и владельцам бизнеса поддерживать соответствие требованиям и безопасность в учетных записях Microsoft Purview. Она также позволяет администраторам и администраторам данных отлаживать проблемы и курировать ресурсы данных.

Журнал карт данных доступен пользователям как в бесплатной , так и в корпоративной версиях Microsoft Purview.

В настоящее время вы можете просмотреть журнал ресурсов:

В решении аудита на портале Microsoft Purview
В отдельных решениях
Использование REST API

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

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

Журнал ресурсов

В настоящее время для этих типов ресурсов доступен журнал карт данных:

Классификации*
Ресурсы данных*
Термины глоссария*
Бизнес-ресурсы*
Домены
Коллекции
Назначения ролей
Источники данных
Проверка
Набор правил сканирования
Credential
Политика

* Интерфейс в решении в настоящее время доступен только для классификаций, ресурсов данных, бизнес-ресурсов и терминов глоссария.

Использование журнала карты данных

Журнал карты данных позволяет просматривать операционный журнал изменений ресурсов карты данных в Microsoft Purview.

Вы можете просмотреть журнал для операций выбора, которые включают:

Создание
Обновления
Задание

Полный список доступных операций в журнале карт данных см. в документации по действиям журнала аудита.

Важно!

Записи журнала карты данных хранятся в разделе Аудит в течение 180 дней и доступны в течение 30 дней в интерфейсе в решении. Чтобы просмотреть журнал аудита дольше, можно использовать Аудит Microsoft Purview (Премиум).

Аудит возможностей решения

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

Перейдите к решению аудита в Microsoft Purview
Выберите Поиск , чтобы найти записи аудита.
Выберите диапазон времени для действия.
Сужайте область поиска, используя действия — понятные имена, действия — имена операций или типы записей.

Совет

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

Опыт работы в журнале решения

Примечание.

Интерфейс в решении в настоящее время доступен только для классификаций, ресурсов данных, бизнес-ресурсов и терминов глоссария.

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

Найдите ресурс данных, термин глоссария или классификацию в Каталог данных Microsoft Purview.
Перейдите на вкладку Журнал .
Прокрутите или отфильтруйте таблицу журнала, чтобы найти нужные операции.

Запрос журнала аудита с помощью REST API

Вы также можете использовать REST API Microsoft Purview для доступа к журналу карты данных.

Для проверки подлинности с помощью REST API следуйте инструкциям на странице Проверка подлинности для API.
Используйте маркер проверки подлинности для POST для этого URL-адреса запроса: https://api.purview-service.microsoft.com/datamap/api/audit/query?api-version=2023-10-01-preview

Вот несколько примеров вызовов API, которые можно использовать для начала работы:

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

Получение журнала ресурса в диапазоне времени

Получение всего журнала аудита ресурса в течение определенного диапазона времени.

{
  "category": "Asset",
  "guid": "f432d351-5442-4724-945b-516d5d501fc9",
  "startTime": "2024-01-01T00:00:00.000Z",
  "endTime": "2024-01-06T00:00:00.000Z",
  "sortBy": "CreationTime",
  "sortOrder": "Descending"
}

Получение журнала конкретной операции

Получение журнала операций определенного типа. Например, если к ресурсу применяются классификации.

Совет

Список доступных операций см. на странице действий журнала аудита.

{
  "category": "Asset",
  "guid": "f432d351-5442-4724-945b-516d5d501fc9",
  "operationType": "ClassificationAdded",
  "sortBy": "CreationTime",
  "sortOrder": "Descending"
}

Фильтрация по пользователю, который редактировал ресурс

{
  "category": "Asset",
  "guid": "f432d351-5442-4724-945b-516d5d501fc9",
  "userId": "contoso@microsoft.com",
  "sortBy": "CreationTime",
  "sortOrder": "Descending"
}

Фильтрация по ключевым словам

Фильтрация по ключевым словам, таким как измененное имя атрибута, значение атрибута и т. д.

{
  "category": "Asset",
  "guid": "f432d351-5442-4724-945b-516d5d501fc9",
  "keywords": "userDescription",
  "sortBy": "CreationTime",
  "sortOrder": "Descending"
}

Пример с разбивкой на страницы

Если после первого запроса свойство lastPage в тексте ответа имеет значение false, то для получения следующей страницы можно использовать параметр "continuationToken" в тексте ответа.

{
  "continuationToken": "TY7BbsIwEAV%2fKDZr4oQ0KAcEVKo4klNvK…",
  "category": "Asset",
  "guid": "f432d351-5442-4724-945b-516d5d501fc9",
  "sortBy": "CreationTime",
  "sortOrder": "Descending",
  "pageSize": 10
}

Ограничения

В настоящее время на появление рабочего элемента на вкладке "Журнал активов" требуется несколько минут.
В настоящее время, чтобы увидеть новый элемент на вкладке Журнал , необходимо обновить вкладку вручную.

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