Követő adatbázisok használata

A követő adatbázis funkcióval egy másik fürtben található adatbázist csatolhat az Azure Data Explorer-fürthöz. A követő adatbázisírásvédett módban van csatolva, így megtekintheti az adatokat, és lekérdezéseket futtathat a vezető adatbázisba betöltött adatokon. A követő adatbázis szinkronizálja a vezető adatbázisok módosításait. A szinkronizálás miatt néhány másodperc és néhány perc közötti adatelmaradás tapasztalható az adatok rendelkezésre állásában. Az időeltolódás hossza a vezető adatbázis metaadatainak teljes méretétől függ. A vezető és követő adatbázisok ugyanazt a tárfiókot használják az adatok lekéréséhez. A tárterület a vezető adatbázis tulajdonában van. A követő adatbázis úgy tekinti meg az adatokat, hogy nem kell betöltődnie. Mivel a csatolt adatbázis írásvédett adatbázis, az adatbázisban lévő adatok, táblák és szabályzatok nem módosíthatók, kivéve a gyorsítótárazási szabályzatot, a tagokat és az engedélyeket. A csatolt adatbázisok nem törölhetők. A vezetőnek vagy a követőnek le kell választania őket, és csak akkor törölhetők.

Az adatbázis egy másik fürthöz való csatolása a követő képesség használatával infrastruktúraként szolgál az adatok szervezetek és csapatok közötti megosztásához. A funkció hasznos a számítási erőforrások elkülönítéséhez, hogy megvédje az éles környezetet a nem éles használati esetektől. A követő az Azure Data Explorer-fürt költségeit is társíthatja az adatokon lekérdezéseket futtató félhez.

A korábbi SDK-verziókon alapuló kódmintákért tekintse meg az archivált cikket.

Mely adatbázisokat követi a rendszer?

• A fürtök egy adatbázist, több adatbázist vagy egy vezetőfürt összes adatbázisát követhetik.
• Egyetlen fürt több vezető fürt adatbázisait is követheti.
• A fürtök a követő adatbázisokat és a vezető adatbázisokat is tartalmazhatják.

Előfeltételek

• Azure-előfizetés. Hozzon létre egy ingyenes Azure-fiókot.
• Egy Azure Data Explorer-fürt és adatbázis a vezető és a követő számára. Hozzon létre egy fürtöt és egy adatbázist.
• A vezető adatbázisnak adatokat kell tartalmaznia. Az adatokat a betöltési áttekintésben ismertetett módszerek egyikével töltheti be.

Adatbázis csatolása

Az adatbázisok csatolására többféle módszer is használható. Ebben a cikkben egy adatbázis C#, Python, PowerShell vagy Azure Resource Manager sablon használatával történő csatolását tárgyaljuk. Adatbázis csatolásához rendelkeznie kell legalább közreműködői szerepkörrel rendelkező felhasználóval, csoporttal, szolgáltatásnévvel vagy felügyelt identitással a vezető fürtön és a követő fürtön. Szerepkör-hozzárendelések hozzáadása vagy eltávolítása Azure Portal, PowerShell, Azure CLI és ARM-sablon használatával. További információ az Azure szerepköralapú hozzáférés-vezérlésről (Azure RBAC) és a különböző szerepkörökről.

Táblaszintű megosztás

Az adatbázis csatolásakor a rendszer minden táblát, külső táblát és materializált nézetet is követ. A "TableLevelSharingProperties" konfigurálásával megoszthatja az adott táblákat/külső táblákat/materializált nézeteket.

A TableLevelSharingProperties nyolc sztringtömböt tartalmaz: tablesToInclude, , tablesToExclude, externalTablesToIncludeexternalTablesToExclude, materializedViewsToInclude, materializedViewsToExclude, functionsToIncludeés functionsToExclude. Az összes tömb bejegyzéseinek maximális száma 100.

Megjegyzés

• A táblaszintű megosztás nem támogatott az összes adatbázis jelölésének *használata esetén.
• A materializált nézetek belefoglalásakor a forrástáblák is bekerülnek.

