Korzystanie z baz danych obserwowanych

Funkcja bazy danych obserwowanej umożliwia dołączenie bazy danych znajdującej się w innym klastrze do klastra usługi Azure Data Explorer. Baza danych obserwowanych jest dołączona w trybie tylko do odczytu, umożliwiając wyświetlanie danych i uruchamianie zapytań dotyczących danych pozyskanych do bazy danych lidera. Baza danych obserwowanych synchronizuje zmiany w bazach danych liderów. Ze względu na synchronizację opóźnienie danych może potrwać od kilku sekund do kilku minut w dostępności danych. Długość opóźnienia zależy od ogólnego rozmiaru metadanych bazy danych lidera. Bazy danych liderów i obserwowanych używają tego samego konta magazynu, aby pobrać dane. Magazyn jest własnością bazy danych lidera. Baza danych obserwowanych wyświetla dane bez konieczności ich pozyskiwania. Ponieważ dołączona baza danych jest bazą danych tylko do odczytu, nie można modyfikować danych, tabel i zasad w bazie danych z wyjątkiem zasad buforowania, podmiotów zabezpieczeń i uprawnień. Nie można usunąć dołączonych baz danych. Muszą być odłączone przez lidera lub zwolennika, a dopiero wtedy można je usunąć.

Dołączanie bazy danych do innego klastra przy użyciu funkcji obserwowania jest używane jako infrastruktura do udostępniania danych między organizacjami i zespołami. Funkcja jest przydatna do segregowania zasobów obliczeniowych w celu ochrony środowiska produkcyjnego przed przypadkami użycia nieprodukcyjnymi. Za pomocą narzędzia obserwowanego można również skojarzyć koszt klastra usługi Azure Data Explorer z partią, która uruchamia zapytania dotyczące danych.

Przykłady kodu oparte na poprzednich wersjach zestawu SDK można znaleźć w zarchiwizowanym artykule.

Które bazy danych są obserwowane?

• Klaster może podążać za jedną bazą danych, kilkoma bazami danych lub wszystkimi bazami danych klastra lidera.
• Pojedynczy klaster może podążać za bazami danych z wielu klastrów liderów.
• Klaster może zawierać zarówno bazy danych obserwowanych, jak i wiodące bazy danych.

Wymagania wstępne

• Subskrypcja platformy Azure. Utwórz bezpłatne konto platformy Azure.
• Klaster i baza danych usługi Azure Data Explorer dla lidera i obserwowanego. Utwórz klaster i bazę danych.
• Baza danych lidera powinna zawierać dane. Dane można pozyskiwać przy użyciu jednej z metod omówionych w omówieniu pozyskiwania.

Dołączanie bazy danych

Istnieją różne metody, których można użyć do dołączania bazy danych. W tym artykule omówiono dołączanie bazy danych przy użyciu języka C#, Python, programu PowerShell lub szablonu usługi Azure Resource Manager. Aby dołączyć bazę danych, musisz mieć użytkownika, grupę, jednostkę usługi lub tożsamość zarządzaną z co najmniej rolą współautora w klastrze liderów i klastrem obserwowanym. Dodawanie lub usuwanie przypisań ról przy użyciu witryny Azure Portal, programu PowerShell, interfejsu wiersza polecenia platformy Azure i szablonu usługi ARM. Dowiedz się więcej na temat kontroli dostępu opartej na rolach (RBAC) platformy Azure i różnych ról.

Uwaga

Wstępne utworzenie bazy danych obserwowanej nie jest konieczne, ponieważ jest ona tworzona podczas procesu załącznika.

Udostępnianie na poziomie tabeli

Podczas dołączania bazy danych wszystkie tabele są również obserwowane tabele zewnętrzne i zmaterializowane widoki. Określone tabele/tabele zewnętrzne/zmaterializowane widoki można udostępniać, konfigurując właściwość "TableLevelSharingProperties".

Element "TableLevelSharingProperties" zawiera osiem tablic ciągów: tablesToInclude, , , externalTablesToIncludeexternalTablesToExcludetablesToExclude, materializedViewsToExcludematerializedViewsToInclude, functionsToInclude, i functionsToExclude. Maksymalna liczba wpisów we wszystkich tablicach wynosi 100.

Uwaga

• Udostępnianie na poziomie tabeli nie jest obsługiwane w przypadku używania notacji "*" wszystkich baz danych.
• Po dołączeniu zmaterializowanych widoków ich tabele źródłowe również są uwzględniane.

