팔로워 데이터베이스 사용

팔로워 데이터베이스 기능을 사용하면 다른 클러스터에 있는 데이터베이스를 Azure Data Explorer 클러스터에 연결할 수 있습니다. 팔로워 데이터베이스는 읽기 전용 모드로 연결되므로 데이터를 보고 리더 데이터베이스에 수집된 데이터에 대한 쿼리를 실행할 수 있습니다. 팔로워 데이터베이스는 리더 데이터베이스의 변경 내용을 동기화합니다. 동기화 때문에, 데이터 가용성에 몇 초에서 몇 분의 데이터 지연이 있습니다. 시간 지연의 길이는 리더 데이터베이스 메타데이터의 전체 크기에 따라 달라집니다. 리더 및 팔로워 데이터베이스는 동일한 스토리지 계정을 사용하여 데이터를 가져옵니다. 스토리지는 리더 데이터베이스가 소유합니다. 팔로워 데이터베이스는 데이터를 수집할 필요 없이 데이터를 볼 수 있습니다. 연결된 데이터베이스는 읽기 전용 데이터베이스이므로 캐 싱 정책, 보안 주체 및 권한을 제외하고 데이터베이스의 데이터, 테이블 및 정책을 수정할 수 없습니다. 연결된 데이터베이스는 삭제할 수 없습니다. 리더 또는 팔로워가 먼저 분리해야만 삭제할 수 있습니다.

팔로워 기능을 사용하여 다른 클러스터에 데이터베이스를 연결하는 것은 조직과 팀 간에 데이터를 공유하는 인프라로 사용됩니다. 이 기능은 비프로덕션 사용 사례로부터 프로덕션 환경을 보호하기 위해 컴퓨팅 리소스를 분리하는 데 유용합니다. 팔로워를 사용하여 Azure Data Explorer 클러스터의 비용을 데이터에 대한 쿼리를 실행하는 당사자와 연결할 수도 있습니다.

어떤 데이터베이스를 팔로우합니까?

클러스터는 하나의 데이터베이스, 여러 데이터베이스 또는 리더 클러스터의 모든 데이터베이스를 따를 수 있습니다.
단일 클러스터는 여러 리더 클러스터의 데이터베이스를 따를 수 있습니다.
클러스터는 팔로워 데이터베이스와 리더 데이터베이스를 모두 포함할 수 있습니다.
EngineV3 클러스터는 EngineV3 클러스터만 팔로우할 수 있고, 마찬가지로 EngineV2 클러스터는 V2 클러스터만 팔로우할 수 있습니다.

필수 조건

Azure 구독. 무료 Azure 계정을 만듭니다.
리더 및 팔로워를 위한 Azure Data Explorer 클러스터 및 데이터베이스입니다. 클러스터 및 데이터베이스를 만듭니다.
리더 데이터베이스에는 데이터가 포함되어야 합니다. 수집 개요에서 설명하는 방법 중 하나를 사용하여 데이터를 수집할 수 있습니다.

데이터베이스 연결

데이터베이스를 연결하는 데 사용할 수 있는 다양한 방법이 있습니다. 이 문서에서는 C#, Python, PowerShell 또는 Azure Resource Manager 템플릿을 사용하여 데이터베이스를 연결하는 방법에 대해 설명합니다. 데이터베이스를 연결하려면 리더 클러스터 및 팔로워 클러스터에서 적어도 기여자 역할이 있는 사용자, 그룹, 서비스 주체 또는 관리 ID가 있어야 합니다. Azure Portal, PowerShell, Azure CLI 및 ARM 템플릿을 사용하여 역할 할당을 추가하거나 제거합니다. Azure RBAC(Azure 역할 기반 액세스 제어) 및 다양한 역할에 대해 자세히 알아봅니다.

데이터베이스를 연결할 때 모든 테이블뿐만 아니라 외부 테이블과 구체화된 뷰도 포함됩니다. 'TableLevelSharingProperties'를 구성하여 특정 테이블/외부 테이블/구체화된 뷰를 공유할 수 있습니다.

'TableLevelSharingProperties'에는 8개의 문자열 배열이 있으며, tablesToInclude, tablesToExclude, externalTablesToInclude, externalTablesToExclude, materializedViewsToInclude, materializedViewsToExclude, functionsToInclude, 및 functionsToExclude입니다. 모든 배열의 최대 항목 수는 100개입니다.

