Udostępnij przez

Menedżer połączeń plików prostych

Dotyczy:SQL Server SSIS Integration Runtime w ramach usługi Azure Data Factory

Menedżer połączeń plików prostych umożliwia pakietowi dostęp do danych w pliku prostym. Na przykład źródło i miejsce docelowe pliku prostego mogą używać menedżerów połączeń plików prostych do wyodrębniania i ładowania danych.

Menedżer połączeń plików prostych może uzyskać dostęp tylko do jednego pliku. Aby odwołać się do wielu plików, należy użyć Menedżera połączeń z wieloma plikami flat files zamiast menedżera połączeń Flat File. Aby uzyskać więcej informacji, zobacz Menedżer połączeń wielu plików prostych.

Długość kolumny

Domyślnie menedżer połączeń plików prostych ustawia długość kolumn parametrów na 50 znaków. W oknie dialogowym Edytor menedżera połączeń plików prostych można ocenić przykładowe dane i automatycznie zmienić rozmiar długości tych kolumn, aby zapobiec obcięciu danych lub nadmiarowej szerokości kolumny. Ponadto, o ile długość kolumny nie zostanie później zmieniona w źródle pliku prostego lub przekształcenia, długość kolumny ciągu pozostaje taka sama w całym przepływie danych. Jeśli te kolumny ciągów są mapowane na kolumny docelowe, które są węższe, ostrzeżenia są wyświetlane w interfejsie użytkownika. Ponadto w czasie wykonywania mogą wystąpić błędy spowodowane obcięciem danych. Aby uniknąć błędów lub obcinania, można zmienić rozmiar kolumn tak, aby były zgodne z kolumnami docelowymi w Menedżerze połączeń plików prostych, źródle pliku prostego lub przekształcenia. Aby zmodyfikować długość kolumn wyjściowych, należy ustawić właściwość Length kolumny wyjściowej na karcie Właściwości wejściowe i wyjściowe w oknie dialogowym Edytor zaawansowany .

W przypadku aktualizowania długości kolumn w Menedżerze połączeń plików prostych po dodaniu i skonfigurowaniu źródła pliku prostego korzystającego z menedżera połączeń nie trzeba ręcznie zmieniać rozmiaru kolumn wyjściowych w źródle pliku prostego. Po otwarciu okna dialogowego Źródło pliku prostego źródło pliku prostego udostępnia opcję synchronizowania metadanych kolumny.

Konfiguracja Menedżera połączeń plików prostych

Po dodaniu menedżera połączeń plików prostych do pakietu usługi SQL Server Integration Services tworzy menedżera połączeń, który będzie rozpoznawany jako połączenie pliku prostego w czasie wykonywania, ustawia właściwości połączenia pliku prostego i dodaje menedżera połączeń plików prostych do kolekcji Połączenia pakietu.

Właściwość ConnectionManagerType menedżera połączeń jest ustawiona na FLATFILE.

Domyślnie menedżer połączeń plików prostych zawsze sprawdza ogranicznik wiersza w danych bez cudzysłów i uruchamia nowy wiersz po znalezieniu ogranicznika wiersza. Dzięki temu menedżer połączeń może poprawnie analizować pliki z wierszami, w których brakuje pól kolumn.

W niektórych przypadkach wyłączenie tej funkcji może poprawić wydajność pakietu. Tę funkcję można wyłączyć, ustawiając właściwość Menedżera połączeń plików prostych, AlwaysCheckForRowDelimiters, na False.

Menedżer połączeń plików prostych można skonfigurować w następujący sposób:

  • Określ plik, ustawienia regionalne i stronę kodów do użycia. Ustawienia regionalne służą do interpretowania danych zależnych od ustawień regionalnych, takich jak daty, a strona kodowania służy do konwertowania ciągów znaków na Unicode.

  • Określ format pliku. Można użyć formatu rozdzielanego, stałej szerokości lub poszarpanego prawego.

  • Określ ograniczniki wiersza nagłówka, wiersza danych i kolumny. Ograniczniki kolumn można ustawić na poziomie pliku i zastąpić na poziomie kolumny.

  • Określ, czy pierwszy wiersz w pliku zawiera nazwy kolumn.

  • Określ znak kwalifikatora tekstu. Każdą kolumnę można skonfigurować do rozpoznawania kwalifikatora tekstu.

    Użycie znaku kwalifikatora w celu osadzenia znaku kwalifikatora w kwalifikowanych parametrach jest obsługiwane przez Menedżera połączeń plików prostych. Podwójne wystąpienie tekstowego kwalifikatora jest interpretowane jako literał, pojedyncze wystąpienie tego samego ciągu. Na przykład, jeśli znacznik tekstu jest pojedynczym cudzysłowem, a dane wejściowe to 'abc', 'def', 'g'hi', to dane wyjściowe będą jako abc, def, g'hi. Jednak wystąpienie kwalifikatora osadzonego w kwalifikowanym ciągu powoduje niepowodzenie źródła pliku prostego z powodu błędu DTS_E_PRIMEOUTPUTFAILED.

  • Ustaw właściwości, takie jak nazwa, typ danych i maksymalna szerokość poszczególnych kolumn.

