ZADANIE FTP
Dotyczy:
sql Server SSIS Integration Runtime w usłudze Azure Data Factory
Zadanie FTP pobiera i przekazuje pliki danych oraz zarządza katalogami na serwerach. Na przykład pakiet może pobierać pliki danych z serwera zdalnego lub lokalizacji internetowej w ramach przepływu pracy pakietu usług Integration Services. Do następujących celów można użyć zadania FTP:
Kopiowanie katalogów i plików danych z jednego katalogu do innego, przed przeniesieniem lub po przeniesieniu danych i zastosowanie przekształceń do danych.
Logowanie się do źródłowej lokalizacji FTP i kopiowanie plików lub pakietów do katalogu docelowego.
Pobieranie plików z lokalizacji FTP i stosowanie przekształceń do danych kolumn przed załadowaniem danych do bazy danych.
W czasie wykonywania zadanie FTP łączy się z serwerem przy użyciu menedżera połączeń FTP. Menedżer połączeń FTP jest konfigurowany oddzielnie od zadania FTP, a następnie jest przywołyny w zadaniu FTP. Menedżer połączeń FTP zawiera ustawienia serwera, poświadczenia dostępu do serwera FTP oraz opcje, takie jak limit czasu i liczba ponownych prób nawiązania połączenia z serwerem. Aby uzyskać więcej informacji, zobacz Menedżer Połączeń FTP.
Ważny
Menedżer połączeń FTP obsługuje tylko uwierzytelnianie anonimowe i uwierzytelnianie podstawowe. Nie obsługuje uwierzytelniania systemu Windows.
Podczas uzyskiwania dostępu do pliku lokalnego lub katalogu lokalnego zadanie FTP używa menedżera połączeń plików lub informacji o ścieżce przechowywanych w zmiennej. Natomiast podczas uzyskiwania dostępu do pliku zdalnego lub katalogu zdalnego zadanie FTP używa bezpośrednio określonej ścieżki na serwerze zdalnym, jak określono w Menedżerze połączeń FTP lub informacje o ścieżce przechowywane w zmiennej. Aby uzyskać więcej informacji, zobacz File Connection Manager oraz Integration Services (SSIS) Variables.
Oznacza to, że zadanie FTP może odbierać wiele plików i usuwać wiele plików zdalnych; ale zadanie może wysyłać tylko jeden plik i usuwać tylko jeden plik lokalny, jeśli używa menedżera połączeń, ponieważ menedżer połączeń plików może uzyskać dostęp tylko do jednego pliku. Aby uzyskać dostęp do wielu plików lokalnych, zadanie FTP musi użyć zmiennej, aby podać informacje o ścieżce. Na przykład zmienna zawierająca "C:\Test*.txt" udostępnia ścieżkę, która obsługuje usuwanie lub wysyłanie wszystkich plików, które mają rozszerzenie .txt w katalogu Test.
Aby wysłać wiele plików i uzyskać dostęp do wielu lokalnych plików i katalogów, można również wykonać zadanie FTP wiele razy, uwzględniając zadanie w pętli Foreach. Pętla Foreach może wyliczać pliki w katalogu przy użyciu enumeratora Dla Każdego Pliku. Aby uzyskać więcej informacji, zobacz Foreach Loop Container.
Zadanie FTP obsługuje ? i * symbole wieloznaczne w ścieżkach. Dzięki temu zadanie będzie uzyskiwać dostęp do wielu plików. Można jednak użyć symboli wieloznacznych tylko w części ścieżki, która określa nazwę pliku. Na przykład C:\MyDirectory\*.txt jest prawidłową ścieżką, ale C:\*\MyText.txt nie jest.
Operacje FTP można skonfigurować tak, aby zatrzymać zadanie systemu plików, gdy operacja zakończy się niepowodzeniem, lub aby przenosić pliki w trybie ASCII. Operacje wysyłania i odbierania kopii plików można skonfigurować do zastępowania plików docelowych i katalogów.
Wstępnie zdefiniowane operacje FTP
Zadanie FTP zawiera wstępnie zdefiniowany zestaw operacji. W poniższej tabeli opisano te operacje.
| Operacja | Opis |
|---|---|
| Wysyłanie plików | Wysyła plik z komputera lokalnego do serwera FTP. |
| Odbieranie plików | Zapisuje plik z serwera FTP na komputerze lokalnym. |
| Tworzenie katalogu lokalnego | Tworzy folder na komputerze lokalnym. |
| Tworzenie katalogu zdalnego | Tworzy folder na serwerze FTP. |
| Usuwanie katalogu lokalnego | Usuwa folder (lub katalog) na lokalnym komputerze. |
| Usuwanie katalogu zdalnego | Usuwa katalog na serwerze FTP. |
| Usuwanie plików lokalnych | Usuwa plik na komputerze lokalnym. |
| Usuwanie plików zdalnych | Usuwa plik na serwerze FTP. |
Niestandardowe wpisy dziennika dostępne w zadaniu FTP
W poniższej tabeli wymieniono niestandardowe wpisy dziennika dla zadania FTP. Więcej informacji znajdziesz w Integration Services (SSIS) Logging.
| Wpis dziennika | Opis |
|---|---|
| FTPŁączenieZSerwerem | Wskazuje, że zadanie zainicjowało połączenie z serwerem FTP. |
| FTPOperation | Raportuje początek i typ operacji FTP, którą wykonuje zadanie. |
Powiązane zadania
Właściwości można ustawić za pomocą projektanta usług SSIS lub programowo.
Aby uzyskać informacje o sposobie ustawiania tych właściwości w projektancie usług SSIS, zobacz Ustawianie właściwości zadania lub kontenera.
Aby uzyskać więcej informacji na temat programowego ustawiania tych właściwości, zobacz FtpTask.
Edytor zadań FTP (strona ogólna)
Użyj zakładki Ogólne w oknie dialogowym edytora zadań FTP , aby określić menedżera połączeń FTP, który łączy się z serwerem FTP, z którym komunikuje się zadanie. Możesz również nazwać i opisać zadanie FTP.
Opcje
FtpConnection
Wybierz istniejącego menedżera połączeń FTP lub kliknij <Nowe połączenie...>, aby utworzyć menedżera połączeń.
Ważny
Menedżer połączeń FTP obsługuje tylko uwierzytelnianie anonimowe i uwierzytelnianie podstawowe. Nie obsługuje uwierzytelniania systemu Windows.
Tematy pokrewne: Menedżer połączeń FTP, Edytor menedżera połączeń FTP
ZatrzymajPrzyNiepowodzeniu
Określ, czy zadanie FTP kończy się, jeśli operacja FTP zakończy się niepowodzeniem.
nazwa
Podaj unikatową nazwę zadania FTP. Ta nazwa jest używana jako etykieta w ikonie zadania.
Notatka
Nazwy zadań muszą być unikatowe w pakiecie.
opis
Wpisz opis zadania FTP.
Edytor zadań FTP (strona transferu plików)
Użyj zakładki transferu plików w oknie dialogowym edytora zadań FTP , aby skonfigurować operację FTP wykonywaną przez zadanie.
Opcje
IsRemotePathVariable
Określ, czy ścieżka zdalna jest przechowywana w zmiennej. Ta właściwość zawiera opcje wymienione w poniższej tabeli.
| Wartość | Opis |
|---|---|
| Prawda | Ścieżka docelowa jest przechowywana w zmiennej. Wybranie wartości powoduje wyświetlenie opcji dynamicznej RemoteVariable. |
| fałsz | Ścieżka docelowa jest określona w Menedżerze połączeń plików. Wybranie wartości powoduje wyświetlenie opcji dynamicznej RemotePath. |
NadpiszPlikWDestynacji
Określ, czy plik w miejscu docelowym może zostać zastąpiony.
IsLocalPathVariable
Określ, czy ścieżka lokalna jest przechowywana w zmiennej. Ta właściwość zawiera opcje wymienione w poniższej tabeli.
| Wartość | Opis |
|---|---|
| Prawda | Ścieżka docelowa jest przechowywana w zmiennej. Wybranie wartości powoduje wyświetlenie opcji dynamicznej LocalVariable. |
| false | Ścieżka docelowa jest określona w Menedżerze połączeń plików. Wybranie wartości powoduje wyświetlenie opcji dynamicznej LocalPath. |
operacja
Wybierz operację FTP do wykonania. Ta właściwość zawiera opcje wymienione w poniższej tabeli.
| Wartość | Opis |
|---|---|
| Wysyłanie plików | Wysyłanie plików. Wybranie tej wartości powoduje wyświetlenie opcji dynamicznych, localVariable, LocalPathRemoteVariable i RemotePath. |
| Odbierz pliki | Odbieranie plików. Wybranie tej wartości powoduje wyświetlenie opcji dynamicznych, localVariable, LocalPathRemoteVariable i RemotePath. |
| Tworzenie katalogu lokalnego | Utwórz katalog lokalny. Wybranie tej wartości spowoduje wyświetlenie opcji dynamicznych, LocalVariable i LocalPath. |
| Tworzenie katalogu zdalnego | Utwórz katalog zdalny. Wybranie tej wartości powoduje wyświetlenie opcji dynamicznych, remoteVariable i RemotePath. |
| Usuń katalog lokalny | Usuwa katalog lokalny. Wybranie tej wartości spowoduje wyświetlenie opcji dynamicznych, LocalVariable, oraz LocalPath. |
| Usuwanie katalogu zdalnego | Usuń katalog zdalny. Wybranie tej wartości powoduje wyświetlenie opcji dynamicznych, remoteVariable i RemotePath. |
| Usuwanie plików lokalnych | Usuń pliki lokalne. Wybranie tej wartości spowoduje wyświetlenie dynamicznych opcji, LocalVariable i LocalPath . |
| Usuwanie plików zdalnych | Usuń pliki zdalne. Wybranie tej wartości powoduje wyświetlenie opcji dynamicznych, remoteVariable i RemotePath. |
IsTransferASCII
Określ, czy pliki przesyłane do i z zdalnego serwera FTP powinny być przesyłane w trybie ASCII.
IsRemotePathVariable, opcje dynamiczne
IsRemotePathVariable = Prawda
remoteVariable
Wybierz istniejącą zmienną zdefiniowaną przez użytkownika lub kliknij <Nowa zmienna...>, aby utworzyć zmienną zdefiniowaną przez użytkownika.
Tematy pokrewne:zmienne usług Integration Services (SSIS), Dodaj zmienną
IsRemotePathVariable = False
RemotePath
Wybierz istniejącego menedżera połączeń FTP lub kliknij <Nowe połączenie...>, aby utworzyć menedżera połączeń.
Tematy pokrewne:Menedżer połączeń FTP, Edytor menedżera połączeń FTP
IsLocalPathVariable, opcje dynamiczne
IsLocalPathVariable = True
LocalVariable
Wybierz istniejącą zmienną zdefiniowaną przez użytkownika lub kliknij <Nowa zmienna...>, aby utworzyć zmienną.
Tematy pokrewne:Zmienne programu Integration Services (SSIS), Dodaj zmienną
IsLocalPathVariable = Fałsz
LocalPath
Wybierz istniejącego Menedżera połączeń plików lub kliknij przycisk <Nowe połączenie...>, aby utworzyć menedżera połączeń.
tematy pokrewne: Menedżer połączeń plików prostych