DataWorks:Düğümleri ve iş akışlarını hata ayıklama

Önkoşul

Bir düğüm geliştirmiş olmalısınız. Daha fazla bilgi için bkz. Data Studio.

Arka Plan

Tek bir düğümü hata ayıklama veya bir iş akışını hata ayıklama yapabilirsiniz. Bir çalıştırma tamamlandığında, sonuçları Çalıştırma geçmişi bölümünde görüntüleyebilir, verileri incelemek için bir geçici sorgu kullanabilir ve sorgu sonuçlarını işleyebilirsiniz.

• Tek bir düğümü veya bir iş akışını hata ayıklarken DataWorks zamanlama kaynakları için ücretlendirilmezsiniz; ancak kullanılan hesaplama motorları için ücretlendirilirsiniz. Hesaplama motoru ücretleri hakkında daha fazla bilgi için ilgili motorun faturalama belgelerine bakın.

• Sorgu hızlandırma kullanan sorguların maksimum çalışma süresi 1 saattir.

Tek bir düğümü hata ayıklama

1. Data Studio sayfasına gidin. Sol gezinme bölmesinde, Veri Geliştirme veya Manuel Tetiklenen İş Akışı altında hedef iş akışını bulun ve düzenlemek istediğiniz düğüme çift tıklayın.

2. Düğümü hata ayıklamak için çalıştırın.

   Kod mantığını hata ayıklamak için düğümün düzenleyici sekmesindeki araç çubuğundan Çalıştır veya Parametrelerle Çalıştır seçeneklerini kullanın. Ayrıca bir kod parçacığını hata ayıklamak için Hızlı çalıştır seçeneğini de kullanabilirsiniz. Aşağıdaki tabloda her bir seçenek açıklanmıştır.

   Not

   Bir düğümü çalıştırdığınızda sorgulamak istediğiniz veriler için izniniz yoksa, DataWorks'teki farklı hesaplama motorları için izin kontrolü hakkında bilgi edinmek üzere Hesaplama motorları ve veriler için izin yönetimine genel bakış konusuna bakın.

   Çalıştırma seçeneği	Açıklama	Kullanım durumu
   Çalıştır ( simgesi)	Bu seçenekle değişkenlere değer atayabilir ve test için bir kaynak grubu belirtebilirsiniz. Bu ayarlar sonraki çalıştırmalar için kaydedilir. Not Yeni oluşturulan bir düğümü ilk kez çalıştırdığınızda bir yapılandırma iletişim kutusu görünür. Kod içindeki değişkenlere sabit değerleri manuel olarak atamanız gerekir. DataWorks atadığınız değerleri kaydeder. Düğümü bir dahaki sefer çalıştırdığınızda, varsayılan olarak kaydedilen yapılandırma kullanılır.	Kodu sık sık hata ayıklamanız gerektiğinde bu seçeneği kullanın.
   Parametrelerle Çalıştır ( simgesi)	Düğümü her çalıştırdığınızda test senaryosu için değişkenlere sabit değerler atamanız ve bir kaynak grubu belirtmeniz gerekir.	Koddaki değişkenlere atanan değerleri değiştirmeniz veya görev tarafından kullanılan kaynak grubunu değiştirmeniz gerektiğinde bu seçeneği kullanın.
   Hızlı çalıştır ( simgesi)	Bu seçenekle düğümün düzenleyici sekmesindeki kod alanında bir kod parçacığını hata ayıklayabilirsiniz.	Yalnızca bir düğümdeki kod parçacığını hata ayıklamanız gerektiğinde bu seçeneği kullanın. Not Bu özellik yalnızca bir kod parçacığının doğruluğunu hata ayıklamak için kullanılır. Tam kod mantığını hata ayıklamak için Çalıştır veya Parametrelerle Çalıştır seçeneklerini kullanın.

Bir iş akışını hata ayıklama

1. Data Studio sayfasına gidin. Sol gezinme bölmesinde, Veri Geliştirme veya Manuel Tetiklenen İş Akışı altında hedef iş akışına çift tıklayarak panelini açın.

