Pengelola Koneksi File Datar

Berlaku untuk: Integration Runtime SSIS SQL Server di Azure Data Factory

Manajer koneksi File Datar memungkinkan paket untuk mengakses data dalam file datar. Misalnya, sumber dan tujuan File Datar dapat menggunakan manajer koneksi File Datar untuk mengekstrak dan memuat data.

Pengelola koneksi File Datar hanya dapat mengakses satu file. Untuk mereferensikan beberapa file, gunakan manajer koneksi Beberapa File Datar alih-alih manajer koneksi File Datar. Untuk informasi selengkapnya, lihat Beberapa File Datar Pengelola Sambungan.

Panjang Kolom

Secara default, manajer koneksi File Datar mengatur panjang kolom string menjadi 50 karakter. Dalam kotak dialog Editor Pengelola Sambungan File Datar, Anda bisa mengevaluasi data sampel dan mengubah ukuran panjang kolom ini secara otomatis untuk mencegah pemotokan data atau lebar kolom berlebih. Selain itu, kecuali Anda kemudian mengubah ukuran panjang kolom dalam sumber File Datar atau transformasi, panjang kolom kolom kolom string tetap sama di seluruh aliran data. Jika kolom string ini memetakan ke kolom tujuan yang lebih sempit, peringatan muncul di antarmuka pengguna. Selain itu, pada durasi, kesalahan dapat terjadi karena pemotokan data. Untuk menghindari kesalahan atau pemotokan, Anda dapat mengubah ukuran kolom agar kompatibel dengan kolom tujuan di manajer koneksi File Datar, sumber File Datar, atau transformasi. Untuk mengubah panjang kolom output, Anda mengatur properti Panjang kolom output pada tab Properti Input dan Output dalam kotak dialog Editor Lanjutan.

Jika Anda memperbarui panjang kolom di manajer koneksi File Datar setelah Anda menambahkan dan mengonfigurasi sumber File Datar yang menggunakan manajer koneksi, Anda tidak perlu mengubah ukuran kolom output secara manual di sumber File Datar. Saat Anda membuka kotak dialog Sumber File Datar , sumber File Datar menyediakan opsi untuk menyinkronkan metadata kolom.

Konfigurasi Pengelola Sambungan File Datar

Saat Anda menambahkan manajer koneksi File Datar ke paket, SQL Server Integration Services membuat manajer koneksi yang akan menyelesaikan koneksi File Datar pada durasi, mengatur properti koneksi File Datar, dan menambahkan manajer koneksi File Datar ke kumpulan Koneksi paket.

Properti ConnectionManagerType dari pengelola koneksi diatur ke FLATFILE.

Secara default, manajer koneksi File Datar selalu memeriksa pemisah baris dalam data yang tidak dikutip, dan memulai baris baru saat pemisah baris ditemukan. Ini memungkinkan pengelola koneksi untuk mengurai file dengan benar dengan baris yang tidak memiliki bidang kolom.

Dalam beberapa kasus, menonaktifkan fitur ini dapat meningkatkan performa paket. Anda dapat menonaktifkan fitur ini dengan mengatur properti pengelola koneksi File Datar, AlwaysCheckForRowDelimiters, ke False.

Anda dapat mengonfigurasi manajer koneksi File Datar dengan cara berikut:

• Tentukan file, lokal, dan halaman kode yang akan digunakan. Lokal digunakan untuk menginterpretasikan data sensitif lokal seperti tanggal, dan halaman kode digunakan untuk mengonversi data string ke Unicode.

• Tentukan format file. Anda dapat menggunakan format kanan yang dibatasi, lebar tetap, atau kanan yang dibatasi.

• Tentukan baris header, baris data, dan pemisah kolom. Pemisah kolom dapat diatur pada tingkat file dan ditimpa di tingkat kolom.

• Menunjukkan apakah baris pertama dalam file berisi nama kolom.

