Takipçi komutları

  • Makale

Takipçi yapılandırmanızı yönetmek için yönetim komutları. Bu komutlar zaman uyumlu olarak çalışır, ancak bir sonraki düzenli şema yenilemesinde uygulanır ve bu da yeni yapılandırma uygulanana kadar kısa bir gecikmeye neden olabilir.

İzleyici komutları veritabanı düzeyi komutlarını ve tablo düzeyi komutlarını içerir.

İzinler

Bu komutu çalıştırmak için en az Veritabanı Yönetici izinlerine sahip olmanız gerekir.

Veritabanı ilkesi geçersiz kılmaları

Öncü veritabanı, aşağıdaki veritabanı düzeyindeki ilkeleri izleyen kümede geçersiz kılabilir: Önbelleğe alma ilkesi ve Yetkili sorumlular.

Önbelleğe alma ilkesi

İzleyici kümesi için varsayılan önbelleğe alma ilkesi öncü küme veritabanını ve tablo düzeyinde önbelleğe alma ilkelerini kullanır.

Seçenek Açıklama
Hiçbiri Kullanılan önbelleğe alma ilkeleri, öncü kümedeki kaynak veritabanında tanımlanan ilkelerdir.
Değiştirmek Öncü küme veritabanındaki kaynak veritabanı ve tablo düzeyinde önbelleğe alma ilkeleri kaldırılır (olarak nullayarlanır). Bu ilkeler, tanımlanmışsa veritabanı ve tablo düzeyinde geçersiz kılma ilkeleriyle değiştirilir.
union(varsayılan) Öncü küme veritabanındaki kaynak veritabanı ve tablo düzeyinde önbelleğe alma ilkeleri, veritabanında tanımlanan ilkelerle ve tablo düzeyinde geçersiz kılma ilkeleriyle birleştirilir.

Not

  • Geçersiz kılma veritabanı ve tablo düzeyinde önbelleğe alma ilkeleri koleksiyonu boşsa, her şey varsayılan olarak önbelleğe alınır.
  • Veritabanı düzeyinde önbelleğe alma ilkesini geçersiz kılmayı olarak 0dayarlayabilirsiniz ve varsayılan olarak hiçbir şey önbelleğe alınmaz.

Yetkili sorumlular

Seçenek Açıklama
Hiçbiri Yetkili sorumlular, öncü kümenin kaynak veritabanında tanımlanır.
Değiştirmek Geçersiz kılma yetkili sorumluları, öncü kümedeki kaynak veritabanındaki yetkili sorumluların yerini alır.
union(varsayılan) Geçersiz kılma yetkili sorumluları, öncü kümedeki kaynak veritabanındaki yetkili sorumlularla birleştirilir.

Not

Geçersiz kılma yetkili sorumluları koleksiyonu boşsa, veritabanı düzeyinde sorumlular olmaz.

Tablo ve gerçekleştirilmiş görünümler ilkesi geçersiz kılmaları

Varsayılan olarak, takip eden bir küme tarafından izlenen bir veritabanındaki tablolar ve gerçekleştirilmiş görünümler kaynak varlığın önbelleğe alma ilkesini korur. Ancak tablo ve gerçekleştirilmiş görünüm önbelleğe alma ilkeleri , izleyen kümede geçersiz kılınabilir. Kaynak varlığın replace önbelleğe alma ilkesini geçersiz kılmak için seçeneğini kullanın.

Veritabanı düzeyi komutları

.show follower database

Bir veya daha fazla veritabanı düzeyinde geçersiz kılma yapılandırılmış olan ve diğer öncü kümeden gelen bir veritabanını (veya veritabanlarını) gösterir.

Syntax

.showfollowerdatabaseDatabasename

.showfollowerdatabases(DatabaseName1,...,DatabaseNameN)

Çıkış

Çıkış parametresi Tür Description
DatabaseName string Takip edilen veritabanının adı.
LeaderClusterMetadataPath string Öncü kümenin meta veri kapsayıcısının yolu.
CachingPolicyOverride string Veritabanı için JSON veya null olarak serileştirilmiş bir geçersiz kılma önbelleğe alma ilkesi.
AuthorizedPrincipalsOverride string Veritabanı için JSON veya null olarak serileştirilmiş yetkili sorumluların geçersiz kılma koleksiyonu.
AuthorizedPrincipalsModificationKind string AuthorizedPrincipalsOverride (none, unionveya replace) kullanılarak uygulanacak değişiklik türü.
CachingPoliciesModificationKind string Veritabanı veya tablo düzeyinde önbelleğe alma ilkesi geçersiz kılmaları (none, unionveya replace) kullanılarak uygulanacak değişiklik türü.
IsAutoPrefetchEnabled bool Her şema yenilemesinde yeni verilerin önceden getirilip getirilmediği.
TableMetadataOverrides string Tanımlanmışsa, Tablo düzeyi özelliğin JSON serileştirmesi geçersiz kılar.

