Veri kümelerini dönüştürmek için kurallar oluşturma

Replikasyon, Landing, Depolama, Dönüştürme, ve Data mart veri görevlerindeki veri kümelerinde genel dönüştürme gerçekleştirmek için yeniden kullanılabilir dönüştürme kuralları oluşturabilirsiniz.

Yeni bir dönüştürme kuralı oluşturmak için Veri Kümeleri seçeneğini belirleyin, Dönüştürme kuralları öğesine ve ardından Dönüştürme kuralı ekle seçeneğine tıklayın.

1. Dönüştürme türünü seçin ve İleri seçeneğine tıklayın.

   Aşağıdaki dönüştürmeleri gerçekleştirebilirsiniz:

   • Veri kümelerini yeniden adlandırma

   • Veri mesajı yayınlamayı geçersiz kılma

     Bilgi notu

     • Yalnızca Kafka hedefi için kullanılabilir.

     • Data Movement gateway kullanıyorsanız (şirket içi Kafka için gereklidir), 2025.5.40 veya üzeri bir sürüm gereklidir.

   • Sütunları yeniden adlandırma

   • Sütun ekleme

   • Sütunları bırakma

   • Veri türlerini dönüştürme

   • Sütun değerlerini değiştirme

2. Dönüştürme kapsamını seçin ve İleri seçeneğine tıklayın.

3. Hangi dönüştürme eyleminin gerçekleştirileceğini seçin ve İleri seçeneğine tıklayın.

4. Kural için bir ad ve açıklama ekleyin ve Son seçeneğine tıklayın.

Kural, veri görevini çalıştırdığınızda uygulanacaktır. Birden fazla kural eklerseniz kurallar listelendikleri sırayla yürütülür.

Dönüştürme kapsamı

Aynı veri kümesine veya sütunlara birkaç dönüştürme uygulandığında kapsam her zaman orijinal kaynak adlarındadır; eylem ise önceki kural uygulandıktan sonraki değerle ilgilidir. Örneğin, şu kurallara sahipseniz:

1. Ön eki ABC_ olarak değiştirmek için Abc_ (Abc_%) ile başlayan tüm veri kümelerini yeniden adlandırın.

2. ABC_ (ABC_%) ile başlayan veri kümelerine _zzz son ekini ekleyin.

Kuralların bu veri kümelerine uygulanması şu sonuçları sağlayacaktır. İkinci kuraldan sonra, kapsam her zaman orijinal adda (Abc_customers) olduğundan _zzz son ekinin ABC_customers öğesine eklenmediğine dikkat edin.

Veri kümelerini yeniden adlandırma

1. Veri kümesini yeniden adlandır seçeneğini belirleyin ve ardından İleri seçeneğine tıklayın.

2. Dönüştürme kapsamını, yani hangi veri kümelerinin yeniden adlandırılacağını ayarlayın. Bir veya daha fazla veri varlığından birkaç veri kümesi seçmek için joker karakter olarak % kullanabilirsiniz.

   Click İleri.

3. Dönüştürme eylemini ayarlayın. Aşağıdaki eylemleri gerçekleştirebilirsiniz:

   • Veri kümesini sabit bir adla yeniden adlandırın.

   • Ön ek veya son ek ekleyin.

   • Ön eki veya son eki kaldırın.

   • Ön eki veya son eki değiştirin.

   • Büyük/küçük harf durumunu küçük harf veya büyük harf olarak değiştirin.

   • Bir ifade kullanarak veri kümesi adlarını değiştirin.

   • Sözlük kullanarak veri kümesi adlarını değiştirin.

     Daha fazla bilgi için bkz. Sözlük kullanarak veri kümelerini veya sütunları yeniden adlandırma.

   Hazır olduğunuzda İleri seçeneğine tıklayın.

4. Kuralın adını ayarlayın ve Son seçeneğine tıklayın.

Veri mesajı yayınlamayı özelleştirme

1. Veri mesajı yayınlamayı özelleştir seçeneğini belirleyin ve ardından İleri seçeneğine tıklayın.