비고

테이블 수준 공유는 '*' 모든 데이터베이스 표기법을 사용할 때 지원되지 않습니다.

비고

구체화된 뷰가 포함되면 원본 테이블도 포함됩니다.

예시

모든 테이블을 포함합니다. 기본적으로 모든 테이블이 자동으로 따라오기 때문에 '*'가 필요하지 않습니다.
```
tablesToInclude = []
```
이름이 "로그"로 시작하는 모든 테이블을 포함합니다.
```
tablesToInclude = ["Logs*"]
```
모든 외부 테이블을 제외합니다.
```
externalTablesToExclude = ["*"]
```
구체화된 모든 뷰를 제외합니다.
```
materializedViewsToExclude=["*"]
```

데이터베이스 이름 재정의

필요에 따라 팔로워 클러스터의 데이터베이스 이름을 리더 클러스터와 다르게 만들 수 있습니다. 예를 들어 여러 리더 클러스터의 동일한 데이터베이스 이름을 팔로워 클러스터에 연결할 수 있습니다. 다른 데이터베이스 이름을 지정하려면 'DatabaseNameOverride' 또는 'DatabaseNamePrefix' 속성을 구성합니다.

C를 사용하여 데이터베이스 연결#

필수 NuGet 패키지

C# 예제

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

Python을 사용하여 데이터베이스 연결

선행 모듈

pip install azure-common
pip install azure-mgmt-kusto

Python 예제

from azure.mgmt.kusto import KustoManagementClient
from azure.mgmt.kusto.models import AttachedDatabaseConfiguration
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 = "uniqueNameForAttachedDatabaseConfiguration"
database_name  = "db" # Can be specific database name 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.create_or_update(follower_resource_group_name, follower_cluster_name, attached_database_Configuration_name, attached_database_configuration_properties)

PowerShell을 사용하여 데이터베이스 연결

선행 모듈

Install : Az.Kusto

PowerShell 예제

$FollowerClustername = 'follower'
$FollowerClusterSubscriptionID = 'xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx'
$FollowerResourceGroupName = 'followerResourceGroup'
$DatabaseName = "db"  ## Can be specific database name or * for all databases
$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 needs to be followed
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 `
    -ClusterResourceId $LeaderClusterResourceid `
    -DefaultPrincipalsModificationKind $DefaultPrincipalsModificationKind `
    -Location $Location `
    -TableLevelSharingPropertyTablesToInclude "table1", "table2", "table3" `
    -TableLevelSharingPropertyExternalTablesToExclude "Logs*" `
    -ErrorAction Stop

Azure Resource Manager 템플릿을 사용하여 데이터베이스 연결

Azure Resource Manager 템플릿을 사용하여 기존 클러스터에 데이터베이스를 연결할 수 있습니다.

다음 단계를 사용하여 데이터베이스를 연결합니다.

다음 표의 정보를 사용하여 템플릿을 만들어 구성합니다.

매개 변수	설명	예시
followerClusterName	팔로워 클러스터의 이름입니다. 템플릿을 배포할 위치입니다.
연결된데이터베이스구성설정이름	연결된 데이터베이스 구성 개체의 이름입니다. 이름은 클러스터 수준에서 고유한 문자열일 수 있습니다.
databaseName	따를 데이터베이스의 이름입니다. 모든 리더의 데이터베이스를 따르려면 '*'를 사용합니다.
leaderClusterResourceId	리더 클러스터의 리소스 ID입니다.
기본 프린시플 수정 유형	기본 주요 수정 종류입니다.	`Union`, `Replace` 또는 `None`일 수 있습니다. 기본 보안 주체 수정 종류에 대한 자세한 내용은 보안 주체 수정 종류 제어 명령을 참조하세요.
포함할_테이블	포함할 테이블 목록입니다. '로그'로 시작하는 모든 테이블을 포함하려면 ["Logs*"]를 사용합니다.	`["table1ToInclude", "table2ToInclude"]`
제외할_테이블	제외할 테이블 목록입니다. 모든 테이블을 제외하려면 ["*"]를 사용합니다.	`["table1ToExclude", "table2ToExclude"]`
포함할 외부 테이블	포함할 테이블 목록입니다. '로그'로 시작하는 모든 외부 테이블을 포함하려면 ["Logs*"]를 사용합니다.	`["ExternalTable1ToInclude", "ExternalTable2ToInclude"]`
externalTablesToExclude	제외할 테이블 목록입니다. 모든 외부 테이블을 제외하려면 ["*"]를 사용합니다.	`["ExternalTable1ToExclude", "ExternalTable2ToExclude"]`
포함할 구체화된 뷰	포함할 구체화된 뷰의 목록입니다. '로그'로 시작하는 구체화된 모든 보기를 포함하려면 ["Logs*"]를 사용합니다.	`["Mv1ToInclude", "Mv2ToInclude"]`
제외할 구체화된 뷰들	제외할 구체화된 뷰의 목록입니다. 구체화된 모든 뷰를 제외하려면 ["*"]를 사용합니다.	`["Mv11ToExclude", "Mv22ToExclude"]`
포함할 함수	포함할 함수 목록입니다.	`["FunctionToInclude"]`
제외할_함수	제외할 함수 목록입니다.	`["FunctionToExclude"]`
위치	모든 리소스의 위치입니다. 리더와 팔로워는 동일한 위치에 있어야 합니다.

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