.alter follower database policy caching

Öncü kümedeki kaynak veritabanındaki kümeyi geçersiz kılmak için bir takipçi veritabanı önbelleğe alma ilkesini değiştirir.

Notlar

Syntax

.alterfollowerdatabaseDatabasenamepolicycachinghot=HotDataSpan

Örnek

.alter follower database MyDb policy caching hot = 7d

.delete follower veritabanı ilkesi önbelleğe alma

Bir takipçi veritabanını geçersiz kılma önbelleğe alma ilkesini siler. Bu silme, öncü kümedeki kaynak veritabanında ayarlanan ilkenin etkili bir ilkeye neden olur.

Notlar

Syntax

.deletefollowerdatabaseDatabasenamepolicycaching

Örnek

.delete follower database MyDB policy caching

.add follower database principals

Geçersiz kılma yetkili sorumlularının takip eden veritabanı koleksiyonuna yetkili sorumlular ekler. Notlar

Syntax

.addfollowerdatabaseDatabaseName (adminsviewers | users | | monitors) Rol (sorumlusu1,...,principalN) ['notlar']

Örnek

.add follower database MyDB viewers ('aadgroup=mygroup@microsoft.com') 'My Group'

.drop follower veritabanı sorumluları

Geçersiz kılma yetkili sorumlularının takip eden veritabanı koleksiyonundan yetkili sorumluları bırakır.

Not

Syntax

.dropfollowerdatabaseDatabaseName (adminsviewers | | | usersmonitors) (principal1,...,principalN)

Örnek

.drop follower database MyDB viewers ('aadgroup=mygroup@microsoft.com')

.alter follower database principals-modification-kind

Takipçi veritabanı yetkili sorumluları değişiklik türünü değiştirir.

Not

Syntax

.alterfollowerdatabaseDatabasenameprincipals-modification-kind = (none | | unionreplace)

Örnek

.alter follower database MyDB principals-modification-kind = union

.alter follower database caching-policies-modification-kind

İzleyici veritabanı, tablo ve gerçekleştirilmiş görünümler için önbelleğe alma ilkeleri değişiklik türünü değiştirir.

Not

  • Değişiklik standart .show komutlar kullanılarak yapıldıktan sonra veritabanı/tablo düzeyinde önbelleğe alma ilkelerinin etkili koleksiyonunu görüntüleme:
  • Değişiklik kullanılarak yapıldıktan sonra takipçi veritabanında geçersiz kılma ayarlarını görüntüleme .show follower database

Syntax

.alterfollowerdatabaseDatabasenamecaching-policies-modification-kind = (none | | unionreplace)

Örnek

.alter follower database MyDB caching-policies-modification-kind = union

.alter follower database prefetch-extents

İzleyici kümesi, bu verileri sorgulanabilir hale getirmeden önce temel alınan depolamadan düğümlerin SSD'sine (önbellek) yeni verilerin getirilmesini bekleyebilir.

Aşağıdaki komut, her şema yenilemesinde yeni kapsamları önceden getirme işleminin takipçi veritabanı yapılandırmasını değiştirir.

Uyarı

  • Bu ayar, takipçi veritabanındaki verilerin güncelliğini düşürebilir.
  • Varsayılan yapılandırma şeklindedir falseve varsayılan yapılandırmanın kullanılması önerilir.
  • ayarını trueolarak değiştirmeyi seçerken, yapılandırma değişikliğinden sonraki bir süre için yenilik üzerindeki etkisini yakından değerlendirin.

Syntax

.alterfollowerdatabaseDatabasenameprefetch-extents = (true | false)

Örnek

.alter follower database MyDB prefetch-extents = false

Tablolar ve gerçekleştirilmiş görünüm komutları

İzleme tablosunu veya gerçekleştirilmiş görünümü önbelleğe alma ilkesini değiştirme

Öncü kümedeki kaynak veritabanında ayarlanan ilkeyi geçersiz kılmak için, bir tablonun veya gerçekleştirilmiş görünümün izleyen veritabanındaki önbelleğe alma ilkesini değiştirir.

Not

Syntax

.alterfollowerdatabaseDatabaseName tablosu TableNamepolicy=cachinghotHotDataSpan