• Tentukan karakter kualifikasi teks. Setiap kolom dapat dikonfigurasi untuk mengenali kualifikasi teks.

  Penggunaan karakter kualifikasi untuk menyematkan karakter kualifikasi ke dalam string yang memenuhi syarat didukung oleh Pengelola Sambungan File Datar. Instans ganda dari kualifikasi teks ditafsirkan sebagai instans tunggal harfiah dari string tersebut. Misalnya, jika kualifikasi teks adalah kutipan tunggal dan data input adalah 'abc', 'def', 'g'hi', data outputnya adalah abc, def, g'hi. Namun, instans kualifikasi yang disematkan dalam string yang memenuhi syarat menyebabkan Sumber File Datar gagal dengan kesalahan DTS_E_PRIMEOUTPUTFAILED.

• Atur properti seperti nama, jenis data, dan lebar maksimum pada kolom individual.

Anda dapat mengatur properti ConnectionString untuk manajer koneksi File Datar dengan menentukan ekspresi di jendela Properti SQL Server Data Tools (SSDT). Untuk menghindari kesalahan validasi, lakukan hal berikut.

• Saat Anda menggunakan ekspresi untuk menentukan file, tambahkan jalur file dalam kotak Nama file di Editor Pengelola Sambungan File Datar.

• Atur properti DelayValidation pada manajer koneksi File Datar ke True.

Anda dapat menggunakan ekspresi untuk membuat nama file saat runtime dengan menggunakan manajer koneksi File Datar dengan tujuan File Datar.

Anda dapat mengatur properti melalui SSIS Designer atau secara terprogram.

Untuk informasi tentang mengonfigurasi pengelola koneksi secara terprogram, lihat ConnectionManager dan Menambahkan Koneksi Secara Terprogram.

Editor Pengelola Sambungan File Datar (Halaman Umum)

Gunakan halaman Umum kotak dialog Pengelola Sambungan Editor File Datar untuk memilih format file dan data. Koneksi file datar memungkinkan paket tersambung ke file teks.

Untuk mempelajari selengkapnya tentang pengelola koneksi File Datar, lihat Pengelola Sambungan File Datar.

Opsi

Nama pengelola koneksi
Berikan nama unik untuk koneksi file datar dalam alur kerja. Nama yang disediakan akan ditampilkan dalam SSIS Designer.

Deskripsi
Jelaskan koneksi. Sebagai praktik terbaik, jelaskan koneksi dalam hal tujuannya, untuk membuat paket mendokumentasikan sendiri dan lebih mudah dipertahankan.

Nama file
Ketik jalur dan nama file yang akan digunakan dalam koneksi file datar.

Telusuri
Temukan nama file yang akan digunakan dalam koneksi file datar.

Lokal
Tentukan lokal untuk menyediakan informasi khusus bahasa untuk mengurutkan dan untuk format tanggal dan waktu.

Unicode
Menunjukkan apakah akan menggunakan Unicode. Jika Anda menggunakan Unicode, Anda tidak dapat menentukan halaman kode.

Halaman kode
Tentukan halaman kode untuk teks non-Unicode.

Format
Menunjukkan apakah file menggunakan pemformatan yang dibatasi, lebar tetap, atau kanan yang dibatasi.

Nilai	Deskripsi
Dibatasi	Kolom dipisahkan oleh pemisah, ditentukan pada halaman Kolom .
Lebar tetap	Kolom memiliki lebar tetap.
Kanan tidak ragged	File kanan yang di-ragg adalah file di mana setiap kolom memiliki lebar tetap, kecuali untuk kolom terakhir. Ini dibatasi oleh pemisah baris.

Kualifikasi teks
Tentukan kualifikasi teks yang akan digunakan. Misalnya, Anda dapat menentukan bahwa bidang teks diapit dalam tanda kutip.

Catatan

Setelah Anda memilih kualifikasi teks, Anda tidak dapat memilih kembali opsi Tidak Ada . Ketik Tidak Ada untuk membatalkan pilihan kualifikasi teks.

Pemisah baris header
Pilih dari daftar pemisah untuk baris header, atau masukkan teks pemisah.

