Samouczek: Zarządzaj harmonogramami analizy sejsmycznej i pobieraj raporty

Important

Ta funkcja jest obecnie dostępna w wersji zapoznawczej. Zobacz dodatkowe warunki użytkowania dla wersji zapoznawczych platformy Microsoft Azure, aby zapoznać się z postanowieniami prawnymi dotyczącymi funkcji platformy Azure, które są w wersji beta, wersji zapoznawczej lub w inny sposób nie zostały jeszcze wydane w wersji ogólnodostępnej.

Ten samouczek pokazuje, jak korzystać z operacji Seismic DDMS Analytics w Azure Data Manager for Energy do tworzenia cyklicznych harmonogramów analitycznych dla Twoich danych sejsmicznych, listowania i pobierania wygenerowanych raportów oraz usuwania harmonogramów, których już nie potrzebujesz. Zaplanowane analizy pomagają śledzić zużycie pamięci masowej i wzorce dostępu do danych między podprojektami i dzierżawcami w czasie, dzięki czemu możesz planować pojemność i optymalizować koszty przechowywania bez konieczności budowania własnego pipeline'u raportowego. Zadanie w tle oblicza żądane statystyki w cyklicznym rytmie i zapisuje każdy raport do Azure Blob Storage. Pobierasz dane raportów bezpośrednio z magazynu, a one nigdy nie przepływają przez usługę.

W tym poradniku nauczysz się, jak:

• Stwórz harmonogram analityczny dla podprojektu lub tenanta
• Wyświetl harmonogramy analityczne i generowane raporty
• Pobierz raport przy użyciu krótkotrwałego adresu URL SAS
• Usuń harmonogram analizy

Prerequisites

Przed rozpoczęciem upewnij się, że spełnisz następujące wymagania wstępne:

• Subskrypcja platformy Azure.
• Zasób Azure Data Manager for Energy z skonfigurowanym modułem Seismic DDMS.
• Zarejestrowana tenant i subproject w usłudze Seismic DDMS.
• Do twojego konta użytkownika jest przypisana rola subproject.admin, datamanager lub tenant.admin, w zależności od zakresu.
• Token typu bearer na potrzeby uwierzytelniania interfejsu API. Gdy używasz DefaultAzureCredential, poproś o zakres https://energy.azure.com/.default (scope). Zobacz Jak wygenerować token uwierzytelniania.
• data-partition-id dzierżawy. W przypadku braku wartości zwracane jest 400 BAD_REQUEST.

Poznaj zakresy analityki

Zadania analityczne działają w jednym z dwóch zakresów. Zakres decyduje, które zbiory danych są mierzone i jaka rola jest wymagana.

Scope	Co mierzy	Jak go ukierunkować	Wymagana rola
Podprojekt	Pojedynczy podprojekt w ramach partycji	name w ciele żądania (create) lub subprojectid w ścieżce URL	subproject.admin, datamanager lub tenant.admin
Najemca	Cała partycja danych	Puste lub pominięte name (create), albo /tenant/... trasy	datamanager lub tenant.admin

Każdy harmonogram przechowuje trzy ustawienia: wartość statistics do obliczenia, dzień tygodnia dla pierwszego uruchomienia (first_execution) oraz jak często powtarza się w dniach (freq_execution). API wykorzystuje /job punkty końcowe do operacji harmonogramowych. Zadanie tła odczytuje harmonogramy i zapisuje raporty do kontenera sdms-analytics-reports, korzystając z układu ścieżki <subproject>/YYYY/MM/DD/.

Prześlij harmonogram analizy

Wyślij żądanie PUT z tablicą JSON, która zawiera pojedynczy obiekt harmonogramu. Pomiń name (lub wyślij pusty ciąg znaków), aby utworzyć harmonogram dla całej dzierżawy; podaj projekt podrzędny name, aby ograniczyć harmonogram do tego podprojektu.

Treść żądania obsługuje następujące pola:

