Unity Catalog のセキュリティ保護可能なオブジェクトにタグを適用する
この記事では、Unity Catalog のセキュリティ保護可能なオブジェクトにタグを適用する方法について説明します。
タグは、Unity Catalog でセキュリティ保護可能なオブジェクトを整理および分類するために使用できるキーと省略可能な値を含む属性です。 タグを使用すると、ワークスペースの検索機能を使用したテーブルとビューの検索と検出も簡素化されます。
タグデータはグローバルにレプリケートできます。 リソースのセキュリティを損なう可能性のあるタグ名や値は使用しないでください。 たとえば、個人情報や機密情報を含むタグ名は使用しないでください。
サポートされているセキュリティ保護可能なオブジェクト
セキュリティ保護可能なオブジェクトのタグ付けは、現在、カタログ、スキーマ、テーブル、テーブル列、ボリューム、ビュー、登録済みモデル、およびモデル バージョンでサポートされています。 セキュリティ保護可能なオブジェクトの詳細については、「Unity Catalogのセキュリティ保護可能なオブジェクト」を参照してください。
必要条件
Unity Catalog のセキュリティ保護可能なオブジェクトにタグを追加するには、オブジェクトを所有しているか、次のすべての特権を持っている必要があります。
APPLY TAGオブジェクトについてUSE SCHEMAオブジェクトの親スキーマUSE CATALOGオブジェクトの親カタログ
制約
タグ制約の一覧を次に示します。
-
1 つのセキュリティ保護可能なオブジェクトに最大 50 個のタグを割り当てることができます。
-
タグキーの最大長は 255 文字です。
-
タグ値の最大長は 1000 文字です。
-
次の文字はタグキーには使用できません。
. , - = / : -
ワークスペース検索 UI を使用したタグ検索は、テーブル、ビュー、およびテーブル列でのみサポートされます。
-
タグ検索では、用語が完全に一致する必要があります。
Catalog Explorer を使用したタグの追加と更新
Catalog Explorerを使用してセキュリティ保護可能なオブジェクトタグを追加および更新するには：
-
サイドバーの [
カタログ ] をクリックします。 -
セキュリティ保護可能なオブジェクトを選択します。
-
オブジェクトの [概要 ] ページで、タグを追加または更新します。
- タグがない場合は、[ タグの追加 ] ボタンをクリックします。
- タグがある場合は、[
タグの追加/編集] アイコン をクリックします。
タグの追加/編集ダイアログを使用して、複数のタグを追加および削除できます 。
タグキーは必須です。 タグの値はオプションです。
テーブル列のタグを追加または削除するには、「
タグを追加 」アイコンをクリックします。
SQL コマンドを使用したタグの追加と更新
この機能は、Databricks Runtime バージョン 13.3 以降で使用できます。
ALTER <object> SQL コマンドを使用して、カタログ、スキーマ、テーブル (ビュー、マテリアライズド・ビュー、ストリーミング・テーブルを含む)、ボリューム、およびテーブル列にタグを付けることができます。たとえば、 SET TAGS 句と UNSET TAGS 句を ALTER TABLE と共に使用して、テーブルのタグを管理できます。 使用可能なデータ定義言語 (DDL) コマンドとその構文のリストについては、 DDL ステートメント を参照してください。
登録済みモデルの場合は、Catalog Explorer または MLflow ClientAPI を使用する必要があります。 モデルでのタグの使用を参照してください。
タグを使用してテーブルを検索する
Databricks ワークスペースの検索バーを使用して、タグ キーとタグ値を使用してテーブル、ビュー、およびテーブル列を検索できます。 テーブルタグとテーブル列タグの両方を使用できます。 タグを使用して、カタログ、スキーマ、ボリュームなどの他のタグ付きオブジェクトを検索することはできません。
表示権限のあるテーブルとビューのみが検索結果に表示されます。 つまり、検索結果でオブジェクトを返すには、少なくとも オブジェクト (またはオブジェクトの親カタログとスキーマ) に対する BROWSE 権限が必要です。
詳細については、「タグを使ってテーブルを検索する」を参照してください。
情報スキーマテーブルからタグ情報を取得する
Unity Catalog で作成された各カタログには、 INFORMATION_SCHEMA. このスキーマには、スキーマのカタログで認識されているオブジェクトを記述するテーブルが含まれています。 スキーマ情報を表示するには、適切な権限が必要です。
次のクエリを実行して、タグ情報を取得できます。
詳細については、「 情報スキーマ」を参照してください。