Usare i database di follower

Articolo
10/02/2024

La funzionalità database follower consente di collegare al proprio cluster di Esplora dati di Azure un database che si trova in un cluster diverso. Il database follower è collegato in modalità di sola lettura, consentendo di visualizzare i dati ed eseguire query sui dati inseriti nel database leader. Il database follower sincronizza le modifiche nei database leader. A causa della sincronizzazione, è previsto un ritardo dei dati di alcuni secondi fino a pochi minuti nella disponibilità dei dati. L'intervallo di tempo dipende dalle dimensioni complessive dei metadati del database leader. I database leader e follower usano lo stesso account di archiviazione per recuperare i dati. L'archiviazione è di proprietà del database leader. Il database follower visualizza i dati senza dover inserirli. Poiché il database collegato è un database di sola lettura, i dati, le tabelle e i criteri nel database non possono essere modificati, ad eccezione dei criteri di memorizzazione nella cache, delle entità e delle autorizzazioni. I database collegati non possono essere eliminati. Devono essere scollegati dal leader o dal seguace e solo successivamente possono essere eliminati.

Il collegamento di un database a un cluster diverso tramite la funzionalità follower viene usato come infrastruttura per condividere i dati tra organizzazioni e team. La funzionalità è utile per separare le risorse di calcolo per proteggere un ambiente di produzione da casi d'uso non di produzione. I follower possono anche essere usati per associare il costo del cluster di Azure Esplora dati all'entità che esegue query sui dati.

Per esempi di codice basati sulle versioni precedenti dell'SDK, vedere l'articolo archiviato.

Quali database vengono seguiti?

Un cluster può seguire un database, diversi database o tutti i database di un cluster leader.
Un singolo cluster può seguire i database di più cluster leader.
Un cluster può contenere sia database di follower che database leader.

Prerequisiti

Una sottoscrizione di Azure. Creare un account Azure gratuito.
Un cluster e un database di Azure Esplora dati per leader e follower. Creare un cluster e un database.
Il database leader deve contenere dati. È possibile inserire dati usando uno dei metodi descritti nella panoramica dell'inserimento.

Collegare un database

Esistono diversi metodi che è possibile usare per collegare un database. In questo articolo viene illustrato come collegare un database usando C#, Python, PowerShell o un modello di Azure Resource Manager. Per collegare un database, è necessario avere un utente, un gruppo, un'entità servizio o un'identità gestita con almeno il ruolo collaboratore nel cluster leader e nel cluster follower. Aggiungere o rimuovere assegnazioni di ruolo usando portale di Azure, PowerShell, l'interfaccia della riga di comando di Azure e il modello di Resource Manager. Altre informazioni sul controllo degli accessi in base al ruolo di Azure e sui diversi ruoli.

Nota

La creazione preliminare di un database di follower non è necessaria perché ne viene creata una durante il processo di allegato.

Quando si collega il database a tutte le tabelle, vengono seguite anche tabelle esterne e viste materializzate. È possibile condividere tabelle,tabelle esterne/viste materializzate specifiche configurando 'TableLevelSharingProperties'.

'TableLevelSharingProperties' contiene otto matrici di stringhe: tablesToInclude, externalTablesToIncludetablesToExclude, externalTablesToExclude, materializedViewsToInclude, materializedViewsToExclude, functionsToInclude, e functionsToExclude. Il numero massimo di voci in tutte le matrici è 100.

Nota

La condivisione a livello di tabella non è supportata quando si usa la notazione di tutti i database '*'.
Quando vengono incluse viste materializzate, vengono incluse anche le relative tabelle di origine.

Esempi

Nell'esempio seguente sono incluse tutte le tabelle. Per impostazione predefinita, tutte le tabelle vengono seguite senza usare la notazione '*':

tablesToInclude = []

Nell'esempio seguente sono incluse tutte le funzioni. Per impostazione predefinita, tutte le funzioni vengono seguite senza usare la notazione '*':

functionsToInclude = []