2. Dönüştürme kapsamını, yani hangi veri kümeleri için veri mesajı yayınlama ayarlarının geçersiz kılınacağını ayarlayın. Bir veya daha fazla veri varlığından birkaç veri kümesi seçmek için joker karakter olarak % kullanabilirsiniz.

   Click İleri.

3. Dönüştürme eylemini ayarlayın.

   Her ayar için, geçerli görev ayarı Görev ayarı: <ayar> alanı ile belirtilir (örneğin, Görev ayarı: Belirli konu).

   Bu ayarların açıklaması için bkz. Veri mesajı yayınlama.

   Görev ayarını koruyabilir veya özel bir konu, ileti anahtarı ya da bölüm anahtarı belirtmek için İfade Oluşturucu'yu kullanabilirsiniz.

   Bilgi notuBu ayarlar görev ayarlarını geçersiz kılacak ancak bağımsız veri kümeleri için yapılandırılan ayarları geçersiz kılmayacaktır.

   İfade Oluşturucu'yu kullanmak için:

   1. Uygun şekilde Özel konu, Özel ileti anahtarı veya Özel bölüm anahtarı alanını seçin ve öğesine tıklayın.

      Bilgi notuÖzel konular zaten mevcut olmalıdır veya aracı, bunları oluşturacak şekilde yapılandırılmalıdır.

      İfade Oluşturucu açılır.

   2. Bir ifade oluşturun.

      İfadeyi oluşturmak için fonksiyonları, işleçleri ve meta verileri kullanabilirsiniz.

      Bir öğeyi ifadeye taşımak için üzerine tıklayın.

      İfadede ayrıca Kafka tarafından desteklenen tüm fonksiyonları kullanabilirsiniz.

   3. Parametreleri ayıkla'ya tıklayın.

      Artık tüm parametreler için Test edilecek değer'e bir test değeri ekleyebilirsiniz.

   4. İfadeyi test et'e tıklayın.

      Şimdi test değerlerini kullanan ifadenin sonucunu görebilirsiniz.

   5. Hazır olduğunuzda Tamam'a tıklayın.

      İfade alana eklenir.

   İfade oluşturma

   Özel değerleri tanımlayan bir ifade oluşturmanız gerekir. Kullanabilecekleriniz:

   • Fonksiyonlar

     Dize fonksiyonları, sayısal fonksiyonlar, null değer denetleme fonksiyonları, tarih ve saat fonksiyonları ve mantıksal fonksiyonlar.

   • İşleçler

     Matematiksel ve mantıksal işleçler. Ayrıca ifadenin üzerindeki araç çubuğundaki işleçler de kullanılabilir. || olan dize birleştirme işlecini de burada bulabilirsiniz.

   • Meta veriler

     Aşağıdaki meta veriler mevcuttur:

     • $Q_M_ŞEMA_ADI
     • $Q_M_SOURCE_SCHEMA_NAME
     • $Q_M_SOURCE_TABLE_NAME
     • $Q_M_TABLE_NAME

   Bir öğeyi ifadeye taşımak için üzerine tıklayın.

   İfadede Kafka tarafından desteklenen tüm fonksiyonları da kullanabilirsiniz.

   Hazır olduğunuzda İleri seçeneğine tıklayın.

4. Kuralın adını ayarlayın ve Son seçeneğine tıklayın.

Sütunları yeniden adlandırma

1. Sütunu yeniden adlandır seçeneğini belirleyin ve ardından İleri seçeneğine tıklayın.

2. Dönüştürme kapsamını, yani hangi sütunların yeniden adlandırılacağını ayarlayın. Bir veya daha fazla veri görevi ve veri kümesinden birkaç sütun seçmek için joker karakter olarak % kullanabilirsiniz.

   Eylemi belirli bir veri türüyle de sınırlayabilirsiniz. Veri türünden bağımsız olarak tüm eşleşen sütunlar için eylemi gerçekleştirmek üzere veri türünü UNSPECIFIED olarak ayarlayın.
   

   Click İleri.

   Kapsamı anahtar veya boş bırakılabilir (nullable) olan sütunlarla da sınırlayabilirsiniz.

