catalog.add_data_tap_by_guid

  • Artikel

Berlaku untuk: Integration Runtime SSIS SQL Server di Azure Data Factory

Berlaku untuk:SQL Server

Menambahkan ketukan data ke jalur aliran data tertentu dalam aliran data paket, untuk instans eksekusi.

Sintaks

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

Argumen

[ @execution_id = ] execution_id
ID eksekusi untuk eksekusi yang berisi paket. Execution_id itu sangat besar.

[ @dataflow_task_guid = ] dataflow_task_guid
ID untuk aliran tugas data dalam paket yang berisi jalur aliran data yang akan diketuk. dataflow_task_guid adalahpengidentifikasi unik.

[ @dataflow_path_id_string = ] dataflow_path_id_string
String identifikasi untuk jalur aliran data. Jalur menghubungkan dua komponen aliran data. Properti IdentificationString untuk jalur menentukan string.

Untuk menemukan string identifikasi, di SQL Server Data Tools klik kanan jalur antara dua komponen aliran data lalu klik Properti. Properti IdentificationString muncul di jendela Properti .

dataflow_path_id_string adalah nvarchar(4000).

[ @data_filename = ] data_filename
Nama file yang menyimpan data yang diketuk. Jika tugas aliran data dijalankan di dalam Foreach Loop atau kontainer For Loop, file terpisah menyimpan data yang diketuk untuk setiap perulangan perulangan. Setiap file diawali dengan angka yang sesuai dengan perulangan. File ketuk data ditulis ke folder "<SQL Server folder> penginstalan\130\DTS\". data_filename adalah nvarchar(4000).

[ @max_rows = ] max_rows
Jumlah baris yang diambil selama ketukan data. Jika nilai ini tidak ditentukan, semua baris akan diambil. max_rows adalah int.

[ @data_tap_id = ] data_tap_id
ID ketukan data. Data_tap_id itu sangat besar.

Contoh

Dalam contoh berikut, ketukan data dibuat pada jalur aliran data, Paths[SRC DimDCVentor.OLE DB Source Output], dalam tugas {D978A2E4-E05D-4374-9B05-50178A8817E8}aliran data . Data yang diketuk disimpan dalam file DCVendorOutput.csv.

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'

Keterangan

Untuk menambahkan ketukan data, instans eksekusi harus dalam status dibuat (nilai 1 di kolom statustampilan catalog.operations (Database SSISDB)) . Nilai status berubah setelah Anda menjalankan eksekusi. Anda dapat membuat eksekusi dengan memanggil catalog.create_execution (Database SSISDB).

Berikut ini adalah pertimbangan untuk prosedur tersimpan add_data_tap_by_guid.

  • Saat Anda menambahkan ketukan data, itu tidak divalidasi sebelum paket dijalankan.

  • Disarankan agar Anda membatasi jumlah baris yang diambil selama ketukan data, untuk menghindari pembuatan file data besar. Jika mesin tempat prosedur tersimpan dijalankan, kehabisan ruang penyimpanan untuk file data, prosedur tersimpan berhenti berjalan.

  • Menjalankan prosedur tersimpan add_data_tap_by_guid berdampak pada performa paket. Disarankan agar Anda menjalankan prosedur tersimpan hanya untuk memecahkan masalah data.

  • Untuk mengakses file yang menyimpan data yang diketuk, Anda harus memiliki izin administrator pada mesin tempat prosedur tersimpan dijalankan, atau Anda harus menjadi pengguna yang memulai eksekusi yang berisi paket dengan ketukan data.

Mengembalikan kode

0 (berhasil)

Ketika prosedur tersimpan gagal, itu melemparkan kesalahan.

Tataan Hasil

Tidak ada

Izin

Prosedur tersimpan ini memerlukan salah satu izin berikut:

  • IZIN MODIFIKASI pada instans eksekusi

  • Keanggotaan ke peran database ssis_admin

  • Keanggotaan ke peran server sysadmin

Kesalahan dan peringatan

Daftar berikut menjelaskan kondisi yang menyebabkan prosedur tersimpan gagal.

  • Pengguna tidak memiliki izin MODIFIKASI.

  • Ketuk data untuk komponen yang ditentukan, dalam paket yang ditentukan, telah ditambahkan.

  • Nilai yang ditentukan untuk jumlah baris yang akan diambil, tidak valid.

Persyaratan

Lihat juga

catalog.add_data_tap