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

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

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

您可以手動新增註解，也可以讓 Databricks 為您建立 AI 產生的註解。 AI 產生的註解 (也稱為 AI 產生的文件) 適用於資料表和資料表資料行。請參閱將 AI 產生的註解新增至 Unity Catalog 物件。

當您修改 Unity Catalog 資料表的註解時 (或舊版 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 陳述式傳回時呈現。在目錄總管中支援影像除外的所有基本語法，但只會轉譯兩個標題層級。如需詳細資訊，請參閱基本語法。

如需 AI 產生之註解的詳細資訊，請參閱將 AI 產生的註解新增至 Unity Catalog 物件。

您可以使用 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 參考文章。