Właściwość ConnectionString dla menedżera połączeń plików prostych można ustawić, określając wyrażenie w oknie Właściwości narzędzi SQL Server Data Tools (SSDT). Aby uniknąć błędu weryfikacji, wykonaj następujące czynności.

  • Gdy używasz wyrażenia do określania pliku, dodaj ścieżkę pliku w polu Nazwa pliku w Edytorze Menedżera połączeń plików prostych.

  • Ustaw właściwość DelayValidation w Menedżerze połączeń plików prostych na wartość True.

Możesz użyć wyrażenia, aby utworzyć nazwę pliku w czasie wykonywania, korzystając z Menedżera połączeń plików płaskich z miejscem docelowym pliku płaskiego.

Właściwości można ustawić za pomocą projektanta usług SSIS lub programowo.

Aby uzyskać informacje na temat programowego konfigurowania menedżera połączeń, zobacz ConnectionManager i Programowe dodawanie połączeń.

Edytor Menedżera połączeń plików prostych (strona ogólna)

Użyj strony Ogólne okna dialogowego Edytora menedżera połączeń plików prostych , aby wybrać plik i format danych. Połączenie pliku płaskiego umożliwia pakietowi połączenie z plikiem tekstowym.

Aby dowiedzieć się więcej o menedżerze połączeń plików prostych, zobacz Menedżer połączeń plików prostych.

Opcje

Nazwa menedżera połączeń
Podaj unikatową nazwę połączenia pliku płaskiego w przepływie pracy. Nazwa, którą podano, będzie wyświetlana w SSIS Designer.

Opis
Opisz połączenie. Najlepszym rozwiązaniem jest opisanie połączenia pod względem jego celu, aby pakiety samodzielnie dokumentować i ułatwić konserwację.

Nazwa pliku
Wpisz ścieżkę i nazwę pliku, która ma być używana w połączeniu pliku prostego.

Przeglądaj
Znajdź nazwę pliku do wykorzystania w połączeniu pliku płaskiego.

ustawień regionalnych
Określ ustawienia regionalne, aby zapewnić informacje specyficzne dla języka dotyczące składania zamówień oraz formatów daty i godziny.

Unicode
Wskaż, czy należy używać formatu Unicode. Jeśli używasz formatu Unicode, nie można określić strony kodowej.

strona kodowa
Określ stronę kodową dla tekstu innego niż Unicode.

Format
Określ, czy plik używa formatowania o stałej szerokości, rozdzielanego czy poszarpanego prawego formatowania.

Wartość Opis
Odgraniczone Kolumny są rozdzielane ogranicznikami określonymi na stronie Kolumny .
Stała szerokość Kolumny mają stałą szerokość.
Justowanie do lewej Poszarpane prawe pliki to pliki, w których każda kolumna ma stałą szerokość, z wyjątkiem ostatniej kolumny. Jest ograniczony przez ogranicznik wierszy.

Kwalifikator tekstu
Określ kwalifikator tekstu do użycia. Można na przykład określić, że pola tekstowe są ujęte w znaki cudzysłowu.

Uwaga / Notatka

Po wybraniu kwalifikatora tekstu nie można ponownie wybrać opcji Brak . Wpisz Brak , aby usunąć zaznaczenie kwalifikatora tekstu.

Ogranicznik wiersza nagłówkowego
Wybierz z listy ograniczników dla wierszy nagłówka lub wprowadź tekst ogranicznika.