L'esempio seguente include tutte le tabelle con nomi che iniziano con "Logs":

tablesToInclude = ["Logs*"]

L'esempio seguente include tutte le tabelle esterne:

externalTablesToExclude = ["*"]

L'esempio seguente include tutte le viste materializzate:

materializedViewsToExclude=["*"]

Override del nome del database

Facoltativamente, è possibile rendere il nome del database nel cluster follower diverso dal cluster leader. Ad esempio, è possibile collegare lo stesso nome di database da più cluster leader a un cluster follower. Per specificare un nome di database diverso, configurare la proprietà 'DatabaseNameOverride' o 'DatabaseNamePrefix'.

Collegare un database usando C#

Pacchetti NuGet necessari

Installare Azure.ResourceManager.Kusto.
Installare Azure.Identity per l'autenticazione.

Esempio in 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 = 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);

Collegare un database usando Python

Moduli prerequisiti

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

Esempio in Python

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://video2.skills-academy.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)

Collegare un database tramite PowerShell

Modulo prerequisito

Install : Az.Kusto

Esempio di PowerShell

$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

Collegare un database usando un modello di Azure Resource Manager

È possibile usare un modello di Azure Resource Manager per collegare un database a un cluster esistente.

Per collegare un database, seguire questa procedura:

Creare un modello usando le informazioni nella tabella seguente per configurarla.

Parametro	Descrizione	Esempio
followerClusterName	Nome del cluster di follower; in cui verrà distribuito il modello.
attachedDatabaseConfigurationsName	Nome dell'oggetto configurazioni del database collegato. Il nome può essere qualsiasi stringa univoca a livello di cluster.
databaseName	Nome del database da seguire. Per seguire tutti i database leader, usare '*'.
leaderClusterResourceId	ID risorsa del cluster leader.
defaultPrincipalsModificationKind	Tipo di modifica dell'entità predefinito.	Può essere `Union`, `Replace` o `None`. Per altre informazioni sul tipo di modifica dell'entità predefinita, vedere comando di gestione dei tipi di modifica dell'entità di sicurezza.
tablesToInclude	Elenco di tabelle da includere. Per includere tutte le tabelle che iniziano con "Logs", usare ["Logs*"].	`["table1ToInclude", "table2ToInclude"]`
tablesToExclude	Elenco di tabelle da escludere. Per escludere tutte le tabelle, usare ["*"].	`["table1ToExclude", "table2ToExclude"]`
externalTablesToInclude	Elenco di tabelle da includere. Per includere tutte le tabelle esterne che iniziano con "Logs", usare ["Logs*"].	`["ExternalTable1ToInclude", "ExternalTable2ToInclude"]`
externalTablesToExclude	Elenco di tabelle da escludere. Per escludere tutte le tabelle esterne, usare ["*"].	`["ExternalTable1ToExclude", "ExternalTable2ToExclude"]`
materializedViewsToInclude	Elenco di visualizzazioni materializzate da includere. Per includere tutte le viste materializzate a partire da "Logs", usare ["Logs*"].	`["Mv1ToInclude", "Mv2ToInclude"]`
materializedViewsToExclude	Elenco di visualizzazioni materializzate da escludere. Per escludere tutte le viste materializzate, usare ["*"].	`["Mv11ToExclude", "Mv22ToExclude"]`
functionsToInclude	Elenco di funzioni da includere.	`["FunctionToInclude"]`
functionsToExclude	Elenco di funzioni da escludere.	`["FunctionToExclude"]`
location	Posizione di tutte le risorse. Il leader e il follower devono trovarsi nella stessa posizione.

{
    "$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')]"
                }
            }
        }
    ]
}

Distribuire il modello di Azure Resource Manager usando il portale di Azure o PowerShell.

Verificare che il database sia stato collegato correttamente

Per verificare che il database sia stato collegato correttamente, trovare i database collegati nel portale di Azure. È possibile verificare che i database siano stati collegati correttamente nei cluster di follower o leader .

