0 / 0
資料の 英語版 に戻る
プラットフォーム全体での資産および成果物の検索

プラットフォーム全体での資産および成果物の検索

グローバル検索バーを使用して、アクセス権限を持つすべてのプロジェクト、デプロイメント・スペース、およびカタログにわたって資産を検索できます。 また、アクセスできるカテゴリー全体でガバナンス成果物を検索することもできます。

要件と制約事項

アセットおよび成果物は、以下の状況で見つけることができます。

必須サービス

ありません。 検索は常に使用可能です。

必要な権限

資産を検索するために、プロジェクト、カタログ、またはデプロイメント・スペースで任意の役割を持つことができます。

ガバナンス成果物を検索するために、カテゴリー内で任意の役割を持つことができます。

ワークスペース

以下のワークスペースにある資産を検索できます。

  • プロジェクト
  • カタログ
  • 展開スペース

カテゴリー内のガバナンス成果物を検索できます。

資産タイプ

すべてのタイプの資産を検索できます。

制限

カテゴリー・コラボレーターとして追加された場合、そのカテゴリー内のガバナンス成果物を検索するには、最大 20 分待つ必要がある場合があります。

検索結果には、自分が属するワークスペース内のアセットと成果物のみが含まれます。

プロパティーの検索

検索バーで key:value ペアを使用すると、アセットと成果物のプロパティー (説明、タグ、カスタム・プロパティー、列名など) 内を検索できます。 最高の優先順位は、常にアセットまたは成果物の名前に与えられます。

すぐに使用可能なプロパティーには、以下の検索キーを指定できます。 検索ドロップダウンには、これらのキーのオートコンプリート候補が表示されます。 これらのキーの一部では検索結果で完全一致のみがサポートされ、一部では部分一致がサポートされていることに注意してください。

プロパティー名 検索で使用するキー 説明 部分一致はサポートされていますか?
名前 name: アセットまたは成果物の名前内で検索します。 はい
説明 desc: アセットまたは成果物の説明内で検索します。 はい
ビジネス用語 term: 特定のビジネス用語が割り当てられているアセットおよび成果物を検索します。 はい
タグ tag: 特定のタグを使用してアセットおよび成果物を検索します。 はい
1 次カテゴリー category: 指定された 1 次カテゴリーを持つ成果物を検索します。 はい
2 次カテゴリー category2: 指定された 2 次カテゴリーの成果物を検索します。 はい
分類 classification: アセットまたは成果物の分類で検索します。 はい
省略形 abbr: ビジネス用語の省略形で検索します。 いいえ
同義語 syn: ビジネス用語の同義語で検索します。 いいえ
名前 (列) column: データ資産内の列の名前内を検索します。 はい
説明 (列) columnDesc: データ資産の列の説明内で検索します。 はい
タグ (列) columnTag: データ資産内の列でタグを使用して検索します。 はい
ビジネス用語 (列) columnTerm: データ資産内の列に割り当てられたビジネス用語を使用して検索します。 はい
データ・クラス (列) columnDataclass: データ資産内の列のデータ・クラスを使用して検索します。 いいえ
接続パス connection: 資産の接続パスを使用して検索します。 はい
スキーマ名 schema: 指定されたスキーマ名を持つデータ資産を検索します。 はい
表名 table: 指定された表名のデータ資産を検索します。 はい
リソース・キー resourceKey: 資産のリソース・キーを使用して検索します。 いいえ

以下の方法でキーを使用して検索することができます。

  • 特定のプロパティー内で検索するには、検索バーに key:value のペアを指定します。 例えば、名前に customer という単語が含まれている資産を検索するには、 name:customerというペアを使用します。 値が複数の単語で構成されている場合は、引用符で囲んでください (例: name:"sales report" )。
  • 複数の key:value ペアを使用して、検索をさらに絞り込みます (例: name:sales type:report)。 検索結果には、名前フィールドに sale があり、タイプ・フィールドに report があるすべての資産が含まれます。
  • key:value のペアを任意のテキスト・ストリング ( name:sales reportなど) と結合します。 名前フィールドで sales という語が検索され、通常のストリングとして report という語が検索されます。
  • key:value のペアをフィルター・ピルと組み合わせて、検索をさらに絞り込みます。