Przykłady

Poniższy przykład zawiera wszystkie tabele. Domyślnie wszystkie tabele są obserwowane bez użycia notacji "*":

tablesToInclude = []

Poniższy przykład obejmuje wszystkie funkcje. Domyślnie wszystkie funkcje są obserwowane bez użycia notacji "*":

functionsToInclude = []

Poniższy przykład obejmuje wszystkie tabele o nazwach rozpoczynających się od "Dzienniki":

tablesToInclude = ["Logs*"]

Poniższy przykład obejmuje wszystkie tabele zewnętrzne:

externalTablesToExclude = ["*"]

Poniższy przykład obejmuje wszystkie zmaterializowane widoki:

materializedViewsToExclude=["*"]

Zastępowanie nazwy bazy danych

Opcjonalnie możesz ustawić nazwę bazy danych w klastrze obserwowanym inaczej niż klaster liderów. Możesz na przykład dołączyć tę samą nazwę bazy danych z wielu klastrów liderów do klastra obserwowanego. Aby określić inną nazwę bazy danych, skonfiguruj właściwość "DatabaseNameOverride" lub "DatabaseNamePrefix".

C#

Dołączanie bazy danych przy użyciu języka C#

Wymagane pakiety NuGet

• Zainstaluj narzędzie Azure.ResourceManager.Kusto.
• Zainstaluj usługę Azure.Identity na potrzeby uwierzytelniania.

Przykład w języku 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);

Python

Dołączanie bazy danych przy użyciu języka Python

Moduły wymagań wstępnych

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

Przykład języka 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)

Program PowerShell

Dołączanie bazy danych przy użyciu programu PowerShell

Moduł wymagań wstępnych

Install : Az.Kusto

Przykład programu 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

Szablon usługi Resource Manager

Dołączanie bazy danych przy użyciu szablonu usługi Azure Resource Manager

Szablon usługi Azure Resource Manager umożliwia dołączenie bazy danych do istniejącego klastra.

Aby dołączyć bazę danych, wykonaj następujące kroki:

1. Utwórz szablon, korzystając z informacji w poniższej tabeli, aby ułatwić jej skonfigurowanie.

   Parametr	Opis	Przykład
   followerClusterName	Nazwa klastra obserwowanego; gdzie szablon zostanie wdrożony.
   attachedDatabaseConfigurationsName	Nazwa dołączonego obiektu konfiguracji bazy danych. Nazwa może być dowolnym ciągiem unikatowym na poziomie klastra.
   databaseName	Nazwa bazy danych do naśladowania. Aby postępować zgodnie ze wszystkimi bazami danych lidera, użyj "*".
   leaderClusterResourceId	Identyfikator zasobu klastra lidera.
   defaultPrincipalsModificationKind	Domyślny rodzaj modyfikacji podmiotu zabezpieczeń.	Może to być Union, Replacelub None. Aby uzyskać więcej informacji na temat domyślnego typu modyfikacji podmiotu zabezpieczeń, zobacz główne polecenie zarządzania rodzajem modyfikacji.
   tablesToInclude	Lista tabel do uwzględnienia. Aby uwzględnić wszystkie tabele rozpoczynające się od ciągu "Logs", użyj polecenia ["Logs*"].	["table1ToInclude", "table2ToInclude"]
   tablesToExclude	Lista tabel do wykluczenia. Aby wykluczyć wszystkie tabele, użyj polecenia ["*"].	["table1ToExclude", "table2ToExclude"]
   externalTablesToInclude	Lista tabel do uwzględnienia. Aby uwzględnić wszystkie tabele zewnętrzne rozpoczynające się od "Dzienniki", użyj polecenia ["Logs*"].	["ExternalTable1ToInclude", "ExternalTable2ToInclude"]
   externalTablesToExclude	Lista tabel do wykluczenia. Aby wykluczyć wszystkie tabele zewnętrzne, użyj polecenia ["*"].	["ExternalTable1ToExclude", "ExternalTable2ToExclude"]
   materializedViewsToInclude	Lista zmaterializowanych widoków do uwzględnienia. Aby uwzględnić wszystkie zmaterializowane widoki rozpoczynające się od "Dzienniki", użyj polecenia ["Logs*".].	["Mv1ToInclude", "Mv2ToInclude"]
   materializedViewsToExclude	Lista zmaterializowanych widoków do wykluczenia. Aby wykluczyć wszystkie zmaterializowane widoki, użyj polecenia ["*"].	["Mv11ToExclude", "Mv22ToExclude"]
   functionsToInclude	Lista funkcji do uwzględnienia.	["FunctionToInclude"]
   functionsToExclude	Lista funkcji do wykluczenia.	["FunctionToExclude"]
   location	Lokalizacja wszystkich zasobów. Lider i zwolennik muszą znajdować się w tej samej lokalizacji.

   {
       "$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. Wdróż szablon usługi Azure Resource Manager przy użyciu witryny Azure Portal lub programu PowerShell.

   

Sprawdź, czy baza danych została pomyślnie dołączona

Aby sprawdzić, czy baza danych została pomyślnie dołączona, znajdź dołączone bazy danych w witrynie Azure Portal. Możesz sprawdzić, czy bazy danych zostały pomyślnie dołączone w klastrach obserwowanych lub liderów.

Sprawdzanie klastra obserwowanych

1. Przejdź do klastra obserwowanego i wybierz pozycję Bazy danych.

2. Na liście baz danych wyszukaj nowe bazy danych tylko do odczytu.

   

   Tę listę można również wyświetlić na stronie przeglądu bazy danych:

   

Sprawdzanie klastra liderów

1. Przejdź do klastra lidera i wybierz pozycję Bazy danych

2. Sprawdź, czy odpowiednie bazy danych są oznaczone jako UDOSTĘPNIONE INNYM TAK>

3. Przełącz link relacji, aby wyświetlić szczegóły.

   

   Można to również wyświetlić na stronie przeglądu bazy danych:

   

Odłącz bazę danych obserwowanych

Uwaga

Aby odłączyć bazę danych od obserwowanej lub wiodącej strony, musisz mieć użytkownika, grupę, jednostkę usługi lub tożsamość zarządzaną z co najmniej rolą współautora w klastrze, z którego odłączasz bazę danych. W poniższym przykładzie używamy jednostki usługi.

C#

Odłącz dołączoną bazę danych obserwowanych z klastra obserwowanego przy użyciu języka C#**

Klaster obserwowania może odłączyć dowolną dołączoną bazę danych obserwowanych w następujący sposób:

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

Odłącz dołączoną bazę danych obserwowanych od klastra lidera przy użyciu języka C#

Klaster liderów może odłączyć dowolną dołączoną bazę danych w następujący sposób:

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

Odłącz dołączoną bazę danych obserwowanych z klastra obserwowanego przy użyciu języka Python

Klaster obserwowania może odłączyć dowolną dołączoną bazę danych w następujący sposób:

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)

Odłącz dołączoną bazę danych obserwowanych od klastra lidera przy użyciu języka Python

Klaster liderów może odłączyć dowolną dołączoną bazę danych w następujący sposób:

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)

Program PowerShell

Odłączanie bazy danych przy użyciu programu PowerShell

Moduł wymagań wstępnych

Install : Az.Kusto

Przykład

$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

Szablon usługi Resource Manager

Odłącz bazę danych obserwowanych przy użyciu języka C#, Python lub programu PowerShell.

Zarządzanie zasadami podmiotów zabezpieczeń, uprawnień i buforowania

Zarządzanie podmiotami zabezpieczeń

Podczas dołączania bazy danych określ "domyślny rodzaj modyfikacji podmiotów zabezpieczeń". Wartością domyślną jest połączenie przesłonięć autoryzowanych podmiotów zabezpieczeń z kolekcją bazy danych lidera autoryzowanych podmiotów zabezpieczeń

Rodzaj	Opis
Unia	Dołączone podmioty zabezpieczeń bazy danych zawsze będą zawierać oryginalne podmioty zabezpieczeń bazy danych oraz inne nowe podmioty zabezpieczeń dodane do bazy danych obserwowanej bazy danych.
Replace	Brak dziedziczenia podmiotów zabezpieczeń z oryginalnej bazy danych. Dla dołączonej bazy danych należy utworzyć nowe podmioty zabezpieczeń.
Brak	Dołączone podmioty zabezpieczeń bazy danych obejmują tylko podmioty zabezpieczeń oryginalnej bazy danych bez innych podmiotów zabezpieczeń.

Aby uzyskać więcej informacji na temat używania poleceń zarządzania do konfigurowania autoryzowanych podmiotów zabezpieczeń, zobacz Zarządzanie poleceniami do zarządzania klastrem obserwowanym.

Zarządzaj uprawnieniami

