0 / 0
Go back to the English version of the documentation
Importowanie metod dla artefaktów zarządzania
Last updated: 18 sie 2023
Importowanie metod dla artefaktów zarządzania

Istnieje możliwość importowania artefaktów zarządzania z plikiem. Jednocześnie można zaimportować jeden typ artefaktu zarządzania lub zaimportować wszystkie artefakty zarządzania z innej instancji produktu Watson Knowledge Catalog .

Kompatybilność między środowiskami wdrażania

Artefakty zarządzania można eksportować, a następnie importować między instancjami produktu Watson Knowledge Catalog w następujących środowiskach wdrażania:

  • Cloud Pak for Data 3.5
  • Cloud Pak for Data 4.x
  • Cloud Pak for Data as a Service

Wartości Stewardsa nie są zgodne między instancjami Watson Knowledge Catalog Cloud Pak for Data as a Service i Cloud Pak for Data 3.5 lub 4.x.

Istnieje możliwość importowania artefaktów zarządzania z produktu IBM InfoSphere Information Governance Catalog do instancji Watson Knowledge Catalog w ramach Cloud Pak for Data 3.5 i 4.x. Aby zaimportować artefakty zarządzania z produktu IBM InfoSphere Information Governance Catalog do instancji Watson Knowledge Catalog w produkcie Cloud Pak for Data as a Service, należy zmodyfikować każdy plik CSV w taki sposób, aby był zgodny z formatem plików CSV artefaktów produktu Watson Knowledge Catalog . Na przykład: może być konieczne, aby następujące typy edycji:

  • Usuń nieobsługiwane kolumny
  • Oddziel różne typy artefaktów do wielu plików CSV
  • Modyfikuj obsługiwane kolumny
  • Dodaj wymagane kolumny

Porównanie metod przywozu

Wybierz odpowiednią metodę importu dla celów i okoliczności.

Importowanie pojedynczego typu artefaktu

Istnieje możliwość zaimportowania pojedynczego typu artefaktu zarządzania w czasie z plikiem CSV.

Metoda ta jest przydatna w następujących rodzajach okoliczności:

  • Użytkownik chce, aby zaimportowane artefakty podległy przepływowi pracy.
  • Użytkownik chce dodać wartości dla właściwości do jednego typu artefaktu zarządzania. Wyeksportuj ten typ artefaktu jako plik CSV, dokonaj edycji pliku CSV, a następnie zaimportuj ten plik. Na przykład można użyć tej metody w celu dodania atrybutu niestandardowego do warunków biznesowych.
  • Użytkownik chce zdefiniować artefakty w innym programie. Utwórz pliki CSV dla każdego typu artefaktu. Za pomocą tej metody można na przykład zdefiniować artefakty w programie arkusza kalkulacyjnego, a następnie zaimportować je.

Więcej informacji na ten temat zawiera sekcja Importowanie artefaktów zarządzania według typu z plikami CSV i Format pliku CSV na potrzeby importowania artefaktów zarządzania.

Importowanie wielu typów artefaktów

Istnieje możliwość zaimportowania wielu typów artefaktów zarządzania za pomocą pliku ZIP utworzonego przez wyeksportowanie wielu typów istniejących artefaktów zarządzania z instancji Watson Knowledge Catalog . Plik ZIP zawiera pliki CSV dla kategorii i każdego eksportowanego typu artefaktu. Pliki CSV są zgodne z formatem pliku importu CSV, z wyjątkiem dodatkowego kolumny ID artefaktu , która zawiera identyfikatory artefaktów zamiast identyfikować artefakty według nazwy i ścieżki kategorii.

Metoda ta jest przydatna w następujących rodzajach okoliczności:

  • Użytkownik chce przenieść wszystkie artefakty zarządzania z jednej instancji Watson Knowledge Catalog do innej.
  • Użytkownik chce, aby podobne aktualizacje były aktualizowane w wielu różnych typach artefaktów. Wyeksportuj artefakty w postaci pliku ZIP, dokonaj edycji każdego pliku CSV, a następnie zaimportuj plik ZIP. Na przykład, aby zmienić znaczniki dla wielu artefaktów, można użyć tej metody w celu wydajnego wprowadzania tych aktualizacji.

Więcej informacji na ten temat zawiera sekcja Importowanie wielu typów artefaktów zarządzania z instancji z plikiem ZIP.

W poniższej tabeli podsumowano różnice między importownymi artefaktami z plikami CSV lub ZIP.

