Comando .replace extents

Si applica a: ✅Azure Esplora dati

Questo comando elimina e sposta extent in una singola transazione all'interno del contesto di un database specifico. Il comando elimina tutti gli extent specificati dalla tabella di destinazione e sposta gli extent specificati dalle tabelle di origine alla tabella di destinazione.

Autorizzazioni

È necessario disporre almeno delle autorizzazioni di amministratore tabella per le tabelle di origine e di destinazione.

Restrizioni

• Sia le tabelle di origine che di destinazione devono trovarsi nel database di contesto.
• Tutti gli extent specificati da ExtentsToDropQuery devono appartenere alla tabella di destinazione.
• Tutte le colonne nelle tabelle di origine dovrebbero esistere nella tabella di destinazione con lo stesso nome e tipo di dati.
• Se la tabella di destinazione è una tabella di origine di una vista materializzata, il comando potrebbe non riuscire perché la vista materializzata non può elaborare i record negli extent spostati. Per altri dettagli, vedere la pagina delle limitazioni delle visualizzazioni materializzate. È possibile risolvere questo errore impostando un nuovo tempo di inserimento durante il comando di spostamento. Vedere setNewIngestionTime nelle proprietà supportate.

Sintassi

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

Altre informazioni sulle convenzioni di sintassi.

Parametri

Proprietà supportate

Valori restituiti

Quando il comando viene eseguito in modo sincrono, viene restituita una tabella con lo schema seguente.

Quando il comando viene eseguito in modo asincrono, viene restituito un ID operazione (GUID). Monitorare lo stato dell'operazione con il comando operazioni .show e recuperare i risultati di un'esecuzione riuscita con il comando .show operation details .

Esempi

Spostare tutti gli extent in un intervallo di tempo di creazione specificato da due tabelle

Spostare tutti gli extent da due tabelle specifiche (MyTable1, MyTable2) in un intervallo di tempo di creazione specificato alla tabella MyOtherTablee eliminare tutti gli extent in MyOtherTable contrassegnati con drop-by:MyTag:

.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
    }

Output di esempio

Spostare tutti gli extent in un intervallo di tempo di creazione specificato da una tabella a un'altra, eliminare un extent specifico

Spostare tutti gli extent in un intervallo di tempo di creazione specificato da una tabella specifica (MyTable1) alla tabella MyOtherTablee eliminare un extent specifico in MyOtherTable, in base al relativo ID:

.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 
    }

Implementare una logica idempotente

Implementare una logica idempotente in modo che Kusto elimina gli extent dalla tabella t_dest solo se sono presenti extent per passare dalla tabella t_source alla tabella t_dest:

.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
}