Nilai	Deskripsi
{CR} {LF}	Baris header dibatasi oleh kombinasi umpan baris kembali pengangkutan.
{CR}	Baris header dibatasi oleh pengembalian pengangkutan.
{LF}	Baris header dibatasi oleh umpan baris.
Titik koma {;}	Baris header dibatasi oleh titik koma.
Titik dua {:}	Baris header dibatasi oleh titik dua.
Koma {,}	Baris header dibatasi oleh koma.
Tab {t}	Baris header dibatasi oleh tab.
Bilah vertikal {|}	Baris header dibatasi oleh bilah vertikal.

Baris header untuk dilewati
Tentukan jumlah baris header atau baris data awal yang akan dilewati, jika ada.

Nama kolom di baris data pertama
Menunjukkan apakah akan mengharapkan atau memberikan nama kolom di baris data pertama.

Editor Pengelola Sambungan File Datar (Halaman Kolom)

Gunakan halaman Kolom dari kotak dialog Editor Pengelola Sambungan File Datar untuk menentukan informasi baris dan kolom, dan untuk mempratinjau file.

Untuk mempelajari selengkapnya tentang manajer koneksi File Datar, lihat Pengelola Sambungan File Datar.

Opsi Statis

Nama pengelola koneksi
Berikan nama unik untuk koneksi File Datar dalam alur kerja. Nama yang disediakan akan ditampilkan dalam SSIS Designer.

Deskripsi
Jelaskan koneksi. Sebagai praktik terbaik, jelaskan koneksi dalam hal tujuannya, untuk membuat paket dokumentasi mandiri dan lebih mudah dipertahankan.

Opsi Dinamis Format File Datar

Format = Dibatasi

Pemisah baris
Pilih dari daftar pemisah baris yang tersedia, atau masukkan teks pemisah.

Nilai	Deskripsi
{CR} {LF}	Baris dibatasi oleh kombinasi umpan baris kembali pengangkutan.
{CR}	Baris dibatasi oleh pengembalian pengangkutan.
{LF}	Baris dibatasi oleh umpan baris.
Titik koma {;}	Baris dibatasi oleh titik koma.
Titik dua {:}	Baris dibatasi oleh titik dua.
Koma {,}	Baris dibatasi oleh koma.
Tab {t}	Baris dibatasi oleh tab.
Bilah vertikal {|}	Baris dibatasi oleh bilah vertikal.

Pemisah Kolom
Pilih dari daftar pemisah kolom yang tersedia, atau masukkan teks pemisah.

Nilai	Deskripsi
{CR} {LF}	Kolom dibatasi oleh kombinasi umpan baris kembali pengangkutan.
{CR}	Kolom dibatasi oleh pengembalian pengangkutan.
{LF}	Kolom dibatasi oleh umpan baris.
Titik koma {;}	Kolom dibatasi oleh titik koma.
Titik dua {:}	Kolom dibatasi oleh titik dua.
Koma {,}	Kolom dibatasi oleh koma.
Tab {t}	Kolom dibatasi oleh tab.
Bilah vertikal {|}	Kolom dibatasi oleh bilah vertikal.

Refresh
Lihat efek mengubah pemisah untuk dilewati dengan mengklik Refresh. Tombol ini hanya terlihat setelah Anda mengubah opsi koneksi lainnya.

Baris pratinjau
Lihat data sampel dalam file datar, dibagi menjadi kolom dan baris dengan menggunakan opsi yang dipilih.

Reset Kolom
Hapus semua kecuali kolom asli dengan mengklik Reset Kolom.

Format = Lebar Tetap

Font
Pilih font untuk menampilkan data pratinjau.

Kolom data sumber
Sesuaikan lebar baris dengan geser penanda baris merah vertikal, dan sesuaikan lebar kolom dengan mengklik penggaris di bagian atas jendela pratinjau

Lebar baris
Tentukan panjang baris sebelum menambahkan pemisah untuk kolom individual. Atau, seret garis merah vertikal di jendela pratinjau untuk menandai akhir baris. Nilai lebar baris diperbarui secara otomatis.

Reset Kolom
Hapus semua kecuali kolom asli dengan mengklik Reset Kolom.

Format = Kanan Yang Tidak Dikakukan