Charakterystyka Plik CSV Plik ZIP
Tworzenie plików Wyeksportuj jeden typ istniejących artefaktów
Utwórz plik w programie arkusza kalkulacyjnego
Eksportuj artefakty z produktu IBM InfoSphere Information Governance Catalog i dopasuj format.		 Eksportowanie wielu typów artefaktów z instancji
Liczba typów artefaktów Kategorie lub jeden typ artefaktu dla pliku. Wiele typów artefaktów, z kategoriami i każdym typem artefaktu w oddzielnym pliku CSV.
Metody importowania Za pomocą żądania interfejsu API interfejsu użytkownika
 Żądanie API
Przepływ pracy Wszystkie artefakty są importowane jako wersje robocze i podlegają przepływowi pracy. Kategorie są publikowane natychmiast, ponieważ nie podlegają one przepływowi pracy. Wszystkie artefakty i kategorie są publikowane natychmiast.
wymagane uprawnienia Uprawnienia do tworzenia lub edytowania kategorii. Patrz Wymagane uprawnienia. Uprawnienie Zarządzanie glosariuszem

Artefakty zarządzania, które można zaimportować

Przy użyciu obu metod importowania można importować kategorie i następujące typy artefaktów zarządzania:

Ograniczenia:

  • Istnieje możliwość zaimportowania wartości dla wszystkich właściwości tych typów artefaktów zarządzania, w tym relacji z innymi artefaktami. Relacje są jednak importowane tylko wtedy, gdy powiązany artefakt istnieje lub jest zdefiniowany w tym samym procesie importowania. Aby dodać relacje pominięte przez proces importowania, najpierw opublikuj wszystkie zaimportowane artefakty robocze, a następnie ponownie uruchom proces importowania.
  • Pliku CSV nie można używać do przenoszenia artefaktów zarządzania i ich relacji między instancjami Cloud Pak for Data . Jeśli na przykład użytkownik podejmie próbę wyeksportowania klas danych z dopasowaniem metody Dopasuj do danych referencyjnych do pliku CSV, a następnie zaimportuje je do innej instancji Cloud Pak for Data , importowanie nie powiedzie się, ponieważ identyfikator artefaktu nie jest uwzględniany w importach i eksportach CSV. Zamiast tego należy użyć importu ZIP.
  • Podczas importowania zestawu danych odniesienia z pliku CSV wartości danych odniesienia z tego zestawu nie są importowane. Aby zaimportować wartości do zestawu danych, należy użyć oddzielnego pliku CSV. Alternatywnie można użyć importu ZIP w celu zaimportowania zarówno referencyjnego zestawu danych, jak i jego wartości danych odniesienia. Więcej informacji na ten temat zawiera sekcja Importowanie plików dla zestawów danych odniesienia.
  • Nie można importować reguł ochrony danych ani reguł położenia danych.

Metody scalania zaimportowanych i istniejących artefaktów

Niezależnie od tego, czy artefakty są importowane z plikami CSV, czy z plikiem ZIP, należy wybrać, co się dzieje podczas importowania artefaktów zarządzania, które już istnieją, a wartości właściwości są różne. W poniższej tabeli podsumowano trzy metody scalania.

Metoda łączenia Wpływ na pierwotne wartości Wpływ na zaimportowane wartości
Zastąp wszystkie wartości Odrzuć wszystkie oryginalne wartości. Akceptuj wszystkie zaimportowane wartości, nawet puste wartości.
Zastąp przy użyciu zdefiniowanych wartości Zachowuj oryginalne wartości, jeśli zaimportowane wartości są puste. Akceptuj wszystkie zaimportowane wartości z wyjątkiem pustych wartości.
Zastąp puste wartości Zachowuj oryginalne wartości, z wyjątkiem pustych wartości. Akceptuj tylko zaimportowane wartości, które zastępują puste wartości.

W przypadku nowych artefaktów każda z tych metod generuje te same wyniki.

Zastąp wszystkie wartości

Wszystkie oryginalne wartości artefaktu są usuwane i zastępowane przez wartości zaimportowanego artefaktu. Jeśli wartość właściwości zaimportowanego artefaktu jest pusta, wszystkie oryginalne wartości dla tej właściwości zostaną usunięte.

Załóżmy na przykład, że istnieje opublikowany termin biznesowy o nazwie release , a plik CSV zostanie zaimportowany w celu jego zmodyfikowania. W poniższej tabeli przedstawiono efekt działania opcji Zastąp wszystkie wartości :

Właściwość Wartości oryg. Wartości w pliku CSV Wartości wynikowe
Nazwa wersja wersja wersja
Typ artefaktu glossary_term glossary_term glossary_term
Kategoria marketing marketing marketing
Opis termin przykładowy przykładowy termin edytowany przykładowy termin edytowany
Znaczniki beta beta
Terminy pokrewne marketing> > wersja marketing> > data marketing> > data
Klasyfikacje

Dane poufne

