Criteri di mirroring

Si applica a: ✅Microsoft Fabric

I comandi dei criteri di mirroring consentono di visualizzare, modificare, partizionare ed eliminare i criteri di mirroring della tabella. Forniscono anche un modo per controllare la latenza del mirroring esaminando lo stato del mirroring delle operazioni.

Comandi di gestione

• Usare il comando di mirroring dei criteri di tabella .show per visualizzare i criteri di mirroring correnti della tabella.
• Usare il comando di mirroring dei criteri della tabella alter-merge per modificare i criteri di mirroring correnti.
• Usare il comando di mirroring dei criteri di tabella .delete per eliminare temporanea i criteri di mirroring correnti.
• Usare il comando .show table mirroring operations per controllare lo stato del mirroring delle operazioni.
• Usare il comando .show table mirroring operations export artifacts per controllare lo stato degli artefatti esportati nelle operazioni.
• Usare gli errori delle operazioni di mirroring delle tabelle .show per controllare lo stato di errore del mirroring delle operazioni.

Oggetto criteri

I criteri di mirroring includono le proprietà seguenti:

Proprietà	Descrizione	Valori	Predefiniti
Formato	Formato dei file con mirroring.	Il valore valido è parquet.	parquet
ConnectionStrings	Matrice di stringa di connessione che consentono di configurare e stabilire connessioni. Questo valore viene popolato automaticamente.
IsEnabled	Determina se i criteri di mirroring sono abilitati. Quando i criteri di mirroring sono disabilitati e impostati su false, i dati di mirroring sottostanti vengono conservati nel database.	true, false, null.	null
Partitions	Elenco delimitato da virgole di colonne usate per dividere i dati in partizioni più piccole.	Vedere Formattazione delle partizioni.

Avviso

L'eliminazione o l'eliminazione dei criteri di mirroring della tabella eliminerà definitivamente la tabella delta in OneLake.

Nota

Quando il criterio di mirroring è abilitato, le tabelle non possono essere rinominate.

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.

Mapping dei tipi di dati

Per garantire la compatibilità e ottimizzare le query, assicurarsi che i tipi di dati siano mappati correttamente ai tipi di dati parquet.

Mapping dei tipi di dati da eventhouse a Delta Parquet

I tipi di dati della casa di eventi vengono mappati ai tipi di dati Delta Parquet usando le regole seguenti:

Tipi di sati eventhouse	Tipo di dati Delta
bool	boolean
datetime	timestamp OR date (for date-bound partition definitions)
dynamic	string
guid	string
int	integer
long	long
real	double
string	string
timespan	long
decimal	decimal(38,18)

Per maggiori informazioni sull'utilizzo dei tipi di dati Event house, vedere Tipi di dati scalari.

Criterio di esempio

{
  "Format": "parquet",
  "IsEnabled": true,
  "Partitions": null,
}