Sdílet prostřednictvím

Značky rozsahu

Přepněte služby pomocí rozevíracího seznamu Verze . Přečtěte si další informace o navigaci.
Platí pro: ✅ Microsoft Fabric ✅ Azure Data Explorer

Značka rozsahu je řetězec, který popisuje vlastnosti společné pro všechna data v rozsahu. Během příjmu dat můžete například připojit značku rozsahu, která označuje zdroj přijatých dat. Tuto značku pak můžete použít k analýze.

Rozsahy můžou obsahovat více značek jako součást jejich metadat. Při sloučení rozsahů se jejich značky také sloučí a zajišťují konzistentní reprezentaci metadat.

Pokud chcete zobrazit značky přidružené k rozsahu, použijte příkaz .show extents . Podrobné zobrazení značek přidružených k záznamům v rozsahu použijte funkci extent-tags().

Důležité

Značky začínající drop-by: nebo ingest-by: nesou specifické významy. Další informace najdete v tématu rozevírací značky rozsahu a ingestování podle značek rozsahu.

drop-by značky rozsahu

Značky, které začínají předponou drop-by: , lze použít k řízení toho, s jakým jiným rozsahem se mají sloučit. Rozsahy, které mají stejnou sadu drop-by: značek, lze sloučit dohromady, ale nebudou sloučeny s dalšími rozsahy, pokud mají jinou sadu drop-by: značek.

Poznámka:

  • Vyhněte se nadměrnému drop-by používání značek.
  • Tyto značky by se neměly používat k nahrazení jednotlivých dat na úrovni záznamů a při použití na velké objemy dat jsou nejúčinnější.
  • Přiřazení jedinečných drop-by značek k jednotlivým záznamům nebo souborům může výrazně ovlivnit výkon.

Příklady

Určení rozsahů, které lze sloučit

Když:

  • Rozsah 1 má následující značky: drop-by:blue, drop-by:red, green.
  • Rozsah 2 má následující značky: drop-by:red, yellow.
  • Rozsah 3 má následující značky: purple, drop-by:red, drop-by:blue.

Potom:

  • Rozsahy 1 a 2 nebudou sloučeny společně, protože mají jinou sadu drop-by značek.
  • Rozsahy 2 a 3 nebudou sloučeny dohromady, protože mají jinou sadu drop-by značek.
  • Rozsahy 1 a 3 lze sloučit společně, protože mají stejnou sadu drop-by značek.

Použití drop-by značek v rámci operací na úrovni rozsahu

Následující dotaz vydá příkaz, který zahodí rozsahy podle jejich drop-by: značky.

.ingest ... with @'{"tags":"[\"drop-by:2016-02-17\"]"}'

.drop extents <| .show table MyTable extents where tags has "drop-by:2016-02-17"

ingest-by značky rozsahu

Značky s předponou ingest-by: lze použít společně s ingestIfNotExists vlastností, aby se zajistilo, že se data ingestují pouze jednou.

Tato ingestIfNotExists vlastnost brání duplicitnímu příjmu dat kontrolou, jestli již existuje rozsah se zadanou ingest-by: značkou. Příkaz ingestování obvykle obsahuje ingest-by: značku a ingestIfNotExists vlastnost se stejnou hodnotou.

Poznámka:

  • Vyhněte se nadměrnému ingest-by používání značek.
  • Přiřazení jedinečných ingest-by značek pro každé volání příjmu dat může výrazně ovlivnit výkon.
  • Pokud je v kanálu známo, že mají duplicitní data, doporučujeme před ingestováním dat tyto duplicity vyřešit.

Příklady

Přidání značky při příjmu dat

Následující příkaz ingestuje data a přidá značku ingest-by:2016-02-17.

.ingest ... with (tags = '["ingest-by:2016-02-17"]')

Zabránění duplicitnímu příjmu dat

Následující příkaz ingestuje data, pokud značka neobsahuje ingest-by:2016-02-17 žádný rozsah v tabulce.

.ingest ... with (ingestIfNotExists = '["2016-02-17"]')

Zabránění duplicitnímu příjmu dat a přidání značky do nových dat

Následující příkaz ingestuje data, pokud značka neobsahuje ingest-by:2016-02-17 žádný rozsah v tabulce. Všechna nově přijatá data načte ingest-by:2016-02-17 značku.

.ingest ... with (ingestIfNotExists = '["2016-02-17"]', tags = '["ingest-by:2016-02-17"]')

Omezení

  • Značky rozsahu lze použít pouze u záznamů v rozsahu. Značky proto není možné nastavit u streamovaných dat příjmu dat před jejich uložením v rozsahech.
  • Značky rozsahu nelze ukládat na data v externích tabulkách ani materializovaných zobrazeních.

Související obsah

  • Last updated on