Wynikowy artefakt roboczy ma te zmiany do pierwotnych wartości:

  • Oryginalny opis jest zastępowany przez nowy opis.
  • Pierwotna pusta wartość dla znaczników jest zastępowana przez wartość.
  • Pierwotny termin pokrewny jest zastępowany nowym terminem pokrewnej.
  • Pierwotna wartość klasyfikacji jest zastępowana pustą wartością.
Uwaga:

Jeśli używana jest opcja scalania produktu all , należy upewnić się, że cała treść CSV jest spójna w odniesieniu do relacji między artefaktami. Jeśli na przykład plik importu ZIP zawiera zarówno termin, jak i klasę danych połączone ze sobą, to relacja ta musi być obecna w obu klasach danych CSV i CSV. W przeciwnym razie zachowanie importu relacji jest nieprzewidywalne, relacja może być importowana lub nie.

Zastąp przez zdefiniowane wartości

Oryginalne i puste wartości artefaktu są zastępowane przez podane wartości zaimportowanego artefaktu. Jeśli wartość właściwości zaimportowanego artefaktu jest pusta, wszystkie oryginalne wartości dla tej właściwości są zachowywane.

Załóżmy na przykład, że istnieje opublikowany termin biznesowy o nazwie release , a plik CSV zostanie zaimportowany w celu jego zmodyfikowania. W poniższej tabeli przedstawiono efekt działania opcji Zastąp wszystkie wartości :

Właściwość Wartości oryg. Wartości w pliku CSV Wartości wynikowe
Nazwa wersja wersja wersja
Typ artefaktu glossary_term glossary_term glossary_term
Kategoria marketing marketing marketing
Opis termin przykładowy przykładowy termin edytowany przykładowy termin edytowany
Znaczniki beta beta
Terminy pokrewne marketing> > wersja marketing> > data marketing> > data
Klasyfikacje

Dane poufne

Dane poufne

Wynikowy artefakt roboczy ma te zmiany do pierwotnych wartości:

  • Oryginalny opis jest zastępowany przez nowy opis.
  • Pierwotna pusta wartość dla znaczników jest zastępowana przez wartość.
  • Pierwotny termin pokrewny jest zastępowany nowym terminem pokrewnej.

Zastąp puste wartości

Puste wartości oryginalnego artefaktu są zastępowane przez dostarczone wartości zaimportowanego artefaktu.

Załóżmy na przykład, że istnieje opublikowany termin biznesowy o nazwie release , a plik CSV zostanie zaimportowany w celu jego zmodyfikowania. W poniższej tabeli przedstawiono efekt działania opcji Zastąp wszystkie wartości :

Właściwość Wartości oryg. Wartości w pliku CSV Wartości wynikowe
Nazwa wersja wersja wersja
Typ artefaktu glossary_term glossary_term glossary_term
Kategoria marketing marketing marketing
Opis termin przykładowy przykładowy termin edytowany termin przykładowy
Znaczniki beta beta
Terminy pokrewne marketing> > wersja marketing> > data marketing> > wersja
Klasyfikacje

Dane poufne

Dane poufne

Wynikowy artefakt roboczy ma tę zmianę do pierwotnych wartości:

  • Pierwotna pusta wartość dla znaczników jest zastępowana przez wartość.

Zagadnienia związane z zabezpieczeniami

Dane zarządzania eksportowane do plików CSV są oczyszczane przed znanymi atakami w formacie CSV, w celu zapewnienia bezpieczeństwa dla tych arkuszy kalkulacyjnych, które automatycznie interpretują dane CSV. W wyniku tego wszystkie wartości tekstowe, które rozpoczynają się od jednego z następujących znaków:

  • jest równe (=)
  • plus (+)
  • minus (-)
  • w (@)

są poprzedzane pojedynczym znakiem cudzysłowu ('). Aby funkcjonalność była spójna, importowane pliki CSV są dodatkowo analizowane w celu automatycznego usunięcia pojedynczego znaku cudzysłowu ('). Sanityzacja ma również zastosowanie podczas importowania i eksportowania artefaktów zarządzania do plików ZIP, ponieważ zawierają one pliki CSV.

Aby wyłączyć tę funkcję:

  1. Edytuj wdrożenie usługi glosariusza Watson Knowledge Catalog :

    oc edit deployment wkc-glossary-service

  2. Ustaw zmienną środowiskową ESCAPE_FORMULAS_IN_CSV_FILES na wartość false.

Więcej informacji na ten temat zawiera sekcja Wprowadzanie CSV.

Więcej inform.

Temat nadrzędny: Zarządzanie artefaktami zarządzania

Generative AI search and answer
These answers are generated by a large language model in watsonx.ai based on content from the product documentation. Learn more