Wartość Opis
{CR}{LF} Wiersz nagłówka jest rozdzielany kombinacją powrotu karetki i przejścia do nowej linii.
{CR} Wiersz nagłówka jest rozdzielany zwrotem karetki.
{LF} Wiersz nagłówka jest rozdzielany przez źródło danych wiersza.
Średnik {;} Wiersz nagłówka jest rozdzielany średnikiem.
Dwukropek {:} Wiersz nagłówka jest rozdzielany dwukropkiem.
Przecinek {,} Wiersz nagłówka jest rozdzielany przecinkami.
Karta {t} Wiersz nagłówka jest rozdzielany przez tabulator.
Pionowy pasek {|} Wiersz nagłówka jest rozdzielany pionowym paskiem.

Wiersze nagłówka do pominięcia
Określ liczbę wierszy nagłówka lub początkowych wierszy danych, które mają być pomijane, jeśli istnieją.

Nazwy kolumn w pierwszym wierszu danych
Określ, czy nazwy kolumn mają być oczekiwane, czy podane w pierwszym wierszu danych.

Edytor Menedżera połączeń plików prostych (strona kolumn)

Użyj strony Kolumny okna dialogowego Edytora menedżera połączeń plików prostych , aby określić informacje o wierszu i kolumnie oraz wyświetlić podgląd pliku.

Aby dowiedzieć się więcej o menedżerze połączeń plików prostych, zobacz Menedżer połączeń plików prostych.

Opcje statyczne

Nazwa menedżera połączeń
Podaj unikatową nazwę połączenia z plikiem płaskim w przepływie pracy. Nazwa, którą podano, będzie wyświetlana w SSIS Designer.

Opis
Opisz połączenie. Najlepszym rozwiązaniem jest opisanie połączenia pod względem jego celu, aby pakiety samodzielnie dokumentować i ułatwić konserwację.

Opcje dynamiczne formatu płaskiego pliku

Format = rozdzielany

Ogranicznik wierszy
Wybierz z listy dostępnych ograniczników wierszy lub wprowadź tekst ogranicznika.

Wartość Opis
{CR}{LF} Wiersze są rozdzielane kombinacją powrotu karetki i znaku nowej linii.
{CR} Wiersze są rozdzielane zwrotem karetki.
{LF} Wiersze są rozdzielane przez źródło danych wierszy.
Średnik {;} Wiersze są rozdzielane średnikami.
Dwukropek {:} Wiersze są rozdzielane dwukropkiem.
Przecinek {,} Wiersze są rozdzielane przecinkami.
Karta {t} Wiersze są oddzielane tabulatorem.
Pionowy pasek {|} Wiersze są rozdzielane pionowym paskiem.

Ogranicznik kolumn
Wybierz z listy dostępnych ograniczników kolumn lub wprowadź tekst ogranicznika.

Wartość Opis
{CR}{LF} Kolumny są rozdzielane kombinacją zestawienia powrotnego karetki.
{CR} Kolumny są rozdzielane przez znak końca linii.
{LF} Kolumny są rozdzielane za pomocą znaku końca linii.
Średnik {;} Kolumny są rozdzielane średnikami.
Dwukropek {:} Kolumny są rozdzielane dwukropkiem.
Przecinek {,} Kolumny są rozdzielane przecinkami.
Karta {t} Kolumny są rozdzielane tabulatorem.
Pionowy pasek {|} Kolumny są rozdzielane pionowym paskiem.

Odświeżyć
Wyświetl efekt zmiany ograniczników, aby pominąć, klikając pozycję Odśwież. Ten przycisk staje się widoczny tylko po zmianie innych opcji połączenia.

Podgląd wierszy
Wyświetl przykładowe dane w pliku płaskim podzielone na kolumny i wiersze przy użyciu wybranych opcji.

Resetuj kolumny
Kliknij Resetuj kolumny, aby usunąć wszystkie kolumny poza oryginalnymi.

Format = stała szerokość

czcionki
Wybierz czcionkę, w której mają być wyświetlane dane podglądu.

Kolumny danych źródłowych
Dopasuj szerokość wiersza, przesuwając pionowy czerwony znacznik wiersza i dopasowując szerokość kolumn, klikając linijkę w górnej części okna podglądu

Szerokość wiersza
Określ długość wiersza przed dodaniem ograniczników dla poszczególnych kolumn. Możesz też przeciągnąć pionową czerwoną linię w oknie podglądu, aby oznaczyć koniec wiersza. Wartość szerokości wiersza jest automatycznie aktualizowana.