Azure Portal 또는 PowerShell을 사용하여 Azure Resource Manager 템플릿을 배포합니다.

데이터베이스가 성공적으로 연결되었는지 확인

데이터베이스가 성공적으로 연결되었는지 확인하려면 Azure Portal에서 연결된 데이터베이스를 찾습니다. 데이터베이스가 팔로워 또는 리더 클러스터에 성공적으로 연결되었는지 확인할 수 있습니다.

팔로워 클러스터 확인

팔로워 클러스터로 이동하여 데이터베이스를 선택합니다.
데이터베이스 목록에서 새 읽기 전용 데이터베이스를 검색합니다.

데이터베이스 개요 페이지에서 이 목록을 볼 수도 있습니다.

리더 클러스터 확인

리더 클러스터로 이동하고 데이터베이스를 선택합니다.
관련 데이터베이스가 SHARED WITH OTHERS>Yes로 표시되는지 확인합니다.
세부 정보를 보려면 관계 링크를 전환합니다.

데이터베이스 개요 페이지에서도 볼 수 있습니다.

팔로워 데이터베이스 분리

비고

팔로워 또는 리더 쪽에서 데이터베이스를 분리하려면 데이터베이스를 분리하는 클러스터에서 적어도 기여자 역할이 있는 사용자, 그룹, 서비스 주체 또는 관리 ID가 있어야 합니다. 아래 예제에서는 서비스 주체를 사용합니다.

C#**을 사용하여 팔로워 클러스터에서 연결된 팔로워 데이터베이스 분리

팔로워 클러스터는 다음과 같이 연결된 모든 팔로워 데이터베이스를 분리할 수 있습니다.

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

C를 사용하여 리더 클러스터에서 연결된 팔로워 데이터베이스 분리#

리더 클러스터는 다음과 같이 연결된 데이터베이스를 분리할 수 있습니다.

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

Python을 사용하여 팔로워 클러스터에서 연결된 팔로워 데이터베이스 분리

팔로워 클러스터는 다음과 같이 연결된 데이터베이스를 분리할 수 있습니다.

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)

Python을 사용하여 리더 클러스터에서 연결된 팔로워 데이터베이스 분리

리더 클러스터는 다음과 같이 연결된 데이터베이스를 분리할 수 있습니다.


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

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

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

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

PowerShell을 사용하여 데이터베이스 분리

선행 모듈

Install : Az.Kusto

예시

$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

계정, 권한 및 캐싱 정책 관리

주요 인물 관리

데이터베이스를 연결할 때 "기본 보안 주체 수정 종류"를 지정합니다. 기본값은 권한 있는 보안 주체 재정의를 권한 있는 보안 주체의 리더 데이터베이스 컬렉션과 결합하는 것입니다.

종류	설명
연합	연결된 데이터베이스 보안 주체에는 항상 원래 데이터베이스 보안 주체와 팔로워 데이터베이스에 추가된 다른 새 보안 주체가 포함됩니다.
교체	원래 데이터베이스에서 주체의 상속이 없습니다. 연결된 데이터베이스에 대한 새로운 주체를 만들어야 합니다.
없음	연결된 데이터베이스 보안 주체에는 다른 보안 주체가 없는 원래 데이터베이스의 보안 주체만 포함됩니다.

제어 명령을 사용하여 권한 있는 보안 주체를 구성하는 방법에 대한 자세한 내용은 팔로워 클러스터를 관리하기 위한 Control 명령을 참조하세요.

