プラットフォーム全体での資産および成果物の検索
グローバル検索バーを使用して、アクセス権限を持つすべてのプロジェクト、デプロイメント・スペース、およびカタログにわたって資産を検索できます。 また、アクセスできるカテゴリー全体でガバナンス成果物を検索することもできます。
要件と制約事項
アセットおよび成果物は、以下の状況で見つけることができます。
必須サービス
ありません。 検索は常に使用可能です。
必要な権限
資産を検索するために、プロジェクト、カタログ、またはデプロイメント・スペースで任意の役割を持つことができます。
ガバナンス成果物を検索するために、カテゴリー内で任意の役割を持つことができます。
ワークスペース
以下のワークスペースにある資産を検索できます。
- プロジェクト
- カタログ
- 展開スペース
カテゴリー内のガバナンス成果物を検索できます。
資産タイプ
すべてのタイプの資産を検索できます。
制限
カテゴリー・コラボレーターとして追加された場合、そのカテゴリー内のガバナンス成果物を検索するには、最大 20 分待つ必要がある場合があります。
検索結果には、自分が属するワークスペース内のアセットと成果物のみが含まれます。
資産と成果物の検索
資産または成果物を検索するには、グローバル検索フィールドに 1 つ以上の単語を入力します。 検索結果は、資産および成果物の以下のプロパティーから一致するものです。
- 名前
- 表示名
- 説明
- タグ
- ビジネス用語の同義語
- 列名注: 列名を検索するには、資産のプロファイルが作成されていることを確認してください。 自動プロファイルが無効になっているカタログに資産を作成すると、それらの資産に対してプロファイルを実行しない限り、列名を検索できない場合があります。
- 列の説明
- 割り当てられたガバナンス成果物
- 割り当てられたカテゴリー
- カスタム・フィールド
- 表名
- スキーマ名
- 列に割り当てられたタグ
- 列に割り当てられたビジネス用語
- ビジネス用語の省略形
- 関連するビジネス用語および関連する資産
以下の手法を使用して、検索をカスタマイズできます。
単語の先頭の検索
単語を検索するには、単語の最初の 3 文字を入力します。
単語の一部の検索
単語の部分一致を検索するには、4 文字以上を含めます。 例えば、 conn
を検索すると、 connection
や disconnect
のような結果が表示されます。
検索で使用されるのは、単語の最初の 12 文字のみです。 入力した検索語のうち、12 文字を超えるものは、最初の 12 文字に切り捨てられます。
部分的な単語の検索は、説明フィールドでは機能しません。
句の検索
特定の句を検索するには、その句を二重引用符で囲みます。 例えば、 "payment plan prediction"
を検索した場合、結果にはその句が正確に含まれます。
長い検索ストリング内に引用符で囲んだ句を含めることができます。 例えば、credit card "payment plan prediction"
を検索すると、credit card
、credit
、card
、およびpayment plan prediction
を含む結果が返される場合があります。
英語で句を検索する場合、自然言語分析は以下の方法で検索結果を最適化します。
- 検索インテントにとって重要でない単語は、検索照会から削除されます。
- 英語で一般的な検索ストリング内の句は、個々の単語の結果よりも自動的に上位にランク付けされます。
例えば、find credit card interest in United States
を検索すると、以下のような結果になります。
credit card interest
とUnited States
の一致が優先されます。credit
、card
、interest
、United
、およびStates
の一致が返されます。in
の一致は返されません。
複数の代替ワードの検索
いずれかの 検索語が含まれる検索結果を得るには、複数の単語を入力します。 例えば、 machine learning
を検索した場合、結果には machine
という語、 learning
という語、またはその両方の語が含まれます。
プロパティーの検索
検索バーで 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で取得する:
グループ識別子を取得するには、次の API を使用します。
GET /v2/asset_types/{type_name}
カスタムプロパティグループの一意な識別子は、
decorated_by
プロパティに列挙されています。同じエンドポイントを使用しますが、カスタムプロパティグループの一意の識別子をアセットとして提供します。
type_name
このグループに含まれるカスタム プロパティの識別子を取得します。
グローバル検索バーで機能するには、カスタム属性を検索可能として定義する必要があることに注意してください。 カスタム・プロパティーが検索可能かどうかを確認するには、以下のようにします。
- 以下の照会を使用して、資産タイプの
global_search_searchable
としてマークされているフィールドを確認します。
GET /v2/asset_types/{asset_type_name}
結果の選択
最良の結果を選択するには、アセットまたは成果物のどのプロパティーが検索ストリングと一致するかを確認します。 一致するテキストが強調表示されます。 カスタム プロパティで検索する場合、一致するテキストは現在検索結果に表示されません。
以下のイメージは、検索結果がどのように表示されるかを示しています。
スコアリング結果が最も高くなるのは、資産または成果物の名前と一致する場合です。 複数の資産および成果物が同じ名前を持つことができます。 ただし、資産名や成果物名の下にプロジェクト、カタログ、デプロイメント・スペース、またはカテゴリーの名前が表示されるため、どれが必要な結果であるかを判別することは可能です。
資産または成果物の名前をクリックすると、プロジェクト、カタログ、デプロイメント・スペース、またはカテゴリーで表示されます。
結果は以下の順序で優先順位付けされます。
- 引用符で囲まれた句または共通の句の一致 (英語のみ)
- 全単語の完全一致
- 全単語の部分一致
- あいまい一致
検索結果から 「プレビュー」 をクリックすると、サイド・パネルに詳細情報を表示できます。 「カタログに公開」 ボタンを使用してプロジェクトからカタログに資産を公開することも、 「プロジェクトに追加」 ボタンを使用してカタログからプロジェクトに資産を追加することもできます。
結果のフィルタリングとソート
以下のプロパティーで検索結果をフィルターに掛けることができます。
- アセットまたは成果物のタイプ
- タグ
- スチュワードまたは所有者 (一部のタイプの資産および成果物)
- 資産または成果物を変更したユーザー
- 資産または成果物が最後に変更された期間
- カテゴリー (成果物のみ)
- カタログ (資産のみ)
- プロジェクト (資産のみ)
- ワークスペース
- 列・単語
- 列・データ・クラス
- スキーマ
- 表
- 分類 (資産のみ)
- ビジネス用語
- 包含要素: 特徴量グループ
最も高い関連性、または最終変更日で結果をソートできます。
検索の保存
後で使用するために検索条件を保存できます。 検索バーに入力すると、保存済み検索がドロップダウン・リストにリストされます。 保存済み検索を編集または削除することもできます。
検索バーに検索語を入力し、必要に応じて検索結果にフィルターを適用します。 準備ができたら、上部バーの 「検索の保存」 をクリックします。
右側のパネルにリストを表示するには、「保存済み検索」アイコンをクリックします。 そこから、検索名を変更するか、保存済み検索を削除することができます。
もっと見る
親トピック: アセット・タイプおよびプロパティー