Partager via


Commande .alter-merge table policy ingestionbatching

S’applique à : ✅Microsoft Fabric✅Azure Data Explorer

Définit la stratégie de traitement par lot d’ingestion de la table pour déterminer quand l’agrégation des données s’arrête et qu’un lot est scellé et ingéré. La stratégie de traitement par lot d’ingestion s’applique à l’ingestion en file d’attente.

Si la stratégie n’est pas définie pour une table, la stratégie au niveau de la base de données s’applique. Si la stratégie n’est pas définie au niveau de la base de données, les valeurs par défaut s’appliquent.

autorisations

Vous devez disposer au moins des autorisations d’administrateur de table pour exécuter cette commande.

Valeurs par défaut et limites

Consultez les valeurs par défaut et les limites.

Syntaxe

.alter-mergetable [ DatabaseName]TableName .policy ingestionbatching PolicyObject

.alter-mergetables (Table1 , Table2 [,...]) policy ingestionbatching PolicyObject

En savoir plus sur les conventions de syntaxe.

Paramètres

Nom Type Requise Description
TableName string ✔️ Nom de la table à modifier.
DatabaseName string Nom de la base de données. Lorsque vous exécutez la commande à partir du contexte de base de données qui contient la table à modifier, DatabaseName n’est pas obligatoire.
PolicyObject string ✔️ Objet de stratégie JSON sérialisé. Consultez la stratégie de traitement par lots d’ingestion.

Exemples

La commande suivante définit une durée de données d’entrée de lot de 30 secondes, pour 500 fichiers ou 1 Go, selon le cas en premier.

.alter-merge table MyDatabase.MyTable policy ingestionbatching
```
{
    "MaximumBatchingTimeSpan" : "00:00:30",
    "MaximumNumberOfItems" : 500,
    "MaximumRawDataSizeMB": 1024
}
```

La commande suivante définit une durée de données d’entrée de lot de 45 secondes, pour 450 fichiers ou la valeur précédente de MaximumRawDataSizeMB, selon ce qui se produit en premier.

.alter-merge table MyDataMyDatabase.MyTable policy ingestionbatching
```
{
    "MaximumBatchingTimeSpan" : "00:00:45",
    "MaximumNumberOfItems" : 450
}
```

Remarque

Si vous spécifiez uniquement certains paramètres d’un PolicyObject, ils remplacent les valeurs de la stratégie actuelle, tandis que les autres paramètres restent intacts. Pour définir les valeurs par défaut des paramètres non spécifiés, utilisez la commande alter command .