Menggunakan database pengikut

Fitur database pengikut memungkinkan Anda melampirkan database yang terletak di kluster yang berbeda ke kluster Azure Data Explorer Anda. Database pengikut dilampirkan dalam mode baca-saja, memungkinkan untuk melihat data dan menjalankan kueri pada data yang diserap ke dalam database pemimpin. Database pengikut menyinkronkan perubahan dalam database pemimpin. Karena sinkronisasi, ada jeda data beberapa detik hingga beberapa menit dalam ketersediaan data. Panjang jeda waktu tergantung pada ukuran keseluruhan metadata database pemimpin. Database pemimpin dan pengikut menggunakan akun penyimpanan yang sama untuk mengambil data. Penyimpanan dimiliki oleh database pemimpin. Database pengikut menampilkan data tanpa perlu menyerapnya. Karena database terlampir adalah database baca-saja, data, tabel, dan kebijakan dalam database tidak dapat dimodifikasi kecuali untuk kebijakan penyimpanan sementara, prinsipal, dan izin. Database terlampir tidak dapat dihapus. Mereka harus dilepaskan oleh pemimpin atau pengikut dan hanya kemudian mereka dapat dihapus.

Melampirkan database ke kluster yang berbeda menggunakan kemampuan pengikut digunakan sebagai infrastruktur untuk berbagi data antara organisasi dan tim. Fitur ini berguna untuk memisahkan sumber daya komputasi untuk melindungi lingkungan produksi dari kasus penggunaan non-produksi. Pengikut juga dapat digunakan untuk mengaitkan biaya kluster Azure Data Explorer kepada pihak yang bertanggung jawab menjalankan kueri pada data.

Database mana yang diikuti?

• Kluster dapat mengikuti satu database, beberapa database, atau semua database kluster pemimpin.
• Satu kluster dapat mengikuti database dari beberapa kluster pemimpin.
• Kluster dapat berisi database pengikut dan database pemimpin.
• Kluster EngineV3 hanya dapat mengikuti kluster EngineV3, demikian pula kluster EngineV2 hanya dapat mengikuti kluster V2.

Prasyarat

• Langganan Azure. Membuat akun Azure gratis.
• Kluster dan database Azure Data Explorer untuk pemimpin dan pengikut. Membuat kluster dan database.
• Database pemimpin harus berisi data. Anda dapat menyerap data menggunakan salah satu metode yang dibahas dalam gambaran umum penyerapan.

Melampirkan database

Ada berbagai metode yang dapat Anda gunakan untuk melampirkan database. Dalam artikel ini, kita membahas melampirkan database menggunakan C#, Python, PowerShell, atau templat Azure Resource Manager. Untuk melampirkan database, Anda harus memiliki pengguna, grup, perwakilan layanan, atau identitas terkelola dengan setidaknya peran kontributor pada kluster pemimpin dan kluster pengikut. Menambahkan atau menghapus penetapan peran menggunakan portal Microsoft Azure, PowerShell, Azure CLI, dan templat ARM. Pelajari selengkapnya tentang kontrol akses berbasis peran Azure (Azure RBAC) dan peran yang berbeda.

Berbagi di tingkat tabel

Saat melampirkan database, semua tabel, tabel eksternal, dan tampilan materialisasi juga disertakan. Anda dapat berbagi tabel/tabel eksternal/tampilan materialisasi tertentu dengan mengonfigurasi 'TableLevelSharingProperties'.

'TableLevelSharingProperties' berisi delapan array string: tablesToInclude, tablesToExclude, externalTablesToInclude, externalTablesToExclude, materializedViewsToInclude, materializedViewsToExclude, functionsToInclude, dan functionsToExclude. Jumlah maksimum entri dalam semua array bersama-sama adalah 100.

Nota

Pembagian tingkat tabel tidak didukung saat menggunakan notasi '*' untuk semua database.

Nota

Saat tampilan materialisasi disertakan, tabel sumbernya juga disertakan.

Contoh

1. Sertakan semua tabel. Tidak diperlukan '*', karena semua tabel diikuti secara default:

   tablesToInclude = []
   

2. Sertakan semua tabel dengan nama yang dimulai dengan "Log":

   tablesToInclude = ["Logs*"]
   

3. Kecualikan semua tabel eksternal:

   externalTablesToExclude = ["*"]
   

4. Kecualikan semua tampilan materialisasi:

   materializedViewsToExclude=["*"]
   

Penggantian nama database

Anda dapat secara opsional membuat nama database di kluster pengikut berbeda dari kluster pemimpin. Misalnya, Anda mungkin ingin melampirkan nama database yang sama dari beberapa kluster pemimpin ke kluster pengikut. Untuk menentukan nama database yang berbeda, konfigurasikan properti 'DatabaseNameOverride' atau 'DatabaseNamePrefix'.

C#