Resetuj kolumny
Kliknij Resetuj kolumny, aby usunąć wszystkie kolumny poza oryginalnymi.

Format = Poszarpane z prawej

Uwaga / Notatka

Poszarpane prawe pliki to pliki, w których każda kolumna ma stałą szerokość, z wyjątkiem ostatniej kolumny. Jest ograniczony przez ogranicznik wierszy.

czcionki
Wybierz czcionkę, w której mają być wyświetlane dane podglądu.

Kolumny danych źródłowych
Dopasuj szerokość wiersza, przesuwając pionowy czerwony znacznik wiersza i dopasowując szerokość kolumn, klikając linijkę w górnej części okna podglądu

Ogranicznik wierszy
Wybierz z listy dostępnych ograniczników wierszy lub wprowadź tekst ogranicznika.

Wartość Opis
{CR}{LF} Wiersze są rozdzielane kombinacją powrotu karetki i znaku nowej linii.
{CR} Wiersze są rozdzielane zwrotem karetki.
{LF} Wiersze są rozdzielane przez źródło danych wierszy.
Średnik {;} Wiersze są rozdzielane średnikami.
Dwukropek {:} Wiersze są rozdzielane dwukropkiem.
Przecinek {,} Wiersze są rozdzielane przecinkami.
Karta {t} Wiersze są oddzielane tabulatorem.
Pionowy pasek {|} Wiersze są rozdzielane pionowym paskiem.

Resetuj kolumny
Kliknij Resetuj kolumny, aby usunąć wszystkie kolumny poza oryginalnymi.

Edytor Menedżera połączeń plików prostych (strona zaawansowana)

Użyj strony Zaawansowane okna dialogowego Edytora menedżera połączeń plików prostych, aby ustawić właściwości określające sposób, w jaki usługi Integration Services odczytują i zapisują dane w plikach prostych. Możesz zmienić nazwy kolumn w pliku płaskim i ustawić właściwości, które zawierają typ danych i ograniczniki dla każdej kolumny w pliku.

Domyślnie długość kolumn ciągu wynosi 50 znaków. Możesz zmienić rozmiar długości tych kolumn, aby zapobiec obcięciu danych lub nadmiarowej szerokości kolumny. Można również zaktualizować inne metadane, aby umożliwić zgodność z kolumnami docelowymi. Można na przykład zmienić typ danych kolumny zawierającej tylko dane całkowite na typ danych liczbowych, na przykład DT_I2. Te modyfikacje można wprowadzić ręcznie lub kliknąć przycisk Wybierz typy , aby użyć okna dialogowego Sugerowanie typów kolumn , aby ocenić przykładowe dane i automatycznie wprowadzić niektóre z tych zmian.

Aby dowiedzieć się więcej o menedżerze połączeń plików prostych, zobacz Menedżer połączeń plików prostych.

Opcje

Nazwa menedżera połączeń
Podaj unikatową nazwę menedżera połączeń plików prostych w przepływie pracy. Nazwa, którą podano, będzie wyświetlana w SSIS Designer.

Opis
Opisz menedżera połączeń. Najlepszym rozwiązaniem jest opisanie menedżera połączeń pod względem jego przeznaczenia, aby pakiety samodzielnie dokumentować i ułatwić konserwację.

Konfigurowanie właściwości każdej kolumny
Wybierz kolumnę w okienku po lewej stronie, aby wyświetlić jej właściwości w okienku po prawej stronie. Aby uzyskać opis właściwości typu danych, zobacz poniższą tabelę. Niektóre z wymienionych właściwości można skonfigurować tylko dla niektórych formatów plików prostych.

Majątek Opis
Typ kolumny Określa, czy kolumna jest oddzielona, o stałej szerokości, czy nierówne w prawo. Ta właściwość jest tylko do odczytu. Poszarpane prawe pliki to pliki, w których każda kolumna ma stałą szerokość, z wyjątkiem ostatniej kolumny. Jest ograniczony przez ogranicznik wierszy.
OutputColumnWidth Określ wartość, która ma być przechowywana jako liczba bajtów; w przypadku plików Unicode ta wartość odpowiada liczbie znaków. W zadaniu Przepływu danych ta wartość służy do ustawiania szerokości kolumny wyjściowej dla źródła pliku prostego. W modelu obiektów nazwa tej właściwości to MaximumWidth.
Datatype Wybierz z listy dostępnych typów danych. Aby uzyskać więcej informacji, zobacz Integration Services Data Types.
Tekstkwalifikowany Określ, czy dane tekstowe są otoczone znakami kwalifikatora tekstu, takimi jak znaki cudzysłowu.

