Comando di mirroring dei criteri della tabella con estensione alter-merge
Si applica a: ✅Microsoft Fabric
Modifica i criteri di mirroring delle tabelle. I criteri di mirroring creano una copia logica delle tabelle nel database in formato parquet delta e consentono di partizionare i file per migliorare la velocità di query. Ogni partizione è rappresentata come colonna separata usando PartitionName elencato nell'elenco Partizioni. Ciò significa che nella destinazione sono presenti più colonne rispetto alla tabella di origine.
Sintassi
(.alter | .alter-merge) tableTableNamepolicy mirroring [partitionby (Partitions)] dataformat = parquet [with(propertyName=propertyValue [, ...])]
Altre informazioni sulle convenzioni di sintassi.
Parametri
| Nome | Digita | Obbligatorio | Descrizione |
|---|---|---|---|
| TableName | string | ✔️ | Nome di tabella conforme alle regole Dei nomi di entità. |
| Partitions | string | Elenco delimitato da virgole di colonne usate per dividere i dati in partizioni più piccole. Vedere Formattazione delle partizioni. | |
| propertyName, propertyValue | string |
Elenco delimitato da virgole di coppie di proprietà chiave-valore. Vedere proprietà supportate. |
Formattazione delle partizioni
L'elenco delle partizioni è qualsiasi combinazione di colonne di partizione, specificate utilizzando uno dei moduli illustrati nella tabella seguente.
| Tipo di partizione | Sintassi | Note |
|---|---|---|
| Colonna virtuale |
PartitionName: (datetime | string) |
Altre informazioni sulle colonne virtuali. |
| Valore colonna stringa |
ColumnName PartitionName:string= |
|
| String column value hash() |
PartitionName:long=hash( ColumnName Number,) |
L'hash è il numero modulo. |
| Colonna datetime troncata (valore) |
|
startofday
(
)
|
Vedere la documentazione sulle funzioni startofyear, startofmonth, startofweek o startofday . |
Valore colonna =bin(,TimeSpan) |
Altre informazioni sulla funzione bin . |
Nota
Ogni partizione è rappresentata come colonna separata usando PartitionName elencato nell'elenco Partizioni. PartitionName deve essere una stringa univoca senza distinzione tra maiuscole e minuscole, sia tra gli altri nomi di partizione che i nomi di colonna della tabella con mirroring.
Proprietà supportate
| Nome | Digita | Descrizione |
|---|---|---|
IsEnabled |
bool |
Valore booleano che determina se il criterio di mirroring è abilitato. Il valore predefinito è true. Quando i criteri di mirroring sono disabilitati e impostati su false, i dati di mirroring sottostanti vengono eliminati e mantenuti nel database. |
TargetLatencyInMinutes |
int |
Ritardo dell'operazione di scrittura in minites. Per impostazione predefinita, l'operazione di scrittura può richiedere fino a 3 ore o fino a quando non sono disponibili 256 MB di dati. È possibile modificare il ritardo in un valore compreso tra 5 minuti e 3 ore. |
Nota
Quando il criterio di mirroring è abilitato, le tabelle non possono essere rinominate.
Esempi
.alter table policy mirroring
Nell'esempio seguente viene eseguito il mirroring di una tabella denominata myTable . I dati vengono partizionati per nome e quindi per data.
.alter table myTable policy mirroring
partition by (Name: string=Name, Date: datetime= startofday(timestamp))
dataformat=parquet
with
(IsEnabled=true)
Contenuto correlato
- Per controllare le operazioni di mirroring, vedere .show table mirroring operations command .show table mirroring operations.To check mirroring operations, see .show table mirroring operations command.
- Per eliminare le operazioni di mirroring, vedere comando di mirroring dei criteri di tabella .delete.