Aracılığıyla paylaş

CDC Kaynağı

Şunlar için geçerlidir:SQL Server Azure Data Factory'de SSIS Integration Runtime

Önemli

CDC Denetim Görevi, CDC Kaynağı ve CDC Bölücü de dahil olmak üzere CDC Akış Bileşenleri kullanım dışıdır. Ayrıntılar için duyurubakın.

CDC kaynağı, SQL Server değişiklik tablolarından bir dizi değişiklik verisi okur ve değişiklikleri diğer SSIS bileşenlerine gönderir.

CDC kaynağı tarafından okunan değişiklik veri aralığı CDC İşleme Aralığı olarak adlandırılır ve geçerli veri akışı başlamadan önce yürütülen CDC Denetimi görevi tarafından belirlenir. CDC İşleme Aralığı, bir grup tablo için CDC işleme durumunu koruyan bir paket değişkeninin değerinden türetilir.

CDC kaynağı veritabanı tablosu, görünüm veya SQL deyimi kullanarak SQL Server veritabanından veri ayıklar.

CDC kaynağı aşağıdaki yapılandırmaları kullanır:

  • SQL Server CDC veritabanına erişmek için bir SQL Server ADO.NET bağlantı yöneticisi.

  • CDC için etkinleştirilmiş bir tablo.

  • Seçili tablonun yakalama örneğinin adı (birden fazla varsa).

  • Değişiklik işleme modu.

  • CDC İşleme aralığının belirlendiği CDC durum paketi değişkeninin adı. CDC kaynağı bu değişkeni değiştirmez.

CDC Kaynağı tarafından döndürülen veriler, SQL Server CDC işlevleri olan cdc.fn_cdc_get_all_changes_<capture-instance-name> veya cdc.fn_cdc_get_net_changes_<capture-instance-name> (varsa) ile aynı olan verilerdir. İsteğe bağlı tek ekleme, geçerli işlem aralığının tablonun ilk yüküyle çakışıp çakışamayacağını gösteren __$initial_processing sütunudur. İlk işleme hakkında daha fazla bilgi için bkz. CDC Denetim Görevi.

CDC kaynağında bir normal çıkış ve bir hata çıkışı vardır.

Hata İşleme

CDC kaynağında hata çıktısı var. Bileşen hatası çıkışı aşağıdaki çıkış sütunlarını içerir:

  • Hata Kodu: Değer her zaman -1'dir.

  • Hata Sütunu: Hataya neden olan kaynak sütun (dönüştürme hataları için).

  • Hata Satırı Sütunları: Hataya neden olan kayıt verileri.

Hata davranışı ayarına bağlı olarak, CDC kaynağı ayıklama işlemi sırasında oluşan hataların hata çıkışında döndürülmesini destekler (veri dönüştürme, kesme).

Veri Türü Desteği

Microsoft için CDC kaynak bileşeni, doğru SSIS veri türlerine eşlenen tüm SQL Server veri türlerini destekler.

CDC Kaynağının Sorunlarını Giderme

Aşağıda CDC kaynağının sorunlarını gidermeyle ilgili bilgiler yer alır.

Sql Server Management Studio'da sorunları yalıtmak ve yeniden oluşturmak için bu betiği kullanın

CDC kaynak işlemi, CDC kaynağını çağırmadan önce yürütülen CDC Denetimi görevinin işlemine tabidir. CDC Denetimi görevi, CDC durum paketi değişkeninin değerini başlangıç ve bitiş LSN'lerini içerecek şekilde hazırlar. Aşağıdaki betikle eşdeğer bir işlev gerçekleştirir:

use <cdc-enabled-database-name>  
               declare @start_lsn binary(10), @end_lsn binary(10)  
               set @start_lsn = sys.fn_cdc_increment_lsn(  
                       convert(binary(10),'0x' + '<value-from-state-cs>', 1))  
               set @end_lsn =   
                       convert(binary(10),'0x' + '<value-from-state-ce>', 1)  
               select * from cdc.fn_cdc_get_net_changes_dbo_Table1(@start_lsn,  
@end_lsn, '<mode>')

