Freigeben über

Follower-Kommandos

Wechseln Von Diensten mithilfe der Dropdownliste "Version ". Weitere Informationen zur Navigation.
Gilt für: ✅ Azure Data Explorer

Verwaltungsbefehle für die Verwaltung Ihrer Followerkonfiguration. Diese Befehle werden synchron ausgeführt, werden aber auf die nächste regelmäßige Schemaaktualisierung angewendet, was zu einer kurzen Verzögerung führen kann, bis die neue Konfiguration angewendet wird.

Die Folgenbefehle umfassen Befehle auf Datenbankebene und Befehle auf Tabellenebene.

Erlaubnisse

Sie müssen mindestens über Datenbankadministrator- Berechtigungen zum Ausführen dieses Befehls verfügen.

Außerkraftsetzungen von Datenbankrichtlinien

Eine Führungsdatenbank kann die folgenden Richtlinien auf Datenbankebene im Followercluster außer Kraft setzen: Zwischenspeicherungsrichtlinie und autorisierte Prinzipale.

Zwischenspeicherungsrichtlinie

Die Standardzwischenspeicherungsrichtlinie für den Followercluster verwendet die Richtlinien für die Clusterdatenbank und die Zwischenspeicherung auf Tabellenebene.

Option Description
None Die verwendeten Zwischenspeicherungsrichtlinien sind diese Richtlinien, die in der Quelldatenbank im Leadercluster definiert sind.
ersetzen Die Quelldatenbank in der Spitzenclusterdatenbank und Zwischenspeicherungsrichtlinien auf Tabellenebene werden entfernt (festgelegt auf null). Diese Richtlinien werden durch die Richtlinien auf Datenbank- und Tabellenebene ersetzt, sofern definiert.
union(standard) Die Quelldatenbank in der Spitzenclusterdatenbank und Zwischenspeicherungsrichtlinien auf Tabellenebene werden mit den richtlinien kombiniert, die in den Richtlinien auf Datenbank- und Tabellenebene überschreiben.

Hinweis

  • Wenn die Auflistung der Zwischenspeicherungsrichtlinien auf Tabellenebene leer ist, wird standardmäßig alles zwischengespeichert.
  • Sie können die Außerkraftsetzung der Zwischenspeicherungsrichtlinie auf Datenbankebene auf 0d" festlegen, und standardmäßig wird nichts zwischengespeichert.

Autorisierte Prinzipale

Option Description
None Die autorisierten Prinzipale werden in der Quelldatenbank des Leaderclusters definiert.
ersetzen Die außer Kraft setzen autorisierten Prinzipale ersetzen die autorisierten Prinzipale aus der Quelldatenbank im Leadercluster.
union(standard) Die außer Kraft setzen autorisierten Prinzipale werden mit den autorisierten Prinzipale aus der Quelldatenbank im Leadercluster kombiniert.

Hinweis

Wenn die Sammlung autorisierter Prinzipale leer ist, gibt es keine Prinzipale auf Datenbankebene.

Außerkraftsetzungen von Tabellen- und materialisierten Ansichten

Standardmäßig behalten Tabellen und materialisierte Ansichten in einer Datenbank, auf die ein Followercluster folgt, die Zwischenspeicherungsrichtlinie der Quellentität. Tabellen- und materialisierte Zwischenspeicherungsrichtlinien für Tabellen und Ansichten können jedoch im Followercluster überschrieben werden. Verwenden Sie die replace Option, um die Zwischenspeicherungsrichtlinie der Quellentität außer Kraft zu setzen.

Befehle auf Datenbankebene

.show follower database

Zeigt eine Datenbank (oder Datenbanken) an, auf die ein oder mehrere Überschreibungen auf Datenbankebene konfiguriert sind, gefolgt von einem anderen Leadercluster.

Syntax

.show follower database Databasename

.show follower databases ( DatabaseName1,...,DatabaseNameN)

Output

