0 / 0

Knowledge Accelerators の概説

最終更新: 2025年7月09日
Knowledge Accelerators を IBM Knowledge Catalog にインポートする方法

コンポーネントを Knowledge Accelerators コンポーネントを IBM Knowledge Catalog に追加し、コンポーネントをカスタマイズする。

始める前に

  1. 以下のプランと ユーザー権限があることを確認してください:
    オファリング・プラン
    その IBM Cloud Pak for Data エンタープライズ・プラン 詳しくは、 IBM Knowledge Catalog サービスプランをご覧ください。
    必要な権限
    • カタログへのアクセス
    • 資産ディスカバリーの管理
    • ガバナンス成果物へのアクセス
    • グロッサリー管理
    • ガバナンス・カテゴリーの管理
    • プロジェクトの管理

を追加する Knowledge Accelerators UIで

業界アライメント・ボキャブラリーは、UIではインポートできません。 代わりに、 APIメソッドを使う必要がある。 ビジネス・スコープまたはビジネス・コア・ボキャブラリとビジネス・パフォーマンス指標をインポートするには、UIインポート方法を使用します。
  1. 「管理」 > 「構成と設定 」に移動し、 Add Knowledge Accelerator タイル。
  2. 語彙を追加する業種を選択します。
  3. 業種に追加したいビジネススコープまたはスコープを選択します。
    全項目 - 特定の Knowledge Accelerators 語彙をすべてインポートする

    完全なビジネス・ボキャブラリーとすべてのビジネス・スコープを含む特定の Knowledge Accelerators ボキャブラリーのそれぞれをインポートすることを選択できます。 例えば、5,000~20,000語など、幅広い業種に対応するために広範なビジネス用語セットをインポートする必要がある場合は、このオプションを選択してください。

    Industry Alignment Vocabularies は、API を使用して個別にインポートできます。

    選択項目 - ビジネススコープのインポート

    Data Privacy、その他の業界固有のスコープなど、 Knowledge Accelerators ビジネススコープを個別にインポートすることができます。 関心のある分野にこれらのビジネススコープが1つ以上存在し、比較的少数のビジネス用語、たとえば200から500の用語から始めることを好む場合は、これらの別個のスコープを1つ以上インストールしてください。 各ビジネス・スコープは個別にインポートされる。

    定義、ID、および詳細情報を含む、各業界で使用可能なすべての項目の詳細なリストについては、以下のリンクを参照してください。
  4. インポートのマージオプションを設定する。

    詳細は インポートした成果物と既存の成果物をマージする方法 を参照。

  5. Add をクリックしてインポートを開始する。
    注:
    • 複数のKAビジネススコープをインポートした場合、ポリシーやルールなどの共有成果物語彙用語へのリレーションシップの一部が、後続のビジネススコープのインポートによって上書きされる可能性があります。
    • 複数の業界の Knowledge Accelerators をインポートする場合、ポリシーやルールから語彙用語への変換などの共有成果物からの関係は、後続のインポートのためにマージされない可能性があります。最初にインポートされた KA 成果物からのマッピングは保持されます。 ポリシーおよびガバナンス・ルールに関連するインポート・ログ内のメッセージ (GIM00010E または GIM00015E) は無視できます。

    インポート開始の通知メッセージが表示されたら、ウィンドウを閉じます。

    複数のインポート・ジョブを同時に開始することはできません。

  6. インポートが完了しても通知されないので、通知の process_id

    process_id を使って ジョブステータスをチェックする。 輸入される商品の数や大きさによっては、輸入に時間がかかる場合があります。

    インポートが完了したら、共同作業者の追加を開始できます。

を追加する Knowledge Accelerators APIで