권한 관리

읽기 전용 데이터베이스 권한 관리는 모든 데이터베이스 유형과 동일합니다. Azure Portal에서 권한 관리를 참조하세요.

캐싱 정책 구성

팔로워 데이터베이스 관리자는 연결된 데이터베이스 또는 호스팅 클러스터의 해당 테이블의 캐싱 정책을 수정할 수 있습니다. 기본값은 리더 클러스터 데이터베이스의 원본 데이터베이스와 테이블 수준 캐싱 정책을 데이터베이스 및 테이블 수준 재정의 정책에 정의된 정책과 결합하는 것입니다. 예를 들어 월별 보고를 실행하기 위해 리더 데이터베이스에 대한 30일 캐싱 정책을 사용하고, 팔로워 데이터베이스에서 3일 캐싱 정책을 사용하여 문제 해결을 위해 최근 데이터만 쿼리할 수 있습니다. 컨트롤 명령을 사용하여 팔로워 데이터베이스 또는 테이블에서 캐싱 정책을 구성하는 방법에 대한 자세한 내용은 팔로워 클러스터를 관리하기 위한 Control 명령을 참조하세요.

비고

리더/팔로워 클러스터의 데이터베이스 간에 충돌이 있는 경우 모든 데이터베이스 다음에 팔로워 클러스터가 오면 다음과 같이 해결됩니다.
- 팔로워 클러스터에서 만든 DB 라는 데이터베이스가 리더 클러스터에서 만든 이름과 동일한 데이터베이스보다 우선합니다. 따라서 팔로워 클러스터의 데이터베이스 DB 를 제거하거나 이름을 변경하여 리더의 데이터베이스 DB를 포함해야 합니다.
- 둘 이상의 리더 클러스터에서 뒤에 오는 DB 라는 데이터베이스는 리더 클러스터 중 하나에서 임의로 선택되며 두 번 이상 수행되지 않습니다.
팔로워 클러스터에서 실행되는 클러스터 활동 로그 및 기록을 표시하는 명령은 팔로워 클러스터의 활동 및 기록을 표시하며 결과 집합에는 리더 클러스터 또는 클러스터의 결과가 포함되지 않습니다.
- 예를 들어 .show queries , 팔로워 클러스터에서 실행되는 명령은 다음에 오는 데이터베이스에서 실행되는 쿼리만 표시하고 순위 클러스터의 동일한 데이터베이스에 대해 실행되는 쿼리는 표시하지 않습니다.

제한점

팔로워와 리더 클러스터는 동일한 지역에 있어야 합니다.
팔로우 중인 데이터베이스에 스트리밍 수집을 사용하는 경우, 스트리밍 수집 데이터를 팔로우할 수 있도록 팔로워 클러스터가 사용 가능하도록 설정되어야 합니다.
고객 관리형 키를 사용한 데이터 암호화는 리더 클러스터와 팔로워 클러스터 모두에서 지원되지 않습니다.
다른 클러스터에 연결된 데이터베이스는 분리하기 전에 삭제할 수 없습니다.
데이터베이스를 분리하기 전에 다른 클러스터에 연결된 클러스터는 삭제할 수 없습니다.
테이블 수준 공유 속성은 모든 데이터베이스를 팔로우할 때 지원되지 않습니다.

다음 단계

팔로워 클러스터 구성에 대한 자세한 내용은 팔로워 클러스터를 관리하기 위한 제어 명령을 참조하세요.

Last updated on 2023-05-03

다음을 통해 공유

팔로워 데이터베이스 사용

어떤 데이터베이스를 팔로우합니까?

필수 조건

데이터베이스 연결

테이블 수준 공유

예시

데이터베이스 이름 재정의

C를 사용하여 데이터베이스 연결#

필수 NuGet 패키지

C# 예제

데이터베이스가 성공적으로 연결되었는지 확인

팔로워 클러스터 확인

리더 클러스터 확인

팔로워 데이터베이스 분리

C#**을 사용하여 팔로워 클러스터에서 연결된 팔로워 데이터베이스 분리

C를 사용하여 리더 클러스터에서 연결된 팔로워 데이터베이스 분리#

계정, 권한 및 캐싱 정책 관리

주요 인물 관리

권한 관리

캐싱 정책 구성

비고

제한점

다음 단계

추가 리소스