共用方式為

使用追隨者資料庫

追蹤資料庫 功能可讓您將位於不同叢集中的資料庫附加至 Azure 數據總管叢集。 從屬資料庫 會以 只讀 模式附加，使您可以檢視數據，並對已擷取到 主資料庫的數據執行查詢。 追蹤者資料庫會同步領導者資料庫的變更。 由於同步處理，數據可用性會有幾秒鐘到幾分鐘的數據延遲。 時間延遲的長度取決於領導者資料庫元數據的整體大小。 領導者和追蹤者資料庫會使用相同的記憶體帳戶來擷取數據。 記憶體是由領導者資料庫所擁有。 後續資料庫會檢視數據，而不需要擷取數據。 由於附加資料庫是只讀資料庫，因此除了 快取原則、主體和 許可權之外，無法修改資料庫中的數據、數據表和原則。 無法刪除附加的資料庫。 它們必須由領導者或跟隨者移除，然後才能刪除。

使用追隨功能將資料庫附加至不同的叢集，作為在組織和團隊之間共享資料的基礎架構。 此功能有助於隔離計算資源，以保護生產環境免於非生產使用案例。 追蹤程式也可以用來將 Azure 數據總管叢集的成本與對數據執行查詢的合作對象產生關聯。

追蹤哪些資料庫？

  • 叢集可以遵循一個資料庫、數個資料庫或領導者叢集的所有資料庫。
  • 單一叢集可以追蹤來自多個領導者叢集的資料庫。
  • 叢集可以同時包含追蹤者資料庫和領導者資料庫。
  • EngineV3 叢集只能遵循 EngineV3 叢集，同樣地，EngineV2 叢集只能遵循 V2 叢集。

先決條件

附加資料庫

您可以使用各種方法來附加資料庫。 在本文中，我們會討論使用 C#、Python、PowerShell 或 Azure Resource Manager 範本附加資料庫。 若要附加資料庫，您必須擁有使用者、群組、服務主體或受控身份，而且在領導者叢集和追隨者叢集上至少具備貢獻者角色。 使用 Azure 入口網站、PowerShell、Azure CLI和 ARM 範本新增或移除角色指派。 深入瞭解 Azure 角色型訪問控制 （Azure RBAC） 和 不同角色。

資料表層級共用

在附加資料庫時，所有資料表、外部數據表和具體化檢視也會被隨附。 您可以藉由設定 『TableLevelSharingProperties'，來共用特定的數據表/外部數據表/具體化檢視。

'TableLevelSharingProperties' 包含八個字串陣列：tablesToInclude、tablesToExclude、externalTablesToInclude、externalTablesToExclude、materializedViewsToInclude、materializedViewsToExclude、functionsToInclude和 functionsToExclude。 所有陣列中的項目數目上限為100。

備註

使用 『*』 所有資料庫表示法時，不支持數據表層級共用。

備註

包含物化視圖時，也會包含其來源資料表。

範例

  1. 包含所有數據表。 不需要 『*』，因為所有數據表預設都會跟著：

    tablesToInclude = []

  2. 包含名稱開頭為 「Logs」 的所有資料表：

    tablesToInclude = ["Logs*"]

  3. 排除所有外部資料表：

    externalTablesToExclude = ["*"]

  4. 排除所有實體化視圖：

    materializedViewsToExclude=["*"]

資料庫名稱重設

您可以選擇性地讓追蹤叢集中的資料庫名稱與領導者叢集不同。 例如，您可能想要將多個領導者叢集的相同資料庫名稱附加至追蹤者叢集。 若要指定不同的資料庫名稱，請設定 'DatabaseNameOverride' 或 'DatabaseNamePrefix' 属性。

使用 C# 附加資料庫

所需的 NuGet 套件

C# 範例