Ausgabeparameter Typ Description
DatabaseName string Der Name der Datenbank, der gefolgt wird.
LeaderClusterMetadataPath string Der Pfad zum Metadatencontainer des Leaderclusters.
CachingPolicyOverride string Eine Außerkraftsetzungsrichtlinie für die Datenbank, serialisiert als JSON oder NULL.
AuthorizedPrincipalsOverride string Eine Außerkraftsetzungsauflistung autorisierter Prinzipale für die Datenbank, serialisiert als JSON oder NULL.
AuthorizedPrincipalsModificationKind string Die Änderungsart, die mit AuthorizedPrincipalsOverride (none, unionoder replace) angewendet werden soll.
CachingPoliciesModificationKind string Die Änderungsart, die mithilfe von Richtlinienüberschreibungen auf Datenbank- oder Tabellenebene angewendet werden soll (noneoder unionreplace).
IsAutoPrefetchEnabled bool Gibt an, ob neue Daten bei jeder Schemaaktualisierung vorab abgerufen werden.
TableMetadataOverrides string Wenn definiert, wird eine JSON-Serialisierung von Außerkraftsetzungen von Eigenschaften auf Tabellenebene verwendet.

.alter follower-Datenbankrichtlinienzwischenspeicherung

Ändert eine Richtlinie für die Zwischenspeicherung von Followerdatenbanken, um den Satz für die Quelldatenbank im Leadercluster außer Kraft zu setzen.

Hinweise

Syntax

.alter follower database Databasenamepolicycachinghot=HotDataSpan

Beispiel

.alter follower database MyDb policy caching hot = 7d

.delete Follower-Datenbankrichtlinienzwischenspeicherung

Löscht eine Richtlinie zur Außerkraftsetzung der Zwischenspeicherung einer Folgedatenbank. Durch diesen Löschvorgang wird die Richtlinie, die für die Quelldatenbank im Leadercluster festgelegt ist, als effektiv festgelegt.

Hinweise

Syntax

.delete follower database Databasenamepolicycaching

Beispiel

.delete follower database MyDB policy caching

.add follower database principals

Fügt der Followerdatenbanksammlung autorisierte Prinzipale der Außerkraftsetzung autorisierter Prinzipale hinzu. Hinweise

Syntax

.add follower database DatabaseName (admins | users | viewers | monitors) Role (principal1,...,principalN) ['Hinweise']

Beispiel

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

.drop follower database principals

Entfernt autorisierte Prinzipale aus der Follower-Datenbanksammlung der Außerkraftsetzung autorisierter Prinzipale.

Hinweis

Syntax

.drop follower database DatabaseName (adminsviewers | | | usersmonitors) (principal1,...,principalN)

Beispiel

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

.alter follower database principals-modification-kind

Ändert die Änderungsart der Autorisierten Prinzipaldatenbank.

Hinweis

Syntax

.alter follower database Databasenameprincipals-modification-kind = (none | union | replace)

Beispiel

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

.alter follower database caching-policies-modification-kind

Ändert die Änderungsart der Zwischenspeicherungsrichtlinien für die Followerdatenbank, die Tabelle und die materialisierten Ansichten.

Hinweis

  • Anzeigen der effektiven Sammlung von Zwischenspeicherungsrichtlinien auf Datenbank-/Tabellenebene, nachdem die Änderung mithilfe der Standardbefehle .show durchgeführt werden kann:
  • Anzeigen der Außerkraftsetzungseinstellungen in der Followerdatenbank, nachdem die Änderung mithilfe der Änderung erfolgen kann .show follower database

Syntax

.alter follower database Databasenamecaching-policies-modification-kind = (none | union | replace)

Beispiel

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

.alter follower database prefetch-extents

Der Followercluster kann warten, bis neue Daten aus dem zugrunde liegenden Speicher in den SSD (Cache) der Knoten abgerufen werden, bevor diese Daten abgefragt werden können.

Mit dem folgenden Befehl wird die Konfiguration der Followerdatenbank für das Vorababrufen neuer Erweiterungen bei jeder Schemaaktualisierung geändert.

