範圍標籤保留原則

  • 發行項

範圍標記保留原則可控制根據範圍存留期以自動從資料表中移除範圍標記的機制。

建議您移除任何不再有用的標記，或暫時作為擷取管線一部分的標記，而這些標記可能會讓系統無法達到最佳效能。 例如：舊 drop-by: 標記，會防止將範圍合併在一起。

您可以在資料表層級或資料庫層級設定原則。 資料庫層級原則會套用至資料庫中未覆寫該原則的所有資料表。

注意

刪除時間不精確。 系統保證不會在超過限制之前刪除標記，但不會在該時間點之後立即刪除。

原則物件

範圍標記保留原則是原則物件的陣列。 每個物件都會包括下列屬性：

屬性名稱 類型 描述 範例
TagPrefix string 超過 RetentionPeriod 之後，所要自動刪除標記的前置詞。 前置詞必須包括冒號 (:) 作為其最後一個字元，而且只能包括一個冒號。 drop-by:, ingest-by:, custom_prefix:
RetentionPeriod timespan 保證不會捨棄標記的持續時間。 此期間是從範圍的建立時間開始測量。 1.00:00:00

範例

下列原則將會自動卸除任何超過三天的 drop-by: 標記，以及任何超過兩小時的 ingest-by: 標記：

[
    {
        "TagPrefix": "drop-by:",
        "RetentionPeriod": "3.00:00:00"
    },
    {
        "TagPrefix": "ingest-by:",
        "RetentionPeriod": "02:00:00"
    }
]

Defaults

未定義原則時，只要不卸除範圍，預設就會保留任何類型的範圍標記。

管理命令

下列管理命令可用來管理範圍標籤保留原則：