Öğretici: Sismik analiz zamanlamalarını yönetin ve raporları indirin

Important

Bu özellik şu anda önizlemededir. Beta veya önizleme aşamasında olan ya da başka bir şekilde henüz genel kullanıma sunulmamış olan Azure özelliklerinde geçerli olan yasal koşullar için bkz. Microsoft Azure Önizlemeleri için Ek Kullanım Koşulları.

Bu eğitim, Azure Data Manager for Energy'deki Seismic DDMS Analytics işleminin sismik verileriniz için yinelenen analiz zamanlamaları oluşturmak, oluşturulan raporları listelemek ve indirmek ve artık ihtiyacınız olmayan zamanlamaları silmek amacıyla nasıl kullanılacağını gösterir. Zamanlanmış analizler, alt projeler ve tenant’lar arasında depolama tüketimini ve veri erişim kalıplarını zaman içinde takip etmenize yardımcı olur; böylece özel bir raporlama işlem hattı oluşturmadan kapasite planlayabilir ve depolama maliyetlerini optimize edebilirsiniz. Bir arka plan işi, istenen istatistikleri düzenli aralıklarla hesaplar ve her raporu Azure Blob Depolama'a yazar. Rapor verisini doğrudan depodan indiriyorsunuz ve bu veriler hizmet üzerinden hiç akmıyor.

Bu eğitimde şunları öğreniyorsunuz:

  • Bir alt proje veya kiracı için bir analitik takvimi oluşturun
  • Analiz zamanlamalarını ve oluşturulan raporları listeleyin
  • Kısa ömürlü bir SAS URL'si içeren bir rapor indirin
  • Bir analitik takvimini sil

Prerequisites

Başlamadan önce aşağıdaki önkoşulları karşıladığınızdan emin olun:

  • Azure aboneliği.
  • Seismic DDMS'in yapılandırıldığı enerji için bir Azure Data Manager kaynağı.
  • Sismik DDMS hizmetine kayıtlı bir tenant ve bir subproject.
  • Kapsama bağlı olarak kullanıcı hesabınıza subproject.admin, datamanager veya tenant.admin rolü atanmıştır.
  • API kimlik doğrulaması için taşıyıcı belirteç. DefaultAzureCredential kullandığınızda, https://energy.azure.com/.default kapsamını talep edin. Bkz Kimlik doğrulama belirteci oluşturma nasıl yapılır.
  • Kiracınızın data-partition-id. Eksik bir değer 400 BAD_REQUEST döndürür.

Analitik kapsamlarını anlayın

Analiz işleri iki kapsamdan birinde çalışır. Bu kapsam, hangi veri setlerinin ölçüleceğini ve hangi rolün gerekeceğini belirler.

Scope Ölçüleri Onu nasıl hedeflediğiniz Gerekli rol
Alt Proje Bölümleme içindeki tek bir alt proje name istek gövdesinde (create) veya subprojectid URL yolunda subproject.admin, datamanager veya tenant.admin
Kiracı Tüm veri bölmesi Boş veya atlanmış name (create) ya da /tenant/... rotaları datamanager veya tenant.admin

Her program üç ayar kaydeder: hesaplanacak statistics, ilk çalışma için haftanın günü (first_execution) ve gün cinsinden ne sıklıkla tekrarlandığı (freq_execution). API, zamanlama işlemleri için /job uç noktalarını kullanır. Arka plan işi zamanlamaları okur ve <subproject>/YYYY/MM/DD/ yol düzenini kullanarak raporları sdms-analytics-reports konteynere yazar.

Bir analitik programı gönderin

Tek bir zamanlama nesnesi içeren bir JSON dizisi ile bir PUT istek gönderin. Kiracı genelinde bir zamanlama oluşturmak için name öğesini belirtmeyin (veya boş bir dize gönderin); zamanlamayı o alt projeyle sınırlamak için name alt projesini belirtin.

İstek gövdesi aşağıdaki alanları destekler:

Alan Required Type Description
name Hayır string Alt proje adı. Boş veya belirtilmediğinde, çizelge kiracı kapsamında oluşturulur ve varsayılan olarak data-partition-id olarak ayarlanır.
statistics Yes string Hesaplanacak istatistiklerin virgülle ayrılmış listesi. Boşluk depolamadan önce kaldırılır ve değer küçük harfe dönüştürülür.
first_execution Hayır tam sayı (1–7) İlk çalıştırma için haftanın günü. Varsayılan olarak geçerli güne ayarlanır. 1–7 aralığının dışındaki değerler 400 BAD_REQUEST döndürür.
freq_execution Hayır tamsayı (>0) Gün cinsinden çalıştırma sıklığı. Varsayılan değer 7’dır.

  1. İsteği gönderin. Bir alt proje takvimi için, alt projeyi name dahil edin:

    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
  }
]

    Kiracı genelinde bir zamanlama için, name öğesini atlayın:

    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. Yanıtta geri dönen normalize edilmiş programı gözden geçirin. subproject alanı, alt proje takvimi için type ve kiracı genelindeki takvim için partition durumundadır. first_execution alanı, bir sonraki planlanan çalışma için zaman damgası olarak geri döner:

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