Melampirkan database menggunakan C#

Paket NuGet yang diperlukan

• Instal Microsoft.Azure.Management.Kusto.
• Instal Microsoft.Rest.ClientRuntime.Azure.Authentication untuk autentikasi.

Contoh 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

Melampirkan database menggunakan Python

Modul prasyarat

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

Contoh 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

Melampirkan database menggunakan PowerShell

Modul prasyarat

Install : Az.Kusto

Contoh 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

Templat Resource Manager

Melampirkan database menggunakan templat Azure Resource Manager

Anda dapat menggunakan templat Azure Resource Manager untuk melampirkan database ke kluster yang sudah ada.

Gunakan langkah-langkah berikut untuk melampirkan database:

1. Buat templat menggunakan informasi dalam tabel berikut untuk membantu Anda mengonfigurasinya.

   Parameter	Deskripsi	Contoh
   followerClusterName	Nama kluster pengikut; di mana templat akan disebarkan.
   attachedDatabaseConfigurationsName	Nama objek konfigurasi database terlampir. Nama dapat berupa string apa pun yang unik di tingkat kluster.
   databaseName	Nama database yang akan diikuti. Untuk mengakses seluruh database milik pemimpin, gunakan '*'.
   leaderClusterResourceId	ID sumber daya kluster utama.
   defaultPrincipalsModificationKind	Jenis modifikasi pokok bawaan.	Bisa Union, Replace, atau None. Untuk informasi selengkapnya tentang jenis modifikasi utama default, lihat perintah jenis modifikasi utama.
   tablesToInclude	Daftar tabel yang akan disertakan. Untuk menyertakan semua tabel yang dimulai dengan 'Log', gunakan ["Logs*"].	["table1ToInclude", "table2ToInclude"]
   tablesToExclude	Daftar tabel yang akan dikecualikan. Untuk mengecualikan semua tabel, gunakan ["*"].	["table1ToExclude", "table2ToExclude"]
   TabelEksternalUntukDisertakan	Daftar tabel yang akan disertakan. Untuk menyertakan semua tabel eksternal yang dimulai dengan 'Log', gunakan ["Logs*"].	["ExternalTable1ToInclude", "ExternalTable2ToInclude"]
   externalTablesToExclude	Daftar tabel yang akan dikecualikan. Untuk mengecualikan semua tabel eksternal, gunakan ["*"].	["ExternalTable1ToExclude", "ExternalTable2ToExclude"]
   menginkludeViewMaterialisasi	Daftar tampilan materialisasi yang akan disertakan. Untuk menyertakan semua tampilan materialisasi yang dimulai dengan 'Log', gunakan ["Logs*"].	["Mv1ToInclude", "Mv2ToInclude"]
   materializedViewsUntukDikecualikan	Daftar tampilan materialisasi yang akan dikecualikan. Untuk mengecualikan semua tampilan materialisasi, gunakan ["*"].	["Mv11ToExclude", "Mv22ToExclude"]
   functionsToInclude	Daftar fungsi yang akan disertakan.	["FunctionToInclude"]
   fungsiUntukDikecualikan	Daftar fungsi yang akan dikecualikan.	["FunctionToExclude"]
   Lokasi	Lokasi semua sumber daya. Pemimpin dan pengikut harus berada di lokasi yang sama.

   {
       "$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. Sebarkan templat Azure Resource Manager menggunakan portal Microsoft Azure atau PowerShell.

   

Verifikasi bahwa database berhasil dilampirkan

Untuk memverifikasi bahwa database berhasil dilampirkan, temukan database terlampir Anda di portal Microsoft Azure. Anda dapat memverifikasi bahwa database berhasil dilampirkan di kluster pengikut atau pemimpin .

Periksa kluster pengikut Anda

1. Telusuri ke kluster pengikut dan pilih Database.

2. Dalam daftar database, cari basis data hanya-baca yang baru.

   

   Anda juga bisa menampilkan daftar ini di halaman gambaran umum database:

   

Periksa kluster pemimpin Anda

1. Telusuri ke kluster pemimpin dan pilih Database

2. Periksa apakah database yang relevan ditandai sebagai DIBAGIKAN DENGAN ORANG LAIN>Ya

3. Ubah tautan hubungan untuk melihat detail.

   

   Anda juga bisa menampilkan ini di halaman gambaran umum database:

   

Memisahkan basis data pengikut

Nota

Untuk melepaskan database dari sisi pengikut atau pemimpin, Anda harus memiliki pengguna, grup, perwakilan layanan, atau identitas terkelola dengan setidaknya peran kontributor pada kluster tempat Anda melepaskan database. Dalam contoh di bawah ini, kami menggunakan prinsipal layanan.

C#

Lepaskan database pengikut terlampir dari kluster pengikut menggunakan C#**

Kluster pengikut dapat memisahkan database pengikut yang terlampir dengan cara berikut:

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

Lepaskan database pengikut terlampir dari kluster pemimpin menggunakan C#

Kluster pemimpin dapat melepaskan database terlampir apa pun sebagai berikut:

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

Lepaskan database pengikut terlampir dari kluster pengikut menggunakan Python

Kluster pengikut dapat melepaskan database terlampir apa pun sebagai berikut:

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)