key: value のように、 key: の後にスペースがないことを確認してください。このような句は、検索によってペアとして扱われないためです。

アセットおよび成果物のカスタム・プロパティーの検索

key:value ペアを使用して、アセットまたは成果物のカスタム・プロパティー内を検索することもできます。 オートコンプリート候補はカスタム・プロパティーには使用できないため、キーはシステムに保存されているとおりに正確に指定する必要があります。

次の API 呼び出しを使用して、特定のアーティファクトのカスタム プロパティのリストを取得できます。

GET /v3/governance_artifact_types/{artifact_type}/custom_attribute_definitions

資産については、keyグループ識別子とドットで接続されたカスタム プロパティ識別子で構成されます。CP_group_unique_identifier.CP_unique_identifier

これらの識別子をUIから取得するには、カスタムプロパティまたはグループを開き、編集をクリックし、識別子を表示をクリックします。

一意な識別子をAPIで取得する:

  1. グループ識別子を取得するには、次の API を使用します。

    GET /v2/asset_types/{type_name}
    

    カスタムプロパティグループの一意な識別子は、decorated_byプロパティに列挙されています。

  2. 同じエンドポイントを使用しますが、カスタムプロパティグループの一意の識別子をアセットとして提供します。type_nameこのグループに含まれるカスタム プロパティの識別子を取得します。

グローバル検索バーで機能するには、カスタム属性を検索可能として定義する必要があることに注意してください。 カスタム・プロパティーが検索可能かどうかを確認するには、以下のようにします。

  • 以下の照会を使用して、資産タイプの global_search_searchable としてマークされているフィールドを確認します。
GET /v2/asset_types/{asset_type_name}

結果の選択

最良の結果を選択するには、アセットまたは成果物のどのプロパティーが検索ストリングと一致するかを確認します。 一致するテキストが強調表示されます。 カスタム プロパティで検索する場合、一致するテキストは現在検索結果に表示されません。

以下のイメージは、検索結果がどのように表示されるかを示しています。

検索結果には、一致するアセットと成果物が表示されます。

スコアリング結果が最も高くなるのは、資産または成果物の名前と一致する場合です。 複数の資産および成果物が同じ名前を持つことができます。 ただし、資産名や成果物名の下にプロジェクト、カタログ、デプロイメント・スペース、またはカテゴリーの名前が表示されるため、どれが必要な結果であるかを判別することは可能です。

資産または成果物の名前をクリックすると、プロジェクト、カタログ、デプロイメント・スペース、またはカテゴリーで表示されます。

結果は以下の順序で優先順位付けされます。

  1. 引用符で囲まれた句または共通の句の一致 (英語のみ)
  2. 全単語の完全一致
  3. 全単語の部分一致
  4. あいまい一致

検索結果から 「プレビュー」 をクリックすると、サイド・パネルに詳細情報を表示できます。 「カタログに公開」 ボタンを使用してプロジェクトからカタログに資産を公開することも、 「プロジェクトに追加」 ボタンを使用してカタログからプロジェクトに資産を追加することもできます。

結果のフィルタリングとソート

以下のプロパティーで検索結果をフィルターに掛けることができます。

  • アセットまたは成果物のタイプ
  • タグ
  • スチュワードまたは所有者 (一部のタイプの資産および成果物)
  • 資産または成果物を変更したユーザー
  • 資産または成果物が最後に変更された期間
  • カテゴリー (成果物のみ)
  • カタログ (資産のみ)
  • プロジェクト (資産のみ)
  • ワークスペース
  • 列・単語
  • 列・データ・クラス
  • スキーマ
  • 分類 (資産のみ)
  • ビジネス用語
  • 包含要素: 特徴量グループ

最も高い関連性、または最終変更日で結果をソートできます。

もっと見る

親トピック: アセット・タイプおよびプロパティー

生成 AI の検索と回答
これらの回答は、製品資料の内容に基づいて、 watsonx.ai のラージ言語モデルによって生成されます。 詳細