nerede:

  • <cdc-enabled-database-name>, değişiklik tablolarını içeren SQL Server veritabanının adıdır.

  • <value-from-state-cs>, CDC durum değişkeninde CS/<value-from-state-cs>/ olarak görünen değerdir (CS, Current-processing-range-Start anlamına gelir).

  • <value-from-state-ce>, CDC durum değişkeninde CE/<value-from-state-cs>/ olarak görünen değerdir (CE, Current-processing-range-End anlamına gelir).

  • <modu> CDC işleme modlarıdır. İşlem modlarının aşağıdaki değerlerden biri vardır: Tüm, Eski Değerlerle Tümü, Net, Güncelleştirme Maskesi ile Net, Birleştirme ile Net.

Bu komut dosyası, hataların yeniden oluşturulmasının ve tanımlanmasının kolay olduğu SQL Server Management Studio'da sorunları yalıtmaya yardımcı olur.

SQL Server Hata İletisi

SQL Server tarafından aşağıdaki ileti döndürülebilir:

Yordam veya işlev cdc.fn_cdc_get_net_changes_<için yetersiz sayıda bağımsız değişken sağlandı.>.

Bu hata bir bağımsız değişkenin eksik olduğunu göstermez. Bu, CDC durum değişkenindeki başlangıç veya bitiş LSN değerlerinin geçersiz olduğu anlamına gelir.

CDC Kaynağını Yapılandırma

CDC kaynağını program aracılığıyla veya SSIS Tasarımcısı aracılığıyla yapılandırabilirsiniz.

Daha fazla bilgi için aşağıdaki konulardan birine bakın:

Gelişmiş Düzenleyici iletişim kutusu, program aracılığıyla ayarlanabilen özellikleri içerir.

Gelişmiş Düzenleyici iletişim kutusunu açmak için:

  • SQL Server 2019 Integration Services (SSIS) projenizin Veri Akışı ekranında CDC kaynağına sağ tıklayın ve Gelişmiş Düzenleyiciyi Gösterseçin.

Gelişmiş Düzenleyici iletişim kutusunda ayarlayabileceğiniz özellikler hakkında daha fazla bilgi için bkz. CDC Kaynak Özel Özellikleri.

Bu Bölümde

CDC Kaynak Düzenleyicisi (Bağlantı Yöneticisi Sayfası)

ADO.NET bağlantı yöneticisini, CDC kaynağının değişiklik satırlarını okuduğu SQL Server veritabanı (CDC veritabanı) için seçmek üzere CDC Kaynak Düzenleyicisi iletişim kutusunun Bağlantı Yöneticisi sayfasını kullanın. CDC veritabanı seçildikten sonra, veritabanındaki yakalanmış bir tabloyu seçmeniz gerekir.

CDC kaynağı hakkında daha fazla bilgi için bkz. CDC Kaynağı.

Görev Listesi

CDC Kaynak Düzenleyicisi Bağlantı Yöneticisi Sayfasını açmak için

  1. SQL Server Veri Araçları'nda, CDC kaynağını içeren SQL Server 2019 Integration Services (SSIS) paketini açın.

  2. Veri Akışı sekmesinde CDC kaynağına çift tıklayın.

  3. CDC Kaynak DüzenleyicisiBağlantı Yöneticisi'netıklayın.

Seçenekler

ADO.NET bağlantı yöneticisi
Listeden var olan bir bağlantı yöneticisini seçin veya yeni bir bağlantı oluşturmak için Yeni 'a tıklayın. Bağlantı, CDC için etkinleştirilmiş bir SQL Server veritabanına ve seçilen değişiklik tablosunun bulunduğu yere olmalıdır.

yeni
Yeniöğesine tıklayın. ADO.NET Bağlantı Yöneticisi Düzenleyicisini Yapılandır iletişim kutusu açılır ve burada yeni bir bağlantı yöneticisi oluşturabilirsiniz.

CDC Tablo
okumak ve işlenmek üzere aşağı akış SSIS bileşenlerine beslemek istediğiniz yakalanan değişiklikleri içeren CDC kaynak tablosunu seçin.

