Руководство. Выполнение приема синтаксического анализа CSV

  • Статья

Синтаксический прием с разделителями-запятыми (CSV) предоставляет возможность приема CSV-файлов в экземпляр Azure Data Manager для энергетики.

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

  • Прием примера CSV-файла данных в azure Data Manager для энергетики с помощью Postman.
  • Найдите записи метаданных хранилища, созданные во время приема CSV-файла с помощью 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 для приема синтаксического анализа CSV содержит 10 запросов, которые необходимо выполнить последовательно.

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

    Screenshot of the Postman environment.

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

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

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

Screenshot of a successful Postman call.

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

Screenshot of a failed Postman call.

Прием данных о благополучии с помощью Postman

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

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

  2. Создайте схему: создайте схему, которая соответствует столбцам, присутствующих в CSV-файле.

  3. Получение сведений о схеме. Получите схему, созданную на предыдущем шаге, и проверьте ее.

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

  5. Получите подписанный URL-адрес для отправки CSV-файла: путь к подписанному URL-адресу, в который будет отправлен CSV-файл.

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

    Screenshot of uploading a CSV file.

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

  8. Создайте рабочий процесс приема синтаксического анализа CSV: создайте направленный ациклический граф (DAG) для рабочего процесса приема синтаксического анализа CSV.

  9. Активируйте рабочий процесс приема синтаксического анализа CSV: активируйте DAG для рабочего процесса приема синтаксического анализа CSV.

  10. Найдите состояние приема рабочего процесса синтаксического анализа CSV: Получите состояние запуска DAG средства анализа CSV.

Поиск принятых данных о благополучии с помощью Postman

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

  • Поиск приема записей CSV: поиск записей CSV, созданных ранее.

    Screenshot of searching ingested CSV records.

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

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

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