Commande .alter 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é.
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. S’il n’est pas également défini, 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
table
[ DatabaseName]TableName .
policy
ingestionbatching
PolicyObject
.alter
tables
(
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 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 1 minute, pour 20 fichiers ou 300 Mo, selon le cas en premier.
.alter tables (MyTable1, MyTable2, MyTable3) policy ingestionbatching
```
{
"MaximumBatchingTimeSpan" : "00:01:00",
"MaximumNumberOfItems" : 20,
"MaximumRawDataSizeMB": 300
}
```
Remarque
Si vous ne spécifiez pas tous les paramètres d’un PolicyObject, les paramètres non spécifiés sont définis sur les valeurs par défaut. Par exemple, si vous spécifiez uniquement « MaximumBatchingTimeSpan », « MaximumNumberOfItems » et « MaximumRawDataSizeMB » sont définis par défaut. Pour remplacer uniquement certains paramètres, utilisez la commande de commande alter-merge.