var tenantId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"; //Directory (tenant) ID
var clientId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"; //Application ID
var clientSecret = "PlaceholderClientSecret"; //Client Secret
var followerSubscriptionId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx";
var credentials = await ApplicationTokenProvider.LoginSilentAsync(tenantId, clientId, clientSecret);
var resourceManagementClient = new KustoManagementClient(credentials) { SubscriptionId = followerSubscriptionId };
var followerResourceGroupName = "followerResourceGroup";
var followerClusterName = "follower";
var attachedDatabaseConfigurationName = "attachedDatabaseConfiguration"
var leaderSubscriptionId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx";
var leaderResourceGroup = "leaderResourceGroup";
var leaderClusterName = "leader";
var attachedDatabaseConfigurationData = new AttachedDatabaseConfiguration
{
    ClusterResourceId = $"/subscriptions/{leaderSubscriptionId}/resourceGroups/{leaderResourceGroup}/providers/Microsoft.Kusto/Clusters/{leaderClusterName}",
    DatabaseName = "<databaseName>", // Can be specific database name or * for all databases
    DefaultPrincipalsModificationKind = "Union",
    Location = "North Central US"
};
// Table level sharing properties are not supported when using '*' all databases notation.
if (attachedDatabaseConfigurationData.DatabaseName != "*")
{
    // Set up the table level sharing properties - the following is just an example.
    attachedDatabaseConfigurationData.TableLevelSharingProperties = new TableLevelSharingProperties(
        tablesToInclude:new List<string> { "table1" },
        tablesToExclude:new List<string> { "table2" },
        externalTablesToInclude:new List<string> { "exTable1" },
        externalTablesToExclude:new List<string> { "exTable2" },
        materializedViewsToInclude:new List<string> { "matTable1" },
        materializedViewsToExclude:new List<string> { "matTable2" }
    );
}
await resourceManagementClient.AttachedDatabaseConfigurations.CreateOrUpdateAsync(
    followerResourceGroupName, followerClusterName, attachedDatabaseConfigurationName, attachedDatabaseConfigurationData
);

確認資料庫已成功附加

若要確認資料庫已成功連結，請在 azure 入口網站 中尋找附加的資料庫。 您可以確認資料庫是否已成功附加在 從屬 或 主節點 叢集中。

檢查您的追蹤者群組

  1. 瀏覽至從屬叢集，然後選取 [資料庫]。

  2. 在資料庫清單中，搜尋新的唯讀資料庫。

    入口網站中只讀追蹤資料庫的螢幕快照。

    您也可以在資料庫概觀頁面中檢視此清單：

    具有追蹤者叢集清單的資料庫概觀頁面螢幕快照。

檢查您的領導者叢集

  1. 瀏覽至主叢集，然後選取 [資料庫]

  2. 檢查相關資料庫是否標示為與其他人共用 >[是]

  3. 切換關聯性連結以檢視詳細數據。

    與其他人共用的資料庫螢幕快照，以檢查領導者叢集。

    您也可以在資料庫概觀頁面中檢視此專案：

    概觀的螢幕快照，其中包含與其他人共用的資料庫清單。

卸載追隨者資料庫

備註

若要從從屬或主導端卸離資料庫，您必須擁有使用者、群組、服務主體或管理識別，且在要卸離資料庫的叢集上至少具有協作者角色。 在以下範例中，我們使用服務主體。

使用 C# 將附加的追蹤者資料庫與追蹤者叢集中斷連結

從屬叢集可以解除連結任何附屬的從屬資料庫，以下是步驟：

var tenantId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"; //Directory (tenant) ID
var clientId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"; //Application ID
var clientSecret = "PlaceholderClientSecret"; //Client Secret
var followerSubscriptionId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx";
var credentials = await ApplicationTokenProvider.LoginSilentAsync(tenantId, clientId, clientSecret);
var resourceManagementClient = new KustoManagementClient(credentials) { SubscriptionId = followerSubscriptionId };
var followerResourceGroupName = "testrg";
//The cluster and database attached database configuration are created as part of the prerequisites
var followerClusterName = "follower";
var attachedDatabaseConfigurationsName = "attachedDatabaseConfiguration";
await resourceManagementClient.AttachedDatabaseConfigurations.DeleteAsync(
    followerResourceGroupName, followerClusterName, attachedDatabaseConfigurationsName
);

使用 C# 從主節點叢集中分離附加的從屬資料庫。

主叢集可以卸載任何所連接的資料庫，如下所示：

