Plan oferty

Knowledge Accelerators można dodać do środowiska zarządzania, jeśli jest to plan IBM Cloud Pak for Data Enterprise. Więcej informacji na temat planu przedsiębiorstwa zawiera sekcja Plany usług Watson Knowledge Catalog.

wymagane uprawnienia

Aby zaimportować Knowledge Accelerators, należy mieć uprawnienie użytkownika :

• Zarządzaj kategoriami zarządzania

• Zaloguj się do galerii Cloud Pak for Data as a Service https://dataplatform.cloud.ibm.com/gallery
• Wybierz opcję Wszystkie filtry > Format > Treść zarządzania .
• Otwórz kafelek galerii aplikacji Knowledge Accelerator dla konkretnej branży.

Użyj następujących komend, aby ustawić zmienne używane w komendzie importowania: CPD_URL; TOKEN; KA_IND i KA_IDS.

1. Ustaw adres URL IBM Cloud Pak for Data , na przykład https://api.dataplatform.cloud.ibm.com:

   export CPD_URL={CPD_URL}

   Aby sprawdzić wartość zmiennej $CPD_URL, uruchom następującą komendę:

   echo $CPD_URL

2. Wygeneruj znacznik przy użyciu parametru API_KEY. Aby uzyskać klucz interfejsu API, należy zapoznać się z tematem https://cloud.ibm.com/docs/account? topic = account-userapikey#create_user_key.

   curl -k -X POST 'https://iam.cloud.ibm.com/identity/token' -H 'Content-Type: application/x-www-form-urlencoded' -d 'grant_type=urn:ibm:params:oauth:grant-type:apikey&apikey=<API_KEY>'

   Dane wyjściowe powinny być podobne do następujących:

   {"access_token":"eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6Ik1PamZFMGNVR2FFe..."}

3. Aby ustawić zmienną TOKEN , należy skopiować i wkleić wartość znacznika do następującej komendy:

   export TOKEN={TOKEN}

   Na przykład:export TOKEN=eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6Ik1PamZFMGNVR2FFe...
   Aby sprawdzić wartość zmiennej TOKEN, uruchom następującą komendę:

   echo $TOKEN

4. Ustaw zmienną KA_IND dla branży aplikacji Knowledge Accelerator, patrz tabela 1 dla wartości {ka_id} :

   export KA_IND={ka_id}

   Tabela 1. Wartości {ka_id} dla każdej gałęzi przemysłu

   Przemysł krzyżowy	Energia i media	usługi finansowe	Służba zdrowia	Ubezpieczenia
   kaci20	kaeu20	kafs20	kahc20	kain20

   Aby sprawdzić wartość zmiennej KA_IND , uruchom następującą komendę:

   echo $KA_IND

Można użyć tego {process id} w celu sprawdzenia statusu importu.

1. Ustaw nową zmienną środowiskową PROCESS_ID , aby zapisać wartość identyfikatora procesu z odpowiedzi importowania:

   export PROCESS_ID={process id}

   Aby sprawdzić wartość zmiennej PROCESS_ID , uruchom następującą komendę:

   echo $PROCESS_ID

2. Uruchom następującą komendę, aby sprawdzić status importu:

   curl -X GET "$CPD_URL/v3/governance_artifact_types/import/status/$PROCESS_ID" -k -s -H "Authorization: Bearer $TOKEN"

"IN_PROGRESS": Importowanie jest w toku i pokazuje, jaki numer kroku jest w toku, z łącznej liczby kroków.

..."status": "IN_PROGRESS",
....
    "step_number": 49,
    "total_steps": 50,.....

"SUCCEEDED": Import jest kompletny, a odpowiedź pokazuje, ile artefaktów jest tworzonych lub zmodyfikowanych.

    "operations_count": {
        "reference_data": {
            "IMPORT_CREATE": 290,
            "IMPORT_MODIFY": 0
        },
        "classification": {
            "IMPORT_CREATE": 0,
            "IMPORT_MODIFY": 22
        },
        "category": {
            "IMPORT_CREATE": 210,
            "IMPORT_MODIFY": 0
        },
        "glossary_term": {
            "IMPORT_CREATE": 7694,
            "IMPORT_MODIFY": 0
        }
    },
    "process_id": "6e23b62f-e20d-4fd8-88d7-06f92950fdb9",
    "status": "SUCCEEDED",....
    "step_number": 50,
    "total_steps": 50,

Podczas importowania opcji Knowledge Accelerators i innych komend można użyć innych opcji. Na przykład:

• Sprawdzanie, które Knowledge Accelerators są zainstalowane
• Opcjonalne parametry importowania

Aby sprawdzić, które Knowledge Accelerators są importowane do instancji Watson Knowledge Catalog , należy użyć następującej komendy:

curl -X GET "$CPD_URL/v1/knowledge_accelerators/import_items" -k -s -H "Authorization: Bearer $TOKEN"

Przykład danych wyjściowych:

{
  "message": "KA008I: The following knowledge accelerator items are imported",
  "import_evaluation": [
    {
      "knowledge_accelerator": "CPD_URL/v1/knowledge_accelerators/kaci20",
      "items": [
        {
          "id": "personal-data",
          "evaluation": "imported_at_undeterminable_version",
          "latest_version": "2.0.20220520"
        }
      ]
    }
  ]
}

Obowiązkowe parametry zapytania

merge_option [ łańcuch]

Nie ma wartości wartość domyślna , więc należy podać wartość.

Wartość	Opis
Wszystkie	Zaimportowane wartości zastępują istniejące wartości w katalogu.
określone	Zaimportowane wartości, które nie są puste, zastępują istniejące wartości w katalogu.
Puste	Zaimportowane wartości zastępują tylko puste wartości w katalogu.

Opcjonalne parametry zapytania

zależności [ łańcuch]

Wartość domyślna to all.

Wartość	Opis
Wszystkie	Importuje wszystkie elementy podrzędne, od których zależy wybrany element, niezależnie od tego, czy istnieją one w słowniku. Uwaga: ta opcja może zastąpić istniejące zmiany wprowadzone przez użytkownika w słowniku.
obowiązkowy	Importuje tylko określone zależności, które użytkownik wskazuje, i wszystko, co jest uważane za obowiązkowe.
niezbędne	Importuje tylko elementy, które są niezbędne. Jeśli element jest już zainstalowany w bieżącej wersji w systemie Watson Knowledge Catalog , to ten element nie jest zainstalowany. Na przykład, jeśli chcesz zainstalować pliki core-bpi i cim, a rdzeń-bpi jest już zainstalowany w bieżącej wersji, to zainstalowany jest tylko cim. Jeśli rdzeń-bpi jest zainstalowany w starszej wersji, to rdzeń-bpi jest zainstalowany również.

do_import [ boolean]

Wartość domyślna to false.

Wartość	Opis
Fałsz	Wykonuje wszystkie czynności związane z kontrolą logiki i wskazuje, co ma być zaimportowane, co jest przydatne do sprawdzania przed dokonaniem importu.
Prawda	Na koniec sprawdzania logiki wyzwala import i zwraca identyfikator procesu do użytkownika.