3. Dönüştürme eylemini ayarlayın. Aşağıdaki eylemleri gerçekleştirebilirsiniz:

   • Sütunu sabit bir adla yeniden adlandırın.

   • Ön ek veya son ek ekleyin.

   • Ön eki veya son eki kaldırın.

   • Ön eki veya son eki değiştirin.

   • Sütun büyük/küçük harf durumunu küçük harf veya büyük harf olarak değiştirin.

   • Bir ifade kullanarak sütun adlarını değiştirin.

   • Sözlük kullanarak sütun adlarını değiştirin.

     Daha fazla bilgi için bkz. Sözlük kullanarak veri kümelerini veya sütunları yeniden adlandırma.

   Hazır olduğunuzda İleri seçeneğine tıklayın.

4. Kuralın adını ayarlayın ve Son seçeneğine tıklayın.

Sütun ekleme

1. Sütun ekle seçeneğini belirleyin ve ardından İleri seçeneğine tıklayın.

2. Dönüştürme kapsamını, yani sütunun hangi veri kümesine ekleneceğini ayarlayın. Sütunu bir veya daha fazla veri kümesine eklemek için joker karakter olarak % kullanabilirsiniz.
   

   Click İleri.

3. Yeni sütunun ayrıntılarını ayarlayın:

   • Sütun adı.

   • Sütun için Değer ayarlamak üzere ifade oluşturucuyu kullanın.

   • Bu sütunu bir birincil anahtar olarak kullanmak için Birincil anahtara ekle seçeneğini belirleyin.

   • Veri türünü Hedef veri türü alanında ayarlayın.

   • Veri türü BYTES, STRING veya WSTRING ise bir Uzunluk da belirtin.

     Veri türü NUMERIC ise Kesinlik ve Ölçek değerlerini de belirtin.

   Hazır olduğunuzda İleri seçeneğine tıklayın.

4. Kuralın adını ayarlayın ve Son seçeneğine tıklayın.

Sütunları bırakma

1. Sütunu bırak seçeneğini belirleyin ve ardından İleri seçeneğine tıklayın.

2. Dönüştürme kapsamını, yani hangi sütunların bırakılacağını ayarlayın. Bir veya daha fazla veri varlığı ve veri kümesinden birkaç sütun seçmek için joker karakter olarak % kullanabilirsiniz.

   Eylemi belirli bir veri türüyle de sınırlayabilirsiniz. Veri türünden bağımsız olarak tüm eşleşen sütunlar için eylemi gerçekleştirmek üzere veri türünü UNSPECIFIED olarak ayarlayın.
   

   Click İleri.

   Kapsamı anahtar veya boş bırakılabilir (nullable) olan sütunlarla da sınırlayabilirsiniz.

3. Kuralın adını ayarlayın ve Son seçeneğine tıklayın.

Veri türlerini dönüştürme

1. Veri türünü dönüştür seçeneğini belirleyin ve ardından İleri seçeneğine tıklayın.

2. Dönüştürme kapsamını, yani hangi sütunların veri türünün dönüştürüleceğini ayarlayın. Bir veya daha fazla veri varlığı ve veri kümesinden birkaç sütun seçmek için joker karakter olarak % kullanabilirsiniz.

   Eylemi belirli bir veri türüyle de sınırlayabilirsiniz. Veri türünden bağımsız olarak tüm eşleşen sütunlar için eylemi gerçekleştirmek üzere veri türünü UNSPECIFIED olarak ayarlayın.
   

   Click İleri.

   Kapsamı anahtar veya boş bırakılabilir (nullable) olan sütunlarla da sınırlayabilirsiniz.

3. Dönüştürme eylemini ayarlayın.

   • Hedef veri türü alanını dönüştürülecek veri türüne ayarlayın.

   • Veri türü BYTES, STRING veya WSTRING ise bir Uzunluk da belirtin.

     Veri türü NUMERIC ise Kesinlik ve Ölçek değerlerini de belirtin.

   Hazır olduğunuzda İleri seçeneğine tıklayın.

4. Kuralın adını ayarlayın ve Son seçeneğine tıklayın.

Ayrıca bkz.: Veri türlerini yönetme

Sütun değerlerini değiştirme