Catatan

File kanan yang tidak di-ragg adalah file di mana setiap kolom memiliki lebar tetap, kecuali untuk kolom terakhir. Ini dibatasi oleh pemisah baris.

Font
Pilih font untuk menampilkan data pratinjau.

Kolom data sumber
Sesuaikan lebar baris dengan geser penanda baris merah vertikal, dan sesuaikan lebar kolom dengan mengklik penggaris di bagian atas jendela pratinjau

Pemisah baris
Pilih dari daftar pemisah baris yang tersedia, atau masukkan teks pemisah.

Nilai	Deskripsi
{CR} {LF}	Baris dibatasi oleh kombinasi umpan baris kembali pengangkutan.
{CR}	Baris dibatasi oleh pengembalian pengangkutan.
{LF}	Baris dibatasi oleh umpan baris.
Titik koma {;}	Baris dibatasi oleh titik koma.
Titik dua {:}	Baris dibatasi oleh titik dua.
Koma {,}	Baris dibatasi oleh koma.
Tab {t}	Baris dibatasi oleh tab.
Bilah vertikal {|}	Baris dibatasi oleh bilah vertikal.

Reset Kolom
Hapus semua kecuali kolom asli dengan mengklik Reset Kolom.

Editor Pengelola Sambungan File Datar (Halaman Tingkat Lanjut)

Gunakan halaman Tingkat Lanjut dari kotak dialog Editor Pengelola Sambungan File Datar untuk mengatur properti yang menentukan cara Layanan Integrasi membaca dan menulis data dalam file datar. Anda dapat mengubah nama kolom dalam file datar, dan mengatur properti yang menyertakan tipe data dan pemisah untuk setiap kolom dalam file.

Secara default, panjang kolom string adalah 50 karakter. Anda dapat mengubah ukuran panjang kolom ini untuk mencegah pemotokan data atau lebar kolom berlebih. Anda juga dapat memperbarui metadata lain untuk mengaktifkan kompatibilitas dengan kolom tujuan. Misalnya, Anda dapat mengubah jenis data kolom yang hanya berisi data bilangan bulat menjadi jenis data numerik, seperti DT_I2. Anda dapat melakukan modifikasi ini secara manual, atau Anda bisa mengklik tombol Pilih Jenis untuk menggunakan kotak dialog Sarankan Tipe Kolom untuk mengevaluasi data sampel dan membuat beberapa perubahan ini untuk Anda secara otomatis.

Untuk mempelajari selengkapnya tentang pengelola koneksi File Datar, lihat Pengelola Sambungan File Datar.

Opsi

Nama pengelola koneksi
Berikan nama unik untuk manajer koneksi file datar dalam alur kerja. Nama yang disediakan akan ditampilkan dalam SSIS Designer.

Deskripsi
Jelaskan manajer koneksi. Sebagai praktik terbaik, jelaskan manajer koneksi dalam hal tujuannya, untuk membuat paket mendokumentasikan sendiri dan lebih mudah dipertahankan.

Mengonfigurasi properti setiap kolom
Pilih kolom di panel kiri untuk menampilkan propertinya di panel kanan. Lihat tabel berikut ini untuk deskripsi properti tipe data. Beberapa properti yang tercantum hanya dapat dikonfigurasi untuk beberapa format file datar.