.alterfollowerdatabaseDatabaseName tabloları (TableName1,...,TableNameN)policycachinghot=HotDataSpan

.alterfollowerdatabaseDatabaseName materialized-view ViewNamepolicy=cachinghotHotDataSpan

.alterfollowerdatabaseDatabaseName materialized-views (ViewName1,...,ViewNameN)policycachinghot=HotDataSpan

Örnekler

.alter follower database MyDb tables (Table1, Table2) policy caching hot = 7d

.alter follower database MyDb materialized-views (View1, View2) policy caching hot = 7d

İzleyici tablosunu veya gerçekleştirilmiş görünüm önbelleğe alma ilkesini silme

Bir tablonun veya gerçekleştirilmiş görünümün takipçi veritabanındaki önbelleğe alma ilkesi için geçersiz kılmayı siler. Öncü kümedeki kaynak veritabanında ayarlanan ilke artık etkili ilke olacaktır.

Not

Syntax

.deletefollowerdatabaseDatabasenametableTablenamepolicycaching

.deletefollowerdatabaseDatabasenametables(TabloAdı1,...,TableNameN)policycaching

.deletefollowerdatabaseDatabasenamematerialized-viewViewnamepolicycaching

.deletefollowerdatabaseDatabasenamematerialized-views(GörünümAdı1,...,ViewNameN)policycaching

Örnek

.delete follower database MyDB tables (Table1, Table2) policy caching

.delete follower database MyDB materialized-views (View1, View2) policy caching

Örnek yapılandırma

Aşağıda, bir takipçi veritabanını yapılandırmaya yönelik örnek adımlar verilmiştir.

Bu örnekte:

  • Takip eden kümemiz, MyFollowerCluster öncü küme MyLeaderClusterolan 'dan veritabanını MyDatabase takip edecektir.

    • MyDatabase tabloları vardır N : MyTable1, MyTable2, MyTable3, ... MyTableN (N> 3).
    • Tarihinde MyLeaderCluster:
    MyTable1 önbelleğe alma ilkesi MyTable2 önbelleğe alma ilkesi MyTable3...MyTableN önbelleğe alma ilkesi MyDatabase Yetkili sorumlular
    sık erişimli veri aralığı = 7d sık erişimli veri aralığı = 30d sık erişimli veri aralığı = 365d görüntüleyenler = aadgroup=scubadivers@contoso.com; Yöneticiler = aaduser=jack@contoso.com
    • İstediğimiz zaman MyFollowerCluster :
    MyTable1 önbelleğe alma ilkesi MyTable2 önbelleğe alma ilkesi MyTable3...MyTableN önbelleğe alma ilkesi MyDatabase Yetkili sorumlular
    sık erişimli veri aralığı = 1d sık erişimli veri aralığı = 3d hot data span = 0d (hiçbir şey önbelleğe alınmaz) = aaduser=jack@contoso.comYöneticiler, Görüntüleyiciler = aaduser=jill@contoso.com

Önemli

MyLeaderCluster hem hem de MyFollowerCluster aynı bölgede olmalıdır.

Yürütülecek adımlar

Önkoşul: kümeden MyFollowerCluster veritabanını MyDatabase takip etmek için kümeyi MyLeaderClusterayarlayın.

Not

Yönetim komutlarını çalıştıran sorumlunun veritabanında MyDatabaseolması DatabaseAdmin beklenir.

Geçerli yapılandırmayı göster

üzerinde takip MyFollowerClusteredilen geçerli yapılandırmaya MyDatabase bakın:

.show follower database MyDatabase
| evaluate narrow() // just for presentation purposes
Sütun Değer
DatabaseName Veritabanım
LeaderClusterMetadataPath https://storageaccountname.blob.core.windows.net/cluster
CachingPolicyOverride null
AuthorizedPrincipalsOverride []
AuthorizedPrincipalsModificationKind Hiçbiri
IsAutoPrefetchEnabled Yanlış
TableMetadataOverrides
CachingPoliciesModificationKind Birleşim

Yetkili sorumluları geçersiz kılma

için MyDatabaseMyFollowerCluster yetkili sorumlular koleksiyonunu, veritabanı yöneticisi olarak yalnızca bir Microsoft Entra kullanıcı ve veritabanı görüntüleyicisi olarak bir Microsoft Entra kullanıcı içeren bir koleksiyonla değiştirin:

.add follower database MyDatabase admins ('aaduser=jack@contoso.com')

.add follower database MyDatabase viewers ('aaduser=jill@contoso.com')

.alter follower database MyDatabase principals-modification-kind = replace