のAPIエンドポイントの説明は、APIドキュメントをご覧ください。 Knowledge Accelerators の API エンドポイントの説明は API ドキュメントを参照してください。

  1. オプション:どの Knowledge Accelerators がすでにインポートされているか確認するには、 Get what Knowledge Accelerator items are imported into glossary APIエンドポイントを呼び出します
  2. オプションです:インポートできる項目をチェックします:
  3. APIを使って Knowledge Accelerators コンポーネントを追加するために Cloud Pak for DataIBM Cloud で認証する必要があります:
    1. コンソールでAPIキーを作成する 」の説明に従って、APIキーを取得します。
    2. API キーを使用して IAM トークンを生成する IBM Cloud IAM トークンを生成する で説明しているように、API キーを使用して IAM トークンを生成します。
  4. 指定された Knowledge Accelerator アイテムを用語集 API エンドポイントにインポートする呼び出します
  5. インストールする項目を選択します。
    注:
    • 複数のKAビジネススコープをインポートした場合、ポリシーやルールなどの共有成果物語彙用語へのリレーションシップの一部が、後続のビジネススコープのインポートによって上書きされる可能性があります。
    • 複数の業界の Knowledge Accelerators をインポートする場合、ポリシーやルールから語彙用語への変換などの共有成果物からの関係は、後続のインポートのためにマージされない可能性があります。最初にインポートされた KA 成果物からのマッピングは保持されます。 ポリシーおよびガバナンス・ルールに関連するインポート・ログ内のメッセージ (GIM00010E または GIM00015E) は無視できます。
    すべての項目
    Knowledge Accelerators のボキャブラリーは、4 つの特定の業種ごとに存在し、完全なビジネス・ボキャブラリー、業界アライメント・ボキャブラリー、およびすべてのビジネス・スコープを含んでいます。 これらのボキャブラリーのすべてをインポートするか、選択したボキャブラリーをインポートするかを選択できます。 業界の幅 (例えば、5,000 から 20,000 個の用語) に対応するために広範なビジネス用語セットをインポートする必要がある場合は、このオプションを選択します。
    選択項目 - ビジネススコープのインポート
    Knowledge Acceleratorのビジネススコープを個別にインポートすることも可能です。例えば、 Data Privacy、その他の業界固有のスコープがあります。 関心のある領域に対してこれらのビジネス・スコープが 1 つ以上存在し、比較的少数のビジネス用語 (例えば、200 から 500 個の用語) から開始する場合は、これらの個別のスコープを 1 つ以上インストールできます。
    定義、ID、および詳細情報を含む、各業界で使用可能なすべての項目の詳細なリストについては、以下のリンクを参照してください。
  6. 以下のパラメーターの値を入力します。
    次に例を示します。
    パラメーター 説明
    ka_id 業界の ID。 kafs20
    ids インポートする 1 つ以上の Knowledge Accelerator 項目の ID をコンマで区切って指定します。 一度にインポートできるスコープは 1 つのみであることに注意してください。 core-bpi,ccpa,fhir, gdpr
    マージ・オプション IBM Knowledge Catalogにインポートするときに使用するマージ・オプション。 all
    dependencies 指定された項目 ID のどの依存関係もインポートする必要があるかを示します。 necessary
    do_import (do_import)
    • false を選択して、パラメーターを確認し、インポートされる内容を調べます。
    • インポートする true を選択します。
    false
  7. インポートが完了しても通知されないので、通知の process_id

    process_id を使って ジョブステータスをチェックする。 輸入される商品の数や大きさによっては、輸入に時間がかかる場合があります。

    インポートが完了したら、共同作業者の追加を開始できます。

輸入状況の確認

資産状況のインポート APIエンドポイントを呼び出す でインポートのステータスを確認する。 {process_id} は API で Knowledge Accelerators を追加した ステップ4 の値。

インポート状況は、すべての成果物がインポートされるまで "IN_PROGRESS" のままです。

コラボレーターの追加

コラボレーターを Knowledge Accelerators カテゴリーに追加する必要があります。追加しない場合は、アクセラレーターをインポートしたユーザーのみが成果物を使用できます。 これを行う方法について詳しくは、 カテゴリーへのアクセスの管理 を参照してください。

論理データモデル資産用語の割り当て

この機能は Knowledge Accelerators この機能は Knowledge Accelerators カタログにインポートされた論理データモデル資産ビジネス用語を自動的に割り当てる。 IBM Cloud Pak for Data カタログにインポートされます。

前提条件
論理データ・モデルをカタログにインポートする必要がある。 IBM Cloud Pak for Data カタログにインポートする必要があります。 以下の手順でモデルをインポートすることができます:
前提条件 ステップと詳細情報
1. MANTA 自動データ・リネージュインストールします。  
2. リネージュ有効にする。  
3.以下の IBM 業種別モデルをお使いの場合は、インポートするモデルを準備する必要があります。
  1. 論理データモデルの erwin Data Modeler ファイルを開きます。
  2. モデルからすべてのダイアグラムを削除する。 詳しくは、こちらのサポートページをご覧ください。 https://www.ibm.com/support/pages/node/7070054
  3. モデルを Standard XMLとして保存します。
  4. 標準XML ファイルを圧縮またはzip圧縮する。

詳細については、 IBM サポートまでお問い合わせください。

4.論理データモデルをインポートします。  
エンドポイントを呼び出すには

