Translation not up to date
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í
- Vyhledání Knowledge Accelerators v galerii
- Nastavení proměnných prostředí
- Import slovníku Knowledge Accelerators Business Core Vocabulary
- Kontrola stavu úlohy importu
- Přidání spolupracovníků
- Volitelný import a další příkazy
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
Vyhledání Knowledge Accelerators v galerii
- Přihlaste se do galerie Cloud Pak for Data as a Service https://dataplatform.cloud.ibm.com/gallery
- Vyberte volbu .
- Otevřete dlaždici Znalostní akcelerátoru pro konkrétní odvětví.
Nastavení proměnných prostředí
- Nastavte adresu URL produktu IBM Cloud Pak for Data , například https://api.dataplatform.cloud.ibm.com:
Chcete-li zkontrolovat hodnotu proměnné $CPD_URL, spusťte tento příkaz:export CPD_URL={CPD_URL}
echo $CPD_URL
- 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.
Měli byste získat výstup podobný: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>'
{"access_token":"eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6Ik1PamZFMGNVR2FFe..."}
- Chcete-li nastavit proměnnou TOKEN , zkopírujte a vložte hodnotu tokenu do následujícího příkazu:
Například:export TOKEN={TOKEN}
export TOKEN=eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6Ik1PamZFMGNVR2FFe...
Chcete-li zkontrolovat hodnotu proměnné TOKEN, spusťte tento příkaz:echo $TOKEN
- Nastavte proměnnou KA_IND pro odvětví Znalostní akcelerátor, viz tabulka 1 pro hodnoty {ka_id} :
export KA_IND={ka_id}
Chcete-li zkontrolovat hodnotu proměnné KA_IND , spusťte tento příkaz: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
echo $KA_IND
Import slovníku Knowledge Accelerators Business Core
Vybraný produkt Knowledge Accelerator to naimportujete pomocí volání rozhraní API import_items .
- Chcete-li zkontrolovat, co se bude importovat v předstihu, spusťte následující příkaz:
Příklad výstupu:curl -X POST "$CPD_URL/v1/knowledge_accelerators/$KA_IND/import_items?ids=core-bpi&merge_option=all" -k -s -H "Authorization: Bearer $TOKEN"
{ "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" } ] } }
- 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"
"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" } ] } }
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.
- Nastavit novou proměnnou prostředí PROCESS_ID k uložení hodnoty ID procesu z odezvy importu:
Chcete-li zkontrolovat hodnotu proměnné PROCESS_ID , spusťte tento příkaz:export PROCESS_ID={process id}
echo $PROCESS_ID
- 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
Kontrola, který produkt Knowledge Accelerators je nainstalován
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 .
{
"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.