1. Sütun değerlerini değiştir seçeneğini belirleyin ve ardından İleri seçeneğine tıklayın.

2. Dönüştürme kapsamını, yani hangi sütunların değerlerinin değiştirileceğini ayarlayın. Bir veya daha fazla veri varlığı ve veri kümesinden birkaç sütun seçmek için joker karakter olarak % kullanabilirsiniz.

   Eylemi belirli bir veri türüyle de sınırlayabilirsiniz. Veri türünden bağımsız olarak tüm eşleşen sütunlar için eylemi gerçekleştirmek üzere veri türünü UNSPECIFIED olarak ayarlayın.
   

   Click İleri.

   Kapsamı anahtar veya boş bırakılabilir (nullable) olan sütunlarla da sınırlayabilirsiniz.

3. Dönüştürme eylemini ayarlayın.

   • Hedef değer alanında değiştirilecek değerleri tanımlamak için bir ifade ayarlayın.

   • Değiştirilen sütunların veri türü için Hedef veri türü alanını ayarlayın.

   • Veri türü BYTES, STRING veya WSTRING ise bir Uzunluk da belirtin.

     Veri türü NUMERIC ise Kesinlik ve Ölçek değerlerini de belirtin.

   Hazır olduğunuzda İleri seçeneğine tıklayın.

4. Kuralın adını ayarlayın ve Son seçeneğine tıklayın.

Sözlük kullanarak veri kümelerini veya sütunları yeniden adlandırma

Veri kümelerini veya sütunları yeniden adlandırma amacıyla bir sözlük kullanabilirsiniz. Bu, gizemli adlandırma kuralları kullanan çok sayıda nesneyle çalışırken kullanışlıdır. Bir sözlük düzenleyicisine çeviriler ekleyebilir veya çevirileri içeren bir CSV dosyasını içe aktarabilirsiniz. Sözlüğü bir CSV dosyasına dışa aktarabilir ve başka bir veri varlığında yeniden kullanabilirsiniz.

Sözlüğe göre yeniden adlandır seçeneği, Veri kümelerini yeniden adlandır veya Sütunları yeniden adlandır seçeneğini belirlediğinizde Dönüştürme eylemleri bölümünde kullanılabilir. Sözlük düzenleyicisini açmak için simgesine tıklayın.

• Sözlüğe bir çeviri eklemek için Çeviri ekle seçeneğine tıklayın ve Kaynak adı ile Çevrilen ad alanlarını doldurun.

İhtiyacınız olan çevirileri oluşturduktan sonra sözlük düzenleyicisini kapatmak için Tamam seçeneğine tıklayın.

Çevirileri içe aktarma

Bir sözlük içeren CSV dosyasından çevirileri içe aktarabilirsiniz. Dosya, satır başına bir çeviri içermelidir. Örnek:

• CSV'den ekle seçeneğine tıklayın ve içe aktarılacak CSV dosyasını seçin.

İçe aktarılan sözlükteki çeviriler sözlüğünüze eklenir.

Çevirileri dışa aktarma

Diğer veri varlıklarında yeniden kullanabilmek için sözlüğünüzü bir CSV dosyasına dışa aktarabilirsiniz.

• Click CSV'ye dışa aktar.

Sözlük bir CSV dosyasına dışa aktarılır.

Bir ifadeye meta verileri dahil etme

İfade düzenleyicisindeki Meta Veriler sekmesi, bir dönüştürme kuralındaki ifadede kullanabileceğiniz aşağıdaki değişkenleri içerir.

Aşağıdaki ifadeyle şema adını ön ek olarak eklemek için dönüştürme kapsamındaki tüm tabloları yeniden adlandırabilirsiniz:

${Q_M_SCHEMA_NAME}||'.'||${Q_M_SOURCE_TABLE_NAME}.

Bu, örneğin dwprod şemasındaki products tablosunu dwprod.products olarak yeniden adlandırır.

Kuralları yönetme

Kuralları Kurallar bölmesinden yönetebilirsiniz.

• Click Kurallar.

Bir kuralı etkinleştirebilir/devre dışı bırakabilir, silebilir ve düzenleyebilirsiniz.