IDTSDesigntimeComponent100.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.
public:
Microsoft::SqlServer::Dts::Pipeline::Wrapper::Sql2014::DTSValidationStatus Validate();[System.Runtime.InteropServices.DispId(29)]
public Microsoft.SqlServer.Dts.Pipeline.Wrapper.Sql2014.DTSValidationStatus Validate ();[<System.Runtime.InteropServices.DispId(29)>]
abstract member Validate : unit -> Microsoft.SqlServer.Dts.Pipeline.Wrapper.Sql2014.DTSValidationStatusPublic Function Validate () As DTSValidationStatusMengembalikan
Nilai dari DTSValidationStatus enumerasi yang menunjukkan status komponen.
- Atribut
Keterangan
Metode Validasi diimplementasikan 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 mengubahnya IDTSComponentMetaData100 selama Validasi.
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.
Verifikasi bahwa setiap objek IDTSInputColumn100 dalam referensinya IDTSInputColumnCollection100 objek yang ada IDTSOutputColumn100 dalam komponen upstream.
Jika komponen menggunakan koneksi, verifikasi bahwa IDTSRuntimeConnection100 ditentukan dan bahwa ConnectionManager ada dalam paket.
Komponen harus memberikan umpan balik kepada pengguna ketika validasi gagal. Umpan balik diberikan melalui FireError metode dan FireWarning dan oleh nilai yang DTSValidationStatus dikembalikan. Panggilan ke FireError metode dan FireWarning ditampilkan di jendela Daftar Tugas di SQL Server Data Tools (SSDT), dan harus memberikan panduan kepada pengguna tentang kegagalan validasi. Dari empat nilai dalam DTSValidationStatus enumerasi, hanya VS_ISVALID yang 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 benar. Pengguna harus membuat perubahan pada ComponentMetaData untuk menyelesaikan masalah. |
| VS_NEEDSNEWMETADATA | Menunjukkan bahwa kesalahan validasi dapat diperbaiki oleh komponen dalam implementasi ReinitializeMetaData metode . Perancang SSIS akan meminta pengguna bahwa komponen dapat memperbaiki dirinya sendiri ketika nilai enumerasi VS_NEEDSNEWMETADATA. Kemudian perancang akan memanggil ReinitializeMetaData metode . |
| VS_ISCORRUPT | Menunjukkan bahwa ComponentMetaData rusak dan tidak dapat diperbaiki dengan panggilan ke ReinitializeMetaData metode atau dengan mengedit komponen. |
DelayValidation Ketika properti tugas aliran data benar, panggilan waktu desain ke metode Validasi dihilangkan, dan metode dipanggil sebelum eksekusi komponen sebagai gantinya.