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

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

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

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

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

開始之前

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

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

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

在工作區提要欄位中，按兩下 [目錄]，以開啟 [目錄總管]。
搜尋並選取您要批注的物件。

數據和 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 參考文章。