Commande de mise en miroir de stratégies de table .alter-merge
S’applique à : ✅Microsoft Fabric
Modifie la stratégie de mise en miroir des tables. La stratégie de mise en miroir crée une copie logique de tables dans votre base de données au format parquet delta et vous permet de partitionner vos fichiers afin d’améliorer la vitesse des requêtes. Chaque partition est représentée par une colonne distincte utilisant le nom de partition figurant dans la liste des partitions. Cela signifie qu’il existe plus de colonnes dans la cible que dans votre table source.
Syntaxe
(.alter | .alter-merge) table TableName policy mirroring [partition by (Partitions)] dataformat = parquet
[with (IsEnabled=IsEnabledValue)]
En savoir plus sur les conventions de syntaxe.
Paramètres
| Nom | Type | Requise | Description |
|---|---|---|---|
| TableName | string | ✔️ | Nom de table qui respecte les règles de noms d’entité. |
| Partitions | string | Liste séparée par des virgules de colonnes utilisée pour diviser les données en partitions plus petites. Consultez la mise en forme des partitions. |
Mise en forme des partitions
La liste des partitions est n’importe quelle combinaison de colonnes de partition, spécifiée à l’aide de l’un des formulaires indiqués dans le tableau suivant.
| Type de partition | Syntaxe | Notes |
|---|---|---|
| Colonne virtuelle | PartitionName : (datetime | string) |
En savoir plus sur les colonnes virtuelles. |
| Valeur de colonne de chaîne | PartitionName ColumnName : string = |
|
| Hachage de valeur de colonne de chaîne() | PartitionName ColumnName=: long hash(, Number) |
Le hachage est modulo Number. |
| Colonne datetime tronquée (valeur) | PartitionName (startofyear | startofmonthstartofday | | startofweek) ( ColumnName : datetime = ) |
Consultez la documentation sur les fonctions startofyear, startofmonth, startofweek ou startofday . |
Valeur de colonne = bin ( datetime tronquée TimeSpan ColumnName , ) |
En savoir plus sur la fonction bin . |
Remarque
Chaque partition est représentée par une colonne distincte utilisant le nom de partition figurant dans la liste des partitions. PartitionName doit être une chaîne unique non sensible à la casse, entre autres noms de partition et noms de colonnes de la table mise en miroir.
Propriétés
| Nom | Type | Description |
|---|---|---|
IsEnabled |
bool |
Valeur booléenne qui détermine si la stratégie de mise en miroir est activée. La valeur par défaut est true. Lorsque la stratégie de mise en miroir est désactivée et définie falsesur , les données de mise en miroir sous-jacentes sont supprimées de manière réversible et conservées dans la base de données. |
Remarque
Lorsque la stratégie de mise en miroir est activée, les tables ne peuvent pas être renommées.
Exemples
Mise en miroir de stratégies de table .alter
Dans l’exemple suivant, une table appelée myTable est mise en miroir. Les données sont partitionnée en premier par nom, puis par date.
.alter table myTable policy mirroring
partition by (Name: string=Name, Date: datetime= startofday(timestamp))
dataformat=parquet
with
(IsEnabled=true)
Contenu connexe
- Pour vérifier les opérations de mise en miroir, consultez la commande des opérations de mise en miroir de tables .show.
- Pour supprimer des opérations de mise en miroir, consultez la commande de mise en miroir de stratégies de table .delete.