建立與管理結構描述註釋

綱要註解是自由格式的文字欄位，其中包含擴充或自訂的資料庫物件特性，例如表格、視觀表、資料欄、索引以及資料使用案例網域。註解是一種輕量的宣告功能，可集中註冊資料庫綱要物件的使用狀況特性。它們可以被視為資料庫中繼資料的輕量標準化標記，供應用程式用來註冊和處理延伸和自訂的使用特性。

另請參閱：Oracle AI Database Concepts，瞭解關於註解的其他一般資訊

建立附註

註解是綱要物件的特性，可以在物件的 CREATE 敘述句中指定。

下列敘述句會為表格本身和基礎資料欄建立一個含有註解的新表格。

CREATE TABLE employees
(
    id NUMBER(5) PRIMARY KEY ANNOTATIONS (Identity, Display 'Employee Name'),

    ename VARCHAR2(50) ANNOTATIONS(Display 'Employee Name'),

    salary NUMBER ANNOTATION(Display 'Employee Name', Confidential)
) ANNOTATIONS (Display 'Employee Table');

下列敘述句在 hr 綱要中建立 dept_codes 應用程式使用網域時包含註解。

CREATE DOMAIN dept_codes AS NUMBER(3)
  CONSTRAINT dept_chk CHECK (dept_codes > 99 AND dept_codes != 200)
  ANNOTATIONS (Title 'Domain Annotation);

另請參閱：Oracle AI Database Development Guide，瞭解註釋的 DDL 陳述式相關資訊

列出註釋

您可以使用說明視觀表來取得用於特定物件的註解清單。

下列字典視觀表是針對註解和註解用途所定義。

ALL_ANNOTATION_VALUES、DBA_ANNOTATION_VALUES、USER_ANNOTATION_VALUES
ALL_ANNOTATIONS，DBA_ANNOTATIONS，USER_ANNOTATIONS，所有註解
ALL_ANNOTATIONS_USAGE、DBA_ANNOTATIONS_USAGE、USER_ANNOTATIONS_USAGE

ALL_* 視觀表包括使用者擁有之物件的所有註解、使用者擁有 ALTER 權限之其他使用者擁有之物件的所有註解，以及使用者擁有該物件類型之系統權限之物件的所有註解。DBA_* 視觀表包含資料庫中所有物件的所有註解。USER_* 視觀表包含使用者擁有之物件的所有註解。

下列敘述句會取得 EMPLOYEE 表格的表格層次註解：

SELECT * from USER_ANNOTATIONS_USAGE WHERE Object_Name = 'EMPLOYEE' AND
Object_Type = 'TABLE' AND Column_Name IS NULL;

下列敘述句會取得 EMPLOYEE 表格的資料欄層次註解：

SELECT * from USER_ANNOTATIONS_USAGE WHERE Object_Name = 'EMPLOYEE' AND
Object_Type = 'TABLE' AND Column_Name IS NOT NULL;

下列敘述句會取得 EMPLOYEE 表格的資料欄層次註解，作為每個資料欄的單一 JSON 集合：

SELECT  U.Column_Name, JSON_ARRAYAGG(JSON_OBJECT(U.Annotation_Name,
U.Annotation_Value)) FROM USER_ANNOTATIONS_USAGE U
WHERE Object_Name = 'EMPLOYEE' AND Object_Type = 'TABLE' AND
Column_Name IS NOT NULL GROUP BY Column_Name;

另請參閱：Oracle AI Database Reference，瞭解註釋的字典檢視相關資訊。

修改註釋

若要修改註釋，請使用註釋綱要物件的 ALTER 敘述句。

下列敘述句會將值為 HR 的其他註解 Department 新增至 employees 表格中。
```
ALTER TABLE employees ANNOTATIONS (ADD Department 'HR');
```
下列陳述式會刪除註釋 Title，並將值為 Domain 的新註釋 Name 新增至 dept_code 網域。
```
ALTER DOMAIN dept_codes ANNOTATIONS(DROP Title, ADD Name 'Domain');
```

另請參閱：Oracle AI Database Development Guide，瞭解註釋的 DDL 陳述式相關資訊