catalog.add_data_tap_by_guid

2025-06-05

Şunlar için geçerlidir:SQL Server Azure Data Factory'de SSIS Entegrasyon Çalışma Zamanı

Şunlar için geçerlidir: SQL Server

Yürütme örneği için paket veri akışındaki belirli bir veri akışı yoluna veri dokunması ekler.

Sözdizimi

catalog.add_data_tap_by_guid [ @execution_id = ] execution_id  
, [ @dataflow_task_guid = ] dataflow_task_guid   
, [ @dataflow_path_id_string = ] dataflow_path_id_string  
, [ @data_filename = ] data_filename  
, [ @max_rows = ] max_rows  
, [ @data_tap_id = ] data_tap_id

Tartışmalar

[ @execution_id = ] execution_id
Paketi içeren yürütmenin yürütme kimliği. execution_id büyük bir şey.

[ @dataflow_task_guid = ] dataflow_task_guid
Pakette, dokunılacak veri akışı yolunu içeren veri görev akışının kimliği. dataflow_task_guidbenzersiz bir belirleyicidir.

[ @dataflow_path_id_string = ] dataflow_path_id_string
Veri akışı yolunun tanımlama dizesi. Yol, iki veri akışı bileşenini bağlar. Yol için IdentificationString özelliği dizeyi belirtir.

Tanımlama dizesini bulmak için SQL Server Veri Araçları'nda iki veri akışı bileşeni arasındaki yola sağ tıklayın ve ardından Özellikler'e tıklayın. IdentificationString özelliği Özellikler penceresinde görüntülenir.

dataflow_path_id_string bir nvarchar(4000) şeklindedir.

[ @data_filename = ] data_filename
Dokunan verileri depolayan dosyanın adı. Veri akışı görevi bir Foreach Döngüsü veya For Döngüsü kapsayıcısı içinde yürütülürse, ayrı dosyalar döngünün her yinelemesi için dokunan verileri depolar. Her dosyaya bir yinelemeye karşılık gelen bir sayı ön eki eklenir. Veri dokunma dosyaları "<SQL Server yükleme klasörü\130\DTS\" klasörüne> yazılır. data_filename bir nvarchar(4000)'dir.

[ @max_rows = ] max_rows
Veri dokunması sırasında yakalanan satır sayısı. Bu değer belirtilmezse, tüm satırlar yakalanır. max_rows bir int'tir.

[ @data_tap_id = ] data_tap_id
Verinin kimliğine dokunun. data_tap_idbüyük bir şey.

Örnek

Aşağıdaki örnekte, veri akışı görevinde Paths[SRC DimDCVentor.OLE DB Source Output]veri akışı yolunda {D978A2E4-E05D-4374-9B05-50178A8817E8}bir veri dokunması oluşturulur. Dokunan veriler DCVendorOutput.csv dosyasında depolanır.

exec catalog.add_data_tap_by_guid   @execution_id,   
'{D978A2E4-E05D-4374-9B05-50178A8817E8}',   
'Paths[SRC DimDCVentor.OLE DB Source Output]',   
'D:\demos\datafiles\DCVendorOutput.csv'

Açıklamalar

Veri dokunmaları eklemek için yürütme örneğinin oluşturulmuş durumda olması gerekir (catalog.operations (SSISDB Veritabanı) görünümünün durum sütununda 1 değeri) . Yürütmeyi çalıştırdığınızda durum değeri değişir. catalog.create_execution (SSISDB Veritabanı) çağrısı yaparak bir yürütme oluşturabilirsiniz.

Aşağıda, add_data_tap_by_guid saklı yordamıyla ilgili dikkat edilmesi gerekenler yer alır.

Veri dokunması eklediğinizde, paket çalıştırılmadan önce doğrulanmaz.
Büyük veri dosyaları oluşturmamak için, veri dokunma sırasında yakalanan satır sayısını sınırlamanız önerilir. Saklı yordamın yürütüldiği makinede veri dosyaları için depolama alanı tükenirse saklı yordam çalışmayı durdurur.
add_data_tap_by_guid saklı yordamının çalıştırılması paketin performansını etkiler. Saklı yordamı yalnızca veri sorunlarını gidermek için çalıştırmanız önerilir.
Dokunan verileri depolayan dosyaya erişmek için, saklı yordamın çalıştırıldığı makinede yönetici izinlerine sahip olmanız veya veri dokunmasıyla birlikte paketi içeren yürütmeyi başlatan kullanıcı olmanız gerekir.

İade Kodları

0 (başarı)

Saklı yordam başarısız olduğunda bir hata oluşturur.

Sonuç Kümesi

Hiç kimse

İzinler

Bu saklı yordam aşağıdaki izinlerden birini gerektirir:

Yürütme örneği üzerinde MODIFY izinleri
ssis_admin veritabanı rolüne üyelik
sysadmin sunucu rolüne üyelik

Hatalar ve Uyarılar

Aşağıdaki listede saklı yordamın başarısız olmasına neden olan koşullar açıklanmaktadır.

Kullanıcının MODIFY izinleri yok.
Belirtilen bileşen için belirtilen paketteki veri dokunması zaten eklenmiş.
Yakalanacak satır sayısı için belirtilen değer geçerli değil.

Gereksinimler

Ayrıca Bkz.

catalog.add_data_tap