0 / 0
Go back to the English version of the documentation
Import slovníku Knowledge Accelerators Business Core Vocabulary
Last updated: 09. 2. 2023
Jak importovat termíny slovníku Knowledge Accelerators do produktu Watson Knowledge Catalog .

Administrátor projektu může importovat Knowledge Accelerators do produktu Watson Knowledge Catalog pomocí volání rozhraní API.

Podívejte se na toto video popisující, jak importovat Knowledge Accelerators Business Core Vocabulary. Právní omezení pro video: Některé méně významné kroky a grafické prvky v tomto videu se mohou lišit od implementace produktu Cloud Pak for Data .

Toto video poskytuje vizuální metodu jako alternativu k následujícím psaným krokům v této dokumentaci.

Následující metoda nastavuje počet proměnných prostředí a volá rozhraní API import_items pro import vybraných klíčových slovíček Knowledge Accelerators přímo do produktu Watson Knowledge Catalog.

Požadavky a oprávnění

Plán nabídky
Do svého rámce regulace můžete přidat Knowledge Accelerators , pokud máte podnikový plán IBM Cloud Pak for Data . Další informace o podnikovém plánu naleznete v tématu Plány služebWatson Knowledge Catalog.
Požadovaná oprávnění
Chcete-li importovat Knowledge Accelerators, musíte mít toto oprávnění uživatele :
  • Správa kategorií regulace

Nastavení proměnných prostředí

Pomocí následujících příkazů nastavte proměnné použité v příkazu import: CPD_URL; TOKEN; KA_IND a KA_IDS.
  1. Nastavte adresu URL produktu IBM Cloud Pak for Data , například https://api.dataplatform.cloud.ibm.com:
    export CPD_URL={CPD_URL}
    Chcete-li zkontrolovat hodnotu proměnné $CPD_URL, spusťte tento příkaz:
    echo $CPD_URL
  2. Vygenerujte svůj token pomocí proměnné API_KEY. Chcete-li získat klíč rozhraní API, prostudujte si téma 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>'
    Měli byste získat výstup podobný:
    {"access_token":"eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6Ik1PamZFMGNVR2FFe..."}
  3. Chcete-li nastavit proměnnou TOKEN , zkopírujte a vložte hodnotu tokenu do následujícího příkazu:
    export TOKEN={TOKEN}
    Například: export TOKEN=eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6Ik1PamZFMGNVR2FFe...
    Chcete-li zkontrolovat hodnotu proměnné TOKEN, spusťte tento příkaz:
    echo $TOKEN
  4. Nastavte proměnnou KA_IND pro odvětví Znalostní akcelerátor, viz tabulka 1 pro hodnoty {ka_id} :
    export KA_IND={ka_id}
    Tabulka 1. Hodnoty {ka_id} pro každé odvětví
    Křížový průmysl Energie a technické vybavení finanční služby Zdravotní péče Pojištění
    kaci20
    kaeu20
    kafs20
    kahc20
    kain20
    Chcete-li zkontrolovat hodnotu proměnné KA_IND , spusťte tento příkaz:
    echo $KA_IND

Import slovníku Knowledge Accelerators Business Core

Vybraný produkt Knowledge Accelerator to naimportujete pomocí volání rozhraní API import_items .

  1. Chcete-li zkontrolovat, co se bude importovat v předstihu, spusťte následující příkaz:
    curl -X POST "$CPD_URL/v1/knowledge_accelerators/$KA_IND/import_items?ids=core-bpi&merge_option=all" -k -s -H "Authorization: Bearer $TOKEN"
    Příklad výstupu:
    {
      "message": "KA004I: The import has been evaluated. If ready to import, please repeat call with the 
       parameter do_import\u003dtrue.",
      "import_evaluation": {
        "knowledge_accelerator": "
    CPD_URL/v1/knowledge_accelerators/kaeu20",
        "items": [
          {
            "id": "base",
            "evaluation": "import",
            "reason": "mandatory_dependency"
          },
          {
            "id": "core-bpi",
            "evaluation": "import",
            "reason": "user_selected"
          }
        ]
      }
    }
  2. Naimportujte vybraný slovník jádra produktu Knowledge Accelerator pomocí následujícího příkazu:
    curl -X POST "$CPD_URL/v1/knowledge_accelerators/$KA_IND/import_items?ids=core-bpi&merge_option=all&do_import=true" -k -s -H "Authorization: Bearer $TOKEN"
Příklad výstupu:
  "message": "The import has been submitted, please check url below for update status",
  "process_id": "CPD_URL/v3/governance_artifact_types/import/st
   atus/c95b4016-3969-4dc4-8858-f152cfd01021",
  "import_evaluation": {
    "knowledge_accelerator": "CPD_URL/v1/knowledge_accelerators/kaeu20",
    "items": [
      {
        "id": "core-bpi",
        "evaluation": "import",
        "reason": "user_selected"
      },
      {
        "id": "base",
        "evaluation": "import",
        "reason": "mandatory_dependency"
      }
    ]
  }
}
Rada: Všimněte si "process_id", jak můžete použít toto pro kontrolu stavu úlohy importu.

