DataWorks:Shell düğümü

Düğüm geliştirme

1. DataWorks konsolu üzerinde oturum açın. Hedef bölgeye geçtikten sonra sol gezinme bölmesinden Data Development and O&M > Data Development seçeneğine tıklayın. Açılan listeden hedef çalışma alanını seçin ve ardından Go to DataStudio seçeneğine tıklayın.

2. simgesinin üzerine gelin ve Create Node > General > Shell seçeneklerini tıklayın. Create Node iletişim kutusunda düğüm adını ve yolunu girin.

3. Betik düzenleyiciye standart kabuk kodunu girin (etkileşimli söz dizimi desteklenmez):

   echo "Hello DataWorks!"

4. Kodu tamamladıktan sonra simgesine tıklayın, hedef kaynak grubunu ve görüntüyü seçin ve shell düğümü görevini çalıştırın.

5. Betik hata ayıklamadan başarıyla geçtiğinde, sağ taraftaki Scheduling Settings seçeneğine tıklayarak zamanlama saati ve kaynak özellikleri gibi üretim düzeyi zamanlama ilkelerini yapılandırın. Bu sayede düğüm planlandığı şekilde periyodik olarak çalışır. Düğüm zamanlama özelliklerini yapılandırma hakkında daha fazla bilgi için bkz. Zamanlama ayarlarını yapılandırma.

Düğümleri dağıtma ve yönetme

1. Zamanlama özelliklerini yapılandırdıktan sonra düğümü geliştirme ortamına gönderebilir ve ardından periyodik zamanlama için dağıtabilirsiniz.

2. Düğüm dağıtıldıktan sonra görev, yapılandırdığınız zamanlamaya göre periyodik olarak çalışır. Sol üst köşedeki simgesine tıklayın ve ardından görünen gezinme sayfasında All Products > Data Development and O&M > Operation Center seçeneğini belirleyerek Operation Center'a gidin. Ardından sol menüden Task O&M > Auto Triggered Task O&M > Periodic tasks yolunu izleyerek dağıtılan zamanlanmış görevleri görüntüleyin. Daha fazla bilgi için bkz. Zamanlanmış görevleri yönetme.

Kaynaklara başvurma

1. DataWorks, shell düğümlerinde kullanılmak üzere kaynak yönetim aracılığıyla kaynakların DataWorks'e yüklenmesine olanak tanır. Daha fazla bilgi için bkz. Kaynakları yönetme.

   Not

   Bir kaynağa bir düğüm tarafından başvurulabilmesi için önce kaynağın gönderilmesi gerekir. Kaynak bir üretim görevi tarafından gerekiyorsa kaynağı üretim ortamına da dağıtmanız gerekir. Daha fazla bilgi için bkz. Düğümleri dağıtma.

2. Data Studio'nun sol dizin ağacında yüklenen kaynağı bulun.

3. Kaynağa sağ tıklayın ve Insert Resource Path seçeneğini belirleyin. Böylece kaynak geçerli düğüme başvurulur. Kaynağı çalıştırmak için düğüm düzenleme sayfasında kod yazabilirsiniz.

   Not

   Başvuru başarılı olduğunda sistem, betiğin en üstüne ##@resource_reference{resource_name} biçiminde bir bildirim yorumu otomatik olarak ekler.

   Bu yorum, DataWorks'ün kaynak bağımlılıklarını tanıması ve ilgili kaynağı çalışma zamanında yürütme ortamına otomatik olarak bağlaması için gerekli bir tanımlayıcıdır. Bu yorumu manuel olarak değiştirmeyin veya silmeyin.

Zamanlama parametrelerini kullanma

Zamanlama parametreleri, shell düğümlerine konumsal parametreler olarak enjekte edilir. Özel değişken adları desteklenmez. DataWorks, bir düğümün Scheduling Settings bölümünde yapılandırdığınız zamanlama parametresi değerlerini kabuk betiğine sırasıyla $1, $2, $3 gibi konumsal parametreler olarak iletir. 9'dan fazla parametre kullanıldığında doğru ayrıştırma sağlamak için ${10} ve ${11} gibi süslü parantez sözdizimini kullanın. Birden fazla parametre değeri boşluk karakteriyle ayrılmalı ve sıra, betikteki konumsal başvurularla kesinlikle eşleşmelidir.

Bu örnekte:

• Yerleşik parametre $1, iş tarihine atanır: $bizdate.

• Özel parametre $2, iş tarihine atanır: ${yyyymmdd}.

• Özel parametre $3, iş tarihine atanır: $[yyyymmdd].

• Bir parametre değeri boşluk içeriyorsa değeri tırnak işaretleri içine alın. Tırnak işaretleri arasındaki tüm içerik tek bir parametre olarak kabul edilir.

• Zamanlama parametrelerini yapılandırma ve kullanma hakkında daha fazla bilgi için bkz. Zamanlama parametrelerini yapılandırma.

ossutil kullanarak OSS'e erişme

DataWorks shell düğümü, Alibaba Cloud OSS komut satırı aracı ossutil öğesini yerel olarak destekler. Bu araç paket yönetimi, dosya yükleme ve indirme, toplu işlemler ve diğer görevlere olanak tanır. ossutil kullanarak OSS'e erişmek için erişim kimlik bilgilerini bir yapılandırma dosyası veya komut satırı parametreleri aracılığıyla yapılandırabilirsiniz.

• Komut satırı parametreleri kullanarak ossutil ile OSS'e erişmek için bkz. Komut satırı parametreleri kullanarak OSS'e erişme.

• Bir yapılandırma dosyası kullanarak ossutil ile OSS'e erişmek için bkz. Yapılandırma dosyası kullanarak OSS'e erişme.

Ek: Betik çıkış kodları

Bir betiğin başarıyla çalışıp çalışmadığını daha kesin bir şekilde belirlemek için betik çıkış kodlarını kullanabilirsiniz.

• Çıkış kodu 0: Başarıyı gösterir.

• Çıkış kodu -1: Sürecin sonlandırıldığını gösterir.

• Çıkış kodu 2: Platformun görevi otomatik olarak bir kez yeniden çalıştırması gerektiğini gösterir.

• Diğer çıkış kodları: Başarısızlığı gösterir.

Aşağıda, shell düğümünün başarıyla çalıştığı durumdaki (çıkış kodu 0) örnek bir çalışma zamanı günlüğü verilmiştir.

INFO Exit code of the Shell command 0 INFO --- Invocation of Shell command completed --- INFO Shell run successfully!

Altta yatan kabuk mekanizması nedeniyle, bir shell düğümündeki tüm betiğin çıkış kodu, son yürütülen komutun çıkış koduna eşittir.