Pole	Required	Typ	Description
name	No	ciąg	Nazwa podprojektu. Gdy jest pusty lub pomijany, harmonogram jest tworzony w zakresie dzierżawy i domyślnie przyjmuje wartość data-partition-id.
statistics	Yes	ciąg	Lista statystyk do obliczenia oddzielona przecinkami. Usuwane są odstępy i wartość jest zamieniana na małe litery przed przechowywaniem.
first_execution	No	Liczba całkowita (1–7)	Dzień tygodnia dla pierwszego uruchomienia. Domyślnie ustawione na bieżący dzień. Wartości spoza zakresu 1–7 zwracają 400 BAD_REQUEST.
freq_execution	No	Liczba całkowita (>0)	Częstotliwość wykonywania w dniach. Wartość domyślna to 7.

1. Prześlij żądanie. Dla harmonogramu podprojektu uwzględnij podprojekt name:

   PUT https://<instance>.energy.azure.com/seistore-svc/api/v3/analytics/job
   Authorization: Bearer {access_token}
   data-partition-id: {data_partition_id}
   Content-Type: application/json
   
   [
     {
       "name": "{subproject_name}",
       "statistics": "count,size",
       "first_execution": 1,
       "freq_execution": 7
     }
   ]
   

   Dla harmonogramu dla całego najemcy pomiń:name

   PUT https://<instance>.energy.azure.com/seistore-svc/api/v3/analytics/job
   Authorization: Bearer {access_token}
   data-partition-id: {data_partition_id}
   Content-Type: application/json
   
   [
     {
       "statistics": "count,size",
       "freq_execution": 7
     }
   ]
   

2. Przejrzyj znormalizowany harmonogram zwrócony w odpowiedzi. Pole type jest przeznaczone subproject dla harmonogramu podprojektu oraz partition dla harmonogramu obejmującego całą organizację. Pole first_execution jest zwracane jako znacznik czasu dla następnego zaplanowanego uruchomienia:

   [
     {
       "name": "{subproject_name}",
       "type": "subproject",
       "statistics": "count,size",
       "first_execution": 1743552000000,
       "freq_execution": 7
     }
   ]
   

Usługa tworzy cykliczny harmonogram analityczny dla wybranego obszaru. Poproś tylko o statystyki, których potrzebujesz, i ustaw freq_execution tak, by odpowiadała częstotliwości przeglądania raportów.

Pobierz harmonogramy analizy

Wywołaj endpoint harmonogramów, aby zobaczyć harmonogramy, które możesz wyświetlić. Użytkownicy z rolą tenant.admin lub datamanager otrzymują pełną listę. Użytkownik z tą rolą subproject.admin otrzymuje tylko harmonogramy podprojektów, którymi może administrować.

1. Prześlij żądanie.

   GET https://<instance>.energy.azure.com/seistore-svc/api/v3/analytics/job
   Authorization: Bearer {access_token}
   data-partition-id: {data_partition_id}
   

2. Przejrzyj zwrócone harmonogramy.

   [
     {
       "name": "{subproject_name}",
       "type": "subproject",
       "statistics": "count,size",
       "first_execution": 1743552000000,
       "freq_execution": 7
     }
   ]
   

Odpowiedź zawiera harmonogramy analityki, które Twoja przypisana rola może wyświetlić.

Pobierz wygenerowane raporty

Raporty stają się dostępne po zakończeniu pierwszego zaplanowanego uruchomienia. Pobierz raporty dla pojedynczego podprojektu lub całej dzierżawy i opcjonalnie zawęź wyniki według daty.

Następujące parametry zapytania kontrolują żądania report-list oraz URL SAS:

Parametr	Required	Typ	Description
filter-date	No	ciąg	Ogranicza wyniki według daty. Musi mieć wartość YYYY, YYYY-MMlub YYYY-MM-DD. Każdy inny format zwraca 400 BAD_REQUEST.
extension	No	ciąg	Wybiera alternatywny kontener raportów o nazwie sdms-analytics-reports-<extension>. Musi zawierać tylko małe litery alfanumeryczne i łączniki, bez kolejnych łączników, a łączna nazwa pojemnika nie może przekraczać 63 znaków.

1. Aby wypisać raporty dla podprojektu, wywołaj trasę podprojektu:

   GET https://<instance>.energy.azure.com/seistore-svc/api/v3/analytics/job/{subprojectid}?filter-date=2026-09
   Authorization: Bearer {access_token}
   data-partition-id: {data_partition_id}
   

   Aby wyświetlić raporty dla całej dzierżawy, wywołaj trasę dzierżawy:

   GET https://<instance>.energy.azure.com/seistore-svc/api/v3/analytics/tenant/job?filter-date=2026
   Authorization: Bearer {access_token}
   data-partition-id: {data_partition_id}
   

