將註解新增至資料和 AI 資產

本文介紹資料和 AI 資產的註解，並說明如何新增。註解可協助您和其他使用者尋找及管理所需的資料和 AI 資產。

註解提供一個元數據欄位，用於標註您的可保護的物件。您可以將註解新增至 Unity Catalog 中的任何可安全操作的物件，例如目錄、結構、資料表、磁碟區、AI 模型等等。您也可以將批註新增至資料表數據行。

在可保護的物件中新增註解後，任何擁有 BROWSE 權限的使用者都可以查看這些留言。提高了目錄中資料的可用性和易於查找性。

您可以手動新增註解，也可以讓 Databricks 為您建立 AI 產生的註解。 AI 產生的批註（也稱為 AI 生成的文件）適用於表格和表格欄位。請參閱將 AI 產生的批註新增至 Unity Catalog 物件。

當您修改 Unity 目錄數據表的批注時（或舊版 Hive 中繼存放區中的 Delta Lake 數據表），數據表記錄中 SET TBLPROPERTIES 作業會記錄用來定義數據表批注的 SQL 查詢。

開始之前

您必須符合下列需求，才能新增或編輯註解：

若要在目錄、架構、磁碟區、模型、共用、收件者、提供者、記憶體認證、外部位置或連接上新增或編輯批註，您必須是對象的擁有者，或擁有物件的 MANAGE 許可權。
若要在資料表或數據行上新增或編輯批注，您必須是擁有者或具有下列許可權：
- 數據表上的 MODIFY 和 SELECT。
- USE CATALOG 和 USE SCHEMA 在父目錄和架構上。
您必須使用支援 Unity 目錄的 SQL 倉儲或其他計算。
若要使用 AI 產生的註解，您必須為 AI 輔助功能啟用工作區。請參閱將 AI 產生的批註新增至 Unity Catalog 物件。

您可以將批註新增至可設安全的物件，或使用 SQL 命令或使用目錄總管來編輯它們。

這很重要

儲存批注會觸發 ALTER SQL 命令，這可能會中斷 Azure Databricks 管線和作業。

在工作區側邊欄中，按一下以開啟目錄總管。
搜尋並選取您要批注的物件。

數據和 AI 物件會列在 [目錄] 窗格中並可供搜尋。共用、記憶體認證、外部位置和連線可以使用當您按下時開啟的功能表來存取。
新增註解或編輯現有註解。
- 若要將 AI 產生的批註新增至表格，請在概觀索引標籤的右側窗格中查看 AI 建議批註。可能會需要幾秒鐘才會顯示。依現況 [接受] 或 [編輯] 並儲存。
- 若要使用 AI 產生的批註將批註新增至資料表數據行，請按兩下資料行清單上方的 AI 產生 按鈕。 Databricks 會產生每個數據行的批注。依現狀接受或編輯。按下核取記號以儲存註解。
- 若要將批註新增至不支援 AI 產生批注的物件，請按兩下 [ 新增批注 ] 以新增批注。
- 若要在不使用 AI 產生的批註的情況下，將批註新增至表格欄位，請點擊 [在欄位列中新增批註 圖示。
- 如果註解已經存在，它會出現在 [概觀] 索引標籤或物件名稱下方的右窗格中。如果不是由 AI 生成，請按下進行編輯。

您可以使用基本 Markdown 來設定目錄總管 UI 中的批注樣式。 Markdown 樣式不會在 DESCRIBE 陳述式傳回時呈現。「目錄總管」支援所有基本語法，影像除外。如需詳細資訊，請參閱基本語法。

您可以使用 SQL 命令，將字串常值作為註釋新增到 Unity Catalog 中的任何可保護物件，或是舊版 Hive 中繼資料庫中管理的資料表。您所使用的 SQL 命令取決於您要新增或編輯註解的物件：

若要新增或更新資料表欄以外的現有可安全物件的註解，請使用 COMMENT ON 命令。請參閱 COMMENT ON。

您也可以將 COMMENT 選項與物件的 ALTER <object> 指令搭配使用 (例如 ALTER TABLE)。請參閱 ALTER <object> 命令的 SQL 參考文章。
若要新增或更新現有數據表的數據行批註，請使用 ALTER TABLE 命令搭配數據行上的 ALTER COLUMN 子句和 COMMENT 選項。請參閱 ALTER TABLE 和 ALTER TABLE ... COLUMN 子句。
若要在建立物件時新增註解，請搭配 COMMENT 命令使用 CREATE <object> 選項。若要使用命令 CREATE <object>，請參閱 SQL 參考文章。

此頁面對您有幫助嗎？