Yakalama örneği
Okunacak CDC tablosunu içeren CDC yakalama örneğinin adını seçin veya yazın.

Yakalanan bir kaynak tablo, şema değişiklikleri aracılığıyla tablo tanımının sorunsuz geçişini işlemek için bir veya iki yakalanan örneğe sahip olabilir. Yakalanan kaynak tablo için birden fazla yakalama örneği tanımlanmışsa, burada kullanmak istediğiniz yakalama örneğini seçin. Tablolar için varsayılan yakalama örneği adı [şema].[tablo] olarak <şema>_<tablo> şeklindedir, ancak kullanılan gerçek yakalama örneği adları farklı olabilir. Okunan asıl tablo, CDC tablosu cdc<capture-instance>_CT'tir.

CDC İşleme Modu
İşleme gereksinimlerinizi en iyi karşılayan işleme modunu seçin. Olası seçenekler şunlardır:

  • Tüm: Güncelleştirmeden Önce değerleri olmadan geçerli CDC aralığındaki değişiklikleri döndürür.

  • Tümü eski değerlerle: Eski değerler de dahil olmak üzere geçerli CDC işlem aralığındaki değişiklikleri döndürür (Güncelleştirmeden Önce). Her Güncelleştirme işlemi için biri güncelleştirme öncesi değerleri ve biri güncelleştirme sonrası değeri olan iki satır olacaktır.

  • Net: Geçerli CDC işleme aralığında değiştirilen kaynak satır başına yalnızca bir değişiklik satırı döndürür. Kaynak satır birden çok kez güncelleştirildiyse, birleştirilmiş değişiklik oluşturulur (örneğin, insert+update tek bir güncelleştirme olarak ve update+delete tek bir silme olarak oluşturulur). Net değişiklik işleme modunda çalışırken, değişiklikleri Sil, Ekle ve Güncelleştir çıkışlarına bölmek ve paralel olarak işlemek mümkündür çünkü tek kaynak satır birden fazla çıktıda görünür.

  • Net güncelleştirme maskesiyle: Bu mod, normal Net moduna benzer ancak mevcut değişiklik satırında değişen sütunları belirten, __$<sütun_adı>__Changed ad desenine sahip boole sütunları da ekler.

  • Birleştirmeile Net: Bu mod, standart Net moduna benzer ancak Ekleme ve Güncelleme işlemleri tek bir Birleştirme işlemiyle (UPSERT) birleştirilir.

Not

Tüm Net değişiklik seçenekleri için kaynak tablonun birincil anahtarı veya benzersiz dizini olmalıdır. Birincil anahtarı veya benzersiz dizinleri olmayan tablolar için Tüm seçeneğini kullanmanız gerekir.

CDC durumunu içeren değişkeni
Geçerli CDC bağlamı için CDC durumunu koruyan SSIS dize paketi değişkenini seçin. CDC durum değişkeni hakkında daha fazla bilgi için bkz. Durum Değişkeni Tanımlama.

Yeniden işleme göstergesi sütununu ekle
__$reprocessingadlı özel bir çıkış sütunu oluşturmak için bu onay kutusunu seçin.

Bu sütun, CDC işleme aralığı ilk işleme aralığıyla çakıştığında (ilk yükleme dönemine karşılık gelen LSN aralığı) veya önceki çalıştırmadaki bir hatadan sonra bir CDC işlem aralığı yeniden işlendiğinde true değerine sahiptir. Bu gösterge sütunu, SSIS geliştiricisinin değişiklikleri yeniden işlerken hataları farklı şekilde işlemesine olanak tanır (örneğin, var olmayan bir satırı silme ve yinelenen anahtarda başarısız olan bir ekleme gibi eylemler yoksayılabilir).

Daha fazla bilgi için bkz. CDC Kaynak Özel Özellikleri.

CDC Kaynak Düzenleyicisi (Sütunlar Sayfası)

Bir çıkış sütununu her dış (kaynak) sütuna eşlemek için CDC Kaynak Düzenleyicisi iletişim kutusunun Sütunlar sayfasını kullanın.

Görev Listesi

