Başarısız U-SQL işleri için Kullanıcı tanımlı C# kodunda hata ayıklama

U-SQL, C# kullanarak bir genişletilebilirlik modeli sağlar. U-SQL betiklerine C# işlevlerini çağırmak ve SQL benzeri bildirime dayalı dilin desteklemediği analitik işlevler gerçekleştirmek kolaydır. U-SQL genişletilebilirliği hakkında daha fazla bilgi edinmek için, bkz. u-SQL programlama kılavuzu.

Uygulamada, herhangi bir kod hata ayıklama gerektirebilir, ancak bulut üzerinde sınırlı günlük dosyaları olan özel kodla dağıtılmış bir işin hata ayıklaması zor olabilir. Visual Studio için Azure Data Lake araçları , özel kodunuzda oluşan hatalarda daha kolay hata ayıklamanıza yardımcı olan başarısız köşe hata ayıklaması adlı bir özellik sağlar. U-SQL işi başarısız olduğunda, hizmet hata durumunu korur ve araç, hata ayıklama için bulut hatası ortamını yerel makineye indirmenize yardımcı olur. Yerel indirme, tüm giriş verileri ve Kullanıcı kodları dahil olmak üzere tüm bulut ortamını yakalar.

Aşağıdaki videoda Visual Studio için Azure Data Lake Araçları 'de başarısız köşe hata ayıklaması gösterilmektedir.

Önemli

Visual Studio, bu özelliği kullanmak için şu iki güncelleştirmeyi gerektirir: Microsoft Visual C++ 2015 yeniden dağıtılabilir güncelleştirme 3 ve Windows Için evrensel C çalışma zamanı.

Başarısız köşeyi yerel makineye indir

Visual Studio için Azure Data Lake Araçları içinde başarısız bir işi açtığınızda, hata sekmesinde ayrıntılı hata iletileriyle birlikte sarı bir uyarı çubuğu görürsünüz.

  1. Tüm gerekli kaynakları ve giriş akışlarını indirmek için İndir ' e tıklayın. İndirme tamamlanmazsa, yeniden dene' ye tıklayın.

  2. Yükleme tamamlandıktan sonra, yerel bir hata ayıklama ortamı oluşturmak için Aç ' a tıklayın. Yeni bir hata ayıklama çözümü açılacak ve Visual Studio 'da açık bir çözümünüz varsa, lütfen hata ayıklamadan önce kaydettiğinizden ve kapandığınızdan emin olun.

Azure Data Lake Analytics U-SQL hata ayıklama Visual Studio indirme köşesi

Hata ayıklama ortamını yapılandırma

Not

Hata ayıklamadan önce, özel durum ayarları penceresinde ortak dil çalışma zamanı özel durumlarını denetlediğinizden emin olun (Ctrl + Alt + E).

Azure Data Lake Analytics U-SQL hata ayıklama Visual Studio ayarı

Yeni başlatılan Visual Studio örneğinde, Kullanıcı tanımlı C# kaynak kodunu veya bulmayabilir:

  1. Çözüm içinde kaynak kodumu bulabiliyorum

  2. Çözümde Kaynak kodumu bulamıyorum

Kaynak kodu hata ayıklama çözümüne dahildir

C# kaynak kodunun yakalandığı iki durum vardır:

  1. Kullanıcı kodu, arka plan kod dosyasında tanımlanır (genellikle Script.usql.cs bir U-SQL projesinde adlandırılır).

  2. Kullanıcı kodu, U-SQL uygulaması için C# sınıf kitaplığı projesinde tanımlanır ve hata ayıklama bilgileri ile derleme olarak kaydedilir.

Kaynak kodu çözüme içeri aktarıldıysa, sorunu gidermek için Visual Studio hata ayıklama araçları 'nı (izleme, değişkenler vb.) kullanabilirsiniz:

  1. Hata ayıklamaya başlamak için F5'e basın. Kod bir özel durum tarafından durduruluncaya kadar çalışır.

  2. Kaynak kodu dosyasını açın ve kesme noktalarını ayarlayın ve ardından adım adım hata ayıklama için F5 tuşuna basın.

    Azure Data Lake Analytics U-SQL hata ayıklama özel durumu

Kaynak kodu hata ayıklama çözümüne dahil değildir

Kullanıcı kodu, arka plan kod dosyasına dahil edilmediyseniz veya derlemeyi hata ayıklama bilgileri ile kaydetmediyseniz, kaynak kodu hata ayıklama çözümüne otomatik olarak dahil edilmez. Bu durumda, kaynak kodunuzu eklemek için ek adımlara ihtiyacınız vardır:

  1. ' VertexDebug ' öğesine sağ tıklayın > mevcut projeyi > ekleyin... derleme kaynak kodunu bulun ve projeyi hata ayıklama çözümüne ekleyin.

    Azure Data Lake Analytics U-SQL hata ayıklama proje ekleme

  2. Failedvertexdebughost projesi için proje klasörü yolunu alın.

  3. Eklenen derleme kaynak kodu projesi > özellikleri Right-Click, sol taraftaki derleme sekmesini seçin ve sonra da \bin\Debug Ile biten kopyalanmış yolu Çıkış > çıkış yolu olarak yapıştırın. Son çıkış yolu gibidir <DataLakeTemp path>\fd91dd21-776e-4729-a78b-81ad85a4fba6\loiu0t1y.mfo\FailedVertexDebug\FailedVertexDebugHost\bin\Debug\ .

    Azure Data Lake Analytics U-SQL hata ayıklama pdb yolunu ayarla

Bu ayarlardan sonra, F5 ve kesme noktalarıyla hata ayıklamaya başlayın. Sorunu gidermek için Visual Studio hata ayıklama araçları 'nı (izleme, değişkenler vb.) de kullanabilirsiniz.

Not

Güncelleştirilmiş. pdb dosyalarını oluşturmak için kodu değiştirdikten sonra derleme kaynak kodu projesini yeniden derleyin.

İşi yeniden gönderin

Hata ayıkladıktan sonra, proje başarıyla tamamlanırsa çıkış penceresinde aşağıdaki ileti görüntülenir:

The Program 'LocalVertexHost.exe' has exited with code 0 (0x0).

Azure Data Lake Analytics U-SQL hata ayıklama başarılı

Başarısız işi yeniden göndermek için:

  1. Arka plan kod çözümleri olan işler için C# kodunu arka plan kod kaynak dosyasına (genellikle Script.usql.cs ) kopyalayın.

  2. Derlemeleri olan işler için, hata ayıklama çözümünde derleme kaynak kodu projesine sağ tıklayın ve güncelleştirilmiş. dll derlemelerini Azure Data Lake kataloğunuza kaydedin.

  3. U-SQL işini yeniden gönderin.

Sonraki adımlar