Aracılığıyla paylaş

Microsoft Planet Computer Pro'da veri alımı sorunlarını giderme

Microsoft Planet Computer Pro GeoCatalog'daki veri alımı sorunları genellikle iki kategoriye ayrılır: erişim izni sorunları ve STAC (SpatioTemporal Varlık Kataloğu) doğrulama hataları. Bu makale, bu yaygın alım hatalarını belirlemenize ve çözmenize yardımcı olur.

Önkoşullar

Belirti -leri

Veri alımı iş akışları belirli hata kodlarıyla başarısız olur. İki ana sorun kategorisiyle karşılaşabilirsiniz:

  1. Erişim ve İzin Hataları: GeoCatalog hizmeti kaynak verileri okuyamadığından alma işlemi başarısız oluyor. , IngestionResourceForbiddenveya IngestionResourceUriNotFoundgibi IngestionAuthenticationFailedhata kodları görebilirsiniz.
  2. STAC Doğrulama Hataları: Sağlanan STAC meta verileri STAC standardına veya hizmete özgü kurallara uymadığından alma işlemi başarısız olur. , InvalidStacCatalogveya InvalidInputDatagibi StacValidationFailedhata kodları görebilirsiniz.

Alma Sırasında Hataları Tanımlama

Tek Öğe Alımı için, bir alma hatası oluşursa API yanıtı veya kullanıcı arabirimi hata kodunu döndürür.

Hata kodunun nerede bulunacağıyla ilgili vurgu içeren tek bir öğe alımı hatasının ekran görüntüsü.

Toplu Alma için hatalar tek tek STAC Öğelerinin her biri için farklı olabilir. Hataları tek tek görmek için Azure portalına gidin ve GeoCatalog kaynağınızın Tanılama Ayarları'nı bulun. Burada, Alım Günlüklerini etkinleştirebilirsiniz.

Azure portalında GeoCatalogs arama işleminin ekran görüntüsü.

Loglama etkinleştirildikten sonra alımınızı tekrar deneyin. Alma işlemi başarısız olursa, hataları gözden geçirmek için tanılama ayarlarında belirttiğiniz konuma gidin.

Neden 1: GeoCatalog kaynak verilere erişemiyor

GeoCatalog hizmetinde STAC meta verilerinizi (örneğin, ) ve ilişkili veri varlıklarını (örneğin, catalog.jsonGeoTIFF dosyaları) okumak için gerekli izinler yoktur. Bu hatanın nedeni, depolama konumu için geçerli bir alma kaynağının yapılandırılmamış olmasıdır. Alım kaynakları, farklı konumlarda yapılandırılmışsa hem meta veri dosyaları hem de varlık dosyaları için yapılandırılmalıdır.

Çözüm 1: Alma kaynağı izinlerini yapılandırma

  1. Alma kaynağının var olduğunu doğrulayın

    • GeoCatalog'unuzun Ayarlar sekmesine gidin
    • Depolama kapsayıcınız için bir veri alım kaynağının yapılandırılıp yapılandırılmadığını kontrol edin.
    • Aksi takdirde, bir alma kaynağı oluşturun

  2. Kimlik bilgilerini doğrulama

    Yönetilen kimlik için:

    • Yönetilen kimliğin Depolama Blob Veri Okuyucusu rolüne sahip olduğundan emin olun
    • Rol atamasının, doğru kapsamda (depolama hesabı veya kapsayıcı düzeyinde) olduğunu doğrulayın.
    • Yönetilen kimliğin GeoCatalog'unuzla ilişkili olup olmadığını denetleyin

    SAS belirteçleri için:

    • Belirtecin süresinin dolmadığını doğrulayın
    • Belirtecin read ve list izinlerine sahip olduğundan emin olun
    • Belirtecin doğru kapsayıcıya ait olduğundan emin olun

  3. Tüm gerekli konumlara erişimi denetleme

    GeoCatalog'un erişmesi gereken hiyerarşiyi gösteren BIR STAC Kataloğu diyagramı.

    Toplu Veri Alımı, catalog.json dosyasının depolandığı kapsayıcının ötesindeki depolama alanında bulunan varlıklara başvuran statik STAC kataloglarını destekler. Ancak her depolama kapsayıcısı, verileri alma izinlerini korumak için GeoCatalog için bir alma kaynağı gerektirir.

    GeoCatalog'un şu izinlere sahip olduğundan emin olun:

    • STAC katalog JSON dosyası
    • Tüm STAC öğesi JSON dosyaları
    • STAC öğelerinde başvuruda bulunan tüm varlık dosyaları

  4. Alma işlemini yeniden deneyin: Alma kaynağı yapılandırmasını doğruladıktan ve düzeltdikten sonra alımı yeniden deneyin.