Példák

1. Foglalja bele az összes táblát. Nincs szükség *-ra, mivel az összes táblát alapértelmezés szerint a következő követi:

   tablesToInclude = []
   

2. Adja meg a "Naplók" kezdetű összes táblát:

   tablesToInclude = ["Logs*"]
   

3. Az összes külső tábla kizárása:

   externalTablesToExclude = ["*"]
   

4. Az összes materializált nézet kizárása:

   materializedViewsToExclude=["*"]
   

Adatbázisnév felülbírálása

A követő fürtben lévő adatbázis nevét tetszés szerint eltérhet a vezetőfürttől. Előfordulhat például, hogy ugyanazt az adatbázisnevet szeretné csatolni több vezető fürtből egy követő fürthöz. Másik adatbázisnév megadásához konfigurálja a DatabaseNameOverride vagy a DatabaseNamePrefix tulajdonságot.

C#

Adatbázis csatolása C használatával#

Szükséges NuGet-csomagok

• Telepítse az Azure.ResourceManager.Kusto elemet.
• Az Azure.Identity telepítése hitelesítéshez.

C# példa

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 = new ClientSecretCredential(tenantId, clientId, clientSecret);
var resourceManagementClient = new ArmClient(credentials, followerSubscriptionId);
var followerResourceGroupName = "followerResourceGroup";
var followerClusterName = "follower";
var subscription = await resourceManagementClient.GetDefaultSubscriptionAsync();
var resourceGroup = (await subscription.GetResourceGroupAsync(followerResourceGroupName)).Value;
var cluster = (await resourceGroup.GetKustoClusterAsync(followerClusterName)).Value;
var attachedDatabaseConfigurations = cluster.GetKustoAttachedDatabaseConfigurations();
var attachedDatabaseConfigurationName = "attachedDatabaseConfiguration"
var leaderSubscriptionId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx";
var leaderResourceGroup = "leaderResourceGroup";
var leaderClusterName = "leader";
var attachedDatabaseConfigurationData = new KustoAttachedDatabaseConfigurationData
{
    ClusterResourceId = new ResourceIdentifier($"/subscriptions/{leaderSubscriptionId}/resourceGroups/{leaderResourceGroup}/providers/Microsoft.Kusto/Clusters/{leaderClusterName}"),
    DatabaseName = "<databaseName>", // Can be a specific database name in a leader cluster or * for all databases
    DefaultPrincipalsModificationKind = KustoDatabaseDefaultPrincipalsModificationKind.Union,
    Location = AzureLocation.NorthCentralUS
};
// 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 KustoDatabaseTableLevelSharingProperties();
    attachedDatabaseConfigurationData.TableLevelSharingProperties.TablesToInclude.Add("table1");
    attachedDatabaseConfigurationData.TableLevelSharingProperties.TablesToExclude.Add("table2");
    attachedDatabaseConfigurationData.TableLevelSharingProperties.ExternalTablesToExclude.Add("exTable1");
    attachedDatabaseConfigurationData.TableLevelSharingProperties.ExternalTablesToInclude.Add("exTable2");
    attachedDatabaseConfigurationData.TableLevelSharingProperties.MaterializedViewsToInclude.Add("matTable1");
    attachedDatabaseConfigurationData.TableLevelSharingProperties.MaterializedViewsToExclude.Add("matTable2");
    attachedDatabaseConfigurationData.TableLevelSharingProperties.FunctionsToInclude.Add("func1");
    attachedDatabaseConfigurationData.TableLevelSharingProperties.FunctionsToExclude.Add("func2");
}
await attachedDatabaseConfigurations.CreateOrUpdateAsync(WaitUntil.Completed, attachedDatabaseConfigurationName, attachedDatabaseConfigurationData);

Python

Adatbázis csatolása a Python használatával

Előfeltételmodulok

pip install azure-identity
pip install azure-mgmt-kusto

Python-példa