Properti	Deskripsi
ColumnType	Menunjukkan apakah kolom dibatasi, lebar tetap, atau kanan yang dibatasi. Properti ini bersifat hanya baca. File kanan yang di-ragg adalah file di mana setiap kolom memiliki lebar tetap, kecuali untuk kolom terakhir. Ini dibatasi oleh pemisah baris.
OutputColumnWidth	Tentukan nilai yang akan disimpan sebagai hitungan byte; untuk file Unicode, nilai ini sesuai dengan hitungan karakter. Dalam tugas Aliran Data, nilai ini digunakan untuk mengatur lebar kolom output untuk sumber File Datar. Dalam model objek, nama properti ini adalah MaximumWidth.
DataType	Pilih dari daftar jenis data yang tersedia. Untuk informasi selengkapnya, lihat Jenis Data Integration Services.
TextQualified	Menunjukkan apakah data teks dikelilingi oleh karakter kualifikasi teks seperti karakter kutipan. Benar: Data teks dalam file datar memenuhi syarat. False: Data teks dalam file datar TIDAK memenuhi syarat.
Nama	Berikan nama kolom deskriptif. Jika Anda tidak memasukkan nama, Integration Services secara otomatis membuat nama dalam format Kolom 0, Kolom 1 dan sebagainya.
Skala Data	Tentukan skala data numerik. Skala mengacu pada jumlah tempat desimal. Untuk informasi selengkapnya, lihat Jenis Data Integration Services.
Pembatas Kolom	Pilih dari daftar pemisah kolom yang tersedia. Pilih pemisah yang tidak mungkin terjadi dalam teks. Nilai ini diabaikan untuk kolom lebar tetap. {CR}{LF}. Kolom dibatasi oleh kombinasi umpan baris kembali pengangkutan. {CR}. Kolom dibatasi oleh pengembalian pengangkutan. {LF}. Kolom dibatasi oleh umpan baris. Titik koma {;}. Kolom dibatasi oleh titik koma. Titik dua {:}. Kolom dibatasi oleh titik dua. Koma {,}. Kolom dibatasi oleh koma. Tab {t}. Kolom dibatasi oleh tab. Bilah vertikal {|}. Kolom dibatasi oleh bilah vertikal.
DataPresisi	Tentukan presisi data numerik. Presisi mengacu pada jumlah digit. Untuk informasi selengkapnya, lihat Jenis Data Integration Services.
InputColumnWidth	Tentukan nilai yang akan disimpan sebagai hitungan byte; untuk file Unicode, ini akan ditampilkan sebagai hitungan karakter. Nilai ini diabaikan untuk kolom yang dibatasi. Catatan Dalam model objek, nama properti ini adalah ColumnWidth.

Baru
Tambahkan kolom baru dengan mengklik Baru. Secara default, tombol Baru menambahkan kolom baru di akhir daftar. Tombol ini juga memiliki opsi berikut, tersedia di daftar drop-down.

Nilai	Deskripsi
Tambahkan Kolom	Tambahkan kolom baru di akhir daftar.
Sisipkan Sebelum	Sisipkan kolom baru sebelum kolom yang dipilih.
Sisipkan Setelah	Sisipkan kolom baru setelah kolom yang dipilih.

Hapus
Pilih kolom, lalu hapus dengan mengklik Hapus.

Jenis Saran
Gunakan kotak dialog Sarankan Tipe Kolom untuk mengevaluasi data sampel dalam file dan untuk mendapatkan saran untuk jenis data dan panjang setiap kolom. Untuk informasi selengkapnya, lihat Sarankan Referensi UI Kotak Dialog Tipe Kolom.

Editor Pengelola Sambungan File Datar (Halaman Pratinjau)

Gunakan simpul Pratinjau dari kotak dialog Editor Pengelola Sambungan File Datar untuk melihat konten file sumber dalam format tabular.

Untuk mempelajari selengkapnya tentang manajer koneksi File Datar, lihat Pengelola Sambungan File Datar.

Opsi

Nama pengelola koneksi
Berikan nama unik untuk koneksi File Datar dalam alur kerja. Nama yang disediakan akan ditampilkan dalam SSIS Designer.

Deskripsi
Jelaskan koneksi. Sebagai praktik terbaik, jelaskan koneksi dalam hal tujuannya, untuk membuat paket dokumentasi mandiri dan lebih mudah dipertahankan.

Baris data yang akan dilewati
Tentukan berapa banyak baris yang akan dilewati di awal file datar.

Refresh
Lihat efek mengubah jumlah baris yang akan dilewati dengan mengklik Refresh. Tombol ini hanya terlihat setelah Anda mengubah opsi koneksi lainnya.

Baris pratinjau
Lihat data sampel dalam file datar, dibagi menjadi kolom dan baris sesuai dengan opsi yang telah Anda pilih.