2. İş akışını hata ayıklayın.

   İş akışı paneli araç çubuğundaki Çalıştır ( simgesi) düğmesine tıklayarak iş akışındaki tüm görevleri bağımlılıklarına göre sırayla çalıştırın.

   Alternatif olarak, iş akışı panelindeki bir düğüme sağ tıklayıp Run Node and Downstream Nodes seçeneğini belirleyerek düğümü ve tüm aşağı akış düğümlerini bağımlılıklarına göre çalıştırabilirsiniz.

   Araç çubuğu üzerinden çalıştırma ile sağ tıklama ile Düğümü ve Aşağı Akış Düğümlerini Çalıştırma seçenekleri farklı şekilde çalışır:

   • Araç çubuğu çalıştırması: İş akışının tam DAG'ine (Yönlendirilmiş Döngüsüz Grafik) göre yukarı akıştan aşağı akışa doğru tüm düğümleri sırayla çalıştırır. Her düğüm bağımsız olarak çalıştırılmak üzere gönderilir; bu, her düğümü düzenleyici sekmesinden tek tek çalıştırmaya eşdeğerdir.

   • Sağ tıklama ile Düğümü ve Aşağı Akış Düğümlerini Çalıştır: Seçilen düğümden başlayarak düğümü ve aşağı akış düğümlerini bağımlılık zamanlama mantığı uygulanarak çalıştırır. Bu seçenek, yukarı akış düğümlerinin çalıştırma durumunu ve çıktısını doğrular; bu durum, bir düğümü doğrudan düzenleyici sekmesinden çalıştırmaktan (bağımsız hata ayıklama modu) farklıdır.

   Düğümü ve Aşağı Akış Düğümlerini Çalıştır seçeneğini kullandığınızda bir hata oluşur ancak aynı SQL kodu düğümün düzenleyici sekmesinden başarıyla çalışıyorsa, bunun nedeni sağ tıklama ile çalıştırmanın yukarı akış düğümlerinin çalıştırma durumunu ve çıktı verilerini doğrulamak için bağımlılık zamanlama mantığını uygulaması, doğrudan çalıştırmanın ise yalnızca geçerli düğümün SQL kodunu yürütmesidir. Sorunu aşağıdaki gibi giderebilirsiniz:

   • Yukarı akış düğümlerinin çalıştırma durumunu kontrol edin. Sağ tıklama ile çalıştırma, yukarı akış bağımlılıklarını doğrular. Yukarı akış düğümü çalıştırılmamışsa veya başarısız olmuşsa, geçerli düğüm hata verir. Tüm yukarı akış düğümlerinin başarıyla çalıştığını onaylamak için iş akışı panelindeki yukarı akış düğümlerinin çalıştırma durumu simgelerini görüntüleyin.

   • Düğümler arasındaki bağımlılık yapılandırmalarını kontrol edin. Düğümler arasında giriş ve çıkış parametrelerinin doğru şekilde iletildiğini ve zamanlama parametresi atamalarının beklentilerinizle eşleştiğini doğrulayın. Düğümün zamanlama ayarları sayfasında, yukarı akış çıkış tablolarının geçerli düğümün giriş tablolarıyla eşleşip eşleşmediğini kontrol edin.

   • Hata veren düğüme sağ tıklayın, çalışma zamanı günlüklerini görüntüleme seçeneğini belirleyin ve belirli hata mesajını bulun. Günlüklerdeki hata genellikle tablonun mevcut olmaması, yetersiz izinler veya sözdizimi hataları gibi belirli bir nedeni içerir.

   • SQL kodundaki yorum sözdizimi sorunlarını kontrol edin. Bazı motorlar, zamanlama modunda doğrudan yürütmeye kıyasla yorumları farklı şekilde ayrıştırır; bu durum sözdizimi hatalarına neden olabilir. Sorunu gidermek için, yalnızca satır içi yorumları (--) tutarken SQL kodundan blok yorumları (/* */) kaldırmayı deneyin ve hatanın devam edip etmediğini kontrol edin.

   • Yukarı akış düğümlerinin çıktı verilerinin hazır olup olmadığını kontrol edin. Sağ tıklama ile çalıştırma, giriş olarak yukarı akış düğümleri tarafından üretilen veri tablolarına dayanır. Yukarı akış düğümü başarıyla çalışmış olsa bile çıktı verileri henüz hazır değilse veya temizlenmişse, geçerli düğüm giriş tablosunu okuyamadığı için hata verir.

   Not

   • Manuel tetiklenen bir iş akışındaki düğümlerin aynı ada sahip değişkenleri varsa ve bu değişkenlere toplu olarak değer atanabiliyorsa, iş akışı panelinde iş akışı parametreleri tanımlayabilir ve parametrelere değer atayabilirsiniz. Ardından, iş akışını çalıştırarak atama sonuçlarını ve manuel görevlerin çalıştırma durumunu görüntüleyin.

   • Yalnızca bazı düğüm türleri iş akışı parametrelerini destekler. Ayrıntılar için gerçek arayüze bakın.

   • Çalıştırma tamamlandıktan sonra, iş akışı panelindeki bir düğüme sağ tıklayarak o düğümün çalışma zamanı günlüklerini görüntüleyebilirsiniz.

Çalıştırma geçmişini görüntüleme

Data Studio'daki Çalıştırma geçmişi sayfasında, son üç gün içinde geçerli hesap tarafından çalıştırılan tüm görevleri görüntüleyebilirsiniz.

Data Studio'da bir görev çalıştırıldıktan sonra, yürütülmesi için ilgili motora gönderilir. Yürütme sırasında görevi yanlışlıkla kapatırsanız bile görev çalışmaya devam eder. Çalıştırma geçmişi sayfasını kullanarak çalışma zamanı günlüklerini görüntüleyebilir veya gönderilen görevleri durdurabilirsiniz.

Geçici sorgu dosyası oluşturma

Sorgu sonuçlarını işleme