Menggunakan database pengikut

Fitur follower memungkinkan Anda melampirkan database yang terletak di kluster yang berbeda ke kluster Azure Data Explorer Anda. Database pengikut dilampirkan dalam mode baca-saja, memungkinkan melihat data dan menjalankan kueri pada data yang telah dimasukkan 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. Database utama mengelola penyimpanan. 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 caching, pengguna, dan izin. Database terlampir tidak dapat dihapus. Pemimpin atau pengikut harus melepaskan database sebelum penghapusan.

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 (Follower) juga dapat digunakan untuk mengaitkan biaya kluster Azure Data Explorer kepada pihak yang menjalankan kueri pada data.

Catatan

Untuk sampel kode berdasarkan versi SDK sebelumnya, lihat artikel yang diarsipkan.

Database mana yang diikuti?

Berikut ini berlaku untuk kluster:

• 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.

Prasyarat

• Langganan Azure. Buat akun free Azure.
• 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. Tambahkan atau hapus penetapan peran menggunakan portal Azure, PowerShell, Azure CLI, dan templat ARM. Pelajari selengkapnya tentang kontrol akses berbasis peran Azure (Azure RBAC) dan berbagai peran.

Catatan

Membuat database pengikut sebelumnya tidak diperlukan karena database dibuat selama proses lampiran.

Berbagi akses tingkat tabel

Saat Anda melampirkan database, semua tabel, tabel eksternal, dan tampilan materialisasi ikut terlampir. 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.

Catatan

• Berbagi tingkat tabel tidak didukung saat menggunakan notasi '*' untuk semua database.
• Saat tampilan materialisasi disertakan, tabel sumbernya juga disertakan.

Contoh

Contoh berikut mencakup semua tabel. Secara default, semua tabel diikuti tanpa menggunakan notasi '*':

tablesToInclude = []

Contoh berikut mencakup semua fungsi. Secara default, semua fungsi diikuti tanpa menggunakan notasi '*':

functionsToInclude = []

Contoh berikut mencakup semua tabel dengan nama yang dimulai dengan "Log":

tablesToInclude = ["Logs*"]

Contoh berikut mencakup semua tabel eksternal:

externalTablesToExclude = ["*"]

Contoh berikut mencakup 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 Azure. ResourceManager.Kusto.
• Instal Azure. Identitas untuk autentikasi.

Contoh C#

var followerClusterId = KustoClusterResource.CreateResourceIdentifier(subscriptionId: "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx", resourceGroupName: "followerResourceGroup", clusterName: "follower");
var leaderClusterId = KustoClusterResource.CreateResourceIdentifier(subscriptionId: "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx", resourceGroupName: "leaderResourceGroup", clusterName: "leader");
var attachedDatabaseConfigurationName = "attachedDatabaseConfiguration";

