Sumber File Datar
Berlaku untuk: SQL Server SSIS Integration Runtime di Azure Data Factory
Sumber File Datar membaca data dari file teks. File teks dapat dalam format dibatasi, lebar tetap, atau campuran.
Format yang dibatasi menggunakan pemisah kolom dan baris untuk menentukan kolom dan baris.
Format lebar tetap menggunakan lebar untuk menentukan kolom dan baris. Format ini juga menyertakan karakter untuk bidang padding ke lebar maksimumnya.
Format kanan yang dibatasi menggunakan lebar untuk menentukan semua kolom, kecuali untuk kolom terakhir, yang dibatasi oleh pemisah baris.
Anda dapat mengonfigurasi sumber File Datar dengan cara berikut:
Tambahkan kolom ke output transformasi yang berisi nama file teks tempat sumber File Datar mengekstrak data.
Tentukan apakah sumber File Datar menginterpretasikan string panjang nol dalam kolom sebagai nilai null.
Catatan
Manajer koneksi File Datar yang digunakan sumber File Datar harus dikonfigurasi untuk menggunakan format yang dibatasi untuk menginterpretasikan string dengan panjang nol sebagai null. Jika manajer koneksi menggunakan lebar tetap atau format kanan yang kokoh, data yang terdiri dari spasi tidak dapat ditafsirkan sebagai nilai null.
Kolom output dalam output sumber File Datar menyertakan properti FastParse. FastParse menunjukkan apakah kolom menggunakan rutinitas penguraian standar yang lebih cepat, tetapi tidak peka lokal dan cepat yang disediakan Layanan Integrasi atau rutinitas penguraian standar yang sensitif terhadap lokal. Untuk informasi selengkapnya, lihat Penguraian Cepat dan Penguraian Standar.
Kolom output juga menyertakan properti UseBinaryFormat. Anda menggunakan properti ini untuk menerapkan dukungan untuk data biner, seperti data dengan format desimal yang dikemas, dalam file. Secara default UseBinaryFormat diatur ke false. Jika Anda ingin menggunakan format biner, atur UseBinaryFormat ke true dan jenis data pada kolom output ke DT_BYTES. Saat Anda melakukan ini, sumber File Datar melewati konversi data dan meneruskan data ke kolom output apa adanya. Anda kemudian dapat menggunakan transformasi seperti Kolom Turunan atau Konversi Data untuk mentransmisikan data DT_BYTES ke jenis data yang berbeda, atau Anda dapat menulis skrip kustom dalam transformasi Skrip untuk menginterpretasikan data. Anda juga dapat menulis komponen aliran data kustom untuk menginterpretasikan data. Untuk informasi selengkapnya tentang jenis data mana yang dapat Anda transmisikan DT_BYTES , lihat Cast (Ekspresi SSIS).
Sumber ini menggunakan manajer koneksi File Datar untuk mengakses file teks. Dengan mengatur properti pada manajer koneksi File Datar, Anda dapat memberikan informasi tentang file dan setiap kolom di dalamnya, dan menentukan bagaimana sumber File Datar harus menangani data dalam file teks. Misalnya, Anda dapat menentukan karakter yang memisahkan kolom dan baris dalam file, dan jenis data dan panjang setiap kolom. Untuk informasi selengkapnya, lihat Pengelola Sambungan File Datar.
Sumber ini memiliki satu output dan satu output kesalahan.
Konfigurasi Sumber File Datar
Anda dapat mengatur properti melalui SSIS Designer atau secara terprogram.
Kotak dialog Editor Lanjutan mencerminkan properti yang dapat diatur secara terprogram. Untuk informasi selengkapnya tentang properti yang bisa Anda atur dalam kotak dialog Editor Lanjutan atau secara terprogram, klik salah satu topik berikut ini:
Tugas Terkait
Untuk detail tentang cara mengatur properti komponen aliran data, lihat Mengatur Properti Komponen Aliran Data.
Editor Sumber File Datar (Halaman Pengelola Sambungan)
Gunakan halaman Pengelola Sambungan kotak dialog Editor Sumber File Datar untuk memilih manajer koneksi yang akan digunakan sumber File Datar. Sumber File Datar membaca data dari file teks, yang dapat dalam format dibatasi, lebar tetap, atau campuran.
Sumber File Datar dapat menggunakan salah satu jenis manajer koneksi berikut:
Manajer koneksi File Datar jika sumbernya adalah satu file datar. Untuk informasi selengkapnya, lihat Pengelola Sambungan File Datar.
Manajer koneksi Beberapa File Datar jika sumbernya adalah beberapa file datar dan tugas Aliran Data berada di dalam kontainer perulangan, seperti kontainer For Loop. Pada setiap perulangan kontainer, sumber File Datar memuat data dari nama file berikutnya yang disediakan manajer koneksi Beberapa File Datar. Untuk informasi selengkapnya, lihat Beberapa File Datar Pengelola Sambungan.
Opsi
Manajer koneksi file datar
Pilih manajer koneksi yang sudah ada dari daftar, atau buat manajer koneksi baru dengan mengklik Baru.
Baru
Buat manajer koneksi baru dengan menggunakan kotak dialog Flat File Pengelola Sambungan Editor.
Pertahankan nilai null dari sumber sebagai nilai null dalam aliran data
Tentukan apakah akan menyimpan nilai null saat data diekstrak. Nilai default properti ini adalah false. Ketika nilai ini adalah false, sumber File Datar menggantikan nilai null dari data sumber dengan nilai default yang sesuai untuk setiap kolom, seperti string kosong untuk kolom string dan nol untuk kolom numerik.
Pratinjau
Pratinjau hasil dengan menggunakan kotak dialog Tampilan Data. Pratinjau dapat menampilkan hingga 200 baris.
Editor Sumber File Datar (Halaman Kolom)
Gunakan simpul Kolom dari kotak dialog Editor Sumber File Datar untuk memetakan kolom output ke setiap kolom eksternal (sumber).
Catatan
Properti FileNameColumnName dari sumber File Datar dan properti FastParse dari kolom outputnya tidak tersedia di Editor Sumber File Datar, tetapi dapat diatur dengan menggunakan Editor Lanjutan. Untuk informasi selengkapnya tentang properti ini, lihat bagian Sumber File Datar dari Properti Kustom File Datar.
Opsi
Kolom Eksternal yang Tersedia
Tampilkan daftar kolom eksternal yang tersedia di sumber data. Anda tidak dapat menggunakan tabel ini untuk menambahkan atau menghapus kolom.
Kolom Eksternal
Tampilkan kolom eksternal (sumber) dalam urutan tugas akan membacanya. Anda dapat mengubah urutan ini dengan terlebih dahulu menghapus kolom yang dipilih dalam tabel, lalu memilih kolom eksternal dari daftar dalam urutan yang berbeda.
Kolom Output
Berikan nama unik untuk setiap kolom output. Defaultnya adalah nama kolom eksternal (sumber) yang dipilih; namun, Anda dapat memilih nama deskriptif yang unik. Nama yang disediakan akan ditampilkan dalam SSIS Designer.
Editor Sumber File Datar (Halaman Output Kesalahan)
Gunakan halaman Output Kesalahan dari kotak dialog Editor Sumber File Datar untuk memilih opsi penanganan kesalahan dan untuk mengatur properti pada kolom output kesalahan.\
Opsi
Input/Output
Lihat nama sumber data.
Kolom
Tampilkan kolom eksternal (sumber) yang Anda pilih di halaman Pengelola Sambungan kotak dialog EditorSumber File Datar.
Kesalahan
Tentukan apa yang harus terjadi ketika kesalahan terjadi: abaikan kegagalan, alihkan baris, atau gagalkan komponen.
Topik Terkait: Penanganan Kesalahan dalam Data
Pemotongan
Tentukan apa yang harus terjadi ketika pemotongan terjadi: abaikan kegagalan, alihkan baris, atau gagalkan komponen.
Keterangan
Lihat deskripsi kesalahan.
Atur nilai ini ke sel terpilih
Tentukan apa yang harus terjadi pada semua sel yang dipilih saat terjadi kesalahan atau pemotongan: abaikan kegagalan, alihkan baris, atau gagalkan komponen.
Terapkan
Terapkan opsi penanganan kesalahan ke sel terpilih.