Knowledge Accelerators の概説
コンポーネントを Knowledge Accelerators コンポーネントを IBM Knowledge Catalog に追加し、コンポーネントをカスタマイズする。
始める前に
- 以下のプランと ユーザー権限があることを確認してください:
- オファリング・プラン
- その IBM Cloud Pak for Data エンタープライズ・プラン 詳しくは、 IBM Knowledge Catalog サービスプランをご覧ください。
- 必要な権限
- カタログへのアクセス
- 資産ディスカバリーの管理
- ガバナンス成果物へのアクセス
- グロッサリー管理
- ガバナンス・カテゴリーの管理
- プロジェクトの管理
を追加する Knowledge Accelerators UIで
Add Knowledge Accelerator
タイル。
」に移動し、 - 語彙を追加する業種を選択します。
- 業種に追加したいビジネススコープまたはスコープを選択します。
- 全項目 - 特定の Knowledge Accelerators 語彙をすべてインポートする
完全なビジネス・ボキャブラリーとすべてのビジネス・スコープを含む特定の Knowledge Accelerators ボキャブラリーのそれぞれをインポートすることを選択できます。 例えば、5,000~20,000語など、幅広い業種に対応するために広範なビジネス用語セットをインポートする必要がある場合は、このオプションを選択してください。
Industry Alignment Vocabularies は、API を使用して個別にインポートできます。
- 選択項目 - ビジネススコープのインポート
Data Privacy、その他の業界固有のスコープなど、 Knowledge Accelerators ビジネススコープを個別にインポートすることができます。 関心のある分野にこれらのビジネススコープが1つ以上存在し、比較的少数のビジネス用語、たとえば200から500の用語から始めることを好む場合は、これらの別個のスコープを1つ以上インストールしてください。 各ビジネス・スコープは個別にインポートされる。
定義、ID、および詳細情報を含む、各業界で使用可能なすべての項目の詳細なリストについては、以下のリンクを参照してください。 - インポートのマージオプションを設定する。
詳細は インポートした成果物と既存の成果物をマージする方法 を参照。
Add
をクリックしてインポートを開始する。注:- 複数のKAビジネススコープをインポートした場合、ポリシーやルールなどの共有成果物語彙用語へのリレーションシップの一部が、後続のビジネススコープのインポートによって上書きされる可能性があります。
- 複数の業界の Knowledge Accelerators をインポートする場合、ポリシーやルールから語彙用語への変換などの共有成果物からの関係は、後続のインポートのためにマージされない可能性があります。最初にインポートされた KA 成果物からのマッピングは保持されます。 ポリシーおよびガバナンス・ルールに関連するインポート・ログ内のメッセージ (GIM00010E または GIM00015E) は無視できます。
インポート開始の通知メッセージが表示されたら、ウィンドウを閉じます。
複数のインポート・ジョブを同時に開始することはできません。
- インポートが完了しても通知されないので、通知の
process_id
。process_id
を使って ジョブステータスをチェックする。 輸入される商品の数や大きさによっては、輸入に時間がかかる場合があります。インポートが完了したら、共同作業者の追加を開始できます。
を追加する Knowledge Accelerators APIで
のAPIエンドポイントの説明は、APIドキュメントをご覧ください。 Knowledge Accelerators の API エンドポイントの説明は API ドキュメントを参照してください。
- オプション:どの Knowledge Accelerators がすでにインポートされているか確認するには、 Get what Knowledge Accelerator items are imported into glossary APIエンドポイントを呼び出します。
- オプションです:インポートできる項目をチェックします:
- 全業種については、 Get all Knowledge Accelerators API エンドポイントを呼び出す。
- 特定の業種については、 Get a specific Knowledge Accelerator API エンドポイントを呼び出してください。
各業界で使用する ID 値を以下の表に示します。
業界共通 電力/ガス 金融サービス 医療 保険 kaci20
kaeu20
kafs20
kahc20
kain20
- APIを使って Knowledge Accelerators コンポーネントを追加するために Cloud Pak for DataIBM Cloud で認証する必要があります:
- コンソールでAPIキーを作成する 」の説明に従って、APIキーを取得します。
- API キーを使用して IAM トークンを生成する IBM Cloud IAM トークンを生成する で説明しているように、API キーを使用して IAM トークンを生成します。
- 指定された Knowledge Accelerator アイテムを用語集 API エンドポイントにインポートする呼び出します。
- インストールする項目を選択します。注:
- 複数のKAビジネススコープをインポートした場合、ポリシーやルールなどの共有成果物語彙用語へのリレーションシップの一部が、後続のビジネススコープのインポートによって上書きされる可能性があります。
- 複数の業界の Knowledge Accelerators をインポートする場合、ポリシーやルールから語彙用語への変換などの共有成果物からの関係は、後続のインポートのためにマージされない可能性があります。最初にインポートされた KA 成果物からのマッピングは保持されます。 ポリシーおよびガバナンス・ルールに関連するインポート・ログ内のメッセージ (GIM00010E または GIM00015E) は無視できます。
- すべての項目
- Knowledge Accelerators のボキャブラリーは、4 つの特定の業種ごとに存在し、完全なビジネス・ボキャブラリー、業界アライメント・ボキャブラリー、およびすべてのビジネス・スコープを含んでいます。 これらのボキャブラリーのすべてをインポートするか、選択したボキャブラリーをインポートするかを選択できます。 業界の幅 (例えば、5,000 から 20,000 個の用語) に対応するために広範なビジネス用語セットをインポートする必要がある場合は、このオプションを選択します。
- 選択項目 - ビジネススコープのインポート
- Knowledge Acceleratorのビジネススコープを個別にインポートすることも可能です。例えば、 Data Privacy、その他の業界固有のスコープがあります。 関心のある領域に対してこれらのビジネス・スコープが 1 つ以上存在し、比較的少数のビジネス用語 (例えば、200 から 500 個の用語) から開始する場合は、これらの個別のスコープを 1 つ以上インストールできます。
定義、ID、および詳細情報を含む、各業界で使用可能なすべての項目の詳細なリストについては、以下のリンクを参照してください。 - 以下のパラメーターの値を入力します。次に例を示します。
パラメーター 説明 例 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
- インポートが完了しても通知されないので、通知の
process_id
。process_id
を使って ジョブステータスをチェックする。 輸入される商品の数や大きさによっては、輸入に時間がかかる場合があります。インポートが完了したら、共同作業者の追加を開始できます。
輸入状況の確認
資産状況のインポート APIエンドポイントを呼び出す でインポートのステータスを確認する。 {process_id}
は API で Knowledge Accelerators を追加した ステップ4 の値。
インポート状況は、すべての成果物がインポートされるまで "IN_PROGRESS"
のままです。
リソース・ハブでの Knowledge Accelerators の検索
- ログイン Cloud Pak for Data as a Service リソースハブ https://dataplatform.cloud.ibm.com/gallery.
- を選択する。
- タイルをクリックすると、特定の業種の詳細が表示されます。 Knowledge Accelerators 業界の詳細を表示します。
コラボレーターの追加
コラボレーターを Knowledge Accelerators カテゴリーに追加する必要があります。追加しない場合は、アクセラレーターをインポートしたユーザーのみが成果物を使用できます。 これを行う方法について詳しくは、 カテゴリーへのアクセスの管理 を参照してください。論理データモデル資産用語の割り当て
この機能は Knowledge Accelerators この機能は Knowledge Accelerators カタログにインポートされた論理データモデル資産ビジネス用語を自動的に割り当てる。 IBM Cloud Pak for Data カタログにインポートされます。
- 前提条件
- 論理データ・モデルをカタログにインポートする必要がある。 IBM Cloud Pak for Data カタログにインポートする必要があります。 以下の手順でモデルをインポートすることができます:
前提条件 ステップと詳細情報 1. MANTA 自動データ・リネージュインストールします。 2. リネージュ有効にする。 3.以下の IBM 業種別モデルをお使いの場合は、インポートするモデルを準備する必要があります。 - 論理データモデルの erwin Data Modeler ファイルを開きます。
- モデルからすべてのダイアグラムを削除する。 詳しくは、こちらのサポートページをご覧ください。 https://www.ibm.com/support/pages/node/7070054
- モデルを Standard XMLとして保存します。
- 標準XML ファイルを圧縮またはzip圧縮する。
詳細については、 IBM サポートまでお問い合わせください。
4.論理データモデルをインポートします。
- エンドポイントを呼び出すには
既存の Knowledge Accelerators 用語を論理データモデル資産割り当てるには、 指定されたストラテジーを使用して資産タームを割り当てる API エンドポイントを呼び出します。
- 参照 https://cloud.ibm.com/apidocs/watson-data-api-cpd#post-add-assignment.
- カタログ、 資産、カテゴリーのIDをユーザー・インターフェイスで検索する。 IBM Knowledge Catalog ユーザーインターフェイスで
- カタログIDを検索する:
- メインメニューから IBM Cloud Pak for Data カタログ]を展開し、[ すべてのカタログ]を選択します。
- 使用しているカタログにアクセスする。
- ブラウザの 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を見つけるには
- カタログからフィルターアイコンをクリックし、
Asset Type
「 論理モデル 」を選択し、「 適用 」をクリックする。 - 結果セットにリストされている "Logical Model" をクリックする。例えば、 Atomic Warehouse Model。
- ブラウザの 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を見つける:
- メインメニューから IBM Cloud Pak for Data Governanceを展開し、 Categoriesを選択します。
- 使用しているカテゴリーに移動する。
- ブラウザの URL では、"
/categories/
" 文字列の後にカタログIDが表示されます。 例えば、以下の URL、idは dc559b02-a39a-4132-8832-d42cd51af994 である:https://api.dataplatform.cloud.ibm.com/gov/categories/dc559b02-a39a-4132-8832-d42cd51af994
- リクエストボディに値を入力する。次に例を示します。
値 指定 デフォルト値 説明 例 戦略 オプション 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
- レスポンスの「
process_id
」に注意してください。これは、次のセクション「 期 間割り当てプロセスのステータスを確認する 」で、 ジョブステータスを確認するために使用でき るからです。 インポートされた論理データモデル資産用語集の数とサイズによっては、割り当て処理に時間がかかることがあるため、このチェックを行うことが必要または望ましい場合があります。
期限付き移籍手続き状況の確認
ビジネス用語の論理データモデル資産割り当ての進捗を監視するには、 資産用語の割り当て状況を取得します APIエンドポイントを呼び出します。ここで、 {process_id}
は 論理データモデル資産用語の割り当て の値です。
参照 https://cloud.ibm.com/apidocs/watson-data-api-cpd#get-mappings-added
プロジェクトへのコピー
参照 https://cloud.ibm.com/apidocs/watson-data-api-cpd#copy-ka-into-ikc.