Руководство. Выполнение приема файлов на основе манифеста

  • Статья

Прием манифеста предоставляет возможность приема манифестов в экземпляр Azure Data Manager для энергетики.

В этом руководстве описано следующее:

  • Прием примеров манифестов в экземпляре Azure Data Manager для энергетики с помощью Postman.
  • Найдите записи метаданных хранилища, созданные во время приема манифеста с помощью Postman.

Необходимые компоненты

Перед началом работы с этим руководством выполните следующие предварительные требования.

Получение сведений об экземпляре Azure Data Manager для энергетики

  • Вам нужен экземпляр Azure Data Manager для энергетики. Если у вас еще нет, создайте его, выполнив действия, описанные в кратком руководстве. Создание экземпляра Azure Data Manager для энергетики.

  • Для работы с этим руководством вам потребуются следующие параметры:

    Параметр Значение для использования Пример Где найти это значение
    CLIENT_ID Идентификатор приложения (клиент) 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx При регистрации приложения с помощью платформа удостоверений Майкрософт используется этот идентификатор или идентификатор клиента. См. раздел "Регистрация приложения".
    CLIENT_SECRET Секреты клиента _fl****************** Иногда называется паролем приложения, секрет клиента — это строковое значение, которое приложение может использовать вместо сертификата для идентификации. См. раздел Добавление секрета клиента.
    TENANT_ID Идентификатор каталога (клиента) 72f988bf-86f1-41af-91ab-xxxxxxxxxxxx Наведите указатель мыши на имя учетной записи в портал Azure, чтобы получить каталог или идентификатор клиента. Кроме того, найдите и выберите идентификатор клиента свойств>идентификатора>Microsoft Entra в портал Azure.
    SCOPE Идентификатор приложения (клиент) 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx Это значение совпадает с идентификатором приложения или клиента, упоминание ранее.
    refresh_token Значение маркера обновления 0.ATcA01-XWHdJ0ES-qDevC6r........... Следуйте инструкциям по созданию маркера проверки подлинности, чтобы создать маркер обновления и сохранить его. Этот маркер обновления потребуется позже для создания маркера пользователя.
    DNS URI-адрес <instance>.energy.Azure.com Найдите это значение на странице обзора экземпляра Azure Data Manager для энергетики.
    data-partition-id Секции данных <instance>-<data-partition-name> Найдите это значение на странице обзора экземпляра Azure Data Manager для энергетики.

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

Настройка Postman и выполнение запросов

  1. Скачайте и установите классическое приложение Postman .

  2. Импортируйте следующие файлы в Postman:

    Чтобы импортировать коллекцию Postman и переменные среды, выполните действия, описанные в разделе "Импорт данных в Postman".

  3. Обновите CURRENT VALUE для среды Postman с информацией, полученной в подробных сведениях экземпляра Azure Data Manager для энергетики.

  4. Коллекция Postman для приема манифеста содержит несколько запросов, которые необходимо выполнить последовательно.

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

    Screenshot of the Postman environment.

  5. Активируйте каждый запрос, нажав кнопку "Отправить ".

    По каждому запросу Postman проверяет фактический код ответа API по ожидаемому коду ответа. Если имеется несоответствие, раздел теста указывает на сбои.

Ниже приведен пример успешного запроса Postman:

Screenshot of a successful Postman call.

Ниже приведен пример неудачного запроса Postman:

Screenshot of a failed Postman call.

Прием примеров манифестов с помощью Postman

Чтобы получить примеры манифестов в экземпляре Azure Data Manager для энергии с помощью коллекции Postman, выполните следующие действия:

  1. Получение маркера доступа пользователей: создание маркера пользователя, который будет использоваться для проверки подлинности дальнейших вызовов API.

  2. Создайте юридический тег: создайте юридический тег, который будет добавлен в данные манифеста в целях соответствия данным.

  3. Получите ПОДПИСАННЫй URL-адрес для отправки файла: получите путь к подписанному URL-адресу, в который будет отправлен файл манифеста.

  4. Отправьте файл: скачайте пример Wellbore.csv на локальный компьютер. Это может быть любой тип файла, включая CSV, LAS или JSON. Выберите этот файл в Postman, нажав кнопку "Выбрать файл ".

    Screenshot of uploading a manifest file.

  5. Отправка метаданных файла: отправка сведений о метаданных файла, таких как расположение файла и другие соответствующие поля.

  6. Получите метаданные файла: вызов для проверки успешности создания метаданных.

  7. Прием данных master, reference and Work Product Component (WPC): прием метаданных манифеста основного, эталонного и рабочего компонента продукта (WPC).

  8. Получение состояния рабочего процесса приема манифеста: запускается рабочий процесс и находится в состоянии выполнения . Продолжайте запрашивать до тех пор, пока состояние не изменится (обычно 20–30 секунд).

Поиск принятых данных с помощью Postman

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

  1. Поиск рабочих продуктов: вызовите службу поиска, чтобы получить записи метаданных рабочего продукта.
  2. Компоненты продукта поиска: вызовите службу поиска, чтобы получить записи метаданных WPC.
  3. Поиск набора данных: вызовите службу поиска, чтобы получить записи метаданных набора данных.
  4. Поиск основных данных: вызовите службу поиска, чтобы получить записи главных метаданных.
  5. Поиск ссылочных данных: вызовите службу поиска, чтобы получить записи ссылочных метаданных.

Следующий шаг

Перейдите к следующему руководству:

Руководство по использованию sdutil для загрузки данных в Сейсмическое хранилище

Дополнительные сведения о приеме манифеста см. в кратком руководстве по загрузке данных оператора OSDU.