既存の Knowledge Accelerators 用語を論理データモデル資産割り当てるには、 指定されたストラテジーを使用して資産タームを割り当てる API エンドポイントを呼び出します。

  1. 参照 https://cloud.ibm.com/apidocs/watson-data-api-cpd#post-add-assignment.
  2. カタログ、 資産、カテゴリーのIDをユーザー・インターフェイスで検索する。 IBM Knowledge Catalog ユーザーインターフェイスで
    カタログIDを検索する:
    1. メインメニューから IBM Cloud Pak for Data カタログ]を展開し、[ すべてのカタログ]を選択します。
    2. 使用しているカタログにアクセスする。
    3. ブラウザの URL で、"/catalogs/" と "?context=icp4data" の文字列の間にカタログIDがあります。 例えば、以下の URL、idは 67ea9e1f-b2d9-423c-ab9e-c234945f9c0b である: https://api.dataplatform.cloud.ibm.com/67ea9e1f-b2d9-423c-ab9e-c234945f9c0b/?context=icp4data
    資産 IDを見つけるには
    1. カタログからフィルターアイコンをクリックし、 Asset Type論理モデル 」を選択し、「 適用 」をクリックする。
    2. 結果セットにリストされている "Logical Model" をクリックする。例えば、 Atomic Warehouse Model
    3. ブラウザの URL で、"/asset/" と "?context=icp4data" の文字列の間に資産 IDを見つけることができます。 例えば、以下の URL、idは 7948818c-d3b5-4844-bf1b-5cc22f6fe6e1 である: https://api.dataplatform.cloud.ibm.com/67ea9e1f-b2d9-423c-ab9e-c234945f9c0b/7948818c-d3b5-4844-bf1b-5cc22f6fe6e1/?context=icp4data
    カテゴリーIDを見つける:
    1. メインメニューから IBM Cloud Pak for Data Governanceを展開し、 Categoriesを選択します。
    2. 使用しているカテゴリーに移動する。
    3. ブラウザの URL では、"/categories/" 文字列の後にカタログIDが表示されます。 例えば、以下の URL、idは dc559b02-a39a-4132-8832-d42cd51af994 である: https://api.dataplatform.cloud.ibm.com/gov/categories/dc559b02-a39a-4132-8832-d42cd51af994
  3. リクエストボディに値を入力する。
    次に例を示します。
    指定 デフォルト値 説明
    戦略 オプション industrymodel_ldm 資産適用する期間割り当て戦略。 industrymodel_ldm
    asset_id オプション カタログの論理データモデル。 ビジネス用語を割り当てるカタログ内の資産 ID。 7948818c-d3b5-4844-bf1b-5cc22f6fe6e1
    カテゴリーID オプション インストールされたナレッジ・アクセラレーターのビジネス・コア・ボキャブラリー。 資産のマップ先となるビジネス用語のsourceする元となるカテゴリーの ID。 これにより、提供されたカテゴリのサブカテゴリが自動的に含まれ、さらにその条件も含まれることになる。 dc559b02-a39a-4132-8832-d42cd51af994
    ldm_type オプション エンティティおよび列名と用語の割り当てに使用する、業界モデル論理モデルのストアド代入のタイプ。 エンティティ名/列名から用語への割り当てに使用する、業界モデル論理モデルの格納された割り当てのタイプ。 bfmdw_awm
    ターム・マッチング・メソッド オプション 用語のマッチング方法としては、artifact_id(id)のみがサポートされている。 用語のマッチング方法としては、artifact_id(id)のみがサポートされている。 id
    catalog_id 必須 ビジネス用語を割り当てたい資産含むカタログの ID。 ビジネス用語を割り当てたい資産含むカタログの ID。 カタログIDまたはプロジェクトIDのいずれかを指定するが、複数指定することはできない。 67ea9e1f-b2d9-423c-ab9e-c234945f9c0b
  4. レスポンスの「process_id 」に注意してください。これは、次のセクション「 期 間割り当てプロセスのステータスを確認する 」で、 ジョブステータスを確認するために使用でき るからです。 インポートされた論理データモデル資産用語集の数とサイズによっては、割り当て処理に時間がかかることがあるため、このチェックを行うことが必要または望ましい場合があります。

期限付き移籍手続き状況の確認

ビジネス用語の論理データモデル資産割り当ての進捗を監視するには、 資産用語の割り当て状況を取得します APIエンドポイントを呼び出します。ここで、 {process_id}論理データモデル資産用語の割り当て の値です。

参照 https://cloud.ibm.com/apidocs/watson-data-api-cpd#get-mappings-added

プロジェクトへのコピー

Knowledge Accelerator アイテムをプロジェクトにコピー API エンドポイントを使用して、 Cloud Pak for Data プロジェクトに Knowledge Accelerators の成果物 CSV ファイルとして追加することもできます。

参照 https://cloud.ibm.com/apidocs/watson-data-api-cpd#copy-ka-into-ikc.

ヒント: CSVファイルをローカルにダウンロードし、UIでコンテンツをインポートすることができます。 詳しくは https://cloud.ibm.com/apidocs/knowledge-catalog#copy-ka-into-ikc.