Commande des étendues .replace

S’applique à : ✅Azure Data Explorer

Cette commande supprime et déplace les étendues dans une transaction unique dans le contexte d’une base de données spécifique. La commande supprime toutes les étendues spécifiées de la table de destination et déplace les étendues spécifiées des tables sources vers la table de destination.

autorisations

Vous devez disposer au moins des autorisations d’administrateur de table pour les tables source et de destination.

Restrictions

• Les tables source et de destination doivent se trouver dans la base de données contextuelle.
• Toutes les étendues spécifiées par ExtentsToDropQuery doivent appartenir à la table de destination.
• Toutes les colonnes des tables sources sont censées exister dans la table de destination portant le même nom et le même type de données.
• Si la table de destination est une table source d’une vue matérialisée, la commande peut échouer, car la vue matérialisée ne peut pas traiter les enregistrements dans les étendues déplacées. Pour plus d’informations, consultez la page limitations des vues matérialisées. Vous pouvez contourner cette erreur en définissant une nouvelle heure d’ingestion pendant la commande move. Consultez setNewIngestionTime les propriétés prises en charge.

Syntaxe

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

En savoir plus sur les conventions de syntaxe.

Paramètres

Propriétés prises en charge

Retours

Lorsque la commande est exécutée de façon synchrone, une table avec le schéma suivant est retournée.

Lorsque la commande est exécutée de façon asynchrone, un ID d’opération (GUID) est retourné. Surveillez l’état de l’opération avec la commande .show operations et récupérez les résultats d’une exécution réussie avec la commande détails de l’opération .show.

Exemples

Déplacer toutes les étendues dans un intervalle de temps de création spécifié à partir de deux tables

Déplacez toutes les étendues de deux tables spécifiques (MyTable1, MyTable2) dans une plage de temps de création spécifiée vers la table MyOtherTable, puis supprimez toutes les étendues marquées MyOtherTable avec 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
    }

Exemple de sortie

Déplacer toutes les étendues d’une plage de temps de création spécifiée d’une table à une autre, supprimer une extension spécifique

Déplacez toutes les étendues d’une plage de temps de création spécifiée d’une table spécifique (MyTable1) vers la table MyOtherTableet supprimez une extension spécifique en MyOtherTable, par son 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 
    }

Implémenter une logique idempotente

Implémentez une logique idempotente afin que Kusto supprime les étendues de la table t_dest uniquement s’il existe des étendues à déplacer d’une table t_source à l’autre 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
}