Poznámka: Spoj, který je uvedený v odpovědi, není otevřen ve vašem prohlížeči, protože je vyžadován token nositele. Použijte příkaz curl ze sekce Kontrola stavu úlohy importu , abyste zkontrolovali stav importu.

Kontrola stavu úlohy importu

Je-li odeslán import Knowledge Accelerators , je možné zkontrolovat stav této úlohy. Tato kontrola může být nezbytná nebo žádoucí, protože v některých případech může proces importu produktu Knowledge Accelerator trvat určitou dobu, v závislosti na počtu importovaných položek.

Když vydáte příkaz k importování položek produktu Knowledge Accelerator, vrátí se v příkazovém řádku návratový kód procesu, například:

"process_id": "CPD_URL/v3/governance_artifact_types/import/status/6e23b62f-e20d-4fd8-88d7-06f92950fdb9" , kde parametr {process id} je 6e23b62f-e20d-4fd8-88d7-06f92950fdb9.

Tuto {process id} můžete použít ke kontrole stavu importu.
  1. Nastavit novou proměnnou prostředí PROCESS_ID k uložení hodnoty ID procesu z odezvy importu:
    export PROCESS_ID={process id}
    Chcete-li zkontrolovat hodnotu proměnné PROCESS_ID , spusťte tento příkaz:
    echo $PROCESS_ID
  2. Spusťte následující příkaz, abyste zkontrolovali stav importu:
    curl -X GET "$CPD_URL/v3/governance_artifact_types/import/status/$PROCESS_ID" -k -s -H "Authorization: Bearer $TOKEN"

Extrakty odpovědí:

"IN_PROGRESS": Probíhá import a ukazuje počet kroků, které proces provádí, z celkového počtu kroků.
..."status": "IN_PROGRESS",
....
    "step_number": 49,
    "total_steps": 50,.....
"SUCCEEDED": Import je dokončen a odezva zobrazuje, kolik artefaktů je vytvořeno nebo upraveno.
    "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,

Přidání spolupracovníků

Je třeba přidat spolupracovníky do kategorií Knowledge Accelerators , jinak pouze ta osoba, která importuje akcelerátor, může artefakty používat. Podrobnosti o tom, jak to provést, najdete v tématu Správa přístupu ke kategorii .

Volitelný import a další příkazy

Při importu produktu Knowledge Accelerators a dalších příkazů můžete použít jiné volby. Příklad:

Kontrola, který produkt Knowledge Accelerators je nainstalován

Můžete zkontrolovat, které Knowledge Accelerators jsou importovány do instance produktu Watson Knowledge Catalog pomocí následujícího příkazu:
curl -X GET "$CPD_URL/v1/knowledge_accelerators/import_items" -k -s -H "Authorization: Bearer $TOKEN"

Tento příkaz vrátí výpis všech Knowledge Accelerators , které jsou již naimportovány do instance Watson Knowledge Catalog .

Příklad výstupu:
{
  "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"
        }
      ]
    }
  ]
}

Volitelné parametry importu

V příkazu POST import_items lze změnit následující parametry:

Povinné parametry dotazu
merge_option [ řetězec]
Žádná výchozí hodnota , takže hodnota musí být uvedena.
Hodnota Popis
vše Importované hodnoty nahradí existující hodnoty v katalogu.
určeno Importované hodnoty, které nejsou prázdné, nahradí existující hodnoty v katalogu.
prázdné Importované hodnoty nahradí pouze prázdné hodnoty v katalogu.
Volitelné parametry dotazu
závislosti [ řetězec]
Výchozí hodnota je all.
Hodnota Popis
vše Importuje všechny dílčí položky, na kterých závisí vybraná položka, bez ohledu na to, zda ve slovníku existují. Poznámka: Tato volba může přepsat existující změny provedené uživatelem ve slovníku.
povinný Importuje pouze určené závislosti, které uživatel označuje, a cokoli, co je považováno za povinné.
nezbytné Importuje pouze ty položky, které jsou nezbytné. Je-li položka již nainstalována v aktuální verzi v produktu Watson Knowledge Catalog , tato položka není nainstalována. Pokud například chcete instalovat jádro-bpi a cim a jádro-bpi je již nainstalováno na aktuální verzi, je nainstalován pouze produkt cim. Je-li jádro-bpi nainstalováno na starší verzi, pak je také nainstalováno jádro-bpi.
do_import [ logická hodnota]
Výchozí hodnota je false.
Hodnota Popis
ne Dostane veškerá logika kontroly a označuje, co se má importovat, což je užitečné pro kontrolu postupu při provádění importu.
ano Na konci logické kontroly spustí import a vrátí ID procesu uživateli.
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