from azure.mgmt.kusto import KustoManagementClient
from azure.mgmt.kusto.models import AttachedDatabaseConfiguration, TableLevelSharingProperties
from azure.identity import ClientSecretCredential
import datetime

#Directory (tenant) ID
tenant_id = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"
#Application ID
client_id = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"
#Client Secret
client_secret = "xxxxxxxxxxxxxx"
follower_subscription_id = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"
leader_subscription_id = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"
credentials = ClientSecretCredential(
         tenant_id=tenant_id,
         client_id=client_id,
         client_secret=client_secret
    )
kusto_management_client = KustoManagementClient(credentials, follower_subscription_id)

follower_resource_group_name = "followerResourceGroup"
leader_resource_group_name = "leaderResourceGroup"
follower_cluster_name = "follower"
leader_cluster_name = "leader"
attached_database_Configuration_name = "uniqueNameForAttachedDatabaseConfiguration"
database_name  = "db" # Can be a specific database name in a leader cluster or * for all databases
default_principals_modification_kind  = "Union"
location = "North Central US"
cluster_resource_id = "/subscriptions/" + leader_subscription_id + "/resourceGroups/" + leader_resource_group_name + "/providers/Microsoft.Kusto/Clusters/" + leader_cluster_name
table_level_sharing_properties = None
if (database_name != "*"):
    #Set up the table level sharing properties - the following is just an example.
    tables_to_include = ["table1", "table2", "table3"]
    external_tables_to_exclude =  ["Logs*"]
    table_level_sharing_properties = TableLevelSharingProperties(tables_to_include = tables_to_include, external_tables_to_exclude = external_tables_to_exclude)


attached_database_configuration_properties = AttachedDatabaseConfiguration(cluster_resource_id = cluster_resource_id, database_name = database_name, default_principals_modification_kind = default_principals_modification_kind, location = location, table_level_sharing_properties = table_level_sharing_properties)

#Returns an instance of LROPoller, see https://learn.microsoft.com/python/api/msrest/msrest.polling.lropoller?view=azure-python
poller = kusto_management_client.attached_database_configurations.begin_create_or_update(follower_resource_group_name, follower_cluster_name, attached_database_Configuration_name, attached_database_configuration_properties)

PowerShell

Adatbázis csatolása a PowerShell használatával

Előfeltételmodul

Install : Az.Kusto

PowerShell-példa

$FollowerClustername = 'follower'
$FollowerClusterSubscriptionID = 'xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx'
$FollowerResourceGroupName = 'followerResourceGroup'
$DatabaseName = "db"  ## Can be a specific database name in a leader cluster or * for all databases
$FollowerDatabaseName = 'followerdbname' ## Use this option if the follower database requires a different name than the leader database.
$LeaderClustername = 'leader'
$LeaderClusterSubscriptionID = 'xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx'
$LeaderClusterResourceGroup = 'leaderResourceGroup'
$DefaultPrincipalsModificationKind = 'Union'
##Construct the LeaderClusterResourceId and Location
$getleadercluster = Get-AzKustoCluster -Name $LeaderClustername -ResourceGroupName $LeaderClusterResourceGroup -SubscriptionId $LeaderClusterSubscriptionID -ErrorAction Stop
$LeaderClusterResourceid = $getleadercluster.Id
$Location = $getleadercluster.Location
## Handle the config name if all databases need to be followed. The config name can be given any unique name
if($DatabaseName -eq '*')  {
        $configname = $FollowerClustername + 'config'  
       }
else {
        $configname = $DatabaseName
     }
