PipelineComponent.Validate Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Penting
API ini bukan kompatibel CLS.
Memverifikasi bahwa komponen dikonfigurasi dengan benar.
public:
virtual Microsoft::SqlServer::Dts::Pipeline::Wrapper::DTSValidationStatus Validate();
[System.CLSCompliant(false)]
public virtual Microsoft.SqlServer.Dts.Pipeline.Wrapper.DTSValidationStatus Validate ();
[<System.CLSCompliant(false)>]
abstract member Validate : unit -> Microsoft.SqlServer.Dts.Pipeline.Wrapper.DTSValidationStatus
override this.Validate : unit -> Microsoft.SqlServer.Dts.Pipeline.Wrapper.DTSValidationStatus
Public Overridable Function Validate () As DTSValidationStatus
Mengembalikan
Nilai dari DTSValidationStatus enumerasi yang menunjukkan status komponen.
- Atribut
Keterangan
Metode Validate ini ditimpa oleh pengembang komponen untuk memverifikasi bahwa komponen dikonfigurasi dengan benar. Ini dipanggil berulang kali selama desain paket, dan satu kali sebelum eksekusi komponen. Komponen tidak boleh memodifikasinya ComponentMetaData selama Validate.
Implementasi Validate kelas dasar pemeriksaan keberadaan IDTSInputColumn100 objek yang propertinya LineageID tidak cocok dengan LineageIDIDTSOutputColumn100 komponen hulu. Pengembang komponen harus memperluas fungsionalitas kelas Validate dasar dengan melakukan pemeriksaan tambahan pada ComponentMetaData. Setiap komponen memiliki persyaratan yang berbeda untuk validasi yang berhasil, tetapi daftar berikut menyediakan beberapa item umum yang harus divalidasi.
Verifikasi bahwa komponen memiliki jumlah IDTSInput100 objek dan IDTSOutput100 yang diharapkan.
Verifikasi bahwa objek apa pun IDTSCustomProperty100 terus ada, dan berisi nilai yang benar.
Jika komponen menggunakan koneksi, komponen harus memverifikasi bahwa IDTSRuntimeConnection100 ditentukan dan bahwa ConnectionManager ada dalam paket.
Komponen harus memberikan umpan balik kepada pengguna saat validasi gagal. Umpan balik diberikan melalui FireError metode dan FireWarning dan oleh nilai yang DTSValidationStatus dikembalikan. Panggilan ke FireError dan FireWarning ditampilkan di jendela Daftar Kesalahan di SQL Server Data Tools (SSDT), dan harus memberikan panduan kepada pengguna tentang kegagalan validasi. Dari empat nilai dalam DTSValidationStatus enumerasi, hanya VS_ISVALID menunjukkan validasi yang berhasil. Tiga nilai lainnya menunjukkan tingkat kegagalan yang berbeda. Tabel berikut ini menjelaskan nilai kegagalan dalam enumerasi dan bagaimana nilai tersebut ditafsirkan oleh SSIS Designer.
Status | Deskripsi |
---|---|
VS_ISBROKEN | Menunjukkan bahwa komponen tidak dikonfigurasi dengan salah, tetapi perubahan oleh pengguna ke ComponentMetaData akan menyelesaikan masalah. |
VS_NEEDSNEWMETADATA | Menunjukkan bahwa kesalahan validasi dapat diperbaiki oleh komponen dalam implementasi ReinitializeMetaData metode . SSIS Designer akan meminta pengguna bahwa komponen dapat memperbaiki dirinya sendiri ketika VS_NEEDSNEWMETADATA, dan kemudian ReinitializeMetaData dipanggil. |
VS_ISCORRUPT | Menunjukkan bahwa ComponentMetaData rusak dan tidak dapat diperbaiki oleh panggilan ke ReinitializeMetaData atau dengan mengedit komponen. |
DelayValidation Ketika properti tugas aliran data adalah true
, waktu desain memanggil untuk Validate dihilangkan dan metode dipanggil sebelum eksekusi komponen.
Untuk informasi selengkapnya, lihat Memvalidasi Komponen Aliran Data.