Controllare il cluster di follower

Passare al cluster follower e selezionare Database.
Nell'elenco di database cercare nuovi database di sola lettura.

È anche possibile visualizzare questo elenco nella pagina di panoramica del database:

Controllare il cluster leader

Passare al cluster leader e selezionare Database
Verificare che i database pertinenti siano contrassegnati come SHARED WITH OTHERS>Sì
Attivare o disattivare il collegamento alla relazione per visualizzare i dettagli.

È anche possibile visualizzare questo valore nella pagina di panoramica del database:

Scollegare il database dei follower

Nota

Per scollegare un database dal lato follower o leader, è necessario disporre di un'identità utente, gruppo, entità servizio o gestita con almeno il ruolo collaboratore nel cluster da cui si sta scollegando il database. Nell'esempio seguente viene usata l'entità servizio.

Scollegare il database di follower collegato dal cluster follower usando C#**

Il cluster follower può scollegare qualsiasi database di follower collegato come segue:

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);

Scollegare il database di follower collegato dal cluster leader usando C#

Il cluster leader può scollegare qualsiasi database collegato come segue:

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);

Scollegare il database di follower collegato dal cluster follower usando Python

Il cluster follower può scollegare qualsiasi database collegato nel modo seguente:

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://video2.skills-academy.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)

Scollegare il database follower collegato dal cluster leader usando Python

Il cluster leader può scollegare qualsiasi database collegato come segue:


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://video2.skills-academy.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)

Scollegare un database tramite PowerShell

Modulo prerequisito

Install : Az.Kusto

Esempio

$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

Gestire entità, autorizzazioni e criteri di memorizzazione nella cache

Gestire le entità

Quando si collega un database, specificare il tipo di modifica delle entità predefinite. L'impostazione predefinita consiste nel combinare le entità autorizzate di override con la raccolta di database leader di entità autorizzate

Tipologia	Descrizione
Union	Le entità di database collegate includono sempre le entità di database originali e altre nuove entità aggiunte al database follower.
Sostituzione	Nessuna ereditarietà delle entità dal database originale. È necessario creare nuove entità per il database collegato.
Nessuno	Le entità di database collegate includono solo le entità del database originale senza altre entità.

Per altre informazioni sull'uso dei comandi di gestione per configurare le entità autorizzate, vedere Comandi di gestione per la gestione di un cluster follower.

Gestisci autorizzazioni

La gestione delle autorizzazioni di database di sola lettura è identica a quella di tutti i tipi di database. Per assegnare le autorizzazioni, vedere Gestire le autorizzazioni del database nel portale di Azure o usare i comandi di gestione per gestire i ruoli di sicurezza del database.

Configurare i criteri di memorizzazione nella cache

L'amministratore del database follower può modificare i criteri di memorizzazione nella cache del database collegato o di una delle relative tabelle nel cluster di hosting. L'impostazione predefinita consiste nel combinare il database di origine nel database del cluster leader e i criteri di memorizzazione nella cache a livello di tabella con i criteri definiti nei criteri di override a livello di database e a livello di tabella. È ad esempio possibile avere un criterio di memorizzazione nella cache di 30 giorni nel database leader per l'esecuzione di report mensili e un criterio di memorizzazione nella cache di tre giorni nel database follower per eseguire una query solo sui dati recenti per la risoluzione dei problemi. Per altre informazioni sull'uso dei comandi di gestione per configurare i criteri di memorizzazione nella cache nel database o nella tabella follower, vedere Comandi di gestione per la gestione di un cluster follower.

Note

