Bagikan melalui

Tugas Sistem File

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

Tugas Sistem File melakukan operasi pada file dan direktori dalam sistem file. Misalnya, dengan menggunakan tugas Sistem File, paket dapat membuat, memindahkan, atau menghapus direktori dan file. Anda juga dapat menggunakan tugas Sistem File untuk mengatur atribut pada file dan direktori. Misalnya, tugas Sistem File dapat membuat file tersembunyi atau baca-saja.

Semua operasi tugas Sistem File menggunakan sumber, yang dapat berupa file atau direktori. Misalnya, file yang disalin tugas atau direktori yang dihapusnya adalah sumber. Sumber dapat ditentukan dengan menggunakan manajer koneksi File yang menunjuk ke direktori atau file atau dengan memberikan nama variabel yang berisi jalur sumber. Untuk informasi selengkapnya, lihat Variabel File Pengelola Sambungan dan Integration Services (SSIS).

Operasi yang menyalin dan memindahkan file dan direktori serta mengganti nama file menggunakan tujuan dan sumber. Tujuan ditentukan dengan menggunakan manajer koneksi File atau variabel. Operasi tugas sistem file dapat dikonfigurasi untuk mengizinkan penimpaan file dan direktori tujuan. Operasi yang membuat direktori baru dapat dikonfigurasi untuk menggunakan direktori yang ada yang memiliki nama yang ditentukan alih-alih gagal ketika direktori sudah ada.

Operasi Sistem File yang telah ditentukan sebelumnya

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

Operasi Deskripsi
Salin direktori Menyalin folder dari satu lokasi ke lokasi lainnya.
Salin file Menyalin file dari satu lokasi ke lokasi lainnya.
Membuat direktori Membuat folder di lokasi tertentu.
Hapus direktori Menghapus folder di lokasi tertentu.
Menghapus konten direktori Menghapus semua file dan folder dalam folder.
Hapus file Menghapus file di lokasi tertentu.
Pindahkan direktori Memindahkan folder dari satu lokasi ke lokasi lainnya.
Pindahkan file Memindahkan file dari satu lokasi ke lokasi lainnya.
Ganti nama file Mengganti nama file di lokasi tertentu.
Mengatur atribut Mengatur atribut pada file dan folder. Atribut termasuk Arsip, Tersembunyi, Normal, ReadOnly, dan Sistem. Normal adalah kurangnya atribut, dan tidak dapat dikombinasikan dengan atribut lain. Semua atribut lain dapat digunakan dalam kombinasi.

Tugas Sistem File beroperasi pada satu file atau direktori. Oleh karena itu, tugas ini tidak mendukung penggunaan karakter kartubebas untuk melakukan operasi yang sama pada beberapa file. Agar tugas Sistem File mengulangi operasi pada beberapa file atau direktori, letakkan tugas Sistem File dalam kontainer Foreach Loop, seperti yang dijelaskan dalam langkah-langkah berikut:

  • Konfigurasikan kontainer Foreach Loop Pada halaman Koleksi Editor Perulangan Foreach, atur enumerator ke Enumerator File Foreach dan masukkan ekspresi kartubebas sebagai konfigurasi enumerator untuk File. Pada halaman Pemetaan Variabel Editor Perulangan Foreach, petakan variabel yang ingin Anda gunakan untuk meneruskan nama file satu per satu ke tugas Sistem File.

  • Tambahkan dan konfigurasikan tugas Sistem File Tambahkan tugas Sistem File ke kontainer Foreach Loop. Pada halaman Umum Editor Tugas Sistem File, atur properti SourceVariable atau DestinationVariable ke variabel yang Anda tentukan dalam kontainer Foreach Loop.

Entri Log Kustom Tersedia pada Tugas Sistem File

Tabel berikut ini menjelaskan entri log kustom untuk tugas Sistem File. Untuk informasi selengkapnya, lihat Pengelogan Integration Services (SSIS).

Entri log Deskripsi
FileSystemOperation Melaporkan operasi yang dilakukan tugas. Entri log ditulis ketika operasi sistem file dimulai dan menyertakan informasi tentang sumber dan tujuan.

Mengonfigurasi Tugas Sistem File

Anda dapat mengatur properti melalui SSIS Designer atau secara terprogram.

Untuk informasi selengkapnya tentang properti yang bisa Anda atur di SSIS Designer, lihat topik berikut ini:

Untuk informasi selengkapnya tentang cara mengatur properti ini di SSIS Designer, lihat topik berikut ini:

Untuk informasi selengkapnya tentang cara mengatur properti ini secara terprogram, lihat topik berikut ini:

Integration Services mencakup tugas yang mengunduh dan mengunggah file data dan mengelola direktori di server. Untuk informasi selengkapnya, lihat Tugas FTP.

Editor Tugas Sistem File (Halaman Umum)

Gunakan halaman Umum dialog Editor Tugas Sistem File untuk mengonfigurasi operasi sistem file yang dilakukan tugas.

