Udostępnij za pośrednictwem

Samouczek: wykonywanie pozyskiwania analizatora CSV

  • Artykuł

Pozyskiwanie analizatora wartości rozdzielanych przecinkami (CSV) umożliwia pozyskiwanie plików CSV do wystąpienia usługi Azure Data Manager for Energy.

Z tego samouczka dowiesz się, jak wykonywać następujące czynności:

  • Pozyskiwanie przykładowego pliku CSV danych do wystąpienia usługi Azure Data Manager for Energy przy użyciu narzędzia Postman.
  • Wyszukaj rekordy metadanych magazynu utworzone podczas pozyskiwania plików CSV przy użyciu narzędzia Postman.

Wymagania wstępne

Przed rozpoczęciem tego samouczka wykonaj następujące wymagania wstępne.

Uzyskiwanie szczegółów dla wystąpienia usługi Azure Data Manager for Energy

  • Potrzebujesz wystąpienia usługi Azure Data Manager dla usługi Energy. Jeśli jeszcze go nie masz, utwórz go, wykonując kroki opisane w przewodniku Szybki start: Tworzenie wystąpienia usługi Azure Data Manager dla energii.

  • Na potrzeby tego samouczka potrzebne są następujące parametry:

    Parametr Wartość do użycia Przykład Gdzie znaleźć tę wartość
    CLIENT_ID Identyfikator aplikacji (klient) 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx Używasz tej aplikacji lub identyfikatora klienta podczas rejestrowania aplikacji w Platforma tożsamości Microsoft. Zobacz Rejestrowanie aplikacji.
    CLIENT_SECRET Klucze tajne klienta _fl****************** Czasami nazywane hasłem aplikacji wpis tajny klienta jest wartością ciągu, która może być używana przez aplikację zamiast certyfikatu do samodzielnej tożsamości. Zobacz Dodawanie wpisu tajnego klienta.
    TENANT_ID Identyfikator katalogu (dzierżawcy) 72f988bf-86f1-41af-91ab-xxxxxxxxxxxx Umieść kursor na nazwie konta w witrynie Azure Portal, aby uzyskać identyfikator katalogu lub dzierżawy. Alternatywnie wyszukaj i wybierz pozycję Microsoft Entra ID>Properties>Tenant ID w witrynie Azure Portal.
    SCOPE Identyfikator aplikacji (klient) 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx Ta wartość jest taka sama jak wcześniej wymieniona aplikacja lub identyfikator klienta.
    refresh_token Odśwież wartość tokenu 0.ATcA01-XWHdJ0ES-qDevC6r........... Postępuj zgodnie z instrukcjami generowania tokenu uwierzytelniania, aby utworzyć token odświeżania i zapisać go. Ten token odświeżania będzie potrzebny później do wygenerowania tokenu użytkownika.
    DNS Identyfikator URI <instance>.energy.Azure.com Znajdź tę wartość na stronie przeglądu wystąpienia usługi Azure Data Manager for Energy.
    data-partition-id Partycje danych <instance>-<data-partition-name> Znajdź tę wartość na stronie przeglądu wystąpienia usługi Azure Data Manager for Energy.

Postępuj zgodnie z przewodnikiem Zarządzanie użytkownikami , aby dodać odpowiednie uprawnienia dla użytkownika, który uruchamia ten samouczek.

Konfigurowanie narzędzia Postman i wykonywanie żądań

  1. Pobierz i zainstaluj aplikację klasyczną Postman .

  2. Zaimportuj następujące pliki do narzędzia Postman:

    Aby zaimportować kolekcję Postman i zmienne środowiskowe, wykonaj kroki opisane w temacie Importowanie danych do narzędzia Postman.

  3. Zaktualizuj bieżącą wartość dla środowiska Postman przy użyciu informacji uzyskanych w szczegółach wystąpienia usługi Azure Data Manager for Energy.

  4. Kolekcja Postman na potrzeby pozyskiwania analizatora CSV zawiera 10 żądań, które należy wykonać sekwencyjnie.

    Przed wyzwoleniem kolekcji Postman wybierz pozycję Środowisko przepływu pracy pozyskiwania.

    Screenshot of the Postman environment.

  5. Wyzwól każde żądanie, wybierając przycisk Wyślij .

    Na każdym żądaniu narzędzie Postman weryfikuje rzeczywisty kod odpowiedzi interfejsu API względem oczekiwanego kodu odpowiedzi. Jeśli wystąpiła niezgodność, sekcja testu wskazuje błędy.

Oto przykład pomyślnego żądania Postman:

Screenshot of a successful Postman call.

Oto przykład nieudanego żądania Postman:

Screenshot of a failed Postman call.

Pozyskiwanie danych wellbore przy użyciu narzędzia Postman

Aby pozyskać przykładowy plik CSV danych do wystąpienia usługi Azure Data Manager for Energy przy użyciu kolekcji Postman, wykonaj następujące kroki:

  1. Uzyskiwanie tokenu dostępu użytkownika: wygeneruj token użytkownika, który będzie używany do uwierzytelniania dalszych wywołań interfejsu API.

  2. Utwórz schemat: wygeneruj schemat zgodny z kolumnami obecnymi w pliku CSV.

  3. Pobierz szczegóły schematu: pobierz schemat utworzony w poprzednim kroku i zweryfikuj go.

  4. Utwórz tag prawny: utwórz tag prawny, który zostanie dodany do danych CSV na potrzeby zgodności danych.

  5. Uzyskaj podpisany adres URL przekazywania pliku CSV: pobierz podpisaną ścieżkę adresu URL, do której zostanie przekazany plik CSV.

  6. Przekaż plik CSV: pobierz przykład Wellbore.csv na komputer lokalny, a następnie wybierz ten plik w narzędziu Postman, klikając przycisk Wybierz plik .

    Screenshot of uploading a CSV file.

  7. Przekaż metadane pliku CSV: przekaż informacje o metadanych pliku, takie jak lokalizacja pliku i inne odpowiednie pola.

  8. Utwórz przepływ pracy pozyskiwania analizatora CSV: utwórz skierowany graf acykliczny (DAG) dla przepływu pracy pozyskiwania analizatora CSV.

  9. Wyzwalanie przepływu pracy pozyskiwania analizatora CSV: wyzwalanie grupy DAG dla przepływu pracy pozyskiwania analizatora CSV.

  10. Wyszukaj stan przepływu pracy pozyskiwania analizatora CSV pozyskanego pliku CSV: Pobierz stan uruchomienia dag analizatora CSV.

Wyszukiwanie pozyskanych danych wellbore przy użyciu narzędzia Postman

Aby wyszukać rekordy metadanych magazynu utworzone podczas pozyskiwania woluminów CSV przy użyciu kolekcji Postman, wykonaj następujący krok:

  • Wyszukaj pozyskane rekordy CSV: wyszukaj utworzone wcześniej rekordy CSV.

    Screenshot of searching ingested CSV records.

Następny krok

Przejdź do następnego samouczka:

Samouczek: wykonywanie pozyskiwania plików opartych na manifeście