Mengatur Properti Komponen Aliran Data
Berlaku untuk:
SQL Server SSIS Integration Runtime di Azure Data Factory
Untuk mengatur properti komponen aliran data, yang mencakup sumber, tujuan, dan transformasi, gunakan salah satu fitur berikut:
Editor komponen yang disediakan Integration Services. Editor ini hanya mencakup properti kustom dari setiap komponen aliran data.
Jendela Properti mencantumkan properti kustom tingkat komponen dari setiap elemen, serta properti yang umum untuk semua elemen aliran data.
Kotak dialog Editor Lanjutan menyediakan akses ke properti kustom untuk setiap komponen. Kotak dialog Editor Lanjutan juga menyediakan akses ke properti yang umum untuk semua komponen aliran data-properti input, output, output kesalahan, kolom, dan kolom eksternal.
Mengatur properti komponen aliran data dengan editor komponen
Di SQL Server Data Tools (SSDT), buka proyek Integration Services yang berisi paket yang Anda inginkan.
Di Penjelajah Solusi, klik dua kali paket untuk membukanya.
Klik tab Alur Kontrol, lalu klik dua kali tugas Aliran Data yang berisi aliran data dengan komponen yang propertinya ingin Anda tampilkan dan ubah.
Klik dua kali komponen aliran data.
Di editor komponen, lihat atau ubah nilai properti, lalu tutup editor.
Untuk menyimpan paket yang diperbarui, pada menu File , klik Simpan Item Terpilih.
Mengatur properti komponen aliran data di jendela Properti
Di SQL Server Data Tools (SSDT), buka proyek Integration Services yang berisi paket yang Anda inginkan.
Di Penjelajah Solusi, klik dua kali paket untuk membukanya.
Klik tab Alur Kontrol, lalu klik dua kali tugas Aliran Data yang berisi komponen yang propertinya ingin Anda tampilkan dan ubah.
Klik kanan komponen aliran data, lalu klik Properti.
Lihat atau ubah nilai properti, lalu tutup jendela Properti .
Catatan
Banyak properti bersifat baca-saja, dan tidak dapat dimodifikasi.
Untuk menyimpan paket yang diperbarui, pada menu File , klik Simpan Item Terpilih.
Mengatur properti komponen aliran data dengan Editor Lanjutan
Di SQL Server Data Tools (SSDT), buka proyek Integration Services yang berisi paket yang Anda inginkan.
Di Penjelajah Solusi, klik dua kali paket untuk membukanya.
Klik tab Alur Kontrol, lalu klik dua kali tugas Aliran Data yang berisi komponen yang ingin Anda tampilkan atau ubah.
Di perancang aliran data, klik kanan komponen aliran data, lalu klik Perlihatkan Editor Lanjutan.
Catatan
Di SQL Server, komponen aliran data yang mendukung beberapa input tidak dapat menggunakan Editor Lanjutan.
Dalam kotak dialog Editor Lanjutan, lakukan salah satu langkah berikut ini:
Untuk melihat dan menentukan koneksi yang digunakan komponen, klik tab Pengelola Sambungan.
Catatan
Tab Pengelola Sambungan hanya tersedia untuk komponen aliran data yang menggunakan pengelola koneksi untuk menyambungkan ke sumber data seperti file dan database
Untuk melihat dan mengubah properti tingkat komponen, klik tab Properti Komponen.
Untuk menampilkan dan mengubah pemetaan antara kolom eksternal dan output yang tersedia, klik tab Pemetaan Kolom.
Catatan
Tab Pemetaan Kolom hanya tersedia saat menampilkan atau mengedit sumber atau tujuan.
Untuk melihat daftar kolom input yang tersedia dan untuk memperbarui nama kolom output, klik tab Kolom Input.
Catatan
Tab Kolom Input hanya tersedia saat bekerja dengan transformasi atau tujuan. Untuk informasi selengkapnya, lihat Transformasi Layanan Integrasi.
Untuk melihat dan memodifikasi properti input, output, dan output kesalahan, dan properti kolom yang dikandungnya, klik tab Properti Input dan Output.
Catatan
Sumber tidak memiliki input. Tujuan tidak memiliki output, kecuali untuk output kesalahan opsional.
Menampilkan atau mengubah nilai properti.
Klik OK.
Untuk menyimpan paket yang diperbarui, pada menu File , klik Simpan Item Terpilih.
Properti umum komponen aliran data
Objek aliran data dalam model objek Microsoft SQL Server Integration Services memiliki properti umum dan properti kustom di tingkat kolom komponen, input dan output, serta kolom input dan output. Banyak properti memiliki nilai baca-saja yang ditetapkan pada waktu proses oleh mesin aliran data.
Topik ini mencantumkan dan menjelaskan properti umum objek aliran data.
Properti komponen
Dalam model objek Layanan Integrasi, komponen dalam aliran data mengimplementasikan IDTSComponentMetaData100 antarmuka.
Tabel berikut ini menjelaskan properti komponen dalam aliran data. Beberapa properti memiliki nilai baca-saja yang ditetapkan pada waktu proses oleh mesin aliran data.
| Properti | Jenis Data | Deskripsi |
|---|---|---|
| ComponentClassID | String | CLSID komponen. |
| ContactInfo | String | Informasi kontak untuk pengembang komponen. |
| Deskripsi | String | Deskripsi komponen aliran data. Nilai default properti ini adalah nama komponen aliran data. |
| ID | Bilangan bulat | Nilai yang secara unik mengidentifikasi instans komponen ini. |
| IdentifikasiString | String | Mengidentifikasi komponen. |
| IsDefaultLocale | Boolean | Menunjukkan apakah komponen menggunakan lokal tugas Aliran Data tempat komponen tersebut berada. |
| LocaleID | Bilangan bulat | Lokal yang digunakan komponen aliran data saat paket berjalan. Semua lokal Windows tersedia untuk digunakan dalam komponen aliran data. |
| Nama | String | Nama komponen aliran data. |
| PipelineVersion | Bilangan bulat | Versi tugas aliran data tempat komponen dirancang untuk dijalankan. |
| UsesDispositions | Boolean | Menunjukkan apakah komponen memiliki output kesalahan. |
| ValidateExternalMetadata | Boolean | Menunjukkan apakah metadata kolom eksternal divalidasi. Nilai default properti ini adalah True. |
| Versi | Bilangan bulat | Versi komponen. |
Properti input
Dalam model objek Integration Services, transformasi dan tujuan memiliki input. Input komponen dalam aliran data mengimplementasikan IDTSInput100 antarmuka.
Tabel berikut ini menjelaskan properti input komponen dalam aliran data. Beberapa properti memiliki nilai baca-saja yang ditetapkan pada waktu proses oleh mesin aliran data.
| Properti | Jenis Data | Deskripsi |
|---|---|---|
| Deskripsi | String | Deskripsi input. |
| ErrorOrTruncationOperation | String | String opsional yang menentukan jenis kesalahan atau pemotongan yang dapat terjadi saat memproses baris. |
| ErrorRowDisposition | DTSRowDisposition | Nilai yang menentukan penanganan kesalahan. Nilainya adalah komponen Gagal, Abaikan kegagalan, dan Baris pengalihan. |
| HasSideEffects | Boolean | Menunjukkan apakah komponen dapat dihapus dari rencana eksekusi aliran data ketika tidak dilampirkan ke komponen hilir dan ketika RunInOptimizedMode benar. |
| ID | Bilangan bulat | Nilai yang secara unik mengidentifikasi input. |
| IdentifikasiString | String | String yang mengidentifikasi input. |
| Disortir | Boolean | Menunjukkan apakah data dalam input diurutkan. |
| Nama | String | Nama input. |
| SourceLocale | Bilangan bulat | ID lokal (LCID) data input. |
| PemotonganRowDisposition | DTSRowDisposition | Nilai yang menentukan bagaimana komponen menangani pemotongan yang terjadi saat memproses baris. . Nilainya adalah komponen Gagal, Abaikan kegagalan, dan Baris pengalihan. |
Tujuan dan beberapa transformasi tidak mendukung output kesalahan, dan properti ErrorRowDisposition dan TruncationRowDisposition dari komponen ini bersifat baca-saja.
Properti kolom input
Dalam model objek Integration Services, input berisi kumpulan kolom input. Kolom input komponen dalam aliran data mengimplementasikan IDTSInputColumn100 antarmuka.
Tabel berikut ini menjelaskan properti kolom input komponen dalam aliran data. Beberapa properti memiliki nilai baca-saja yang ditetapkan pada waktu proses oleh mesin aliran data.
| Properti | Jenis Data | Deskripsi |
|---|---|---|
| PerbandinganFlags | Bilangan bulat | Sekumpulan bendera yang menentukan perbandingan kolom yang memiliki tipe data karakter. Untuk informasi selengkapnya, lihat Membandingkan Data String. |
| Deskripsi | String | Menjelaskan kolom input. |
| ErrorOrTruncationOperation | String | String opsional yang menentukan jenis kesalahan atau pemotongan yang dapat terjadi saat memproses baris. |
| ErrorRowDisposition | DTSRowDisposition | Nilai yang menentukan penanganan kesalahan. Nilainya adalah komponen Gagal, Abaikan kegagalan, dan Baris pengalihan. |
| ExternalMetadataColumnID | IDTSExternalMetadataColumn100 | ID kolom metadata eksternal yang ditetapkan ke kolom input. |
| ID | Bilangan bulat | Nilai yang secara unik mengidentifikasi kolom input. |
| IdentifikasiString | String | String yang mengidentifikasi kolom input. |
| Silsilah DATA | Bilangan bulat | ID kolom upstram. |
| LineageIdentificationString | String | String identifikasi yang menyertakan nama kolom upstream. |
| Nama | String | Nama kolom input. |
| SortKeyPosition | Bilangan bulat | Nilai yang menunjukkan apakah kolom diurutkan, urutan pengurutannya, dan urutan di mana beberapa kolom diurutkan. Nilai 0 menunjukkan kolom tidak diurutkan. Untuk informasi selengkapnya, lihat Mengurutkan Data untuk Transformasi Gabungkan dan Gabungkan Gabungan. |
| PemotonganRowDisposition | DTSRowDisposition | Nilai yang menentukan bagaimana komponen menangani pemotongan yang terjadi saat memproses baris. Nilainya adalah komponen Gagal, Abaikan kegagalan, dan Baris pengalihan. |
| UpstreamComponentName | String | Nama komponen upstream. |
| UsageType | DTSUsageType | Nilai yang menentukan bagaimana kolom input digunakan oleh komponen. |
Kolom input juga memiliki properti jenis data yang dijelaskan di bawah "Properti Tipe Data."
Properti keluaran
Dalam model objek Integration Services, sumber dan transformasi memiliki output. Output komponen dalam aliran data mengimplementasikan IDTSOutput100 antarmuka.
Tabel berikut ini menjelaskan properti output komponen dalam aliran data. Beberapa properti memiliki nilai baca-saja yang ditetapkan pada waktu proses oleh mesin aliran data.
| Properti | Jenis Data | Deskripsi |
|---|---|---|
| DeleteOutputOnPathDetached | Boolean | Nilai yang menentukan apakah mesin aliran data menghapus output saat dilepas dari jalur. |
| Deskripsi | String | Menjelaskan output. |
| ErrorOrTruncationOperation | String | String opsional yang menentukan jenis kesalahan atau pemotongan yang dapat terjadi saat memproses baris. |
| ErrorRowDisposition | DTSRowDisposition | Nilai yang menentukan penanganan kesalahan. Nilainya adalah komponen Gagal, Abaikan kegagalan, dan Baris pengalihan. |
| ExclusionGroup | Bilangan bulat | Nilai yang mengidentifikasi sekelompok output yang saling eksklusif. |
| HasSideEffects | Boolean | Nilai yang menunjukkan apakah komponen dapat dihapus dari rencana eksekusi aliran data ketika tidak dilampirkan ke komponen upstream dan ketika RunInOptimizedMode benar. |
| ID | Bilangan bulat | Nilai yang secara unik mengidentifikasi output. |
| IdentifikasiString | String | String yang mengidentifikasi output. |
| IsErrorOut | Boolean | Menunjukkan apakah output adalah output kesalahan. |
| Disortir | Boolean | Menunjukkan apakah output diurutkan. Nilai defaultnya adalah False. ** Penting ** Mengatur nilai properti IsSorted ke True tidak mengurutkan data. Properti ini hanya menyediakan petunjuk untuk komponen hilir bahwa data telah diurutkan sebelumnya. Untuk informasi selengkapnya, lihat Mengurutkan Data untuk Transformasi Gabungkan dan Gabungkan Gabungan. |
| Nama | String | Nama output. |
| SynchronousInputID | Bilangan bulat | ID input yang sinkron dengan output. |
| PemotonganRowDisposition | DTSRowDisposition | Nilai yang menentukan bagaimana komponen menangani pemotongan yang terjadi saat memproses baris. Nilainya adalah komponen Gagal, Abaikan kegagalan, dan Baris pengalihan. |
Properti kolom output
Dalam model objek Integration Services, output berisi kumpulan kolom output. Kolom output komponen dalam aliran data mengimplementasikan IDTSOutputColumn100 antarmuka.
Tabel berikut ini menjelaskan properti kolom output komponen dalam aliran data. Beberapa properti memiliki nilai baca-saja yang ditetapkan pada waktu proses oleh mesin aliran data.
| Properti | Jenis Data | Deskripsi |
|---|---|---|
| PerbandinganFlags | Bilangan bulat | Sekumpulan bendera yang menentukan perbandingan kolom yang memiliki tipe data karakter. Untuk informasi selengkapnya, lihat Membandingkan Data String. |
| Deskripsi | String | Menjelaskan kolom output. |
| ErrorOrTruncationOperation | String | String opsional yang menentukan jenis kesalahan atau pemotongan yang dapat terjadi saat memproses baris. |
| ErrorRowDisposition | DTSRowDisposition | Nilai yang menentukan penanganan kesalahan. Nilainya adalah komponen Gagal, Abaikan kegagalan, dan Baris pengalihan. Nilai defaultnya adalah komponen Gagal. |
| ExternalMetadataColumnID | Bilangan bulat | ID kolom metadata eksternal yang ditetapkan ke kolom input. |
| ID | Bilangan bulat | Nilai yang secara unik mengidentifikasi kolom output. |
| IdentifikasiString | String | String yang mengidentifikasi kolom output. |
| Silsilah DATA | Bilangan bulat | ID kolom output. Komponen hilir merujuk ke kolom dengan menggunakan nilai ini. |
| LineageIdentificationString | String | String identifikasi yang menyertakan nama kolom. |
| Nama | String | Nama kolom output. |
| SortKeyPosition | Bilangan bulat | Nilai yang menunjukkan apakah kolom diurutkan, urutan pengurutannya, dan urutan di mana beberapa kolom diurutkan. Nilai 0 menunjukkan kolom tidak diurutkan. Untuk informasi selengkapnya, lihat Mengurutkan Data untuk Transformasi Gabungkan dan Gabungkan Gabungan. |
| SpecialFlags | Bilangan bulat | Nilai yang berisi bendera khusus kolom output. |
| PemotonganRowDisposition | DTSRowDisposition | Nilai yang menentukan bagaimana komponen menangani pemotongan yang terjadi saat memproses baris. Nilainya adalah komponen Gagal, Abaikan kegagalan, dan Baris pengalihan. Nilai defaultnya adalah komponen Gagal. |
Kolom output juga menyertakan sekumpulan properti jenis data.
Properti kolom metadata eksternal
Dalam model objek Integration Services, input dan output dapat berisi kumpulan kolom metadata eksternal. Kolom metadata eksternal komponen dalam aliran data mengimplementasikan IDTSExternalMetadataColumn100 antarmuka.
Tabel berikut ini menjelaskan properti kolom metadata eksternal komponen dalam aliran data. Beberapa properti memiliki nilai baca-saja yang ditetapkan pada waktu proses oleh mesin aliran data.
| Properti | Jenis Data | Deskripsi |
|---|---|---|
| Deskripsi | String | Menjelaskan kolom eksternal. |
| ID | Bilangan bulat | Nilai yang secara unik mengidentifikasi kolom. |
| IdentifikasiString | String | Karakter yang mengidentifikasi kolom. |
| Nama | String | Nama kolom eksternal. |
Kolom metadata eksternal juga menyertakan sekumpulan properti tipe data.
Properti jenis data
Kolom output dan kolom metadata eksternal menyertakan sekumpulan properti tipe data. Bergantung pada jenis data kolom, properti dapat bersifat baca/tulis atau baca-saja.
Tabel berikut ini menjelaskan properti jenis data kolom output dan kolom metadata eksternal.
| Properti | Jenis Data | Deskripsi |
|---|---|---|
| CodePage | Bilangan bulat | Menentukan halaman kode untuk data string yang bukan Unicode. |
| DataType | Bilangan bulat (enumerasi) | Jenis data Layanan Integrasi kolom. Untuk informasi selengkapnya, lihat Jenis Data Integration Services. |
| Panjang | Bilangan bulat | Panjangnya, diukur dalam karakter, dari kolom. |
| Presisi | Bilangan bulat | Presisi kolom numerik. |
| Sisik | Bilangan bulat | Skala kolom numerik. |
Properti kustom komponen aliran data
Untuk informasi tentang properti kustom, lihat topik berikut
Properti Kustom OLE DB Properti Kustom OLE DB
Menggunakan ekspresi dalam komponen aliran data
Prosedur ini menjelaskan cara menambahkan ekspresi ke transformasi Pemisahan Bersyar atau ke transformasi Kolom Turunan. Transformasi Pemisahan Bersyarah menggunakan ekspresi untuk menentukan kondisi yang mengarahkan baris data ke output transformasi, dan transformasi Kolom Turunan menggunakan ekspresi untuk menentukan nilai yang ditetapkan ke kolom.
Untuk menerapkan ekspresi dalam transformasi, paket harus sudah menyertakan setidaknya satu tugas Aliran Data dan sumber.
Di SQL Server Data Tools (SSDT), buka proyek Integration Services yang berisi paket yang Anda inginkan.
Di Penjelajah Solusi, klik dua kali paket untuk membukanya.
Di SSIS Designer, klik tab Alur Kontrol, lalu klik tugas Aliran Data yang berisi aliran data tempat Anda ingin menerapkan ekspresi.
Klik tab Aliran Data, dan seret transformasi Pemisahan Bersyar atau Kolom Turunan dari Kotak Alat ke permukaan desain.
Seret konektor hijau dari sumber atau transformasi ke transformasi Pemisahan Bersyar atau Kolom Turunan.
Klik dua kali transformasi untuk membuka kotak dialognya.
Di panel kiri, perluas Variabel untuk menampilkan variabel yang ditentukan sistem dan pengguna, dan perluas Kolom untuk menampilkan kolom input transformasi.
Di panel kanan, perluas Fungsi Matematika, Fungsi String, Fungsi Tanggal/Waktu, Fungsi NULL, Jenis Pemeran, dan Operator untuk mengakses fungsi, transmisi, dan operator yang disediakan tata bahasa ekspresi.
Bergantung pada transformasi, lakukan salah satu hal berikut ini untuk membangun ekspresi:
Dalam kotak dialog Editor Transformasi Pemisahan Bersyarah, seret variabel, kolom, fungsi, operator, dan transmisi ke kolom Kondisi . Atau, Anda dapat mengetikkan ekspresi secara langsung di kolom Kondisi .
Dalam kotak dialog Editor Transformasi Kolom Turunan, seret variabel, kolom, fungsi, operator, dan transmisi ke kolom Ekspresi . Atau, Anda dapat mengetikkan ekspresi secara langsung di kolom Ekspresi .
Catatan
Saat Anda menghapus fokus dari kolom Kondisi atau kolom Ekspresi , teks ekspresi mungkin disorot untuk menunjukkan bahwa sintaks ekspresi salah.
Klik OK untuk keluar dari kotak dialog.
Catatan
Jika ekspresi tidak valid, pemberitahuan akan muncul yang menjelaskan kesalahan sintaks dalam ekspresi.
Properti aliran data yang bisa Anda atur dengan ekspresi
Nilai properti tertentu dari objek aliran data dapat ditentukan dengan menggunakan ekspresi properti yang tersedia pada kontainer tugas Aliran Data.
Untuk informasi tentang menggunakan ekspresi properti, lihat Menggunakan Ekspresi Properti dalam Paket.
Anda dapat menggunakan ekspresi properti untuk menyesuaikan konfigurasi untuk setiap instans paket yang disebarkan. Anda juga dapat menggunakan ekspresi properti untuk menentukan batasan run-time untuk paket dengan menggunakan opsi /set dengan utilitas prompt perintah dtexec . Misalnya, Anda dapat membatasi MaximumThreads yang digunakan oleh transformasi Sortir, atau MaxMemoryUsage dari transformasi Pengelompokan Fuzzy dan Pencarian Fuzzy. Jika tidak dibatasi, transformasi ini dapat menyimpan data dalam jumlah besar dalam memori.
Untuk menentukan ekspresi properti untuk salah satu properti objek aliran data yang tercantum dalam topik ini, tampilkan jendela Properti untuk tugas Aliran Data dengan memilih tugas Aliran Data pada permukaan Alur Kontrol perancang, atau dengan memilih tab Aliran Data perancang tanpa memilih komponen atau jalur individual apa pun. Pilih properti Ekspresi dan klik elipsis (...) untuk menampilkan kotak dialog Editor Ekspresi Properti. Turun bawah daftar Properti untuk memilih properti, lalu ketik ekspresi di kotak teks Ekspresi , atau klik elipsis (...) untuk menampilkan kotak dialog Penyusun Ekspresi.
Daftar Properti menampilkan properti yang tersedia hanya untuk objek aliran data yang telah Anda tempatkan di permukaan Aliran Data perancang. Oleh karena itu, Anda tidak dapat menggunakan daftar Properti untuk melihat semua kemungkinan properti objek aliran data yang mendukung ekspresi properti. Misalnya, jika Anda telah menempatkan sumber ADO NET pada permukaan perancang, daftar Properti berisi entri untuk [ADO NET Source].[ Properti SqlCommand] . Daftar ini juga menampilkan banyak properti tugas Aliran Data itu sendiri.
Nilai properti dalam daftar berikut ini dapat ditentukan dengan menggunakan ekspresi properti.
Sumber aliran data
| Objek Aliran Data | Properti |
|---|---|
| Sumber ADO NET | Properti TableOrViewName Properti SqlCommand |
| Sumber XML | Properti XMLData Properti XMLSchemaDefinition |
Transformasi aliran data
Untuk informasi selengkapnya tentang properti kustom ini, lihat Properti Kustom Transformasi.
| Objek Aliran Data | Properti |
|---|---|
| Transformasi Pemisahan Bersyarah | Properti FriendlyExpression |
| Transformasi Kolom Derived | Properti FriendlyExpression |
| Transformasi Pengelompokan Fuzzy | Properti MaxMemoryUsage |
| Transformasi Pencarian Fuzzy | Properti MaxMemoryUsage |
| Transformasi pencarian | Properti SqlCommand Properti SqlCommandParam |
| Transformasi Perintah OLE DB | Properti SqlCommand |
| Transformasi Pengambilan Sampel Persentase | Properti SamplingValue |
| Transformasi Pivot | Properti PivotKeyValue |
| Transformasi Pengambilan Sampel Baris | Properti SamplingValue |
| Transformasi pengurutan | Properti MaximumThreads |
| Transformasi unpivot | Properti PivotKeyValue |
Tujuan aliran data
| Objek Aliran Data | Properti |
|---|---|
| Tujuan ADO NET | Properti TableOrViewName Properti BatchSize Properti CommandTimeout |
| Tujuan File Datar | Properti header |
| Tujuan Ringkas SQL Server | Properti TableName |
| Tujuan SQL Server | Properti BulkInsertTableName Properti BulkInsertFirstRow Properti BulkInsertLastRow Properti BulkInsertOrder Properti batas waktu |