var credentials = new ManagedIdentityCredential();
var resourceManagementClient = new ArmClient(credentials);
var followerCluster = resourceManagementClient.GetKustoClusterResource(followerClusterId);
var attachedDatabaseConfigurations = followerCluster.GetKustoAttachedDatabaseConfigurations();
var attachedDatabaseConfigurationData = new KustoAttachedDatabaseConfigurationData
{
    ClusterResourceId = leaderClusterId,
    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

Melampirkan database menggunakan Python

Modul prasyarat

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

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

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

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	Keterangan	Contoh
   followerClusterName	Nama kluster pengikut tempat templat diterapkan.
   NamaKonfigurasiDatabaseTerlampir	Nama objek konfigurasi database terlampir. Nama dapat berupa string apa pun yang unik di tingkat kluster.
   databaseName	Nama database yang akan diikuti. Untuk mengikuti semua basis data milik pemimpin, gunakan '*'.
   leaderClusterResourceId	ID sumber daya kluster pemimpin.
   defaultPrincipalsModificationKind	Jenis modifikasi prioritas default.	Bisa Union, Replace, atau None. Untuk informasi selengkapnya tentang jenis modifikasi utama default, lihat perintah manajemen 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 'Logs', gunakan ["Logs*"].	["Mv1ToInclude", "Mv2ToInclude"]
   materializedViewsUntukDikecualikan	Daftar tampilan materialisasi yang akan dikecualikan. Untuk mengecualikan semua tampilan materialisasi, gunakan ["*"].	["Mv11ToExclude", "Mv22ToExclude"]
   fungsiUntukDimasukkan	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 Azure atau PowerShell.

   

Verifikasi bahwa database berhasil dilampirkan

Untuk memverifikasi bahwa database berhasil dilampirkan, temukan database terlampir Anda di portal 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 database baca-saja 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 relasi untuk melihat detail.

   

   Anda juga bisa menampilkan ini di halaman gambaran umum database:

   

Melepas database pengikut

Catatan

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 melepaskan database pengikut yang terlampir sebagai berikut:

var attachedDatabaseConfigurationId = KustoAttachedDatabaseConfigurationResource.CreateResourceIdentifier(
    subscriptionId: "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx", resourceGroupName: "testrg", clusterName: "follower",
    attachedDatabaseConfigurationName: "attachedDatabaseConfiguration");
var credentials = new ManagedIdentityCredential();
var resourceManagementClient = new ArmClient(credentials);
var attachedDatabaseConfiguration = resourceManagementClient.GetKustoAttachedDatabaseConfigurationResource(attachedDatabaseConfigurationId);
await attachedDatabaseConfiguration.DeleteAsync(WaitUntil.Completed);

Lepaskan database pengikut terlampir dari kluster pemimpin menggunakan C#

Kluster pemimpin dapat melepaskan database terlampir apa pun sebagai berikut:

var leaderClusterId = KustoClusterResource.CreateResourceIdentifier(subscriptionId: "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx", resourceGroupName: "testrg", clusterName: "leader");
var followerClusterId = KustoClusterResource.CreateResourceIdentifier(subscriptionId: "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx", resourceGroupName: "followerResourceGroup", clusterName: "follower");
var followerDatabaseDefinition = new KustoFollowerDatabaseDefinition(
    clusterResourceId: followerClusterId,
    attachedDatabaseConfigurationName: "attachedDatabaseConfiguration"
);
var credentials = new ManagedIdentityCredential();
var resourceManagementClient = new ArmClient(credentials);
var leaderCluster = resourceManagementClient.GetKustoClusterResource(leaderClusterId);
await leaderCluster.DetachFollowerDatabasesAsync(WaitUntil.Completed, 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

Resource Manager

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

Mengelola pengguna, izin, dan kebijakan cache

Mengelola prinsipal

Saat melampirkan database, tentukan "jenis modifikasi prinsipal default". Defaultnya adalah menggabungkan prinsipal berwenang yang di-override dengan kumpulan prinsipal berwenang dari database pemimpin

Jenis	Keterangan
Union	Prinsipal database terlampir akan selalu menyertakan prinsipal database asli ditambah prinsipal baru lainnya yang ditambahkan ke database pengikut.
Menggantikan	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 manajemen untuk mengonfigurasi prinsipal yang diotorisasi, lihat Perintah manajemen untuk mengelola kluster pengikut.

Kelola izin

Mengelola izin database baca-saja sama dengan untuk semua jenis database. Untuk menetapkan izin, lihat Kelola izin database di portal Azure atau gunakan perintah manajemen untuk Kelola peran keamanan database.

Mengonfigurasi kebijakan cache

Administrator database pengikut dapat mengubah kebijakan caching dari database terlampir atau tabel-tabelnya di kluster hosting. Nilai default adalah menggabungkan database sumber dalam database kluster utama dan kebijakan caching tingkat tabel dengan kebijakan yang ditentukan dalam kebijakan penggantian tingkat database dan tabel. Anda dapat, misalnya, memiliki kebijakan cache 30 hari pada database leader untuk menjalankan pelaporan bulanan dan kebijakan cache tiga hari pada database follower untuk melakukan query hanya pada data terbaru untuk pemecahan masalah. Untuk informasi selengkapnya tentang menggunakan perintah manajemen untuk mengonfigurasi kebijakan cache pada tabel atau database pengikut, lihat Perintah manajemen untuk mengelola kluster pengikut.

Catatan

Tinjau catatan berikut:

• 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 pengikut dapat menyertakan database pemimpin DB.
  • 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 menunjukkan aktivitas dan riwayat pada kluster pengikut, dan kumpulan hasil ini tidak menyertakan hasil dari kluster pemimpin atau kluster lainnya.
  • Misalnya: perintah yang .show queries dijalankan pada kluster pengikut hanya menunjukkan kueri yang dijalankan di database dalam kluster pengikut, dan bukan kueri yang dijalankan di database yang sama di kluster utama.

Batasan

Tinjau batasan berikut:

• Pengikut dan kluster pemimpin harus berada di wilayah yang sama.
• Jika Ingestion Streaming digunakan pada database yang sedang diikuti, kluster pengikut harus diaktifkan untuk Ingestion Streaming agar memungkinkan pengikut mengikuti data ingestion streaming.
• Mengikuti kluster dengan enkripsi data menggunakan kunci yang dikelola pelanggan (CMK) didukung dengan batasan berikut:
  • Kluster pengikut atau kluster pemimpin tidak mengikuti kluster lain.
  • Jika kluster pengikut mengikuti kluster pemimpin dengan CMK yang diaktifkan, dan akses kluster pemimpin ke kunci dicabut, maka baik kluster pemimpin maupun kluster pengikut akan ditangguhkan. Dalam situasi ini, Anda dapat menyelesaikan masalah CMK dan kemudian melanjutkan node pengikut, atau Anda dapat melepaskan database pengikut dari node pengikut dan melanjutkan terpisah dari node pemimpin.
• 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 tingkat tabel tidak didukung saat mengikuti semua database.
• Dalam database pengikut, untuk mengkueri tabel eksternal yang menggunakan Identitas Terkelola sebagai metode autentikasi, Identitas Terkelola harus ditambahkan ke kluster pengikut. Kemampuan ini tidak berfungsi ketika kluster pemimpin dan pengikut disediakan di penyewa yang berbeda.
• Anda tidak dapat menyimpan hasil kueri dalam database yang diikuti baca-saja.

Langkah selanjutnya

Jalankan perintah pengikut