# Pobieranie i edycja konfiguracji potoku

Możesz pobrać pliki konfiguracyjne YAML dla potoku, eksportując projekt lub pobierając go z kontroli wersji. Następnie możesz edytować pliki YAML w swoim środowisku programistycznym, aby wprowadzić zmiany.

Do wyboru są trzy opcje na początek:

* Eksportuj projekt jako YAML

  Eksportowanie projektu tworzy plik ZIP zawierający pliki YAML dla wszystkich zadań, zestawów danych i ustawień projektu. Więcej informacji zawiera temat [Eksportowanie i importowanie potoków danych](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Introduction/Data-project-export-import.htm).

  WskazówkaEksportuj w Zminimalizowanym formacie najpierw. Zminimalizowane pliki pokazują tylko to, co różni się od wartości domyślnych, co ułatwia ich czytanie i replikowanie w różnych projektach. Po zaimportowaniu zminimalizowanego pliku, Qlik Talend Data Integration stosuje określone wartości i używa wartości domyślnych dla wszystkich pozostałych. Jeśli chcesz zobaczyć pełną listę dostępnych właściwości i ich wartości domyślnych, eksportować ten sam projekt w Pełnym formacie w celach informacyjnych.

* Importuj projekt z kontroli wersji

  Więcej informacji zawiera temat [Importowanie projektu z kontroli wersji](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/VersionControl/Project-version-control.htm#Importin).

* Możesz również utworzyć konfigurację potoku od podstaw, pisząc pliki YAML, które odpowiadają wymaganej strukturze folderów, ale zalecamy rozpoczęcie od istniejącego szablonu.

## Migracja projektu do formatu YAML

Projekty, które zostały utworzone przed wprowadzeniem deklaratywnego zarządzania potokiem, są przechowywane w kontroli wersji przy użyciu starszych plików JSON.

InformacjaStarszy format JSON pozostaje obsługiwany do końca czerwca 2027 roku, co daje czas na płynne zaplanowanie i migrację projektów.

Możesz migrować te projekty do struktury opartej na YAML, aby wykorzystać zminimalizowane pliki i deklaratywny przepływ pracy potoku.

InformacjaTa akcja jest dostępna tylko dla projektów przechowywanych w starym formacie JSON. Projekty, które już używają plików YAML, nie wyświetlają tej opcji.

Aby przeprowadzić migrację projektu do formatu YAML:

1. Otwórz projekt i otwórz menu kontroli wersji.

2. Kliknij Migruj do formatu YAML.

3. Przejrzyj komunikat potwierdzający i kliknij Migruj.

   InformacjaProces migracji zatwierdza i wypycha bieżący stan projektu jako JSON, następnie konwertuje pliki do nowej struktury YAML i ponownie zatwierdza zmiany. Ponieważ struktura folderów i nazwy plików zmieniają się podczas konwersji, historia wersji przed migracją może nie być bezpośrednio porównywalna z historią po migracji.

Po zakończeniu migracji, projekt jest przechowywany w formacie YAML na bieżącej gałęzi. Inne gałęzie, które nadal zawierają pliki JSON, wyświetlą opcję migracji następnym razem, gdy się na nie przełączysz.

WskazówkaMigruj wszystkie gałęzie środowiska sekwencyjnie — zaczynając od środowiska deweloperskiego — aby utrzymać spójną strukturę we wszystkich gałęziach, zanim otworzysz między nimi żądania ściągnięcia.

## Zrozumienie struktury pliku

Wyodrębniony folder zawiera następujące pliki. Zawartość plików jest taka sama we wszystkich typach zadań.

```
qtcp_project.yaml
qtcp_tasks/
  <task-name>/
    task.yaml
    sourceSelection.yaml
    schedule.yaml          (only if a schedule is configured)
    model.yaml             (only if relationships are defined)
    transformationRules.yaml  (only if task-level rules are defined)
    datasets/
      <dataset-name>.yaml
  newTaskDefaults.yaml     (only if custom task defaults are defined)
```

### qtcp\_project.yaml

qtcp\_project.yaml zawiera definicje na poziomie projektu oraz zawiera właściwości takie jak nazwa, platforma i domyślna obsługa schematu.

### task.yaml

task.yaml zawiera definicje na poziomie zadania oraz właściwości takie jak nazwa zadania, typ, połączenia oraz pełne ładowanie i zachowanie przechwytywania zmian.

### sourceSelection.yaml

sourceSelection.yaml definiuje tabele źródłowe wybrane do zadania. Każdy wpis określa schemat i wzorzec wyboru tabeli.

Wybór źródła różni się między Umieszczaniem a innymi typami zadań.

### Pliki zestawu danych

Każdy zestaw danych ma jeden plik YAML nazwany tak jak zestaw danych, znajdujący się bezpośrednio w folderze datasets/. Plik łączy definicję zestawu danych i jawne reguły transformacji.

InformacjaPlik zestawu danych jest wymagany dla wszystkich zadań z wyjątkiem zadań umieszczania i musi zawierać identyfikator zestawu danych, jeśli chcesz odwołać się do zestawu danych z innych zadań.

### schedule.yaml

schedule.yaml określa, kiedy zadanie jest uruchamiane. Plik zawiera `scheduling` tablicę z konfiguracją harmonogramu. Ten plik jest dołączany tylko, jeśli dla projektu zdefiniowano harmonogram.

### model.yaml

model.yaml określa relacje modelu danych dla zadania. Plik zawiera `relationships` tablicę.

### Reguły transformacji.yaml

transformationRules.yaml zawiera wszystkie reguły transformacji na poziomie zadania w tablicy.

## Edytowanie plików konfiguracyjnych

Otwórz wyodrębniony folder w swoim IDE i edytuj pliki YAML według potrzeb. Typowe edycje obejmują:

* Zmiana nazw połączeń, aby wskazywały na inne środowisko.

* Dodawanie lub usuwanie tabel źródłowych w sourceSelection.yaml.

* Aktualizowanie ustawień zadania, takich jak typ ładowania lub obsługa schematu.

* Dodawanie reguł przekształcania do pliku zestawu danych.

* Dodawanie harmonogramu do zadania.

OstrzeżenieOdwołuj się do nazw połączeń dokładnie tak, jak są zdefiniowane w docelowej przestrzeni. Nazwa połączenia, która nie pasuje, spowoduje błąd importu.

## Identyfikatory obiektów w plikach YAML

Dla obiektów, do których istnieją odwołania — takich jak identyfikator zadania, do którego odwołano się w definicji źródłowej innego zadania — należy zdefiniować unikatowy identyfikator i używać go spójnie we wszystkich plikach.

## Tematy pokrewne

* [Walidowanie konfiguracji potoku](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DeclarativePipelines/Validating-pipeline-configuration.htm)

* [Wdrażanie konfiguracji potoku](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DeclarativePipelines/Deploying-pipeline-configuration.htm)