Anda harus menentukan manajer koneksi sumber dan tujuan dengan mengatur properti SourceConnection dan DestinationConnection. Anda dapat memberikan nama manajer koneksi File yang menunjuk ke file yang digunakan tugas sebagai sumber atau tujuan, atau jika jalur file disimpan dalam variabel, Anda dapat memberikan nama variabel. Untuk menggunakan variabel untuk menyimpan jalur file, Anda harus mengatur terlebih dahulu opsi IsSourcePathVariable untuk koneksi sumber dan opsi IsDestinationPatheVariable untuk koneksi tujuan ke True. Anda kemudian dapat memilih variabel sistem atau yang ditentukan pengguna yang ada untuk digunakan, atau Anda dapat membuat variabel baru. Dalam kotak dialog Tambahkan Variabel , Anda dapat mengonfigurasi dan menentukan cakupan variabel. Cakupan harus berupa tugas Sistem File atau kontainer induk. Untuk informasi selengkapnya, lihat Variabel Integration Services (SSIS) dan Gunakan Variabel dalam Paket.

Catatan

Untuk mengambil alih variabel yang Anda pilih untuk properti SourceConnection dan DestinationConnection , masukkan ekspresi untuk properti Sumber dan Tujuan . Anda memasukkan ekspresi pada halaman Ekspresi Editor Tugas Sistem File. Misalnya, untuk mengatur jalur file yang digunakan tugas sebagai tujuan, Anda mungkin ingin menggunakan variabel A dalam kondisi tertentu dan menggunakan variabel B dalam kondisi lain.

Catatan

Tugas Sistem File beroperasi pada satu file atau direktori. Oleh karena itu, tugas ini tidak mendukung penggunaan karakter kartubebas untuk melakukan operasi yang sama pada beberapa file atau direktori. Agar tugas Sistem File mengulangi operasi pada beberapa file atau direktori, letakkan tugas Sistem File dalam kontainer Foreach Loop. Untuk informasi selengkapnya, lihat Tugas Sistem File.

Anda dapat menggunakan ekspresi untuk menggunakan variabel yang berbeda untuk

Opsi

IsDestinationPathVariable
Menunjukkan apakah jalur tujuan disimpan dalam variabel. Properti ini memiliki opsi yang tercantum dalam tabel berikut.

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

OverwriteDestination
Tentukan apakah operasi dapat menimpa file di direktori tujuan.

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

Catatan

Nama tugas harus unik dalam paket.

Keterangan
Ketik deskripsi tugas Sistem File.

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

Nilai Deskripsi
Salin direktori Salin direktori. Memilih nilai ini menampilkan opsi dinamis untuk sumber dan tujuan.
Salin file Menyalin file. Memilih nilai ini menampilkan opsi dinamis untuk sumber dan tujuan.
Membuat direktori Membuat direktori. Memilih nilai ini menampilkan opsi dinamis untuk sumber dan direktori tujuan.
Menghapus direktori Menghapus direktori. Memilih nilai ini menampilkan opsi dinamis untuk sumber.
Menghapus konten direktori Menghapus konten direktori. Memilih nilai ini menampilkan opsi dinamis untuk sumber.
Hapus file Menghapus file. Memilih nilai ini menampilkan opsi dinamis untuk sumber.
Pindahkan direktori Memindahkan direktori. Memilih nilai ini menampilkan opsi dinamis untuk sumber dan tujuan.
Pindahkan file Memindahkan file. Memilih nilai ini menampilkan opsi dinamis untuk sumber dan tujuan. Saat memindahkan file, jangan sertakan nama file di jalur direktori yang Anda sediakan sebagai tujuan.
Ganti nama file Mengganti nama file. Memilih nilai ini menampilkan opsi dinamis untuk sumber dan tujuan. Saat mengganti nama file, sertakan nama file baru di jalur direktori yang Anda sediakan untuk tujuan.
Mengatur atribut Atur atribut file atau direktori. Memilih nilai ini menampilkan opsi dinamis untuk sumber dan operasi.

IsSourcePathVariable
Menunjukkan apakah jalur tujuan disimpan dalam variabel. Properti ini memiliki opsi yang tercantum dalam tabel berikut.

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

Opsi Dinamis IsDestinationPathVariable

IsDestinationPathVariable = True

DestinationVariable
Pilih nama variabel dalam daftar, atau klik <Variabel baru...> untuk membuat variabel baru.

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

IsDestinationPathVariable = False

DestinationConnection
Pilih Manajer koneksi file dalam daftar, atau klik <Koneksi baru...> untuk membuat pengelola koneksi baru.

Topik Terkait:File Pengelola Sambungan, File Pengelola Sambungan Editor

Opsi Dinamis IsSourcePathVariable

IsSourcePathVariable = True

SourceVariable
Pilih nama variabel dalam daftar, atau klik <Variabel baru...> untuk membuat variabel baru.

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

IsSourcePathVariable = False

SourceConnection
Pilih Manajer koneksi file dalam daftar, atau klik <Koneksi baru...> untuk membuat pengelola koneksi baru.

Topik Terkait:Pengelola Sambungan File

Opsi Dinamis Operasi

Operasi = Atur Atribut

Tersembunyi
Menunjukkan apakah file atau direktori terlihat.

Hanya Baca
Menunjukkan apakah file bersifat baca-saja.

Mengarsipkan
Menunjukkan apakah file atau direktori siap untuk pengarsipan.

Log
Menunjukkan apakah file tersebut adalah file sistem operasi.

Operasi = Buat direktori

GunakanDirektoriJikaAda
Menunjukkan apakah operasi Buat direktori menggunakan direktori yang ada dengan nama yang ditentukan alih-alih membuat direktori baru.

Lihat Juga

Tugas Layanan Integrasi
Alur Kontrol