Translation not up to date
Obiekty globalne służą do tworzenia konfigurowalnych stałych w celu skonfigurowania potoku w czasie wykonywania. Użyj parametrów lub zmiennych użytkownika w potokach, aby określić wartości w czasie wykonywania, zamiast na stałe kodować wartości. W przeciwieństwie do parametrów potoku zmienne użytkownika mogą być dynamicznie ustawiane podczas przepływu.
Informacje o tworzeniu:
Parametry potoku
Parametry potoku służą do określania wartości w środowisku wykonawczym potoku. Na przykład, jeśli chcesz, aby użytkownik wprowadził obszar wdrażania dla danych wyjściowych potoku, użyj parametru w celu wyświetlenia zapytania o nazwę obszaru, który ma być używany podczas uruchamiania potoku. Podanie wartości parametru przy każdym uruchomieniu zadania zapewnia użycie poprawnych zasobów.
Należy zwrócić uwagę na następujące informacje dotyczące parametrów potoku:
- Parametr można przypisać jako wartość węzła lub przypisać go do zadania potoku.
- Indykator statusu informuje o tym, czy parametr potoku jest przypisany do dowolnego węzła.
- Tego samego parametru potoku można użyć dla wielu węzłów.
Definiowanie parametru potoku
- Utwórz parametr potoku z panelu konfiguracji dla węzła lub z paska narzędzi edytora potoku.
- Wprowadź nazwę i opcjonalny opis. Należy zauważyć, że nazwa musi być pisana małymi literami snake , z małymi literami, cyframi i znakami podkreślenia. Na przykład lower_snake_case_with_numbers_123 jest poprawną nazwą. Nazwa musi zaczynać się od litery. Jeśli nazwa nie jest zgodna, podczas próby uruchomienia potoku wystąpi błąd 404.
- Przypisz typ parametru. W zależności od typu parametru może być konieczne podanie dodatkowych szczegółów lub przypisanie wartości domyślnej.
- Kliknij przycisk Dodaj do listy , aby zapisać parametr potoku.
Uwagi:
- Można zdefiniować pojedynczy parametr lub utworzyć zestaw parametrów. Parametry definiowane indywidualnie mogą być również dodawane do zestawu.
- Możliwe jest użycie parametru potoku w sposób, który może generować nieobsługiwane wyniki w potoku. Na przykład, jeśli zostanie przypisany parametr, który dostarcza ogólny zasób aplikacyjny jako wartość dla węzła kopii zasobu aplikacyjnego, można wybrać zasób aplikacyjny jako wartość parametru, która nie jest obsługiwana przez węzeł kopii zasobu aplikacyjnego, co spowoduje wystąpienie błędu.
Typy parametrów
Typy parametrów są sklasyfikowane jako:
- Podstawowe: uwzględnianie typów danych w strukturze danych wejściowych dla potoku lub opcji obsługi tworzenia zduplikowanej powierzchni lub zasobu.
- Zasób: do wybierania projektu, katalogu, obszaru lub zasobu aplikacyjnego.
- Instancja: do wyboru instancji uczenia maszynowego lub instancji Cloud Object Storage
- Inne: do określania szczegółów, takich jak tryb tworzenia lub strategia błędów.
Przykład użycia typów potoku
Poniżej przedstawiono przykład użycia typu parametru Path.
- Utwórz zestaw parametrów o nazwie MASTER_PARAMETER_SET.
- Utwórz parametr o nazwie
file_pathi ustaw jego typ na Path(Ścieżka). - Ustaw wartość parametru
file_pathnamnts/workspace/masterdir. - Przeciągnij węzeł Czekaj na plik na kanwę i ustaw wartość Położenie pliku na
MASTER_PARAMETER_SET.file_path. - Połącz węzeł Czekaj na plik z węzłem Uruchamianie skryptu powłoki Bash , aby drugi węzeł był uruchamiany po pierwszym.
- Opcjonalnie: przetestuj zmienną parametru:
- Dodaj parametr zmiennej środowiskowej do zestawu parametrów MASTER_PARAMETER_SET , na przykład
FILE_PATH. - Wklej następującą komendę do pola Kod skryptu w oknie Uruchom skrypt powłoki (Run Bash script):
echo File: $FILE_PATH cat $FILE_PATH
- Dodaj parametr zmiennej środowiskowej do zestawu parametrów MASTER_PARAMETER_SET , na przykład
- Uruchom potok. W obu dziennikach wykonywania węzłów powinna być widoczna ścieżka
mnts/workspace/masterdir, aby można było sprawdzić, czy zostały one pomyślnie zaliczone.
Konfigurowanie węzła z parametrem potoku
Podczas konfigurowania węzła z parametrem potoku można wybrać istniejący parametr potoku lub utworzyć nowy parametr w ramach konfigurowania węzła.
Na przykład:
- Utwórz parametr potoku o nazwie creationmode i zapisz go na liście parametrów.
- Skonfiguruj węzeł Utwórz obszar wdrażania i kliknij, aby otworzyć panel konfiguracji.
- Dla opcji Tryb tworzenia wybierz Parametr potoku jako dane wejściowe.
- Wybierz parametr potoku creationmode i zapisz konfigurację.
Po uruchomieniu przepływu parametr potoku jest przypisywany podczas tworzenia obszaru.
Zestawy parametrów
Zestawy parametrów to grupa powiązanych parametrów, które mają być używane w potoku. Na przykład można utworzyć jeden zestaw parametrów do użycia w środowisku testowym i inny do użycia w środowisku produkcyjnym.
Zestawy parametrów mogą być tworzone jako zasób aplikacyjny projektu. Zestawy parametrów utworzone w projekcie są następnie dostępne do użycia w potokach w tym projekcie.
Tworzenie zestawu parametrów jako zasobu aplikacyjnego projektu
Istnieje możliwość utworzenia zestawu parametrów jako zasobu aplikacyjnego projektu wielokrotnego użytku, który będzie używany w potokach.
- Otwórz istniejący projekt lub utwórz projekt.
- Kliknij opcję Nowe zadanie > Zbierz wiele parametrów zadania z podanymi wartościami, aby ponownie wykorzystać je w dostępnych zadaniach .
- Przypisz nazwę dla zestawu i określ szczegóły dla każdego parametru w zestawie, w tym:
- Nazwa parametru
- Typ danych
- Zachęta
- Wartość domyślna
- Opcjonalnie utwórz zestawy wartości dla parametrów w zestawie parametrów. Zbiory wartości mogą mieć różne wartości dla różnych kontekstów. Na przykład można utworzyć zestaw wartości testowych z wartościami dla środowiska testowego i zestaw produkcyjny dla wartości produkcyjnych.
- Po utworzeniu wszystkich parametrów zapisz zestaw parametrów. Będzie on następnie dostępny do użycia w rurociągach utworzonych w tym projekcie.
Dodawanie zestawu parametrów do użycia w potoku
Aby dodać zestaw parametrów z projektu:
- Kliknij ikonę Obiekty globalne i przejdź do karty Zestawy parametrów.
- Kliknij opcję Dodaj zestaw parametrów , aby dodać zestawy parametrów z projektu, które mają być używane w potoku.
- Można dodawać lub usuwać zestawy parametrów z listy. Zestawy parametrów określone do użycia w potoku będą dostępne po przypisaniu parametrów jako danych wejściowych w potoku.
Tworzenie zestawu parametrów na podstawie listy parametrów w potoku
Zestaw parametrów można utworzyć na podstawie listy parametrów dla potoku.
- Kliknij ikonę Obiekty globalne i otwórz okno Parametry potoku.
- Wybierz żądane parametry w zestawie, a następnie kliknij ikonę Zapisz jako zestaw parametrów .
- Wprowadź nazwę i opcjonalny opis zestawu.
- Zapisz, aby dodać zestaw parametrów do użycia w potoku.
Korzystanie z zestawu parametrów w potoku
Aby użyć zestawu parametrów:
- Z arkusza właściwości węzła wybierz opcję Przypisz parametr potoku jako typ wejściowy.
- Zostanie wyświetlona lista wszystkich dostępnych parametrów o typie wymaganym dla danych wejściowych. Obejmuje to pojedyncze parametry i parametry zdefiniowane jako część zestawu. Wybierz parametr do przypisania. Należy zauważyć, że nazwa zestawu parametrów poprzedza nazwę parametru. Na przykład Parameter_set_name.Parameter_name.
- Po uruchomieniu potoku można wybrać zestaw wartości dla odpowiedniej wartości (jeśli jest dostępna), przypisać wartość dla parametru lub zaakceptować wartość domyślną.
W programie budującym wyrażenia można użyć zestawu parametrów w formacie param_sets.<MyParamSet.BRParam>. Jeśli wartość zestawu parametrów zawiera zmienną środowiskową, należy użyć następującej składni w programie budującym wyrażenia: param_sets.MyParamSet["$ICU_DATA"].
Edytowanie zestawu parametrów w zadaniu
Jeśli podczas definiowania zadania używany jest zestaw parametrów, można wybrać zestaw wartości, aby zapełnić zmienne wartościami z tego zestawu. Zauważ, że jeśli zmienisz i zapiszesz wartości, a następnie zmienisz zadanie i zapiszesz zmiany, wartości zestawu parametrów zostaną zresetowane do wartości domyślnych.
zmienne użytkownika
Utwórz zmienne użytkownika, aby przypisać wartości podczas działania przepływu. W przeciwieństwie do parametrów potoku zmienne użytkownika mogą być modyfikowane podczas przetwarzania.
Definiowanie zmiennej użytkownika
Istnieje możliwość utworzenia zmiennych użytkownika do użycia w potoku. Należy zauważyć, że zmienne użytkownika, takie jak parametry, są definiowane na poziomie globalnym i nie są specyficzne dla żadnego węzła. Wartość początkowa zmiennej użytkownika musi być ustawiona podczas jej definiowania i nie może być ustawiana dynamicznie w wyniku dowolnego wyniku węzła. Po zdefiniowaniu zmiennej użytkownika można użyć węzła Set user variables (Ustaw zmienne użytkownika), aby zaktualizować wynik węzła.
Aby utworzyć zmienną użytkownika:
- Utwórz zmienną z panelu konfiguracji dla węzła Aktualizuj zmienną lub z paska narzędzi edytora potoku.
- Wprowadź nazwę i opcjonalny opis. Należy zauważyć, że nazwa musi być pisana małymi literami snake , z małymi literami, cyframi i znakami podkreślenia. Na przykład lower_snake_case_with_numbers_123 jest poprawną nazwą. Nazwa musi zaczynać się od litery. Jeśli nazwa nie jest zgodna, podczas próby uruchomienia potoku wystąpi błąd 404.
- Dokończ definiowanie zmiennej, wybierając typ zmiennej i typ wejściowy.
- Kliknij przycisk Dodaj , aby dodać zmienną do listy. Jest on teraz dostępny do użycia w węźle.
Temat nadrzędny: Tworzenie potoku