Lepaskan database pengikut terlampir dari kluster pemimpin menggunakan Python

Kluster pemimpin dapat melepaskan database terlampir apa pun sebagai berikut:

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

Melepas database menggunakan PowerShell

Modul Prasyarat

Install : Az.Kusto

Contoh

$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

Templat Resource Manager

Lepaskan database pengikut menggunakan C#, Python, atau PowerShell.

Mengelola pengguna, izin, dan kebijakan penyimpanan cache

Mengelola kepala sekolah

Saat melampirkan database, tentukan "jenis modifikasi prinsipal default". Defaultnya adalah menggabungkan penggantian prinsipal yang berwenang dengan kumpulan database pemimpin prinsipal yang berwenang

Jenis	Deskripsi
Union	Prinsipal database terlampir akan selalu menyertakan prinsipal database asli ditambah prinsipal baru lainnya yang ditambahkan ke database pengikut.
Ganti	Tidak ada warisan prinsipal dari database asli. Prinsipal baru harus dibuat untuk database terlampir.
Tidak	Prinsipal database terlampir hanya mencakup prinsipal database asli tanpa prinsipal lain.

Untuk informasi selengkapnya tentang menggunakan perintah kendali untuk mengonfigurasi prinsipal yang diizinkan, lihat Perintah kendali untuk mengelola kluster replika.

Pengelolaan hak akses

Mengelola izin database baca-saja sama seperti semua jenis database. Lihat mengelola izin di portal Microsoft Azure.

Mengonfigurasi kebijakan cache

Administrator database sekunder dapat mengubah kebijakan caching dari database terlampir atau tabel-tabelnya pada kluster hosting. Defaultnya adalah menggabungkan database sumber dalam database kluster pemimpin dan kebijakan caching tingkat tabel dengan kebijakan yang ditentukan dalam database dan kebijakan pembatalan tingkat tabel. Anda dapat, misalnya, memiliki kebijakan caching 30 hari pada database utama untuk menjalankan pelaporan bulanan dan kebijakan caching tiga hari pada database cadangan untuk mencari data terbaru dalam pemecahan masalah. Untuk informasi lebih lanjut tentang penggunaan perintah kontrol untuk mengonfigurasi kebijakan cache pada database atau tabel pengikut, lihat Perintah kontrol untuk mengelola kluster pengikut.

Catatan

• Jika ada konflik antara database kluster pemimpin/pengikut, ketika semua database diikuti oleh kluster pengikut, mereka diselesaikan sebagai berikut:
  • Database bernama DB yang dibuat pada kluster pengikut lebih diutamakan daripada database dengan nama yang sama yang dibuat pada kluster pemimpin. Itulah sebabnya database DB di kluster pengikut perlu dihapus atau diganti namanya agar kluster tersebut dapat menyertakan database DB pemimpin.
  • Database bernama DB diikuti dari dua kluster pemimpin atau lebih akan dipilih secara semena-mena dari salah satu kluster pemimpin, dan tidak akan diikuti lebih dari sekali.
• Perintah untuk menampilkan log aktivitas kluster dan riwayat yang dijalankan pada kluster pengikut akan menampilkan aktivitas dan riwayat pada kluster pengikut, dan kumpulan hasilnya tidak akan menyertakan hasil kluster atau kluster pemimpin tersebut.
  • Misalnya: perintah yang .show queries dijalankan pada kluster pengikut hanya akan menampilkan kueri yang dijalankan pada database diikuti oleh kluster pengikut, dan bukan kueri yang dijalankan terhadap database yang sama di kluster pemimpin.

Keterbatasan

• Pengikut dan kluster pemimpin harus berada di wilayah yang sama.
• Jika Penyerapan Streaming digunakan pada database yang diikuti, kluster pengikut harus diaktifkan untuk Penyerapan Streaming agar dapat mengikuti data penyerapan streaming.
• Enkripsi data menggunakan kunci yang dikelola pelanggan tidak didukung pada kluster pemimpin dan pengikut.
• Anda tidak dapat menghapus database yang dilampirkan ke kluster lain sebelum melepaskannya.
• Anda tidak dapat menghapus kluster yang memiliki database yang dilampirkan ke kluster lain sebelum melepaskannya.
• Properti berbagi pada tingkat tabel tidak didukung saat menghubungkan semua database.

Langkah berikutnya

• Untuk informasi tentang konfigurasi kluster pengikut, lihat Perintah kontrol untuk mengelola kluster pengikut.