Zarządzanie uprawnieniami bazy danych tylko do odczytu jest takie samo jak w przypadku wszystkich typów baz danych. Aby przypisać uprawnienia, zobacz Zarządzanie uprawnieniami bazy danych w witrynie Azure Portal lub użyj poleceń zarządzania do zarządzania rolami zabezpieczeń bazy danych.

Konfigurowanie zasad buforowania

Administrator bazy danych obserwowanej może zmodyfikować zasady buforowania dołączonej bazy danych lub dowolnej z jej tabel w klastrze hostingu. Ustawieniem domyślnym jest połączenie źródłowej bazy danych w bazie danych klastra wiodącego i zasad buforowania na poziomie tabeli z zasadami zdefiniowanymi w bazie danych i zasadach zastępowania na poziomie tabeli. Możesz na przykład mieć 30-dniowe zasady buforowania w bazie danych lidera do uruchamiania raportowania miesięcznego i trzydniowe zasady buforowania w bazie danych obserwowanych, aby wykonywać zapytania tylko o ostatnie dane na potrzeby rozwiązywania problemów. Aby uzyskać więcej informacji na temat używania poleceń zarządzania do konfigurowania zasad buforowania w bazie danych lub tabeli obserwowanej, zobacz Zarządzanie poleceniami do zarządzania klastrem obserwowanych.

Uwagi

• Jeśli występują konflikty między bazami danych klastrów liderów/obserwowanych, gdy po wszystkich bazach danych następuje klaster obserwowany, są one rozwiązywane w następujący sposób:
  • Baza danych o nazwie DB utworzona w klastrze obserwowanym ma pierwszeństwo przed bazą danych o tej samej nazwie, która została utworzona w klastrze liderów. Dlatego baza danych bazy danych w klastrze obserwowanym musi zostać usunięta lub zmieniona nazwa klastra obserwowanego w celu uwzględnienia bazy danych lidera.
  • Baza danych o nazwie DB, po której następuje co najmniej dwa klastry liderów, zostanie dowolnie wybrana z jednego z klastrów liderów i nie będzie obserwowana więcej niż raz.
• Polecenia służące do wyświetlania dziennika aktywności i historii klastra uruchomionego w klastrze obserwowanym będą pokazywać aktywność i historię w klastrze obserwowanym, a ich zestawy wyników nie będą zawierać tych wyników klastra lub klastrów liderów.
  • Na przykład: polecenie uruchamiane .show queries w klastrze obserwowanym spowoduje wyświetlenie tylko zapytań uruchamianych w bazach danych, po których następuje klaster obserwowany, a nie zapytania uruchamiane względem tej samej bazy danych w klastrze liderów.

Ograniczenia

• Obserwowanie i klastry liderów muszą znajdować się w tym samym regionie.
• Jeśli pozyskiwanie przesyłania strumieniowego jest używane w bazie danych, która jest obserwowana, klaster obserwowany powinien być włączony na potrzeby pozyskiwania danych przesyłania strumieniowego, aby zezwolić na następujące dane pozyskiwania strumieniowego.
• Stosowanie klastra z szyfrowaniem danych przy użyciu kluczy zarządzanych przez klienta (CMK) jest obsługiwane z następującymi ograniczeniami:
  • Ani klaster kontynuacji, ani klaster liderów nie są obserwowane w innych klastrach.
  • Jeśli klaster obserwowany jest po klastrze liderów z włączonym kluczem CMK, a dostęp lidera do klucza zostanie odwołany, zarówno lider, jak i klastry monitora zostaną zawieszone. W takiej sytuacji można rozwiązać problem z kluczem cmK, a następnie wznowić klaster monitora lub odłączyć bazy danych obserwowanych z klastra monitora i wznowić działanie niezależnie od klastra lidera.
• Nie można usunąć bazy danych dołączonej do innego klastra przed odłączeniem.
• Nie można usunąć klastra, który ma bazę danych dołączoną do innego klastra przed odłączeniem go.
• Właściwości udostępniania na poziomie tabeli nie są obsługiwane w przypadku wykonywania wszystkich baz danych.
• W kolejnych bazach danych, aby wysyłać zapytania do tabel zewnętrznych używających tożsamości zarządzanej jako metody uwierzytelniania, tożsamość zarządzana musi zostać dodana do klastra obserwowanego. Ta funkcja nie działa, gdy lider i klastry obserwowane są aprowidowane w różnych dzierżawach.

Następny krok

Uruchamianie poleceń obserwowanych