メインコンテンツまでスキップ

ワークスペース オブジェクトの検索

この記事では、Databricks ワークスペースでテーブル、ボリューム、ノートブック、クエリ、ダッシュボード、アラート、ファイル、フォルダー、ライブラリ、ジョブ、リポジトリ、パートナー、Marketplace の一覧を検索する方法について説明します。

テーブルを検索結果に表示するには、Unity Catalog に登録する必要があります。

注記

このセクションで説明する検索動作は、E2 以外のワークスペースではサポートされていません。 これらのワークスペースでは、サイドバーの「検索アイコン 検索 」をクリックし、「 ワークスペースの検索 」フィールドに検索文字列を入力できます。入力すると、名前に検索文字列が含まれているオブジェクトが一覧表示されます。 リストから名前をクリックすると、その項目がワークスペースで開きます。

暗号化に顧客管理のキーを使用するワークスペースでは、ノートブックの内容とクエリの内容は検索で利用できません。

インテリジェント検索​

検索では、Databricks DatabricksIQ用の Data Intelligence Engine である を活用して、よりインテリジェントなDatabricksAI ベースの検索エクスペリエンスを提供します。AI が生成するコメントは、LLM を使用して、Unity Catalog によって管理されるテーブルと列に説明とタグを自動的に追加します。 これらのコメントにより、検索エンジンは独自の企業用語、メトリクス、セマンティクスを認識し、検索結果をより関連性が高く、正確で、実用的なものにするために必要なコンテキストを提供します。

ナビゲーション検索​

UI の上部バーにあるナビゲーション検索を使用してワークスペースを検索するには、次の操作を行います。

  1. Databricks ワークスペースの上部バーにある [検索 ] フィールドをクリックするか、キーボード ショートカットの Command-P を使用します。

    ナビゲーション検索バー

    最近使用したファイル、ノートブック、クエリー、アラート、ダッシュボードが「 最近使用したアイテム 」の下に一覧表示され、最後に開いた日付順に並んでいます。

  2. 検索条件を入力します。

    リスト内の最近使用したオブジェクトは、検索条件に一致するようにフィルタリングされます。 ナビゲーション検索では、条件に一致する他のオブジェクトが提案される場合もあります。 ワークスペースの完全な検索を実行するには、 検索結果 ページを使用します。

  3. リストから項目を選択してください。

検索結果ページ​

フルページ検索エクスペリエンスにより、結果を表示するためのスペース、オブジェクトのメタデータ、結果を絞り込むためのフィルターが増えます。

「検索結果 」ページで、オブジェクト・タイプ、オブジェクト所有者、または最終更新日で検索結果をフィルタするには、次の手順を実行します。

  1. Databricks ワークスペースの上部バーにある [検索 ] フィールドをクリックするか、キーボード ショートカットの Command-P を使用して、Enter キーを押します。

    検索結果 ページが開きます。

  2. 検索条件を入力します。

  3. リストから項目を選択してください。

テキスト文字列、オブジェクトタイプ、またはその両方で検索できます。 検索条件を入力して Enter キーを押すと、アクセス権を持つワークスペース内のすべてのクエリ、ダッシュボード、アラート、ファイル、フォルダー、ノートブック、ライブラリ、リポジトリ、パートナー、Marketplace リストの名前が検索されます。 ワークスペースで Unity Catalog が有効になっている場合、システムはテーブル名、テーブル コメント、列名、および列コメントも検索します。

テキスト文字列で検索​

テキスト文字列を検索するには、検索フィールドに文字列を入力し、Enterキーを押します。システムは、アクセス権のあるワークスペース内のすべてのオブジェクトの名前を検索します。また、ノートブックコマンド内のテキストも検索しますが、ノートブック以外のファイル内テキストは検索しません。

検索エントリを引用符で囲むと、正確なフレーズを含むドキュメントのみに検索結果を絞り込むことができます。

完全一致検索では、以下がサポートされています。

  • 基本的な引用符（例："spark.sql("）
  • エスケープされた引用符（例："spark.sql(\"select"）

完全一致検索では、以下はサポートされていません。

  • 引用符付きのフレーズと引用符なしのフレーズの混在（例："spark.sql" partition）
  • 複数の引用符（例："spark.sql" "partition"）

セマンティック検索​

備考

プレビュー

この機能は パブリック プレビュー段階です。

自然言語を使用して Unity Catalog テーブルを検索できます。 検索では、関連するセマンティックな意味を持つ結果が返されます。

たとえば、「地域に何を使用すべきか」という検索クエリでは、「地域」に焦点が当てられ、都市、国、地域、地理的位置などの地理的属性を含む関連用語が検索されます。

また、検索では、検索語句をフィルターから分離することで、検索クエリのパターンを理解できるため、自然言語クエリはさらに強力になります。

たとえば、「検査に関する表を見せて」という検索クエリは、「検査」がキーワードで、「テーブル」はユーザーが検索するオブジェクトの種類になるように分類されています。

検索を特定のオブジェクトタイプに限定する​