Prawda: dane tekstowe w pliku prostym są kwalifikowane. Fałsz: Dane tekstowe w pliku prostym nie są kwalifikowane.
Nazwa Podaj opisową nazwę kolumny. Jeśli nie wprowadzisz nazwy, usługi Integration Services automatycznie tworzą nazwę w formacie Kolumna 0, Kolumna 1 itd.
DataScale Określ skalę danych liczbowych. Skala odnosi się do liczby miejsc dziesiętnych. Aby uzyskać więcej informacji, zobacz Integration Services Data Types.
KolumnaDelimiter Wybierz z listy dostępnych ograniczników kolumn. Wybierz ograniczniki, które prawdopodobnie nie występują w tekście. Ta wartość jest ignorowana dla kolumn o stałej szerokości.

{CR}{LF}. Kolumny są rozdzielane kombinacją zestawienia powrotnego karetki.

{CR}. Kolumny są rozdzielane przez znak końca linii.

{LF}. Kolumny są rozdzielane za pomocą znaku końca linii.

Średnik {;}. Kolumny są rozdzielane średnikami.

Dwukropek {:}. Kolumny są rozdzielane dwukropkiem.

Przecinek {,}. Kolumny są rozdzielane przecinkami.

Karta {t}. Kolumny są rozdzielane tabulatorem.

Pionowy pasek {|}. Kolumny są rozdzielane pionowym paskiem.
DataPrecision Określ precyzję danych liczbowych. Precyzja odnosi się do liczby cyfr. Aby uzyskać więcej informacji, zobacz Integration Services Data Types.
SzerokośćKolumnyWejściowej Określ wartość, która ma być przechowywana jako liczba bajtów; w przypadku plików Unicode ta wartość będzie wyświetlana jako liczba znaków. Ta wartość jest ignorowana dla kolumn rozdzielanych.

Uwaga W modelu obiektu nazwa tej właściwości to ColumnWidth.

Nowy
Dodaj nową kolumnę, klikając pozycję Nowy. Domyślnie przycisk Nowy dodaje nową kolumnę na końcu listy. Przycisk ma również następujące opcje dostępne na liście rozwijanej.

Wartość Opis
Dodaj kolumnę Dodaj nową kolumnę na końcu listy.
Wstaw przed Wstaw nową kolumnę przed wybraną kolumną.
Wstaw po Wstaw nową kolumnę po wybranej kolumnie.

Usunąć
Wybierz kolumnę, a następnie usuń ją, klikając pozycję Usuń.

Sugerowane typy
Użyj okna dialogowego Sugerowanie typów kolumn , aby ocenić przykładowe dane w pliku i uzyskać sugestie dotyczące typu danych i długości każdej kolumny. Aby uzyskać więcej informacji, zobacz Sugerowanie typów kolumn — dokumentacja interfejsu użytkownika okna dialogowego.

Edytor Menedżera połączeń plików prostych (strona zapoznawcza)

Użyj węzła Podgląd okna dialogowego Edytora menedżera połączeń plików prostych , aby wyświetlić zawartość pliku źródłowego w formacie tabelarycznym.

Aby dowiedzieć się więcej o menedżerze połączeń plików prostych, zobacz Menedżer połączeń plików prostych.

Opcje

Nazwa menedżera połączeń
Podaj unikatową nazwę połączenia z plikiem płaskim w przepływie pracy. Nazwa, którą podano, będzie wyświetlana w SSIS Designer.

Opis
Opisz połączenie. Najlepszym rozwiązaniem jest opisanie połączenia pod względem jego celu, aby pakiety samodzielnie dokumentować i ułatwić konserwację.

Wiersze danych do pominięcia
Określ liczbę wierszy do pominięcia na początku pliku prostego.

Odświeżyć
Wyświetl efekt zmiany liczby wierszy do pominięcia, klikając pozycję Odśwież. Ten przycisk staje się widoczny tylko po zmianie innych opcji połączenia.

Podgląd wierszy
Wyświetl przykładowe dane w pliku płaskim podzielone na kolumny i wiersze zgodnie z wybranymi opcjami.

  • Last updated on