Bagikan melalui

Tugas FTP

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

Tugas FTP mengunduh dan mengunggah file data dan mengelola direktori di server. Misalnya, paket dapat mengunduh file data dari server jarak jauh atau lokasi Internet sebagai bagian dari alur kerja paket Layanan Integrasi. Anda dapat menggunakan tugas FTP untuk tujuan berikut:

  • Menyalin direktori dan file data dari satu direktori ke direktori lain, sebelum atau sesudah memindahkan data, dan menerapkan transformasi ke data.

  • Masuk ke lokasi FTP sumber dan menyalin file atau paket ke direktori tujuan.

  • Mengunduh file dari lokasi FTP dan menerapkan transformasi ke data kolom sebelum memuat data ke dalam database.

Pada waktu proses, tugas FTP tersambung ke server dengan menggunakan manajer koneksi FTP. Manajer koneksi FTP dikonfigurasi secara terpisah dari tugas FTP, lalu dirujuk dalam tugas FTP. Manajer koneksi FTP mencakup pengaturan server, kredensial untuk mengakses server FTP, dan opsi seperti waktu habis dan jumlah percobaan ulang untuk menyambungkan ke server. Untuk informasi selengkapnya, lihat Pengelola Sambungan FTP.

Penting

Manajer koneksi FTP hanya mendukung autentikasi anonim dan autentikasi dasar. Ini tidak mendukung Autentikasi Windows.

Saat mengakses file lokal atau direktori lokal, tugas FTP menggunakan manajer koneksi file atau informasi jalur yang disimpan dalam variabel. Sebaliknya, saat mengakses file jarak jauh atau direktori jarak jauh, tugas FTP menggunakan jalur yang ditentukan langsung di server jarak jauh, seperti yang ditentukan dalam manajer koneksi FTP, atau informasi jalur yang disimpan dalam variabel. Untuk informasi selengkapnya, lihat Variabel File Pengelola Sambungan dan Integration Services (SSIS).

Ini berarti bahwa tugas FTP dapat menerima beberapa file dan menghapus beberapa file jarak jauh; tetapi tugas hanya dapat mengirim satu file dan hanya menghapus satu file lokal jika menggunakan manajer koneksi, karena manajer koneksi File hanya dapat mengakses satu file. Untuk mengakses beberapa file lokal, tugas FTP harus menggunakan variabel untuk memberikan informasi jalur. Misalnya, variabel yang berisi "C:\Test*. txt" menyediakan jalur yang mendukung penghapusan atau pengiriman semua file yang memiliki ekstensi .txt di direktori Uji.

Untuk mengirim beberapa file dan mengakses beberapa file dan direktori lokal, Anda juga dapat menjalankan tugas FTP beberapa kali dengan menyertakan tugas dalam Perulangan Foreach. Foreach Loop dapat menghitung seluruh file dalam direktori menggunakan enumerator Untuk Setiap File. Untuk informasi selengkapnya, lihat Kontainer Perulangan Foreach.

Tugas FTP mendukung karakter ?*di jalur. Ini memungkinkan tugas mengakses beberapa file. Namun, Anda hanya dapat menggunakan karakter kartubebas di bagian jalur yang menentukan nama file. Misalnya, C:\MyDirectory\*.txt adalah jalur yang valid, tetapi C:\*\MyText.txt tidak.

Operasi FTP dapat dikonfigurasi untuk menghentikan tugas Sistem File ketika operasi gagal, atau mentransfer file dalam mode ASCII. Operasi yang mengirim dan menerima salinan file dapat dikonfigurasi untuk menimpa file dan direktori tujuan.

Operasi FTP yang telah ditentukan sebelumnya

Tugas FTP mencakup serangkaian operasi yang telah ditentukan sebelumnya. Tabel berikut ini menjelaskan operasi ini.

Operasi Deskripsi
Mengirim file Mengirim file dari komputer lokal ke server FTP.
File yang diterima Menyimpan file dari server FTP ke komputer lokal.
Membuat direktori lokal Membuat folder pada komputer lokal.
Membuat direktori jarak jauh Membuat folder pada server FTP.
Menghapus direktori lokal Menghapus folder pada komputer lokal.
Menghapus direktori jarak jauh Menghapus folder pada server FTP.
Menghapus file lokal Menghapus file pada komputer lokal.
Menghapus file jarak jauh Menghapus file pada server FTP.

Entri Log Kustom Tersedia pada Tugas FTP

Tabel berikut mencantumkan entri log kustom untuk tugas FTP. Untuk informasi selengkapnya, lihat Pengelogan Integration Services (SSIS).

Entri log Deskripsi
FTPConnectingToServer Menunjukkan bahwa tugas memulai koneksi ke server FTP.
FTPOperation Melaporkan awal dan jenis operasi FTP yang dilakukan tugas.

Anda dapat mengatur properti melalui SSIS Designer atau secara terprogram.

Untuk informasi tentang cara mengatur properti ini di SSIS Designer, lihat Mengatur Properti Tugas atau Kontainer.

Untuk informasi selengkapnya tentang mengatur properti ini secara terprogram, lihat FtpTask.