Warnung

  • Diese Einstellung kann die Aktualität der Daten in der Followerdatenbank beeinträchtigen.
  • Die Standardkonfiguration ist false, und es wird empfohlen, die Standardeinstellung zu verwenden.
  • Wenn Sie sich dafür entscheiden, die Einstellung truezu ändern, bewerten Sie die Auswirkungen auf die Aktualität für einen bestimmten Zeitraum nach der Konfigurationsänderung genau.

Syntax

.alter follower database Databasenameprefetch-extents = (true | false)

Beispiel

.alter follower database MyDB prefetch-extents = false

Befehle für Tabellen und materialisierte Ansichten

Ändern der Zwischenspeicherungsrichtlinie für die Nachverfolgungstabelle oder der materialisierten Ansicht

Ändert die Zwischenspeicherungsrichtlinie einer Tabelle oder einer materialisierten Ansicht in der Followerdatenbank, um die richtlinie außer Kraft zu setzen, die für die Quelldatenbank im Leadercluster festgelegt ist.

Hinweis

Syntax

.alter follower database DatabaseName-Tabelle"TableNamepolicycachinghot=HotDataSpan"

.alter follower database DatabaseName-Tabellen(TableName1,...,TableNameN)policycachinghot=HotDataSpan

.alter follower database DatabaseName materialized-view ViewNamepolicy=cachinghotHotDataSpan

.alter follower database DatabaseName materialized-views (ViewName1,...,ViewNameN)policycachinghot=HotDataSpan

Examples

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

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

Löschen einer Nachverfolgungstabelle oder materialisierter Ansichtszwischenspeicherungsrichtlinie

Löscht eine Außerkraftsetzung für die Zwischenspeicherungsrichtlinie einer Tabelle oder einer materialisierten Ansicht in der Folgedatenbank. Die richtlinie, die für die Quelldatenbank im Leadercluster festgelegt ist, ist jetzt die effektive Richtlinie.

Hinweis

Syntax

.delete follower database DatabasenametableTablenamepolicycaching

.delete follower database Databasenametables(TableName1,...,TableNameN)policycaching

.delete follower database Databasenamematerialized-viewViewnamepolicycaching

.delete follower database Databasenamematerialized-views(ViewName1,...,ViewNameN)policycaching

Beispiel

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

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

Beispielkonfiguration

Im Folgenden werden Die folgenden Beispielschritte zum Konfigurieren einer Followerdatenbank beschrieben.

In diesem Beispiel:

  • Unser Followercluster MyFollowerCluster folgt der Datenbank MyDatabase des Leaderclusters. MyLeaderCluster

    • MyDatabase hat N Tabellen: MyTable1, , MyTable2, MyTable3... MyTableN (N> 3).
    • Auf MyLeaderCluster:
    MyTable1 Zwischenspeicherungsrichtlinie MyTable2 Zwischenspeicherungsrichtlinie MyTable3...MyTableN Zwischenspeicherungsrichtlinie MyDatabase Autorisierte Prinzipale
    Hot Data Span = 7d Hot Data Span = 30d Hot Data Span = 365d = aadgroup=scubadivers@contoso.comBetrachter; Admins = aaduser=jack@contoso.com
    • Wir MyFollowerCluster wollen:
    MyTable1 Zwischenspeicherungsrichtlinie MyTable2 Zwischenspeicherungsrichtlinie MyTable3...MyTableN Zwischenspeicherungsrichtlinie MyDatabase Autorisierte Prinzipale
    Hot Data Span = 1d Hot Data Span = 3d Hot data span = 0d (nothing is cached) = aaduser=jack@contoso.comAdministratoren, Anzeigende = aaduser=jill@contoso.com

Von Bedeutung

Beide und MyFollowerClusterMyLeaderCluster müssen sich in derselben Region befinden.

Auszuführende Schritte

Voraussetzung: Richten Sie den Cluster MyFollowerCluster ein, um der Datenbank MyDatabase aus dem Cluster MyLeaderClusterzu folgen.

Hinweis

Der Prinzipal, der die Verwaltungsbefehle ausführt, wird erwartet, dass es sich um eine DatabaseAdmin Datenbank MyDatabasehandelt.

Anzeigen der aktuellen Konfiguration

