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

Pozyskiwanie manifestów umożliwia pozyskiwanie manifestów w wystąpieniu usługi Azure Data Manager for Energy.

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

• Pozyskiwanie przykładowych manifestów w wystąpieniu usługi Azure Data Manager for Energy przy użyciu narzędzia Postman.
• Wyszukaj rekordy metadanych magazynu utworzone podczas pozyskiwania manifestu 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:

   • Kolekcja Postman pozyskiwania manifestu
   • Środowisko postman pozyskiwania manifestu

   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 manifestu zawiera wiele żądań, które należy wykonać sekwencyjnie.

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

   

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:

Oto przykład nieudanego żądania Postman:

Pozyskiwanie przykładowych manifestów przy użyciu narzędzia Postman

Aby pozyskać przykładowe manifesty w wystąpieniu 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 tag prawny: utwórz tag prawny, który zostanie dodany do danych manifestu na potrzeby zgodności danych.

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

4. Przekaż plik: pobierz przykład Wellbore.csv na komputer lokalny. Może to być dowolny typ pliku, w tym CSV, LAS lub JSON. Wybierz ten plik w narzędziu Postman, klikając przycisk Wybierz plik .

   

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

6. Pobierz metadane pliku: wywołaj metodę , aby sprawdzić, czy metadane zostały utworzone pomyślnie.

7. Pozyskiwanie danych wzorca, odwołania i składnika produktu roboczego (WPC): pozyskiwanie metadanych manifestu wzorca, odwołania i składnika produktu roboczego (WPC).

8. Pobierz stan przepływu pracy pozyskiwania manifestu: przepływ pracy jest uruchamiany i jest w stanie uruchomienia . Wykonuj zapytania, aż stan zmieni się na ukończony (zazwyczaj od 20 do 30 sekund).

Wyszukiwanie pozyskanych danych przy użyciu narzędzia Postman

Aby wyszukać rekordy metadanych magazynu utworzone podczas pozyskiwania manifestu przy użyciu kolekcji Postman, wykonaj następujące kroki:

1. Wyszukaj produkty robocze: wywołaj usługę wyszukiwania, aby pobrać rekordy metadanych produktu roboczego.
2. Składniki produktu pracy wyszukiwania: wywołaj usługę wyszukiwania, aby pobrać rekordy metadanych WPC.
3. Wyszukaj pozycję Zestaw danych: wywołaj usługę wyszukiwania, aby pobrać rekordy metadanych zestawu danych.
4. Wyszukaj dane główne: wywołaj usługę wyszukiwania, aby pobrać główne rekordy metadanych.
5. Wyszukaj dane referencyjne: wywołaj usługę wyszukiwania, aby pobrać rekordy metadanych odwołania.

Następny krok

Przejdź do następnego samouczka:

Samouczek: ładowanie danych do magazynu seismic za pomocą narzędzia sdutil

Aby uzyskać więcej informacji na temat pozyskiwania manifestu , zobacz Przewodnik Szybki start ładowania danych operatora OSDU.