Editor Tugas FTP (Halaman Umum)

Gunakan halaman Umum kotak dialog Editor Tugas FTP untuk menentukan manajer koneksi FTP yang tersambung ke server FTP yang berkomunikasi dengan tugas. Anda juga dapat memberi nama dan menjelaskan tugas FTP.

Opsi

FtpConnection
Pilih pengelola koneksi FTP yang ada, atau klik <Koneksi baru...> untuk membuat pengelola koneksi.

Penting

Manajer koneksi FTP hanya mendukung autentikasi anonim dan autentikasi dasar. Ini tidak mendukung Autentikasi Windows.

Topik Terkait: FTP Pengelola Sambungan, FTP Pengelola Sambungan Editor

StopOnFailure
Menunjukkan apakah tugas FTP berakhir jika operasi FTP gagal.

Nama
Berikan nama unik untuk tugas FTP. Nama ini digunakan sebagai label dalam ikon tugas.

Catatan

Nama tugas harus unik dalam paket.

Keterangan
Ketik deskripsi tugas FTP.

Editor Tugas FTP (Halaman Transfer File)

Gunakan halaman Transfer File dari kotak dialog Editor Tugas FTP untuk mengonfigurasi operasi FTP yang dilakukan tugas.

Opsi

IsRemotePathVariable
Menunjukkan apakah jalur jarak jauh disimpan dalam variabel. Properti ini memiliki opsi yang tercantum dalam tabel berikut.

Nilai Deskripsi
Benar Jalur tujuan disimpan dalam variabel. Memilih nilai menampilkan opsi dinamis, RemoteVariable.
Salah Jalur tujuan ditentukan dalam manajer koneksi File. Memilih nilai menampilkan opsi dinamis, RemotePath.

OverwriteFileAtDestination
Tentukan apakah file di tujuan dapat ditimpa.

IsLocalPathVariable
Menunjukkan apakah jalur lokal disimpan dalam variabel. Properti ini memiliki opsi yang tercantum dalam tabel berikut.

Nilai Deskripsi
Benar Jalur tujuan disimpan dalam variabel. Memilih nilai menampilkan opsi dinamis, LocalVariable.
Salah Jalur tujuan ditentukan dalam manajer koneksi File. Memilih nilai menampilkan opsi dinamis, LocalPath.

Operasi
Pilih operasi FTP yang akan dilakukan. Properti ini memiliki opsi yang tercantum dalam tabel berikut.

Nilai Deskripsi
Mengirim file Kirim file. Memilih nilai ini menampilkan opsi dinamis, LocalVariable, LocalPathRemoteVariable dan RemotePath.
Menerima file Menerima file. Memilih nilai ini menampilkan opsi dinamis, LocalVariable, LocalPathRemoteVariable dan RemotePath.
Membuat direktori lokal Buat direktori lokal. Memilih nilai ini menampilkan opsi dinamis, LocalVariable dan LocalPath.
Membuat direktori jarak jauh Buat direktori jarak jauh. Memilih nilai ini menampilkan opsi dinamis, RemoteVariable dan RemotePath.
Menghapus direktori lokal Menghapus direktori lokal. Memilih nilai ini menampilkan opsi dinamis, LocalVariable dan LocalPath.
Menghapus direktori jarak jauh Hapus direktori jarak jauh. Memilih nilai ini menampilkan opsi dinamis, RemoteVariable dan RemotePath.
Menghapus file lokal Hapus file lokal. Memilih nilai ini menampilkan opsi dinamis, LocalVariable dan LocalPath.
Menghapus file jarak jauh Hapus file jarak jauh. Memilih nilai ini menampilkan opsi dinamis, RemoteVariable dan RemotePath.

IsTransferASCII
Menunjukkan apakah file yang ditransfer ke dan dari server FTP jarak jauh harus ditransfer dalam mode ASCII.

Opsi Dinamis IsRemotePathVariable

IsRemotePathVariable = True

RemoteVariable
Pilih variabel yang ditentukan pengguna yang ada, atau klik <Variabel baru...> untuk membuat variabel yang ditentukan pengguna.

Topik Terkait:Variabel Integration Services (SSIS), Tambahkan Variabel

IsRemotePathVariable = False

RemotePath
Pilih pengelola koneksi FTP yang ada, atau klik <Koneksi baru...> untuk membuat pengelola koneksi.

Topik Terkait:FTP Pengelola Sambungan, FTP Pengelola Sambungan Editor

Opsi Dinamis IsLocalPathVariable

IsLocalPathVariable = True

LocalVariable
Pilih variabel yang ditentukan pengguna yang sudah ada, atau klik <Variabel baru...> untuk membuat variabel.

Topik Terkait:Variabel Integration Services (SSIS), Tambahkan Variabel

IsLocalPathVariable = False

LocalPath
Pilih pengelola koneksi File yang sudah ada, atau klik <Koneksi baru...> untuk membuat pengelola koneksi.

Topik Terkait: Pengelola Sambungan File Datar

Lihat Juga

Tugas Layanan Integrasi
Alur Kontrol

  • Last updated on