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::Sql2012::DTSValidationStatus Validate();[System.Runtime.InteropServices.DispId(29)]
public Microsoft.SqlServer.Dts.Pipeline.Wrapper.Sql2012.DTSValidationStatus Validate ();[<System.Runtime.InteropServices.DispId(29)>]
abstract member Validate : unit -> Microsoft.SqlServer.Dts.Pipeline.Wrapper.Sql2012.DTSValidationStatusPublic Function Validate () As DTSValidationStatusMengembalikan
Nilai dari enumerasi DTSValidationStatus 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 mengubah 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 objek IDTSInput100 dan IDTSOutput100 yang diharapkan.
Verifikasi bahwa objek IDTSCustomProperty100 terus ada dan berisi nilai yang benar.
Verifikasi bahwa setiap objek IDTSInputColumn100 dalam IDTSInputColumnCollection100 mereferensikan objek IDTSOutputColumn100 yang ada dalam komponen upstram.
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 metode FireError dan FireWarning dan oleh nilai pengembalian DTSValidationStatus. Panggilan ke metode FireError 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 enumerasi DTSValidationStatus, 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 metode ReinitializeMetaData. Perancang SSIS akan meminta pengguna bahwa komponen dapat memperbaiki dirinya sendiri ketika nilai enumerasi VS_NEEDSNEWMETADATA. Kemudian perancang akan memanggil metode ReinitializeMetaData. |
| VS_ISCORRUPT | Menunjukkan bahwa ComponentMetaData rusak dan tidak dapat diperbaiki dengan panggilan ke metode ReinitializeMetaData atau dengan mengedit komponen. |
Ketika properti DelayValidation dari tugas aliran data benar, panggilan waktu desain ke metode Validasi dihilangkan, dan metode dipanggil sebelum eksekusi komponen sebagai gantinya.