アイテムを種類 (ファイル、フォルダ、ノートブック、ライブラリ、テーブル、リポジトリなど) で検索するには、 検索結果 ページで [ 種類 ] ドロップダウン リストまたはページの右側にあるタブからオブジェクトの種類をクリックします。 テキスト文字列は必須ではありません。 テキストフィールドを空白のままにして Enter キーを押すと、そのタイプのすべてのオブジェクトが検索されます。 リストから名前をクリックすると、その項目がワークスペースで開きます。 また、ドロップダウンメニューを使用して、所有者や最終更新日など、特定のタイプのアイテムの検索結果をさらに絞り込むこともできます。

検索クエリのフィルターは、UI の上部にある検索バーで指定することもできます。 たとえば、検索クエリに type:table owner:meを含めて、所有するテーブルを検索できます。 構文を使用してフィルターを指定する方法の詳細については、 検索結果 ページでフィルターを適用し、検索バーのクエリが自動的に更新される方法を確認してください。

人望​

検索では、ワークスペース内の他のユーザーが特定のテーブルを操作している頻度に基づいて人気シグナルを使用し、テーブルのランク付け方法を改善します。

人気度を高めないと、検索結果で返されたテーブルをクエリして、どのテーブルが信頼できるテーブルであるかを知る必要があります。 人気上昇により、最も人気のあるテーブルが上位にランク付けされるため、どちらが正しいかを推測する必要はありません。 検索結果のテーブル名の横にある人気インジケータ 人気指標アイコン 、オブジェクトのランキングを反映しています。 検索結果を人気順に並べ替えることもできます。

ナレッジカード​

検索で探しているものを高い信頼性で特定できる場合、上位の検索結果がナレッジ カードに変わります。 ナレッジ カードは、追加のオブジェクト メタデータを提供します。 ナレッジ カードは、マネージド テーブル Unity Catalog サポートされています。

ナレッジカードの例

Unity Catalog 対応ワークスペースでのテーブルとモデルの検索​

Unity Catalogが有効になっているワークスペースでは、Unity Catalogに登録されているテーブルやモデルを検索できます。次のいずれかで検索できます。

  • テーブル、ビュー、またはモデル名。
  • テーブル、ビュー、またはモデルのコメント。
  • テーブルまたはビューの列名。
  • テーブルまたはビューの列のコメント。
  • テーブルまたはビュー のタグキー。

[検索結果 ] ページで親カタログ、親スキーマ、所有者、またはタグで検索結果をフィルタリングするには、[ タイプ ] ドロップダウン メニューをクリックして [ テーブル ] を選択します。フィルターのドロップダウンメニューは、ページの上部に表示されます。

また、テーブルの人気度で結果を並べ替えることもできます。

以下は検索結果に含まれません：

  • 見る権限のないテーブル、景色、モデル。

    つまり、テーブルまたはモデルを検索結果に表示するには、少なくともそのテーブルに対する SELECT 権限またはモデルに対する EXECUTE 権限、親スキーマに対する USE SCHEMA 権限、および親カタログに対する USE CATALOG 権限が必要です。 メタストアの管理者は、デフォルトによってこれらの特権を持っています。 他のすべてのユーザーには、これらの権限を付与する必要があります。 「Unity Catalog の特権とセキュリティ保護可能なオブジェクト」を参照してください。

  • レガシ (hive_metastore カタログ) のテーブルとビュー Hive metastore

    これらのテーブルを Unity Catalog にアップグレードして検索できるようにするには、「 Hive テーブルとビューを Unity Catalog にアップグレードする」の手順に従います。

  • ワークスペース内のモデル モデルレジストリ.

    ML ワークフローをアップグレードして Unity Catalog でモデルを作成するには、「 Unity Catalog で ML ワークフローをターゲット モデルにアップグレードする」を参照してください。

タグを使用してテーブルを検索する​

Databricks ワークスペースの検索バーを使用して、タグ キーとタグ値を使用して、テーブル、ボリューム、ビュー、およびテーブル列を検索できます。 タグキーを使用して、ワークスペース検索でテーブルとビューをフィルタリングすることもできます。 カタログやスキーマなど、他のタグ付きオブジェクトは検索できません。 「Unity Catalog のセキュリティ保護可能なオブジェクトにタグを適用する」も参照してください。

表示権限のあるテーブルとビューのみが検索結果に表示されます。

タグを使用してテーブル、ビュー、および列を検索するには、次のようにします。

  1. Databricks ワークスペースの上部バーにある [検索 ] フィールドをクリックするか、キーボード ショートカットの Command-P を使用します。

    カタログエクスプローラのフィルタフィールドを使用してタグで検索することはできません。

  2. 検索条件を入力します。 タグ付きのテーブルまたは列を検索するには、テーブルまたは列のタグ キーまたは値を入力します。 正確なタグ キーまたは値の用語を使用する必要があります。

    タグキーのみで検索する場合は、構文 tag:<tag_key>を使用します。 タグ キーとタグ値の両方で検索するには、 tag:を省略します。

    タグキーによるテーブルの検索

タグキーを使用してテーブル検索結果をフィルタリングするには:

  1. Databricks ワークスペースの上部バーにある [検索 ] フィールドをクリックするか、キーボード ショートカットの Command-P を使用します。
  2. 検索語句を入力するか、検索フィールドを空白のままにします。
  3. 検索結果ページで 、「 タイプ 」ドロップダウンメニューをクリックし、「 テーブル 」を選択します。
  4. [タグ フィルター] ドロップダウン メニューを使用して、タグ キーを選択します。
に最終更新