使用 版本 下拉選單切換服務。 了解更多關於導航的資訊。
適用於： ✅ Microsoft Fabric ✅ Azure Data Explorer
範圍標籤是描述範圍中所有數據通用屬性的字串。 例如，在數據擷取期間，您可以附加範圍卷標來表示內嵌數據的來源。 然後，您可以使用此標籤進行分析。
範圍可以保留多個標籤做為其元數據的一部分。 當範圍合併時，其標籤也會合併，以確保一致的元數據表示。
若要查看與範圍相關聯的標籤，請使用 .show extents 命令。 如需範圍內與記錄相關聯之標籤的細微檢視，請使用 extent-tags（） 函式。
drop-by 範圍標籤
開頭為前置詞的 drop-by: 標記可用來控制要合併的其他範圍。 具有相同標籤集合 drop-by: 的範圍可以合併在一起，但如果具有不同的標籤集合 drop-by: ，它們就不會與其他範圍合併。
注意
- 避免過度使用
drop-by標記。 - 這些標籤不應該用來取代個別記錄層級的數據，而且在套用至大量數據時最有效。
- 將唯一
drop-by標記指派給個別記錄或檔案可能會大幅影響效能。
範例
判斷哪些範圍可以合併在一起
如果：
- 範圍 1 具有下列標籤：
drop-by:blue、、drop-by:redgreen。 - 範圍 2 具有下列標籤：
drop-by:red、yellow。 - 範圍 3 具有下列標籤：
purple、drop-by:red、drop-by:blue。
接下來：
- 範圍 1 和 2 不會合併在一起，因為它們有一組
drop-by不同的標記。 - 範圍 2 和 3 不會合併在一起，因為它們有一組
drop-by不同的標記。 - 範圍 1 和 3 可以合併在一起，因為它們具有相同的
drop-by標記集。
使用 drop-by 標籤作為範圍層級作業的一部分
下列查詢會根據其 drop-by: 標籤發出命令來卸除範圍。
.ingest ... with @'{"tags":"[\"drop-by:2016-02-17\"]"}'
.drop extents <| .show table MyTable extents where tags has "drop-by:2016-02-17"
ingest-by 範圍標籤
具有前置 ingest-by: 詞的標記可以與 屬性搭配 ingestIfNotExists 使用，以確保數據只內嵌一次。
屬性 ingestIfNotExists 會藉由檢查具有指定 ingest-by: 標籤的範圍是否已經存在，以防止重複擷取。 一般而言，擷取命令包含具有相同 ingest-by: 值的標記和 ingestIfNotExists 屬性。
注意
- 避免過度使用
ingest-by標記。 - 為每個擷取呼叫指派唯一
ingest-by標記可能會大幅影響效能。 - 如果已知管線有數據重複，建議您先解決這些重複數據，再擷取數據。
範例
在擷取時新增標籤
下列命令會擷取資料，並新增標記 ingest-by:2016-02-17。
.ingest ... with (tags = '["ingest-by:2016-02-17"]')
防止重複擷取
下列命令會擷取數據，只要數據表中沒有任何範圍具有 ingest-by:2016-02-17 標記。
.ingest ... with (ingestIfNotExists = '["2016-02-17"]')
防止重複擷取，並將標記新增至任何新數據
下列命令會擷取數據，只要數據表中沒有任何範圍具有 ingest-by:2016-02-17 標記。 任何新擷取的數據都會取得標記 ingest-by:2016-02-17 。
.ingest ... with (ingestIfNotExists = '["2016-02-17"]', tags = '["ingest-by:2016-02-17"]')
限制
- 範圍標籤只能套用至範圍內的記錄。 因此，在串流擷取數據儲存在範圍之前，就無法在串流擷取數據上設定標記。
- 範圍標籤無法儲存在外部數據表或具體化檢視中的數據上。