Yalnızca bu iki belirli sorumluya erişim MyDatabase yetkisi MyFollowerCluster

.show database MyDatabase principals
Rol Principaltype PrincipalDisplayName PrincipalObjectId PrincipalFQN Notlar
VeritabanımVeritabanı Yönetici Microsoft Entra kullanıcı Jack Kusto (upn: jack@contoso.com) 12345678-abcd-efef-1234-350bf486087b aaduser=87654321-abcd-efef-1234-350bf486087b; 55555555-4444-3333-2222-2d7cd011db47
VeritabanımVeritabanı Görüntüleyicisi Microsoft Entra kullanıcı Jill Kusto (upn: jack@contoso.com) abcdefab-abcd-efef-1234-350bf486087b aaduser=54321789-abcd-efef-1234-350bf486087b; 55555555-4444-3333-2222-2d7cd011db47 
.show follower database MyDatabase
| mv-expand parse_json(AuthorizedPrincipalsOverride)
| project AuthorizedPrincipalsOverride.Principal.FullyQualifiedName
AuthorizedPrincipalsOverride_Principal_FullyQualifiedName
aaduser=87654321-abcd-efef-1234-350bf486087b; 55555555-4444-3333-2222-2d7cd011db47
aaduser=54321789-abcd-efef-1234-350bf486087b; 55555555-4444-3333-2222-2d7cd011db47

Önbelleğe Alma ilkelerini geçersiz kılma

Veritabanı ve tablo düzeyinde önbelleğe alma ilkelerinin koleksiyonunu değiştirmek için MyDatabaseMyFollowerCluster, tüm tabloları verileri önbelleğe alınmayacak şekilde ayarlayın; bu, verilerinin sırasıyla ve 3ddönemleri 1d için önbelleğe alınmasına neden olacak iki tablo (MyTable1, MyTable2 - hariç):

.alter follower database MyDatabase policy caching hot = 0d

.alter follower database MyDatabase table MyTable1 policy caching hot = 1d

.alter follower database MyDatabase table MyTable2 policy caching hot = 3d

.alter follower database MyDatabase caching-policies-modification-kind = replace

Yalnızca bu iki belirli tabloda önbelleğe alınmış veriler vardır ve tabloların geri kalanında sık erişimli veri dönemi vardır 0d:

.show tables details
| summarize TableNames = make_list(TableName) by CachingPolicy
CachingPolicy TableNames
{"DataHotSpan":{"Value":"1.00:00:00"},"IndexHotSpan":{"Value":"1.00:00:00"}} ["MyTable1"]
{"DataHotSpan":{"Value":"3.00:00:00"},"IndexHotSpan":{"Value":"3.00:00:00"}} ["MyTable2"]
{"DataHotSpan":{"Value":"0.00:00:00"},"IndexHotSpan":{"Value":"0.00:00:00"}} ["MyTable3",...,"MyTableN"] 
.show follower database MyDatabase
| mv-expand parse_json(TableMetadataOverrides)
| project TableMetadataOverrides
TableMetadataOverrides
{"MyTable1":{"CachingPolicyOverride":{"DataHotSpan":{"Value":"1.00:00:00"},"IndexHotSpan":{"Value":"1.00:00:00"}}}
{"MyTable2":{"CachingPolicyOverride":{"DataHotSpan":{"Value":"3.00:00:00"},"IndexHotSpan":{"Value":"3.00:00:00"}}}

Özet

üzerinde takip edilen geçerli yapılandırmaya MyDatabaseMyFollowerClusterbakın:

.show follower database MyDatabase
| evaluate narrow() // just for presentation purposes
Sütun Değer
DatabaseName Veritabanım
LeaderClusterMetadataPath https://storageaccountname.blob.core.windows.net/cluster
CachingPolicyOverride {"DataHotSpan":{"Value":"00:00:00"},"IndexHotSpan":{"Value":"00:00:00"}}
AuthorizedPrincipalsOverride [{"Principal":{"FullyQualifiedName":"aaduser=87654321-abcd-efef-1234-350bf486087b",...},{"Principal":{"FullyQualifiedName":"aaduser=54321789-abcd-efef-1234-350bf486087b",...}]
AuthorizedPrincipalsModificationKind Değiştir
IsAutoPrefetchEnabled Yanlış
TableMetadataOverrides {"MyTargetTable":{"CachingPolicyOverride":{"DataHotSpan":{"Value":"3.00:00:00"}...},""MySourceTable":{"CachingPolicyOverride":{"DataHotSpan":{"Value":"1.00:00:00"},...}}}
CachingPoliciesModificationKind Değiştir