Hizmet, seçilen kapsam için tekrarlayan analiz takvimini oluşturur. Sadece ihtiyacınız olan istatistikleri talep edin ve freq_execution raporları ne sıklıkla kullandığınıza göre ayarlayın.

Analitik zamanlamalarını alın

Görüntüleyebileceğiniz programları görmek için schedules endpoint'ini çağırın. datamanager veya tenant.admin rolüne sahip kullanıcılar tam listeyi alır. subproject.admin rolüne sahip olan bir kullanıcı, yalnızca yönetebileceği alt projelerin takvimlerini alır.

  1. İsteği gönderin.

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

  2. Geri gönderilen programları gözden geçirin.

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

Yanıt, atanan rolünüzün görebileceği analitik zamanlamaları içerir.

Oluşturulan raporları getirin

Raporlar, ilk zamanlanmış çalıştırma tamamlandıktan sonra erişilebilir hale gelir. Tek bir alt proje veya tüm kuruluş için raporları alın ve isteğe bağlı olarak sonuçları tarihe göre daraltın.

Aşağıdaki sorgu parametreleri rapor-listesi ve SAS URL isteklerini kontrol eder:

Parametre Required Type Description
filter-date Hayır string Sonuçları tarihe göre sınırlar. Şu olmalıdır: YYYY, YYYY-MM veya YYYY-MM-DD. Diğer tüm biçimler 400 BAD_REQUEST döndürür.
extension Hayır string Alternatif bir rapor konteyneri seçer.sdms-analytics-reports-<extension> Yalnızca küçük harflerden, rakamlardan ve tirelerden oluşmalıdır, ardışık tire olmamalıdır ve birleşik kap adı 63 karakteri geçmemelidir.

  1. Bir alt proje için raporları listelemek için alt proje rotasını çağırın:

    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}

    Tüm tenant için raporları listelemek için tenant rotasını çağırın:

    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. Yanıttaki rapor blob yolu listesini inceleyin:

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

Yanıt, seçilen kapsam ve tarih filtresiyle eşleşen rapor blob yollarını içerir. filter-date İhtiyaçlarınıza en belirli olanı kullanarak geri dönen yol sayısını azaltın.

SAS URL'si içeren bir rapor indirin

Rapor verisi hizmet üzerinden hiç akmaz. Bunun yerine, /connection-string uç noktasından kısa ömürlü bir SAS kimlik bilgisi talep edin, ardından geri dönen SAS URL'sini kullanarak rapor bloblarını doğrudan Azure Blob Depolama'dan okuyun. Sağladığınız filter-date değer depolama yoluna eklenir, yani daha spesifik bir tarih, kimlik bilgisini daha dar bir blob kümesiyle sınırlar. Ayrıca, önceki bölümde açıklanan extension parametreyi alternatif bir rapor konteynerini hedeflemek için kullanabilirsiniz.

  1. Bir alt proje raporu için SAS URL'si talep etmek için, alt proje yolunu çağırın:

    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}

    Kiracı raporu için bir SAS URL’si istemek üzere kiracı rotasını çağırın:

    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. Yanıtı gözden geçirin. access_token, SAS URL'sini içerir:

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

  3. Önceki bölümde seçtiğiniz rapor yolunu indirmek için Azure Depolama SDK veya REST API ile SAS URL'sini kullanın.

Geri dönen SAS URL, seçilen yol için rapor bloblarına geçici erişim sağlar ve bir saatten biraz kısa sürede süresi dolur. URL'yi bir sır olarak kabul edin: loglamayın veya sürekli tutmayın, süresi dolduktan sonra yeni bir URL talep edin.

Bir analitik takvimini sil

Hizmetin o kapsam için tekrar eden raporlar üretmesini istemediğinizde bir analiz zamanlamasını silin.

  1. Bir alt proje takvimini silmek için alt proje yolunu çağırın:

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

    Kiracı takvimini silmek için tenant route’unu çağırın:

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

  2. İsteğin 200 OK döndürdüğünü doğrulayın. Var olmayan bir programı silmek de başarılı olur, böylece işlemi tekrar denemek güvenli olur.

Analitik takvimi silinir ve hizmet artık bu kapsam için tekrar eden raporlar üretmez.

Kaynakları temizle

Bu eğitim yeni bir Azure kaynağı oluşturmaz. Gelecekte rapor oluşturulmasını durdurmak için, Bir analiz zamanlamasını silme bölümünde açıklandığı gibi analiz zamanlamasını silin.

İlgili içerik

  • Son güncelleştirme: