Utilizar bases de dados de seguidores

Artigo
12/21/2023

A funcionalidade de base de dados do seguidor permite-lhe anexar uma base de dados localizada num cluster diferente ao cluster do Azure Data Explorer. A base de dados do seguidor é anexada no modo só de leitura , o que permite ver os dados e executar consultas nos dados que foram ingeridos na base de dados leader. A base de dados do seguidor sincroniza as alterações nas bases de dados leader. Devido à sincronização, existe um atraso de dados de alguns segundos a alguns minutos na disponibilidade de dados. A duração do atraso de tempo depende do tamanho geral dos metadados da base de dados principal. As bases de dados de coordenador e seguidor utilizam a mesma conta de armazenamento para obter os dados. O armazenamento pertence à base de dados leader. A base de dados do seguidor vê os dados sem ter de os ingerir. Uma vez que a base de dados anexada é uma base de dados só de leitura, os dados, tabelas e políticas na base de dados não podem ser modificados, exceto para políticas de colocação em cache, principais e permissões. As bases de dados anexadas não podem ser eliminadas. Têm de ser desanexados pelo líder ou seguidor e só assim podem ser eliminados.

A anexação de uma base de dados a um cluster diferente com a capacidade do seguidor é utilizada como a infraestrutura para partilhar dados entre organizações e equipas. A funcionalidade é útil para segregar recursos de computação para proteger um ambiente de produção de casos de utilização não produtivos. O seguidor também pode ser utilizado para associar o custo do cluster do Azure Data Explorer à entidade que executa consultas nos dados.

Para exemplos de código baseados em versões anteriores do SDK, veja o artigo arquivado.

Que bases de dados são seguidas?

Um cluster pode seguir uma base de dados, várias bases de dados ou todas as bases de dados de um cluster líder.
Um único cluster pode seguir bases de dados de vários clusters líderes.
Um cluster pode conter bases de dados de seguidores e bases de dados de líder.

Pré-requisitos

Uma subscrição do Azure. Crie uma conta gratuita do Azure.
Um cluster e uma base de dados do Azure Data Explorer para o líder e o seguidor. Criar um cluster e uma base de dados.
A base de dados leader deve conter dados. Pode ingerir dados com um dos métodos abordados na descrição geral da ingestão.

Anexar uma base de dados

Existem vários métodos que pode utilizar para anexar uma base de dados. Neste artigo, vamos abordar a anexação de uma base de dados com C#, Python, PowerShell ou um modelo de Resource Manager do Azure. Para anexar uma base de dados, tem de ter utilizador, grupo, principal de serviço ou identidade gerida com, pelo menos, a função de contribuidor no cluster de líderes e no cluster de seguidores. Adicione ou remova atribuições de funções com portal do Azure, PowerShell, CLI do Azure e modelo do ARM. Saiba mais sobre o controlo de acesso baseado em funções do Azure (RBAC do Azure) e as diferentes funções.

Ao anexar todas as tabelas da base de dados, também são seguidas tabelas externas e vistas materializadas. Pode partilhar tabelas/tabelas externas/vistas materializadas ao configurar "TableLevelSharingProperties".

"TableLevelSharingProperties" contém oito matrizes de cadeias: tablesToInclude, , externalTablesToIncludetablesToExclude, externalTablesToExclude, , materializedViewsToInclude, materializedViewsToExclude, functionsToIncludee functionsToExclude. O número máximo de entradas em todas as matrizes em conjunto é 100.

Nota

A partilha ao nível da tabela não é suportada ao utilizar a notação "*" de todas as bases de dados.
Quando as vistas materializadas são incluídas, as respetivas tabelas de origem também são incluídas.

Exemplos

Inclua todas as tabelas. Não é necessário "*", uma vez que todas as tabelas são seguidas por predefinição:
```
tablesToInclude = []
```
Inclua todas as tabelas com nomes que comecem por "Registos":
```
tablesToInclude = ["Logs*"]
```
Excluir todas as tabelas externas:
```
externalTablesToExclude = ["*"]
```
Excluir todas as vistas materializadas:
```
materializedViewsToExclude=["*"]
```

Substituição do nome da base de dados

Opcionalmente, pode tornar o nome da base de dados no cluster de seguidores diferente do cluster de líderes. Por exemplo, poderá querer anexar o mesmo nome de base de dados de vários clusters de líderes a um cluster de seguidores. Para especificar um nome de base de dados diferente, configure a propriedade "DatabaseNameOverride" ou "DatabaseNamePrefix".

Anexar uma base de dados com C#

Pacotes NuGet necessários

Instale Azure.ResourceManager.Kusto.
Instale o Azure.Identity para autenticação.

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

Anexar uma base de dados com Python

Módulos de pré-requisitos

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

Exemplo de 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://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)

Anexar uma base de dados com o PowerShell

Módulo de pré-requisitos

Install : Az.Kusto

Exemplo do 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

Anexar uma base de dados com um modelo de Resource Manager do Azure

Pode utilizar um modelo de Resource Manager do Azure para anexar uma base de dados a um cluster existente.

Utilize os seguintes passos para anexar uma base de dados:

Crie um modelo com as informações na tabela seguinte para o ajudar a configurá-lo.

Parâmetro	Descrição	Exemplo
followerClusterName	O nome do cluster de seguidores; onde o modelo será implementado.
attachedDatabaseConfigurationsName	O nome do objeto de configurações da base de dados anexada. O nome pode ser qualquer cadeia que seja exclusiva ao nível do cluster.
databaseName	O nome da base de dados a seguir. Para seguir todas as bases de dados do líder, utilize "*".
leaderClusterResourceId	O ID de recurso do cluster principal.
defaultPrincipalsModificationKind	O tipo de modificação do principal predefinido.	Pode ser `Union`, `Replace`ou `None`. Para obter mais informações sobre o tipo de modificação do principal predefinido, veja o comando de gestão do tipo de modificação principal.
tablesToInclude	A lista de tabelas a incluir. Para incluir todas as tabelas que começam com "Registos", utilize ["Registos*"].	`["table1ToInclude", "table2ToInclude"]`
tablesToExclude	A lista de tabelas a excluir. Para excluir todas as tabelas, utilize ["*"].	`["table1ToExclude", "table2ToExclude"]`
externalTablesToInclude	A lista de tabelas a incluir. Para incluir todas as tabelas externas a partir de "Registos", utilize ["Registos*"].	`["ExternalTable1ToInclude", "ExternalTable2ToInclude"]`
externalTablesToExclude	A lista de tabelas a excluir. Para excluir todas as tabelas externas, utilize ["*"].	`["ExternalTable1ToExclude", "ExternalTable2ToExclude"]`
materializedViewsToInclude	A lista de vistas materializadas a incluir. Para incluir todas as vistas materializadas a partir de "Registos", utilize ["Registos*"].	`["Mv1ToInclude", "Mv2ToInclude"]`
materializedViewsToExclude	A lista de vistas materializadas a excluir. Para excluir todas as vistas materializadas, utilize ["*"].	`["Mv11ToExclude", "Mv22ToExclude"]`
functionsToInclude	A lista de funções a incluir.	`["FunctionToInclude"]`
functionsToExclude	A lista de funções a excluir.	`["FunctionToExclude"]`
localização	A localização de todos os recursos. O coordenador e o seguidor têm de estar na mesma localização.

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

Implemente o modelo de Resource Manager do Azure com o portal do Azure ou o PowerShell.

Verifique se a base de dados foi anexada com êxito

Para verificar se a base de dados foi anexada com êxito, localize as bases de dados anexadas no portal do Azure. Pode verificar se as bases de dados foram anexadas com êxito nos clusters de seguimento ou de classificação.

Verificar o cluster de seguidores

Navegue para o cluster de seguidores e selecione Bases de dados.
Na lista de bases de dados, procure novas bases de dados só de leitura.

Também pode ver esta lista na página de descrição geral da base de dados:

Verificar o cluster de coordenadores

Navegue para o cluster líder e selecione Bases de Dados
Verifique se as bases de dados relevantes estão marcadas como PARTILHADAS COM OUTRAS Pessoas>– Sim
Alterne a ligação de relação para ver os detalhes.

Também pode ver isto na página de descrição geral da base de dados:

Desanexar a base de dados do seguidor

Nota

Para desanexar uma base de dados do lado do seguidor ou do líder, tem de ter utilizador, grupo, principal de serviço ou identidade gerida com, pelo menos, a função de contribuidor no cluster a partir do qual está a desanexar a base de dados. No exemplo abaixo, utilizamos o principal de serviço.

Desanexe a base de dados do seguidor anexado do cluster de seguidores com C#**

O cluster de seguidores pode desanexar qualquer base de dados de seguidor anexada da seguinte forma:

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

Desanexar a base de dados do seguidor anexado do cluster de coordenador com C#

O cluster de coordenadores pode desanexar qualquer base de dados anexada da seguinte forma:

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

Desanexar a base de dados do seguidor anexado do cluster de seguidores com o Python

O cluster de seguidores pode desanexar qualquer base de dados anexada da seguinte forma:

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)

Desanexar a base de dados do seguidor anexado do cluster de coordenador com o Python

O cluster de coordenadores pode desanexar qualquer base de dados anexada da seguinte forma:


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)

Desanexar uma base de dados com o PowerShell

Módulo de Pré-requisitos

Install : Az.Kusto

Exemplo

$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

Gerir principais, permissões e política de colocação em cache

Gerir principais

Ao anexar uma base de dados, especifique o "tipo de modificação de principais predefinidos". A predefinição é combinar a substituição de principais autorizados com a coleção de bases de dados de coordenador de principais autorizados

Tipo	Descrição
União	Os principais de base de dados anexados incluirão sempre os principais de base de dados originais e outros principais novos adicionados à base de dados de seguidores.
Substituir	Nenhuma herança de principais da base de dados original. Têm de ser criados novos principais para a base de dados anexada.
Nenhuma	Os principais de base de dados anexados incluem apenas os principais da base de dados original sem outros principais.

Para obter mais informações sobre como utilizar comandos de gestão para configurar os principais autorizados, veja Comandos de gestão para gerir um cluster de seguidores.

Gerir permissões

Gerir a permissão de base de dados só de leitura é o mesmo que para todos os tipos de base de dados. Para atribuir permissões, veja Gerir permissões de base de dados no portal do Azure ou utilizar comandos de gestão para Gerir funções de segurança de bases de dados.

Configurar a política de colocação em cache

O administrador da base de dados seguinte pode modificar a política de colocação em cache da base de dados anexada ou qualquer uma das respetivas tabelas no cluster de alojamento. A predefinição é combinar a base de dados de origem na base de dados do cluster líder e políticas de colocação em cache ao nível da tabela com as políticas definidas nas políticas de substituição ao nível da base de dados e da tabela. Pode, por exemplo, ter uma política de colocação em cache de 30 dias na base de dados leader para executar relatórios mensais e uma política de colocação em cache de três dias na base de dados do seguidor para consultar apenas os dados recentes para resolução de problemas. Para obter mais informações sobre como utilizar comandos de gestão para configurar a política de colocação em cache na base de dados ou tabela do seguidor, veja Comandos de gestão para gerir um cluster de seguidores.

Notas

Se existirem conflitos entre bases de dados de clusters de coordenador/seguidor, quando todas as bases de dados são seguidas pelo cluster de seguidores, estas são resolvidas da seguinte forma:
- Uma base de dados com o nome BD criada no cluster de seguidores tem precedência sobre uma base de dados com o mesmo nome que foi criado no cluster de classificação. É por isso que a base de dados DB no cluster de seguidores tem de ser removida ou renomeada para que o cluster de seguidores inclua a base de dados do líder.
- Uma base de dados com o nome BD seguida de dois ou mais clusters de coordenador será escolhida arbitrariamente a partir de um dos clusters de classificação e não será seguida mais do que uma vez.
Os comandos para mostrar o registo de atividades do cluster e a execução do histórico num cluster de seguidores mostrarão a atividade e o histórico no cluster de seguidores e os respetivos conjuntos de resultados não incluirão esses resultados do cluster ou clusters de classificação.
- Por exemplo: uma .show queries execução de comandos no cluster de seguidores apenas mostrará as consultas executadas em bases de dados seguidas pelo cluster de seguidores e não as consultas são executadas na mesma base de dados no cluster de coordenadores.

Limitações

Os clusters de seguimento e de preenchimento têm de estar na mesma região.
Se a Ingestão de transmissão em fluxo for utilizada numa base de dados que está a ser seguida, o cluster de seguidores deve ser ativado para Ingestão de Transmissão em Fluxo para permitir o seguimento dos dados de ingestão de transmissão em fluxo.
Seguir um cluster com encriptação de dados com chaves geridas pelo cliente (CMK) é suportado com as seguintes limitações:
- Nem o cluster de seguidores nem o cluster de classificação estão a seguir outros clusters.
- Se um cluster de seguidores estiver a seguir um cluster de coordenador com CMK ativado e o acesso do coordenador à chave for revogado, os clusters de coordenador e de seguidor serão suspensos. Nesta situação, pode resolver o problema da CMK e, em seguida, retomar o cluster do seguidor ou desanexar as bases de dados de seguidores do cluster de seguidores e retomar independentemente do cluster de coordenadores.
Não pode eliminar uma base de dados anexada a um cluster diferente antes de a desanexar.
Não pode eliminar um cluster que tenha uma base de dados anexada a um cluster diferente antes de o desanexar.
As propriedades de partilha ao nível da tabela não são suportadas ao seguir todas as bases de dados.
Nas bases de dados de seguidores, para consultar tabelas externas que utilizam uma Identidade Gerida como método de autenticação, a Identidade Gerida tem de ser adicionada ao cluster de seguidores. Esta capacidade não funciona quando os clusters de coordenador e seguidor são aprovisionados em inquilinos diferentes.

Passo seguinte

Executar comandos do seguidor

Partilhar via

Utilizar bases de dados de seguidores

Que bases de dados são seguidas?

Pré-requisitos

Anexar uma base de dados

Exemplos

Substituição do nome da base de dados

Anexar uma base de dados com C#

Pacotes NuGet necessários

Exemplo de C#

Anexar uma base de dados com Python

Módulos de pré-requisitos

Exemplo de Python

Anexar uma base de dados com o PowerShell

Módulo de pré-requisitos

Exemplo do PowerShell

Anexar uma base de dados com um modelo de Resource Manager do Azure

Verifique se a base de dados foi anexada com êxito

Verificar o cluster de seguidores

Verificar o cluster de coordenadores

Desanexar a base de dados do seguidor

Desanexe a base de dados do seguidor anexado do cluster de seguidores com C#**

Desanexar a base de dados do seguidor anexado do cluster de coordenador com C#

Desanexar a base de dados do seguidor anexado do cluster de seguidores com o Python

Desanexar a base de dados do seguidor anexado do cluster de coordenador com o Python

Desanexar uma base de dados com o PowerShell

Módulo de Pré-requisitos

Exemplo

Gerir principais, permissões e política de colocação em cache

Gerir principais

Gerir permissões

Configurar a política de colocação em cache

Notas

Limitações

Passo seguinte

Comentários

Recursos adicionais

Partilhar via

Utilizar bases de dados de seguidores

Que bases de dados são seguidas?

Pré-requisitos

Anexar uma base de dados

Partilha ao nível da tabela

Exemplos

Substituição do nome da base de dados

Anexar uma base de dados com C#

Pacotes NuGet necessários

Exemplo de C#

Verifique se a base de dados foi anexada com êxito

Verificar o cluster de seguidores

Verificar o cluster de coordenadores

Desanexar a base de dados do seguidor

Desanexe a base de dados do seguidor anexado do cluster de seguidores com C#**

Desanexar a base de dados do seguidor anexado do cluster de coordenador com C#

Gerir principais, permissões e política de colocação em cache

Gerir principais

Gerir permissões

Configurar a política de colocação em cache

Notas

Limitações

Passo seguinte

Comentários

Recursos adicionais