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) table TableName policy mirroring [partition by (Partitions)] dataformat = parquet
[with (IsEnabled=IsEnabledValue)]
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. |
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) | PartitionName (startofyear | startofmonthstartofday | | startofweek) ( ColumnName : datetime = ) |
Vedere la documentazione sulle funzioni startofyear, startofmonth, startofweek o startofday . |
Valore colonna = ( bin datetime troncato ColumnName , 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à
| Nome | Tipo | 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. |
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.