Sehen Sie sich die aktuelle Konfiguration an, auf die MyDatabase folgt MyFollowerCluster:

.show follower database MyDatabase
| evaluate narrow() // just for presentation purposes
Kolumne Wert
DatabaseName MeineDatenbank
LeaderClusterMetadataPath https://storageaccountname.blob.core.windows.net/cluster
CachingPolicyOverride NULL
AuthorizedPrincipalsOverride []
AuthorizedPrincipalsModificationKind Nichts
IsAutoPrefetchEnabled Falsch
TableMetadataOverrides
CachingPoliciesModificationKind Union

Außerkraftsetzen autorisierter Prinzipale

Ersetzen Sie die Sammlung autorisierter Prinzipale für MyDatabase "on MyFollowerCluster " durch eine Sammlung, die nur einen Microsoft Entra-Benutzer als Datenbankadministrator und einen Microsoft Entra-Benutzer als Datenbank-Viewer enthält:

.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

Nur diese beiden spezifischen Prinzipale sind für den Zugriff MyDatabase auf MyFollowerCluster

.show database MyDatabase principals
Rolle PrincipalType PrincipalDisplayName PrincipalObjectId PrincipalFQN Hinweise
Datenbank-MyDatabase-Administrator Microsoft Entra-Benutzer Jack Kusto (upn: jack@contoso.com) 12345678-abcd-efef-1234-350bf486087b aaduser=87654321-abcd-efef-1234-350bf486087b; 55555555-4444-3333-2222-2d7cd011db47
Datenbank myDatabase Viewer Microsoft Entra-Benutzer 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

Außerkraftsetzen von Zwischenspeicherungsrichtlinien

Ersetzen Sie die Sammlung von Zwischenspeicherungsrichtlinien auf MyDatabaseMyFollowerCluster Datenbank- und Tabellenebene, indem Sie alle Tabellen so festlegen, dass ihre Daten nicht zwischengespeichert werden, mit Ausnahme von zwei spezifischen Tabellen , MyTable1MyTable2 die ihre Daten für Zeiträume 1d und 3djeweils zwischengespeichert haben:

.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

Nur diese beiden spezifischen Tabellen haben Daten zwischengespeichert, und die restlichen Tabellen weisen einen heißen Datenzeitraum auf 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:00"}} ["MyTable1"]
{"DataHotSpan":{"Value":"3.00:00:00"},"IndexHotSpan":{"Value":"3.00:00:00:00"}} ["MyTable2"]
{"DataHotSpan":{"Value":"0.00:00:00"},"IndexHotSpan":{"Value":"0.00: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:00"},"IndexHotSpan":{"Value":"1.00:00:00"}}}
{"MyTable2":{"CachingPolicyOverride":{"DataHotSpan":{"Value":"3.00:00:00"},"IndexHotSpan":{"Value":"3.00:00:00:00"}}}

Zusammenfassung

Sehen Sie sich die aktuelle Konfiguration an, MyDatabase auf MyFollowerClusterdie sie folgt:

.show follower database MyDatabase
| evaluate narrow() // just for presentation purposes
Kolumne Wert
DatabaseName MeineDatenbank
LeaderClusterMetadataPath https://storageaccountname.blob.core.windows.net/cluster
CachingPolicyOverride {"DataHotSpan":{"Value":"00:00:00"},"IndexHotSpan":{"Value":"00:00:00:00"}}
AuthorizedPrincipalsOverride [{"Principal":{"FullyQualifiedName":"aaduser=87654321-abcd-efef-1234-350bf486087b",...},{"Principal":{"FullyQualifiedName":"aaduser=54321789-abcd-efef-1234-350bf486087b",...}]
AuthorizedPrincipalsModificationKind Replace
IsAutoPrefetchEnabled Falsch
TableMetadataOverrides {"MyTargetTable":{"CachingPolicyOverride":{"DataHotSpan":{"Value":"3.00:00:00"}...},"MySourceTable":{"CachingPolicyOverride":{"DataHotSpan":{"Value":"1.00:00:00:00"},...}}}
CachingPoliciesModificationKind Replace
  • Last updated on