hierarchyid 資料類型方法參考
適用於：
SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體
hierarchyid 資料類型是可變長度的系統資料類型。 您可以使用 hierarchyid 來代表階層中的位置。 hierarchyid 類型的資料行不會自動代表樹狀目錄。 應用程式負責決定是否要產生並指派 hierarchyid 值，以便讓資料列之間所需的關聯性反映在值中。
hierarchyid 資料類型的值代表樹狀目錄階層中的位置。 hierarchyid 的值具有下列屬性：
- 極度壓縮
代表樹狀目錄 (含有 n 個節點) 中之節點所需的平均位元數目會因平均扇出 (節點子系的平均數目) 而不同。 若為小型 fanout (0-7)，其大小約為 6*logAn 個位元，其中 A 是平均 fanout。 在平均 fanout 為 6 個階層之 100,000 人員的組織階層中，節點會佔用大約 38 位元。 然後，這會四捨五入成 40 位元 (或 5 個位元組)，以便進行儲存。 - 比較是按照深度優先順序
假設有兩個 hierarchyid 值 (a 和 b)，a<b 表示在樹狀目錄的深度優先周遊中，a 在 b 前面。 hierarchyid 資料類型的索引採用深度優先順序，而且在深度優先周遊中彼此接近的節點會以彼此接近的方式儲存。 例如，某筆記錄的子系會儲存在該記錄旁。 如需詳細資訊，請參閱階層式資料 (SQL Server)。 - 支援任意插入和刪除
透過使用 GetDescendant 方法，您就一定能夠在任何指定節點的右側、任何指定節點的左側，或任何兩個同層級之間產生同層級。 在階層中插入或刪除任意的節點數目時，比較屬性會保留下來。 大部分的插入和刪除項目都會保留壓縮度屬性。 不過，兩個節點之間的插入項目則會以稍微少的壓縮表示來產生 hierarchyid 值。 - 用於 hierarchyid 類型中的編碼限制為 892 個位元組。 因此，在表示中具有太多層級而無法容納在 892 個位元組的節點無法由 hierarchyid 類型代表。
hierarchyid 類型可作為 SqlHierarchyId 資料類型提供給 CLR 用戶端使用。
備註
hierarchyid 類型會透過編碼從樹狀目錄根到節點的路徑，以邏輯方式編碼階層樹狀結構目錄中單一節點的相關資訊。 這類路徑會以邏輯方式表示成在根目錄之後造訪之所有子系的節點標籤序列。 此表示以斜線為開頭，而且只有造訪根目錄的路徑才會以單一斜線表示。 若為根目錄底下的層級，每個標籤都會編碼成以小數點隔開的整數序列。 子系之間的比較是透過按照字典順序比較以小數點隔開的整數序列加以執行。 每個層級後面都跟著一個斜線。 因此，斜線會分隔父代與其子系。 例如，下面是有效的 hierarchyid 路徑 (長度分別為 1、2、2、3 和 3 個層級)：
/
/1/
/0.3.-7/
/1/3/
/0.1/0.2/
您可以在任何位置插入節點。 在 /1/2/ 之後而在 /1/3/ 之前插入的節點可以表示成 /1/2.5/。 在 0 之前插入的節點具有負數的邏輯表示。 例如，在 /1/1/ 之前的節點可以表示成 /1/-1/。 節點不能有前置零。 例如，/1/1.1/ 有效，但是 /1/1.01/ 則無效。 若要避免發生錯誤，請使用 GetDescendant 方法來插入節點。
資料型別轉換
hierarchyid 資料類型可以轉換成其他資料類型，如下所示：
- 使用 ToString() 方法來將 hierarchyid 值以 nvarchar(4000) 資料類型轉換成邏輯表示法。
- 使用 Read() 及 Write() 來將 hierarchyid 轉換成 varbinary。
- 若要透過 SOAP 傳輸 hierarchyid 參數，請先將參數轉換成字串。
升級資料庫
當資料庫升級為較新版本的 SQL Server 時，就會自動安裝新的組件和 hierarchyid 資料類型。 Upgrade Advisor 規則會偵測任何具有衝突名稱的使用者類型或組件。 Upgrade Advisor 將建議您重新命名任何衝突的組件，以及重新命名任何衝突的類型，或在程式碼中使用兩部分名稱來參考預先存在的使用者類型。
如果資料庫升級偵測到具有衝突名稱的使用者組件，它將自動重新命名該組件並讓資料庫進入質疑模式。
如果具有衝突名稱的使用者類型在升級期間存在，將不會採取任何特殊步驟。 在升級之後，舊的使用者類型和新的系統類型都會一起存在。 但是，該使用者類型只能透過兩部分名稱使用。
在複寫資料表中使用 hierarchyid 資料行
hierarchyid 類型的資料行可以使用在任何複寫資料表上。 應用程式的需求會因複寫是單向或雙向，以及使用的 SQL Server 版本而不同。
單向複寫
單向複寫包括快照式複寫、異動複寫，以及不在「訂閱者」端進行變更的合併式複寫。 hierarchyid 資料行使用單向覆寫的方式會因訂閱者執行的 SQL Server 版本而不同。
- SQL Server 發行者可以將 hierarchyid 資料行複寫至相同版本的 SQL Server 訂閱者，而不需要任何特殊考量。
- SQL Server 發行者必須轉換 hierarchyid 資料行，才能將它們複寫至執行 SQL Server Compact 或舊版 SQL Server 的訂閱者。 SQL Server Compact 和舊版的 SQL Server 不支援 hierarchyid 資料行。 如果您正使用其中一個版本，仍然可以將資料複寫至「訂閱者」。 若要這樣做，您必須設定結構描述選項或發行集相容性層級 (用於合併式複寫)，如此資料行才能轉換成相容的資料類型。
在這兩種情況下都支援資料行篩選。 這包括篩選出 hierarchyid 資料行。 只要篩選不包括 hierarchyid 資料行，就會支援資料列篩選。
雙向複寫
雙向複寫包括具有更新訂閱的異動複寫、點對點異動複寫，以及在「訂閱者」端進行變更的合併式複寫。 複寫可讓您使用雙向複寫的 hierarchyid 資料行來設定資料表。 請注意下列需求和考量。
- 發行者和所有訂閱者都必須執行相同版本的 SQL Server 2016 (13.x) 或更新版本。
- 複寫會將資料複寫成位元組，但不會執行任何驗證來確保階層的完整性。
- 在來源 (「訂閱者」或「發行者」) 進行的變更複寫到目的地時，將不會維持這些變更的階層。
- hierarchyid 資料行的雜湊值乃特定於產生這些值的資料庫。 因此，雖然可以在「發行者」和「訂閱者」上產生相同的值，但是它可能會套用至不同的資料列。 複寫並不會檢查這個條件，而且不像 IDENTITY 資料行一樣具有可分割 hierarchyid 資料行值的內建方式。 應用程式必須使用條件約束或其他機制來避免發生這類無法偵測的衝突。
- 在「訂閱者」端插入的資料列可能會被遺棄。 已插入資料列的父資料列可能已經在「發行者」端遭刪除了。 當「訂閱者」的資料列在「發行者」端插入時，這會導致無法偵測的衝突發生。
- 資料行篩選無法篩選出不可為 Null 的 hierarchyid 資料行：來自「訂閱者」的插入將會失敗；因為「發行者」的 hierarchyid 資料行沒有預設值。
- 只要篩選不包括 hierarchyid 資料行，就會支援資料列篩選。