CDC Kaynak Düzenleyicisi Sütunları Sayfasını açmak için

  1. SQL Server Veri Araçları'nda, CDC kaynağını içeren SQL Server 2019 Integration Services (SSIS) paketini açın.

  2. Veri Akışı sekmesinde CDC kaynağına çift tıklayın.

  3. CDC Kaynak Düzenleyicisi'de, Sütunlaröğesine tıklayın.

Seçenekler

Kullanılabilir Dış Sütunlar
Veri kaynağındaki kullanılabilir dış sütunların listesi. Sütunları eklemek veya silmek için bu tabloyu kullanamazsınız. Kaynakta kullanılacak sütunları seçin. Seçili sütunlar, Dış Sütun listesine seçildikleri sırayla eklenir.

Dış Sütun
Bileşenleri, CDC kaynağından veri kullanacak şekilde yapılandırırken gördüğünüz sıradaki dış (kaynak) sütunların bir görünümü. Bu sırayı değiştirmek için, önce Kullanılabilir Dış Sütunlar listesindeki seçili sütunları temizleyin ve sonra listeden dış sütunları farklı bir sırada seçin. Seçili sütunlar, Dış Sütun listesine seçtiğiniz sırayla eklenir.

Çıkış Sütunu
Her çıkış sütunu için benzersiz bir ad girin. Varsayılan değer, seçilen dış (kaynak) sütunun adıdır, ancak benzersiz, açıklayıcı bir ad seçebilirsiniz. Girilen ad SSIS Tasarımcısı'nda görüntülenir.

CDC Kaynak Düzenleyicisi (Hata Çıktı Sayfası)

Hata işleme seçeneklerini seçmek için CDC Kaynak Düzenleyicisi iletişim kutusunun Hata Çıktısı sayfasını kullanın.

Görev Listesi

CDC Kaynak Düzenleyicisi Hata Çıktısı Sayfasını açmak için

  1. SQL Server Veri Araçları'nda, CDC kaynağını içeren SQL Server 2019 Integration Services (SSIS) paketini açın.

  2. Veri Akışı sekmesinde CDC kaynağına çift tıklayın.

  3. CDC Kaynak Düzenleyicisiiçinde, Hata Çıktısı öğesinetıklayın.

Seçenekler

Giriş/Çıkış
Veri kaynağının adını görüntüleyin.

Sütun
CDC Kaynak Düzenleyicisi iletişim kutusunun Bağlantı Yöneticisi sayfasında seçtiğiniz dış (kaynak) sütunları görüntüleyin.

Hatası
CDC kaynağının bir akıştaki hataları nasıl işleyeceğini seçin: hatayı yoksayın, satırı yeniden yönlendirin veya bileşenin çalışmasını durdurun.

Kesme
CDC kaynağının akıştaki kesme işlemini nasıl işlemesi gerektiğini seçin: hatayı yoksayın, satırı yeniden yönlendirin veya bileşeni başarısız yapın.

Açıklama
Kullanılmaz.

Bu değeri seçili hücrelere ayarla
CdC kaynağının bir hata veya kesme oluştuğunda tüm seçili hücreleri nasıl işleyeceklerini seçin: hatayı yoksayın, satırı yeniden yönlendirin veya bileşeni başarısız yapın.

Uygula
Seçili hücrelere hata işleme seçeneklerini uygulayın.

Hata İşleme Seçenekleri

CDC kaynağının hataları ve kesmeleri nasıl ele aldığını yapılandırmak için aşağıdaki seçenekleri kullanırsınız.

Başarısız Bileşen
Veri Akışı görevi bir hata veya kesme oluştuğunda başarısız olur. Bu, varsayılan davranıştır.

Hatayı Yoksay
Hata veya kesinti göz ardı edilir ve veri satırı CDC kaynak çıktısına yönlendirilir.

Akışı Yeniden Yönlendirme
Hata veya kesme veri satırı CDC kaynağının hata çıkışına yönlendirilir. Bu durumda CDC kaynak hata işleme yöntemi kullanılır. Daha fazla bilgi için bkz. CDC Kaynak.

  • Last updated on