Se sono presenti conflitti tra i database dei cluster leader/follower, quando tutti i database sono seguiti dal cluster follower, vengono risolti come segue:
- Un database denominato DB creato nel cluster follower ha la precedenza su un database con lo stesso nome creato nel cluster leader. Ecco perché il database del database nel cluster follower deve essere rimosso o rinominato per il cluster follower per includere il database del leader.
- Un database denominato DB seguito da due o più cluster leader verrà scelto arbitrariamente da uno dei cluster leader e non verrà seguito più di una volta.
I comandi per visualizzare il log attività e la cronologia del cluster eseguiti in un cluster follower mostreranno l'attività e la cronologia nel cluster follower e i relativi set di risultati non includeranno i risultati del cluster leader o dei cluster.
- Ad esempio, un .show queries comando eseguito nel cluster follower mostrerà solo le query eseguite sui database seguiti dal cluster follower e non le query eseguite sullo stesso database nel cluster leader.

Limiti

I follower e i cluster leader devono trovarsi nella stessa area.
Se l'inserimento di streaming viene usato in un database seguito, il cluster follower deve essere abilitato per l'inserimento in streaming per consentire l'inserimento in streaming dei dati di inserimento.
Dopo un cluster con crittografia dei dati usando chiavi gestite dal cliente (CMK) è supportato con le limitazioni seguenti:
- Né il cluster follower né il cluster leader seguono altri cluster.
- Se un cluster di follower segue un cluster leader con cmk abilitato e l'accesso del leader alla chiave viene revocato, verranno sospesi sia il leader che i cluster di follower. In questo caso, è possibile risolvere il problema cmk e quindi riprendere il cluster follower oppure scollegare i database dei follower dal cluster follower e riprendere indipendentemente dal cluster leader.
Non è possibile eliminare un database collegato a un cluster diverso prima di scollegarlo.
Non è possibile eliminare un cluster con un database collegato a un cluster diverso prima di scollegarlo.
Le proprietà di condivisione a livello di tabella non sono supportate quando si seguono tutti i database.
Nei database follower, per eseguire query su tabelle esterne che usano un'identità gestita come metodo di autenticazione, è necessario aggiungere l'identità gestita al cluster follower. Questa funzionalità non funziona quando viene effettuato il provisioning dei cluster leader e follower in tenant diversi.

Passaggio successivo

Eseguire i comandi follower

Condividi tramite

Usare i database di follower

Quali database vengono seguiti?

Prerequisiti

Collegare un database

Esempi

Override del nome del database

Collegare un database usando C#

Pacchetti NuGet necessari

Esempio in C#

Collegare un database usando Python

Moduli prerequisiti

Esempio in Python

Collegare un database tramite PowerShell

Modulo prerequisito

Esempio di PowerShell

Collegare un database usando un modello di Azure Resource Manager

Verificare che il database sia stato collegato correttamente

Controllare il cluster di follower

Controllare il cluster leader

Scollegare il database dei follower

Scollegare il database di follower collegato dal cluster follower usando C#**

Scollegare il database di follower collegato dal cluster leader usando C#

Scollegare il database di follower collegato dal cluster follower usando Python

Scollegare il database follower collegato dal cluster leader usando Python

Scollegare un database tramite PowerShell

Modulo prerequisito

Esempio

Gestire entità, autorizzazioni e criteri di memorizzazione nella cache

Gestire le entità

Gestisci autorizzazioni

Configurare i criteri di memorizzazione nella cache

Note

Limiti

Passaggio successivo

Commenti e suggerimenti

Risorse aggiuntive

Condividi tramite

Usare i database di follower

Quali database vengono seguiti?

Prerequisiti

Collegare un database

Condivisione a livello di tabella

Esempi

Override del nome del database

Collegare un database usando C#

Pacchetti NuGet necessari

Esempio in C#

Verificare che il database sia stato collegato correttamente

Controllare il cluster di follower

Controllare il cluster leader

Scollegare il database dei follower

Scollegare il database di follower collegato dal cluster follower usando C#**

Scollegare il database di follower collegato dal cluster leader usando C#

Gestire entità, autorizzazioni e criteri di memorizzazione nella cache

Gestire le entità

Gestisci autorizzazioni

Configurare i criteri di memorizzazione nella cache

Note

Limiti

Passaggio successivo

Commenti e suggerimenti

Risorse aggiuntive