Neden 2: STAC meta veri doğrulaması başarısız oldu

Veri alma hizmeti STAC belirtimini kesinlikle uygular. STAC Kataloğunuz, Koleksiyonunuz veya Öğe JSON'larınız standartla uyumlu değilse veya belirli GeoCatalog gereksinimlerini karşılamıyorsa alımınız başarısız olur.

Çözüm 2.1: Geçersiz STAC biçimini ve değerlerini düzeltme

  1. Yerel Olarak Doğrula: Alma işleminden önce, STAC nesnelerinizi doğrulamak için bir pystac kitaplık kullanın. Bu yaklaşım, verileri almadan önce birçok yaygın biçimlendirme sorununu yakalayabilir.

  2. Gerekli Alanları Denetle:

    • Meta verilerinizde tüm zorunlu STAC alanlarının mevcut olduğundan emin olun.
    • Tek öğe alımı için, STAC Öğe JSON'u, GeoCatalog'unuzdaki hedef koleksiyonun kimliğine ayarlanmış collection alanını içermelidir.

  3. Tarih Saat Biçimlendir: Tüm datetime alanların ISO 8601 standardına uygun olduğunu doğrulayın (örneğin, YYYY-MM-DDTHH:MM:SSZ). Kütüphane, pystac tarih ve saatleri doğru biçimlendirmek için araçlar sağlar.

  4. Geçersiz Karakter ve Uzunlukları Denetle:

    • STAC Item IDs ve Asset keys:
      • Yalnızca aşağıdaki karakterleri içermelidir:
        • Harfler: A-Z, a-z
        • Basamak: 0-9
        • Simgeler: -, _, +, ,, (, ), .
      • Diğer tüm karakterler geçersiz.
      • Item IDs 150 karakterden az olmalıdır.
      • Asset keys 256 karakterden az olmalıdır.
    • STAC Collection IDs:
      • Yalnızca aşağıdaki karakterleri içermelidir:
        • Harfler: A-Z, a-z
        • Basamaklar: 0-9
        • Simgeler: -, _, .
      • Diğer tüm karakterler geçersiz
      • Collection IDs 243 karakterden az olmalıdır.

  5. Alma işlemini yeniden deneyin: STAC meta verilerini düzeltdikten sonra alımı yeniden deneyin.

Çözüm 2.2: STAC uzantılarını basitleştirme

  1. Uzantıları Tanımlama: STAC Öğelerinizin herhangi bir STAC uzantısı kullanıp kullanmadiğini denetleyin. Güçlü olsalar da, doğrulamaya karmaşıklık eklerler ve birçoğu kesinleştirilmiş durumda değildir.
  2. Temel Olmayan Uzantıları Kaldır: Bir uzantının hataya StacValidationFailed neden olduğundan şüpheleniyorsanız, uzantıyı STAC Öğenizin stac_extensions listesinden ve ilişkili alanlardan kaldırmayı deneyin.
  3. Yeniden doğrulama ve Yeniden Deneme: Basitleştirilmiş STAC Öğesini yerel olarak doğrulayın ve alımı yeniden deneyin.

İlgili içerik

  • Last updated on