2. Przejrzyj listę ścieżek blobów raportu w odpowiedzi:

   [
     "{subproject_name}/2026/09/15/{report_file_name}",
     "{subproject_name}/2026/09/22/{report_file_name}"
   ]
   

Odpowiedź zawiera ścieżki raportowych blobów, które odpowiadają wybranemu filtrowi zakresu i daty. Używaj możliwie najbardziej precyzyjnego elementu filter-date, który spełnia Twoje potrzeby, aby zmniejszyć liczbę zwróconych ścieżek.

Pobierz raport z adresem URL SAS

Dane raportowe nigdy nie przepływają przez usługę. Zamiast tego poproś o krótkotrwałe poświadczenia SAS z /connection-string punktu końcowego, a następnie użyj zwróconego adresu URL SAS, aby odczytać bloby raportów bezpośrednio z usługi Azure Blob Storage. Wartość filter-date, którą podajesz, jest dodawana do ścieżki magazynu, więc bardziej precyzyjna data ogranicza poświadczenie do węższego zestawu blobów. Możesz także użyć parametru extension opisanego w poprzedniej sekcji, aby targetować kontener alternatywnych raportów.

1. Aby zażądać adresu URL SAS dla raportu podprojektu, wywołaj trasę podprojektu:

   GET https://<instance>.energy.azure.com/seistore-svc/api/v3/analytics/job/{subprojectid}/connection-string?filter-date=2026-09-15
   Authorization: Bearer {access_token}
   data-partition-id: {data_partition_id}
   

   Aby zażądać adresu URL SAS dla raportu tenanta, wywołaj trasę tenant:

   GET https://<instance>.energy.azure.com/seistore-svc/api/v3/analytics/tenant/job/connection-string?filter-date=2026-09
   Authorization: Bearer {access_token}
   data-partition-id: {data_partition_id}
   

2. Przejrzyj odpowiedź. access_token zawiera adres URL SAS:

   {
     "access_token": "https://<account>.blob.core.windows.net/sdms-analytics-reports/...&sig=...",
     "expires_in": 3599,
     "token_type": "SasUrl"
   }
   

3. Użyj adresu URL SAS z Azure Storage SDK lub interfejsem API REST, aby pobrać raport ze ścieżki wybranej w poprzedniej sekcji.

Zwrócony adres URL SAS zapewnia tymczasowy dostęp do blobów raportu dla wybranej ścieżki i wygasa w nieco mniej niż godzinę. Traktuj URL jako sekret: nie loguj go ani nie utrwalaj, a po jego wygaśnięciu poproś o nowy.

Usuń harmonogram analiz

Usuń harmonogram analityczny, gdy nie chcesz, aby usługa generowała powtarzające się raporty dla danego zakresu.

1. Aby usunąć harmonogram podprojektu, wywołaj punkt końcowy podprojektu:

   DELETE https://<instance>.energy.azure.com/seistore-svc/api/v3/analytics/job/{subprojectid}
   Authorization: Bearer {access_token}
   data-partition-id: {data_partition_id}
   

   Aby usunąć harmonogram dzierżawcy, wywołaj trasę tenant:

   DELETE https://<instance>.energy.azure.com/seistore-svc/api/v3/analytics/tenant/job
   Authorization: Bearer {access_token}
   data-partition-id: {data_partition_id}
   

2. Potwierdź, że żądanie zwraca 200 OK. Usunięcie nieistniejącego harmonogramu również kończy się powodzeniem, więc operacja jest bezpieczna do ponownego rozpoczęcia.

Harmonogram analityki zostaje usunięty, a usługa przestaje generować powtarzające się raporty dla tego obszaru.

Uprzątnij zasoby

Ten samouczek nie przydziela nowego zasobu Azure. Aby zapobiec generowaniu przyszłych raportów, usuń harmonogram analityki zgodnie z opisem w Usuń harmonogram analityki.

Treści powiązane

• Samouczek: praca z danymi sejsmicznymi przy użyciu interfejsów API Seismic DDMS
• Jak wygenerować token uwierzytelniający
• Dokumentacja interfejsu API Seismic DDMS