catalog.add_data_tap

  • Artikel

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

Berlaku untuk:SQL Server

Menambahkan ketukan data pada output komponen dalam aliran data paket, untuk instans eksekusi.

Sintaks

catalog.add_data_tap [ @execution_id = ] execution_id  
, [ @task_package_path = ] task_package_path  
, [ @dataflow_path_id_string = ] dataflow_path_id_string  
, [ @data_filename = ] data_filename  
, [ @max_rows = ] max_rows  
, [ @data_tap_id = ] data_tap_id OUTPUT

Argumen

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

[ @task_package_path = ] task_package_path
Jalur paket untuk tugas aliran data. Properti PackagePath untuk tugas aliran data menentukan jalur. Jalur tersebut peka huruf besar/kecil. Untuk menemukan jalur paket, di SQL Server Data Tools klik kanan tugas Aliran Data, lalu klik Properti. Properti PackagePath muncul di jendela Properti .

task_package_path adalah nvarchar(max).

[ @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.

Secara default, file disimpan di <folder drive>:\Program Files\Microsoft SQL Server\130\DTS\DataDumps.

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
Mengembalikan ID ketukan data. Data_tap_id itu sangat besar.

Contoh

Dalam contoh berikut, ketukan data dibuat pada jalur aliran data, 'Paths[OLE DB Source.OLE DB Source Output], dalam tugas aliran data, \Package\Data Flow Task. Data yang diketuk disimpan dalam output0.txt file di folder DataDumps (<drive>:\Program Files\Microsoft SQL Server\130\DTS\DataDumps).

Declare @execution_id bigint  
Exec SSISDB.Catalog.create_execution @folder_name='Packages',@project_name='SSISPackages', @package_name='Package.dtsx',@reference_id=Null, @use32bitruntime=False, @execution_id=@execution_id OUTPUT  
  
Exec SSISDB.Catalog.set_execution_parameter_value @execution_id,50, 'LOGGING_LEVEL', 0  
  
Exec SSISDB.Catalog.add_data_tap @execution_id, @task_package_path='\Package\Data Flow Task', @dataflow_path_id_string = 'Paths[OLE DB Source.OLE DB Source Output]', @data_filename = 'output0.txt'  
  
Exec SSISDB.Catalog.start_execution @execution_id

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.

  • Jika eksekusi berisi paket induk dan satu atau beberapa paket anak, Anda perlu menambahkan ketukan data untuk setiap paket yang ingin Anda ketuk datanya.

  • Jika paket berisi lebih dari satu tugas aliran data dengan nama yang sama, task_package_path secara unik mengidentifikasi tugas aliran data yang berisi output komponen yang diketuk.

  • 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, paket berhenti berjalan dan pesan kesalahan ditulis ke log.

  • Menjalankan prosedur tersimpan add_data_tap 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 menjadi administrator di komputer tempat prosedur tersimpan dijalankan. Anda juga 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

Sumber Daya Eksternal

Entri blog, SSIS 2012: Intip Ke Ketukan Data, di rafael-salas.com.

Lihat juga

catalog.add_data_tap_by_guid