Yansıtma ilkesi

Makale
07/03/2024

Yansıtma ilkesi komutları tablo yansıtma ilkenizi görüntülemenize, değiştirmenize, bölümlemenize ve silmenize olanak sağlar. Ayrıca yansıtma durumunu gözden geçirerek yansıtma gecikme süresini denetlemenin bir yolunu da sağlar.

Yönetim komutları

Tablonun geçerli yansıtma ilkesini göstermek için .show table policy mirroring komutunu kullanın.
Geçerli yansıtma ilkesini değiştirmek için .alter-merge tablo ilkesi yansıtma komutunu kullanın.
Geçerli yansıtma ilkesini geçici olarak silmek için .delete tablo ilkesi yansıtma komutunu kullanın.
İşlem yansıtma durumunu denetlemek için .show table mirroring operations komutunu kullanın.
Dışarı aktarılan işlemlerin yapıt durumunu denetlemek için .show table mirroring operations exported artifacts komutunu kullanın.
İşlem yansıtma hata durumunu denetlemek için .show tablo yansıtma işlemleri hatalarını kullanın.

İlke nesnesi

Yansıtma ilkesi aşağıdaki özellikleri içerir:

Özellik	Açıklama	Değerler	Varsayılan
Biçim	Yansıtılmış dosyalarınızın biçimi.	Geçerli değer: `parquet`.	`parquet`
ConnectionStrings	Bağlantıları yapılandırmaya ve kurmaya yardımcı olan bir bağlantı dizesi dizisi. Bu değer otomatik olarak doldurulur.
IsEnabled	Yansıtma ilkesinin etkinleştirilip etkinleştirilmediğini belirler. Yansıtma ilkesi devre dışı bırakılıp olarak ayarlandığında `false`, temel alınan yansıtma verileri veritabanında tutulur.	`true`, `false`, `null`.	`null`
Bölümler	Verileri daha küçük bölümlere bölmek için kullanılan sütunların virgülle ayrılmış listesi.	Bkz. Bölüm biçimlendirmesi.

Uyarı

Tablo yansıtma ilkesini silmek veya bırakmak, OneLake'te delta tablosunu kalıcı olarak siler.

Bölümleri biçimlendirme

Bölümler listesi, aşağıdaki tabloda gösterilen formlardan biri kullanılarak belirtilen bölüm sütunlarının herhangi bir bileşimidir.

Bölüm Türü	Sözdizimi	Notlar
Sanal sütun	PartitionName `:` (`datetime` \| `string`)	Sanal sütunlar hakkında daha fazla bilgi edinin.
Dize sütun değeri	PartitionName `=` `:` `string` ColumnName
Dize sütun değeri hash()	PartitionName `=``long` `hash(:` ColumnName Numarası`,` `)`	Karma mod Numarası'dır.
Kesilmiş tarih saat sütunu (değer)	PartitionName `datetime` `:` `=` (`startofyearstartofweek` \| \| \| `startofdaystartofmonth`) `(` ColumnName `)`	startofyear, startofmonth , startofweek veya startofday işlevleriyle ilgili belgelere bakın.
Kesilmiş tarih saat sütunu (değer)	PartitionName `bin` `=` `(` `datetime` `:` ColumnName `,` TimeSpan `)`	Bin işlevi hakkında daha fazla bilgi edinin.

Not

Her bölüm, Bölümler listesinde listelenen PartitionName kullanılarak ayrı bir sütun olarak temsil edilir. PartitionName , hem diğer bölüm adları hem de yansıtılan tablonun sütun adları arasında büyük/küçük harfe duyarsız benzersiz bir dize olmalıdır.

Veri türleri eşlemesi

Uyumluluğu sağlamak ve sorguları iyileştirmek için veri türlerinizin parquet veri türlerine düzgün eşlendiğinden emin olun.

Olay evinden Delta parquet veri türlerine eşleme

Olay evi veri türleri, aşağıdaki kurallar kullanılarak Delta Parquet veri türleriyle eşlenir:

Olay evi veri türü	Delta veri türü
`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)`

Olay evi veri türleri hakkında daha fazla bilgi için bkz . Skaler veri türleri.

Örnek ilke

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

Bu özellik desteklenmez.

Aracılığıyla paylaş