##Table level sharing is not supported when using '*' all databases notation. If you use the all database notation please remove all table level sharing lines from the powershell command.
New-AzKustoAttachedDatabaseConfiguration -ClusterName $FollowerClustername `
    -Name $configname `
    -ResourceGroupName $FollowerResourceGroupName `
    -SubscriptionId $FollowerClusterSubscriptionID `
    -DatabaseName $DatabaseName ` ## Leader database name.
    -DatabaseNameOverride $FollowerDatabaseName ` ## Use this option if the follower database requires a different name than the leader database. Otherwise, this parameter can be removed.
    -ClusterResourceId $LeaderClusterResourceid `
    -DefaultPrincipalsModificationKind $DefaultPrincipalsModificationKind `
    -Location $Location `
    -TableLevelSharingPropertyTablesToInclude "table1", "table2", "table3" `
    -TableLevelSharingPropertyExternalTablesToExclude "Logs*" `
    -ErrorAction Stop

Resource Manager sablon

Adatbázis csatolása Azure Resource Manager-sablonnal

Azure Resource Manager-sablonnal adatbázist csatolhat egy meglévő fürthöz.

Adatbázis csatolásához kövesse az alábbi lépéseket:

1. Hozzon létre egy sablont az alábbi táblázatban található információk alapján a konfiguráláshoz.

   Paraméter	Leírás	Példa
   followerClusterName	A követő fürt neve; ahol a sablon üzembe lesz helyezve.
   attachedDatabaseConfigurationsName	A csatolt adatbázis-konfigurációs objektum neve. A név bármilyen, a fürt szintjén egyedi sztring lehet.
   databaseName	A követendő adatbázis neve. A vezető összes adatbázisának követéséhez használja a *-t.
   leaderClusterResourceId	A vezetőfürt erőforrás-azonosítója.
   defaultPrincipalsModificationKind	Az alapértelmezett egyszerű módosítási típus.	UnionLehet , vagy ReplaceNone. Az alapértelmezett egyszerű módosítási típusról további információt az egyszerű módosítási típus felügyeleti parancsában talál.
   tablesToInclude	A belefoglalandó táblák listája. A naplókkal kezdődő összes tábla hozzáadásához használja a következőt: ["Naplók*"].	["table1ToInclude", "table2ToInclude"]
   tablesToExclude	A kizárandó táblák listája. Az összes tábla kizárásához használja a következőt: ["*"].	["table1ToExclude", "table2ToExclude"]
   externalTablesToInclude	A belefoglalandó táblák listája. Ha a "Naplók" kezdetű összes külső táblát fel szeretné venni, használja a ["Naplók*" parancsot.	["ExternalTable1ToInclude", "ExternalTable2ToInclude"]
   externalTablesToExclude	A kizárandó táblák listája. Az összes külső tábla kizárásához használja a következőt: ["*"].	["ExternalTable1ToExclude", "ExternalTable2ToExclude"]
   materializedViewsToInclude	A belefoglalandó materializált nézetek listája. Ha a "Naplók" kezdetű összes materializált nézetet fel szeretné venni, használja a ["Naplók*" parancsot.	["Mv1ToInclude", "Mv2ToInclude"]
   materializedViewsToExclude	A kizárandó materializált nézetek listája. Az összes materializált nézet kizárásához használja a következőt: ["*"].	["Mv11ToExclude", "Mv22ToExclude"]
   functionsToInclude	A belefoglalandó függvények listája.	["FunctionToInclude"]
   functionsToExclude	A kizárandó függvények listája.	["FunctionToExclude"]
   Helyen	Az összes erőforrás helye. A vezetőnek és a követőnek ugyanazon a helyen kell lennie.

   {
       "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
       "contentVersion": "1.0.0.0",
       "parameters": {
           "followerClusterName": {
               "type": "string",
               "defaultValue": "",
               "metadata": {
                   "description": "Name of the cluster to which the database will be attached."
               }
           },
           "attachedDatabaseConfigurationsName": {
               "type": "string",
               "defaultValue": "",
               "metadata": {
                   "description": "Name of the attached database configurations to create."
               }
           },
           "databaseName": {
               "type": "string",
               "defaultValue": "",
               "metadata": {
                   "description": "The name of the database to follow. You can follow all databases by using '*'."
               }
           },
           "leaderClusterResourceId": {
               "type": "string",
               "defaultValue": "",
               "metadata": {
                   "description": "The resource ID of the leader cluster."
               }
           },
           "defaultPrincipalsModificationKind": {
               "type": "string",
               "defaultValue": "Union",
               "metadata": {
                   "description": "The default principal modification kind."
               }
           },
           "tablesToInclude": {
               "type": "array",
               "defaultValue": [],
               "metadata": {
                   "description": "The list of tables to include. Not supported when following all databases."
               }
           },
           "tablesToExclude": {
               "type": "array",
               "defaultValue": [],
               "metadata": {
                   "description": "The list of tables to exclude. Not supported when following all databases."
               }
           },
           "externalTablesToInclude": {
               "type": "array",
               "defaultValue": [],
               "metadata": {
                   "description": "The list of external tables to include. Not supported when following all databases."
               }
           },
           "externalTablesToExclude": {
               "type": "array",
               "defaultValue": [],
               "metadata": {
                   "description": "The list of external tables to exclude. Not supported when following all databases."
               }
           },
           "materializedViewsToInclude": {
               "type": "array",
               "defaultValue": [],
               "metadata": {
                   "description": "The list of materialized views to include. Not supported when following all databases."
               }
           },
           "materializedViewsToExclude": {
               "type": "array",
               "defaultValue": [],
               "metadata": {
                   "description": "The list of materialized views to exclude. Not supported when following all databases."
               }
           },
           "functionsToInclude": {
               "type": "array",
               "defaultValue": [],
               "metadata": {
                   "description": "The list of functions to include."
               }
           },
           "functionsToExclude": {
               "type": "array",
               "defaultValue": [],
               "metadata": {
                   "description": "The list of functions to exclude."
               }
           },
           "location": {
               "type": "string",
               "defaultValue": "",
               "metadata": {
                   "description": "Location for all resources."
               }
           }
       },
       "variables": {},
       "resources": [
           {
               "name": "[concat(parameters('followerClusterName'), '/', parameters('attachedDatabaseConfigurationsName'))]",
               "type": "Microsoft.Kusto/clusters/attachedDatabaseConfigurations",
               "apiVersion": "2021-01-01",
               "location": "[parameters('location')]",
               "properties": {
                   "databaseName": "[parameters('databaseName')]",
                   "clusterResourceId": "[parameters('leaderClusterResourceId')]",
                   "defaultPrincipalsModificationKind": "[parameters('defaultPrincipalsModificationKind')]",
                   "tableLevelSharingProperties":{
                       "tablesToInclude": "[parameters('tablesToInclude')]",
                       "tablesToExclude": "[parameters('tablesToExclude')]",
                       "externalTablesToInclude": "[parameters('externalTablesToInclude')]",
                       "externalTablesToExclude": "[parameters('externalTablesToExclude')]",
                       "materializedViewsToInclude": "[parameters('materializedViewsToInclude')]",
                       "materializedViewsToExclude": "[parameters('materializedViewsToExclude')]",
                       "functionsToInclude": "[parameters('functionsToInclude')]",
                       "functionsToExclude": "[parameters('functionsToExclude')]"
                   }
               }
           }
       ]
   }
   

2. Az Azure Resource Manager sablon üzembe helyezése a Azure Portal vagy a PowerShell használatával.

   

Ellenőrizze, hogy az adatbázis csatolása sikerült-e

Az adatbázis sikeres csatolásának ellenőrzéséhez keresse meg a csatolt adatbázisokat a Azure Portal. Ellenőrizheti, hogy az adatbázisok sikeresen csatolva lettek-e a követő vagy vezető fürtökön.

A követő fürt ellenőrzése

1. Keresse meg a követő fürtöt, és válassza az Adatbázisok lehetőséget.

2. Az adatbázislistában keressen új írásvédett adatbázisokat.

   

   A listát az adatbázis áttekintési oldalán is megtekintheti:

   

A vezető fürt ellenőrzése

1. Tallózással keresse meg a vezetőfürtöt, és válassza az Adatbázisok lehetőséget

2. Ellenőrizze, hogy a megfelelő adatbázisok meg vannak-e osztva másokkal>igen

3. A részletek megtekintéséhez váltsa ki a kapcsolathivatkozást.

   

   Ezt az adatbázis áttekintési oldalán is megtekintheti:

   

A követő adatbázis leválasztása

Megjegyzés

Ha le szeretne választani egy adatbázist a követő vagy a vezető oldalról, rendelkeznie kell legalább közreműködői szerepkörrel rendelkező felhasználóval, csoporttal, szolgáltatásnévvel vagy felügyelt identitással azon a fürtön, amelyről az adatbázist leválasztja. Az alábbi példában szolgáltatásnevet használunk.

C#

A csatolt követő adatbázis leválasztása a követő fürtről a C#** használatával

A követő fürt az alábbiak szerint leválaszthatja a csatolt követő adatbázisokat:

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 = new ClientSecretCredential(tenantId, clientId, clientSecret);
var resourceManagementClient = new ArmClient(credentials, followerSubscriptionId);
var followerResourceGroupName = "testrg";
//The cluster and database attached database configuration are created as part of the prerequisites
var followerClusterName = "follower";
var attachedDatabaseConfigurationsName = "attachedDatabaseConfiguration";
var subscription = await resourceManagementClient.GetDefaultSubscriptionAsync();
var resourceGroup = (await subscription.GetResourceGroupAsync(followerResourceGroupName)).Value;
var cluster = (await resourceGroup.GetKustoClusterAsync(followerClusterName)).Value;
var attachedDatabaseConfiguration = (await cluster.GetKustoAttachedDatabaseConfigurationAsync(attachedDatabaseConfigurationsName)).Value;
await attachedDatabaseConfiguration.DeleteAsync(WaitUntil.Completed);

A csatolt követő adatbázis leválasztása a vezető fürtről a C használatával#

A vezetőfürt az alábbi módon leválaszthatja a csatolt adatbázisokat:

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 = new ClientSecretCredential(tenantId, clientId, clientSecret);
var resourceManagementClient = new ArmClient(credentials, leaderSubscriptionId);
var leaderResourceGroupName = "testrg";
var leaderClusterName = "leader";
var subscription = await resourceManagementClient.GetDefaultSubscriptionAsync();
var resourceGroup = (await subscription.GetResourceGroupAsync(leaderResourceGroupName)).Value;
var cluster = (await resourceGroup.GetKustoClusterAsync(leaderClusterName)).Value;
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 KustoFollowerDatabaseDefinition(
    clusterResourceId: new ResourceIdentifier($"/subscriptions/{followerSubscriptionId}/resourceGroups/{followerResourceGroupName}/providers/Microsoft.Kusto/Clusters/{followerClusterName}"),
    attachedDatabaseConfigurationName: attachedDatabaseConfigurationsName
);
await cluster.DetachFollowerDatabasesAsync(WaitUntil.Completed, followerDatabaseDefinition);

Python

A csatolt követő adatbázis leválasztása a követő fürtről a Python használatával

A követő fürt az alábbi módon leválaszthatja a csatolt adatbázisokat:

from azure.mgmt.kusto import KustoManagementClient
from azure.common.credentials import ServicePrincipalCredentials
import datetime

#Directory (tenant) ID
tenant_id = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"
#Application ID
client_id = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"
#Client Secret
client_secret = "xxxxxxxxxxxxxx"
follower_subscription_id = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"
credentials = ServicePrincipalCredentials(
        client_id=client_id,
        secret=client_secret,
        tenant=tenant_id
    )
kusto_management_client = KustoManagementClient(credentials, follower_subscription_id)

follower_resource_group_name = "followerResourceGroup"
follower_cluster_name = "follower"
attached_database_configurationName = "uniqueName"

#Returns an instance of LROPoller, see https://learn.microsoft.com/python/api/msrest/msrest.polling.lropoller?view=azure-python
poller = kusto_management_client.attached_database_configurations.delete(follower_resource_group_name, follower_cluster_name, attached_database_configurationName)

A csatolt követő adatbázis leválasztása a vezető fürtről a Python használatával

A vezetőfürt az alábbi módon leválaszthatja a csatolt adatbázisokat:

from azure.mgmt.kusto import KustoManagementClient
from azure.mgmt.kusto.models import FollowerDatabaseDefinition
from azure.common.credentials import ServicePrincipalCredentials
import datetime

#Directory (tenant) ID
tenant_id = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"
#Application ID
client_id = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"
#Client Secret
client_secret = "xxxxxxxxxxxxxx"
follower_subscription_id = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"
leader_subscription_id = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx"
credentials = ServicePrincipalCredentials(
        client_id=client_id,
        secret=client_secret,
        tenant=tenant_id
    )
kusto_management_client = KustoManagementClient(credentials, follower_subscription_id)

follower_resource_group_name = "followerResourceGroup"
leader_resource_group_name = "leaderResourceGroup"
follower_cluster_name = "follower"
leader_cluster_name = "leader"
attached_database_configuration_name = "uniqueName"
location = "North Central US"
cluster_resource_id = "/subscriptions/" + follower_subscription_id + "/resourceGroups/" + follower_resource_group_name + "/providers/Microsoft.Kusto/Clusters/" + follower_cluster_name

#Returns an instance of LROPoller, see https://learn.microsoft.com/python/api/msrest/msrest.polling.lropoller?view=azure-python
poller = kusto_management_client.clusters.detach_follower_databases(resource_group_name = leader_resource_group_name, cluster_name = leader_cluster_name, cluster_resource_id = cluster_resource_id, attached_database_configuration_name = attached_database_configuration_name)

PowerShell

Adatbázis leválasztása a PowerShell használatával

Előfeltételmodul

Install : Az.Kusto

Példa

$FollowerClustername = 'follower'
$FollowerClusterSubscriptionID = 'xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx'
$FollowerResourceGroupName = 'followerResourceGroup'
$DatabaseName = "sanjn"  ## Can be specific database name or * for all databases

##Construct the Configuration name
$confignameraw = (Get-AzKustoAttachedDatabaseConfiguration -ClusterName $FollowerClustername -ResourceGroupName $FollowerResourceGroupName -SubscriptionId $FollowerClusterSubscriptionID) | Where-Object {$_.DatabaseName -eq $DatabaseName }
$configname =$confignameraw.Name.Split("/")[1]

Remove-AzKustoAttachedDatabaseConfiguration -ClusterName $FollowerClustername -Name $configname -ResourceGroupName $FollowerResourceGroupName -SubscriptionId $FollowerClusterSubscriptionID

Resource Manager sablon

Válassza le a követő adatbázist a C#, a Python vagy a PowerShell használatával.

Tagok, engedélyek és gyorsítótárazási szabályzat kezelése

Rendszerbiztonsági tagok kezelése

Adatbázis csatolásakor adja meg az "alapértelmezett rendszerbiztonsági tagok módosítási típusát". Az alapértelmezett beállítás a felülbírálásra jogosult tagok kombinálása az engedélyezett tagok vezető adatbázis-gyűjteményével

Altípus	Leírás
Unió	A csatolt adatbázisnevek mindig tartalmazzák az eredeti adatbázis-tagokat, valamint a követő adatbázishoz hozzáadott további új tagokat.
Csere	A rendszerbiztonsági tagok nem öröklődnek az eredeti adatbázisból. Új rendszerbiztonsági tagokat kell létrehozni a csatolt adatbázishoz.
Nincs	A csatolt adatbázisnevek csak az eredeti adatbázis rendszerneveit tartalmazzák, más rendszerbiztonsági tagok nélkül.

A felügyeleti parancsok az engedélyezett rendszernevek konfigurálásával kapcsolatos további információkért lásd: Felügyeleti parancsok követő fürt kezeléséhez.

Engedélyek kezelése

Az írásvédett adatbázis-engedélyek kezelése ugyanaz, mint az összes adatbázistípus esetében. Engedélyek hozzárendeléséhez lásd: Adatbázis-engedélyek kezelése a Azure Portal vagy felügyeleti parancsok használata az adatbázis biztonsági szerepköreinek kezeléséhez.

Gyorsítótárazási szabályzat konfigurálása

A követő adatbázis rendszergazdája módosíthatja a csatolt adatbázis vagy annak bármely táblája gyorsítótárazási szabályzatát az üzemeltetési fürtön. Az alapértelmezett beállítás a vezetőfürt-adatbázisban lévő forrásadatbázis és a táblaszintű gyorsítótárazási szabályzatok kombinálása az adatbázisban meghatározott szabályzatokkal és a táblaszintű felülbírálási szabályzatokkal. Például rendelkezhet egy 30 napos gyorsítótárazási szabályzattal a vezető adatbázison a havi jelentéskészítés futtatásához, és egy háromnapos gyorsítótárazási szabályzatot a követő adatbázison, hogy csak a legutóbbi adatokat kérdezhesse le a hibaelhárításhoz. További információ arról, hogy a felügyeleti parancsokkal konfigurálhatja a gyorsítótárazási szabályzatot a követő adatbázison vagy táblán, lásd: Felügyeleti parancsok követő fürt kezeléséhez.

Jegyzetek

• Ha ütközések vannak a vezető/követő fürtök adatbázisai között, amikor az összes adatbázist a követő fürt követi, azokat a következőképpen oldja fel a rendszer:
  • A követő fürtön létrehozott ADATBÁZIS nevű adatbázis elsőbbséget élvez a vezetőfürtön létrehozott adatbázissal szemben. Ezért kell eltávolítani vagy átnevezni a követő fürt adatbázis-adatbázisát , hogy a vezető adatbázis-adatbázisát is tartalmazza.
  • A rendszer tetszőlegesen kiválaszt egy db nevű adatbázist, amelyet két vagy több vezetőfürt követ, és csak egyszer lesz követve.
• A követő fürtökön futtatott fürttevékenység-naplók és -előzmények megjelenítésére szolgáló parancsok a követő fürt tevékenységeit és előzményeit jelenítik meg, és eredményhalmazaik nem tartalmazzák a vezető fürt vagy fürtök eredményeit.
  • Például: a .show queries követő fürtön futtatott parancsok csak az adatbázisokon, majd a követő fürtökön futtatott lekérdezéseket jelenítik meg, és a lekérdezések nem futnak ugyanazon az adatbázison a vezetőfürtben.

Korlátozások

• A követőnek és a vezető fürtöknek ugyanabban a régióban kell lenniük.
• Ha a streambetöltést egy követett adatbázison használják, a követő fürtöt engedélyezni kell a streambetöltéshez, hogy lehetővé tegye a streamelési betöltési adatok követését.
• Az ügyfél által felügyelt kulcsokat (CMK) használó adattitkosítással rendelkező fürtök követése a következő korlátozásokkal támogatott:
  • Sem a követő fürt, sem a vezető fürt nem követ más fürtöket.
  • Ha egy követő fürt olyan vezetőfürtöt követ, amelyen engedélyezve van a CMK, és a vezető hozzáférése vissza van vonva a kulcshoz, a vezető és a követő fürtök is fel lesznek függesztve. Ebben az esetben megoldhatja a CMK-problémát, majd folytathatja a követő fürtöt, vagy leválaszthatja a követő adatbázisokat a követő fürtről, és folytathatja a vezető fürttől való függetlenedését.
• A leválasztása előtt nem törölhet egy másik fürthöz csatolt adatbázist.
• Leválasztása előtt nem törölhet olyan fürtöt, amelyhez egy másik fürthöz van csatolva adatbázis.
• A táblaszintű megosztási tulajdonságok nem támogatottak az összes adatbázis követésekor.
• A követő adatbázisokban a felügyelt identitást hitelesítési módszerként használó külső táblák lekérdezéséhez hozzá kell adni a felügyelt identitást a követő fürthöz. Ez a képesség nem működik, ha a vezető és követő fürtök különböző bérlőkben vannak kiépítve.

Következő lépés

Követő parancsok futtatása