.replace extents 命令

適用於： ✅Azure 數據總管

此命令會在特定資料庫內容內的單一交易中卸除和移動範圍。 此命令會從目的地數據表卸除任何指定的範圍，並將指定的範圍從源數據表移至目的地數據表。

權限

您必須至少有 來源和目的地數據表的數據表管理員 許可權。

限制

• 來源和目的地數據表都必須位於內容資料庫中。
• ExtentsToDropQuery 所指定的所有範圍都應該屬於目的地數據表。
• 源數據表中的所有數據行應該都存在於具有相同名稱和數據類型的目的地數據表中。
• 如果目的地數據表是具體化檢視的源數據表，命令可能會失敗，因為具體化檢視無法處理移動範圍中的記錄。 如需詳細數據， 請參閱具體化檢視限制 頁面。 您可以在移動命令期間設定新的擷取時間，解決此錯誤。 請參閱setNewIngestionTime支持的屬性。

語法

.replace[async] extents table in DestinationTableName [ with(PropertyName = PropertyValue [, ...]] <|{)ExtentsToDropQuery},{ExtentsToMoveQuery}

深入瞭解 語法慣例。

參數

支援的屬性

傳回

當命令以同步方式執行時，會傳回具有下列架構的數據表。

當命令以異步方式執行時，會傳回作業標識碼 （GUID）。 使用 .show operations 命令監視作業的狀態，並使用 .show 作業詳細數據命令擷取成功執行的結果。

範例

從兩個數據表移動指定建立時間範圍中的所有範圍

將指定建立時間範圍中的所有範圍從兩個特定資料表 （MyTable1， MyTable2） 移至資料表 MyOtherTable，然後卸除以drop-by:MyTag標記的所有範圍MyOtherTable：

.replace extents in table MyOtherTable with (extentCreatedOnFrom=datetime(2023-03-10), extentCreatedOnTo=datetime(2023-03-12)) <|
    {
        .show table MyOtherTable extents where tags has 'drop-by:MyTag'
    },
    {
        .show tables (MyTable1,MyTable2) extents
    }

範例輸出

將指定建立時間範圍中的所有範圍從一個數據表移至另一個數據表，卸除特定範圍

將指定建立時間範圍中的所有範圍從一個特定資料表 （MyTable1） 移至資料表 MyOtherTable，然後依標識元卸除 中的 MyOtherTable特定範圍：

.replace extents in table MyOtherTable with (extentCreatedOnFrom=datetime(2023-03-10), extentCreatedOnTo=datetime(2023-03-12)) <|
    {
        print ExtentId = "2cca5844-8f0d-454e-bdad-299e978be5df"
    },
    {
        .show table MyTable1 extents 
    }

.replace extents in table MyOtherTable with (extentCreatedOnFrom=datetime(2023-03-10), extentCreatedOnTo=datetime(2023-03-12)) <|
    {
        .show table MyOtherTable extents
        | where ExtentId == guid(2cca5844-8f0d-454e-bdad-299e978be5df) 
    },
    {
        .show table MyTable1 extents 
    }

實作等冪邏輯

實作等冪邏輯，讓 Kusto 只有在有範圍從數據表移至數據表t_dest時，才會從數據表t_destt_source卸除範圍：

.replace async extents in table t_dest with (extentCreatedOnFrom=datetime(2023-03-10), extentCreatedOnTo=datetime(2023-03-12)) <|
{
    let any_extents_to_move = toscalar( 
        t_source
        | where extent_tags() has 'drop-by:blue'
        | summarize count() > 0
    );
    let extents_to_drop =
        t_dest
        | where any_extents_to_move and extent_tags() has 'drop-by:blue'
        | summarize by ExtentId = extent_id()
    ;
    extents_to_drop
},
{
    let extents_to_move = 
        t_source
        | where extent_tags() has 'drop-by:blue'
        | summarize by ExtentId = extent_id(), TableName = 't_source'
    ;
    extents_to_move
}