var tenantId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"; //Directory (tenant) ID
var clientId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"; //Application ID
var clientSecret = "PlaceholderClientSecret"; //Client Secret
var leaderSubscriptionId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx";
var credentials = await ApplicationTokenProvider.LoginSilentAsync(tenantId, clientId, clientSecret);
var resourceManagementClient = new KustoManagementClient(credentials) { SubscriptionId = leaderSubscriptionId };
var leaderResourceGroupName = "testrg";
var leaderClusterName = "leader";
var followerSubscriptionId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx";
var followerResourceGroupName = "followerResourceGroup";
//The cluster and attached database configuration that are created as part of the Prerequisites
var followerClusterName = "follower";
var attachedDatabaseConfigurationsName = "attachedDatabaseConfiguration";
var followerDatabaseDefinition = new FollowerDatabaseDefinition
{
    ClusterResourceId = $"/subscriptions/{followerSubscriptionId}/resourceGroups/{followerResourceGroupName}/providers/Microsoft.Kusto/Clusters/{followerClusterName}",
    AttachedDatabaseConfigurationName = attachedDatabaseConfigurationsName
};
await resourceManagementClient.Clusters.DetachFollowerDatabasesAsync(
    leaderResourceGroupName, leaderClusterName, followerDatabaseDefinition
);

管理用戶主體、權限和快取政策

管理主體

附加資料庫時，請指定 「預設主體修改種類」。 默認值是將覆寫授權主體與 授權主體的領導者資料庫集合結合

親切 說明
聯集 / 工會 附加的資料庫主體一律會包含原始資料庫主體，以及新增至追蹤資料庫的其他新主體。
取代 原始資料庫沒有主體的繼承。 必須為附加的資料庫建立新主體。
沒有 附加的資料庫主體只包含原始資料庫的主體，沒有其他主體。

如需使用控制命令來設定授權主體的詳細資訊，請參閱 控制命令來管理追蹤者叢集。

管理許可權

管理唯讀資料庫許可權與所有資料庫類型的許可權相同。 請參閱 azure 入口網站中的 管理許可權。

設定快取原則

從屬資料庫管理員可以修改附加資料庫或其主機叢集上任何資料表的 快取原則。 預設值是將領導者叢集資料庫和數據表層級快取原則中的源資料庫與資料庫和數據表層級覆寫原則中定義的原則結合在一起。 例如，您可以在領導者資料庫的 30 天快取原則上執行每月報告，以及追蹤者資料庫的三天快取原則，只查詢最近的數據以進行疑難解答。 如需利用控制指令在從屬資料庫或資料表上設定快取原則的詳細資訊，請參閱 控制指令以管理從屬叢集。

備註

  • 如果主從叢集的資料庫之間發生衝突，當所有資料庫遵循從屬叢集時，衝突將如下解決：
    • 在追蹤叢集上建立 DB 的資料庫，優先於在領導者叢集上建立的相同名稱的資料庫。 這就是為什麼需要移除或重新命名追蹤叢集中的資料庫 DB，讓追蹤者叢集包含領導者的資料庫 DB。
    • 名為 DB 的資料庫將從兩個或多個領導者叢集中的 一個 任意選擇，且不會被選擇超過一次。
  • 顯示 叢集活動記錄和歷程的命令在追隨者叢集 上運行時，會顯示該追隨者叢集內的活動和歷程記錄，且其結果集不會包含領導者叢集或其他叢集的結果。
    • 例如：在從屬叢集上執行的 .show queries 命令只會顯示在從屬叢集所追蹤的資料庫上執行的查詢，而不會顯示在領導者叢集中針對相同資料庫執行的查詢。

局限性

  • 追蹤者和領導者叢集必須位於相同的區域中。
  • 如果在被追蹤的資料庫上使用 串流擷取，則必須在追蹤者叢集上啟用串流擷取，以允許追蹤串流擷取數據。
  • 領導者和追蹤者叢集不支援使用 客戶自控密鑰的數據加密。
  • 在卸離資料庫之前，您無法刪除附加至不同叢集的資料庫。
  • 您無法刪除已連結至其他叢集的叢集，必須先將其卸離。
  • 追蹤所有資料庫時，不支援數據表層級共享屬性。

後續步驟

  • Last updated on