Azure Veri Gezgini kümesi ve veritabanı oluşturma

Azure Veri Gezgini uygulamalar, web siteleri, IoT cihazları ve daha fazlasından akışı yapılan büyük miktarda veri üzerinde gerçek zamanlı analiz yapmaya yönelik hızlı ve tam olarak yönetilen bir veri analizi hizmetidir. Azure Veri Gezgini'ni kullanmak için öncelikle bir küme ve bu kümenin içinde bir veya daha fazla veritabanı oluşturmanız gerekir. Ardından, bir veritabanına veri alabilir (yükleyebilir) ve bu veritabanına yönelik sorgular çalıştırabilirsiniz.

Bu makalede C#, Python, Go, Azure CLI, PowerShell veya Azure Resource Manager (ARM) şablonu kullanarak küme ve veritabanı oluşturmayı öğreneceksiniz. Azure portalını kullanarak küme ve veritabanı oluşturmayı öğrenmek için bkz . Hızlı Başlangıç: Azure Veri Gezgini kümesi ve veritabanı oluşturma.

Önkoşullar

Küme ve veritabanı oluşturma yöntemine göre önkoşullar:

Azure aboneliği. Ücretsiz bir Azure hesabı oluşturun.
Visual Studio 2022 Community Edition. Visual Studio kurulumu sırasında Azure geliştirmeyi açın.
Microsoft.Azure.Management.Kusto NuGet paketini yükleyin.
Kaynaklara erişebilen bir Azure AD uygulaması ve hizmet sorumlusu. Dizin (kiracı) Kimliği, Uygulama Kimliği ve İstemci Gizli Anahtarı'nı kaydedin.

Azure aboneliği. Ücretsiz bir Azure hesabı oluşturun.
Yerel ortamınıza herhangi bir şey yüklemek zorunda kalmadan bu makaledeki kodu çalıştırmak için Azure Cloud Shell'i kullanabilirsiniz.
Azure CLI'yı yerel olarak yükleyip kullanmayı seçerseniz Parametreleri yapılandırma makalesindeki adımları izleyin. Bu makale, Azure CLI sürüm 2.0.4 veya üzerini gerektirir. Sürümünüzü kontrol etmek için az --version komutunu çalıştırın. Yüklemeniz veya yükseltmeniz gerekiyorsa bkz. Azure CLI'yi yükleme.

CLI parametrelerini yapılandırma

Azure Cloud Shell'de komut çalıştırıyorsanız aşağıdaki adımlar gerekli değildir. CLI'yi yerel olarak çalıştırıyorsanız ortamı ayarlamak için şu adımları izleyin:

En son Kusto CLI sürümünü kullanmak için uzantıyı yükleyin:
```
az extension add -n kusto
```
Azure'da oturum açmak için aşağıdaki komutu çalıştırın:
```
az login
```
Kümenizin oluşturulmasını istediğiniz aboneliği ayarlayın. değerini, kullanmak istediğiniz Azure aboneliğinin adıyla değiştirin MyAzureSub :
```
az account set --subscription MyAzureSub
```
Kümenizin oluşturulmasını istediğiniz kaynak grubunu ayarlayın. değerini, kullanmak istediğiniz kaynak grubunun adıyla değiştirin testrg :
```
az group create --name testrg --location westus
```

Azure aboneliği. Ücretsiz bir Azure hesabı oluşturun.
Yerel ortamınıza herhangi bir şey yüklemek zorunda kalmadan bu makaledeki kodu çalıştırmak için Azure Cloud Shell'i kullanabilirsiniz.
PowerShell'i yerel olarak yükleyip kullanmayı seçerseniz Parametreleri yapılandırma makalesindeki adımları izleyin.

Parametreleri yapılandırma

Azure Cloud Shell'de komut çalıştırıyorsanız aşağıdaki adımlar gerekli değildir. CLI'yi yerel olarak çalıştırıyorsanız ortamı ayarlamak için şu adımları izleyin:

Azure'da oturum açmak için aşağıdaki komutu çalıştırın:
```
Connect-AzAccount
```

Kümenizin oluşturulmasını istediğiniz aboneliği ayarlayın:

 Set-AzContext -SubscriptionId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

Azure CLI'yi yerel olarak veya Azure Cloud Shell'de çalıştırırken modülü cihazınıza Az.Kusto yüklemeniz gerekir:
```
 Install-Module -Name Az.Kusto
```

Azure Veri Gezgini kümesi oluşturma

Bu bölüm, Azure Veri Gezgini kümesi oluşturma işleminde size yol gösterir. Kümeyi oluşturmak için tercih ettiğiniz yöntemin ilgili sekmesini seçin.

Aşağıdaki kodu kullanarak kümenizi oluşturun:

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 subscriptionId = "xxxxxxxx-xxxxx-xxxx-xxxx-xxxxxxxxx";
var authClient = ConfidentialClientApplicationBuilder.Create(clientId)
    .WithAuthority($"https://login.microsoftonline.com/{tenantId}")
    .WithClientSecret(clientSecret)
    .Build();
var result = authClient.AcquireTokenForClient(new[] { "https://management.core.windows.net/" }).ExecuteAsync().Result;
var credentials = new TokenCredentials(result.AccessToken, result.TokenType);
var kustoManagementClient = new KustoManagementClient(credentials) { SubscriptionId = subscriptionId };
var resourceGroupName = "testrg";
var clusterName = "mykustocluster";
var skuName = KustoSkuName.StandardE8adsV5;
var skuTier = KustoSkuTier.Standard;
var capacity = 5;
var clusterData = new Cluster(
    location: "Central US",
    sku: new AzureSku(skuName, skuTier, capacity)
);
await kustoManagementClient.Clusters.CreateOrUpdateAsync(resourceGroupName, clusterName, clusterData);

Ayar	Önerilen değer	Alan açıklaması
kümeAdı	mykustocluster	Kümenizin istenen adı.
SKU Adı	Standard_E8ads_v5	Kümeniz için kullanılacak SKU.
seviye	Standart	SKU katmanı.
kapasite	sayı	Kümenin örnek sayısı.
kaynakGrupAdı	testrg	Kümenin oluşturulacağı kaynak grubu adı.

Not

Küme oluşturma uzun süre çalışan bir işlem olduğundan, CreateOrUpdate yerine CreateOrUpdateAsync kullanılması kesinlikle önerilir.

Kümenizin başarıyla oluşturulup oluşturulmadığını denetlemek için aşağıdaki komutu çalıştırın:
```
clusterData = await kustoManagementClient.Clusters.GetAsync(resourceGroupName, clusterName);
```
Sonucun provisioningState içerdiğini doğrulayarak kümenin başarıyla oluşturulmasını Succeeded doğrulayın.

Aşağıdaki komutu kullanarak kümenizi oluşturun:

from azure.mgmt.kusto import KustoManagementClient
from azure.mgmt.kusto.models import Cluster, AzureSku
from azure.common.credentials import ServicePrincipalCredentials

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

location = 'Central US'
sku_name = 'Standard_E8ads_v5'
capacity = 5
tier = "Standard"
resource_group_name = 'testrg'
cluster_name = 'mykustocluster'
cluster = Cluster(location=location, sku=AzureSku(name=sku_name, capacity=capacity, tier=tier))

kusto_management_client = KustoManagementClient(credentials, subscription_id)

cluster_operations = kusto_management_client.clusters

poller = cluster_operations.begin_create_or_update(resource_group_name, cluster_name, cluster)
poller.wait()

Ayarlar	Önerilen değer	Alan açıklaması
cluster_adı	mykustocluster	Kümenizin istenen adı.
stok_birimi_adı	Standard_E8ads_v5	Kümeniz için kullanılacak SKU.
seviye	Standart	SKU (Stok Tutma Birimi) katmanı.
kapasite	sayı	Kümenin örnek sayısı.
kaynak_grup_adı	testrg	Kümenin oluşturulacağı kaynak grubu adı.

Not

Küme oluşturma işlemi uzun süre çalışan bir işlemdir. Yöntem begin_create_or_update bir LROPoller örneği döndürür. Daha fazla bilgi edinmek için bkz. LROPoller sınıfı .

Kümenizin başarıyla oluşturulup oluşturulmadığını denetlemek için aşağıdaki komutu çalıştırın:

cluster_operations.get(resource_group_name = resource_group_name, cluster_name= cluster_name, custom_headers=None, raw=False)

Sonucun provisioningState içerdiğini doğrulayarak kümenin başarıyla oluşturulmasını Succeeded doğrulayın.

Aşağıdaki kodda bir kümenin nasıl oluşturulacağı gösterilmektedir. Kod deposunu kopyalamak için bkz. Azure Go SDK kullanarak Azure Veri Gezgini kümesini yönetme.

Önkoşullardan hizmet sorumlusu bilgileri de dahil olmak üzere gerekli ortam değişkenlerini ayarlayın. Kümeyi oluşturmak istediğiniz abonelik kimliğinizi, kaynak grubunuzu ve bölgenizi girin.

export AZURE_CLIENT_ID="<enter service principal client ID>"
export AZURE_CLIENT_SECRET="<enter service principal client secret>"
export AZURE_TENANT_ID="<enter tenant ID>"

export SUBSCRIPTION="<enter subscription ID>"
export RESOURCE_GROUP="<enter resource group name>"
export LOCATION="<enter azure location e.g. Southeast Asia>"

export CLUSTER_NAME_PREFIX="<enter prefix (cluster name will be [prefix]-ADXTestCluster)>"
export DATABASE_NAME_PREFIX="<enter prefix (database name will be [prefix]-ADXTestDB)>"

İpucu

Azure CLI'yi yüklediyseniz ve kimlik doğrulama için yapılandırdıysanız, auth.NewAuthorizerFromCLIWithResource kullanın. Bu durumda hizmet sorumlusu oluşturmanız gerekmez.

Kümeyi oluşturmak için aşağıdaki kodu çalıştırın:

import (
 "context"
 "log"
 "os"
 "strconv"

 "github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
 "github.com/Azure/azure-sdk-for-go/sdk/azidentity"
 "github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/kusto/armkusto"
 "github.com/olekukonko/tablewriter"
)

const (
 subscriptionEnvVar      = "AZURE_SUBSCRIPTION_ID"
 resourceGroupEnvVar     = "AZURE_RESOURCE_GROUP"
 locationEnvVar          = "AZURE_LOCATION"
 clusterNamePrefixEnvVar = "CLUSTER_NAME_PREFIX"
 dbNamePrefixEnvVar      = "DATABASE_NAME_PREFIX"

 clusterName  = "ADXTestCluster"
 databaseName = "ADXTestDB"
)

func init() {
 subscription = os.Getenv(subscriptionEnvVar)
 if subscription == "" {
  log.Fatalf("missing environment variable %s", subscriptionEnvVar)
 }

 rgName = os.Getenv(resourceGroupEnvVar)
 if rgName == "" {
  log.Fatalf("missing environment variable %s", resourceGroupEnvVar)
 }

 location = os.Getenv(locationEnvVar)
 if location == "" {
  log.Fatalf("missing environment variable %s", locationEnvVar)
 }

 clusterNamePrefix = os.Getenv(clusterNamePrefixEnvVar)
 if clusterNamePrefix == "" {
  log.Fatalf("missing environment variable %s", clusterNamePrefixEnvVar)
 }

 dbNamePrefix = os.Getenv(dbNamePrefixEnvVar)
 if dbNamePrefix == "" {
  log.Fatalf("missing environment variable %s", dbNamePrefixEnvVar)
 }
}

func getClustersClient(subscription string) *armkusto.ClustersClient {
 cred, err := azidentity.NewDefaultAzureCredential(nil)
 if err != nil {
  log.Fatal(err)
 }

 client, err := armkusto.NewClustersClient(subscription, cred, nil)
 if err != nil {
  log.Fatal(err)
 }

 return client
}

// 1 instance, Basic tier with compute type Dev(No SLA)_Standard_D11_v2
func createCluster(sub, name, location, rgName string) {
 ctx := context.Background()

 numInstances := int32(1)
 client := getClustersClient(sub)
 result, err := client.BeginCreateOrUpdate(
  ctx,
  rgName,
  name,
  armkusto.Cluster{
   Location: &location,
   SKU: &armkusto.AzureSKU{
    Name:     to.Ptr(armkusto.AzureSKUNameDevNoSLAStandardD11V2),
    Capacity: &numInstances,
    Tier:     to.Ptr(armkusto.AzureSKUTierBasic),
   },
  },
  nil,
 )
 if err != nil {
  log.Fatal("failed to start cluster creation ", err)
 }

 log.Printf("waiting for cluster creation to complete - %s\n", name)
 r, err := result.PollUntilDone(ctx, nil)
 if err != nil {
  log.Fatal(err)
 }

 log.Printf("created cluster %s\n", *r.Name)
}

createCluster(subscription, clusterNamePrefix+clusterName, location, rgName)

Başarıyla oluşturulduğundan emin olmak için kümeleri listeleyin:

func listClusters(sub, rgName string) {
 log.Printf("listing clusters in resource group %s\n", rgName)
 ctx := context.Background()

 result := getClustersClient(sub).NewListByResourceGroupPager(rgName, nil)

 data := [][]string{}

 for result.More() {
  temp, err := result.NextPage(ctx)
  if err != nil {
   log.Fatal(err)
  }
  for _, c := range temp.Value {
   data = append(data, []string{*c.Name, string(*c.Properties.State), *c.Location, strconv.Itoa(int(*c.SKU.Capacity)), *c.Properties.URI})
  }
 }

 table := tablewriter.NewWriter(os.Stdout)
 table.SetHeader([]string{"Name", "State", "Location", "Instances", "URI"})

 for _, v := range data {
  table.Append(v)
 }
 table.Render()
}

listClusters(subscription, rgName)

Aşağıdaki komutu kullanarak kümenizi oluşturun:

az kusto cluster create --cluster-name azureclitest --sku name="Standard_E8ads_v5" tier="Standard" --resource-group testrg --location westus

Ayar	Önerilen değer	Alan açıklaması
Adı	azureclitest	Kümenizin istenen adı.
sku	Standard_E8ads_v5	Kümeniz için kullanılacak SKU. Parametreler: name - SKU adı. tier - SKU katmanı.
kaynak grubu	testrg	Kümenin oluşturulacağı kaynak grubu adı.
konum	westus	Kümenin oluşturulacağı konum.

Kümenin kapasitesi gibi kullanabileceğiniz başka isteğe bağlı parametreler de vardır.

Kümenizin başarıyla oluşturulup oluşturulmadığını denetlemek için aşağıdaki komutu çalıştırın:
```
az kusto cluster show --cluster-name azureclitest --resource-group testrg
```
Sonucun provisioningState içerdiğini doğrulayarak kümenin başarıyla oluşturulmasını Succeeded doğrulayın.

Aşağıdaki komutu kullanarak kümenizi oluşturun:

 New-AzKustoCluster -ResourceGroupName testrg -Name mykustocluster -Location westus2 -SkuTier Standard -SkuCapacity 2 -SkuName 'Standard_E8ads_v5'

Ayar	Önerilen değer	Alan açıklaması
İsim	mykustocluster	Kümenizin istenen adı.
Sku	Standard_E8ads_v5	Kümeniz için kullanılacak SKU.
KaynakGrupAdı	testrg	Kümenin oluşturulacağı kaynak grubu adı.

Kümenin kapasitesi gibi kullanabileceğiniz başka isteğe bağlı parametreler de vardır.

Kümenizin başarıyla oluşturulup oluşturulmadığını denetlemek için aşağıdaki komutu çalıştırın:
```
Get-AzKustoCluster -Name mykustocluster -ResourceGroupName testrg
```
Sonucun provisioningState içerdiğini doğrulayarak kümenin başarıyla oluşturulmasını Succeeded doğrulayın.

Aşağıdaki ARM şablonunu PowerShell kullanarak dağıtmayı öğrenmek için bkz. ARM şablonunu kullanma. Alternatif olarak, Azure portalında Azure'adağıt'ı seçerek şablonu dağıtabilirsiniz.

ARM şablonu

Bu şablonu kendi dağıtımlarınız için kullanabilir veya kendi gereksinimlerinize göre özelleştirebilirsiniz. Şablonda kullanılacak JSON söz dizimi ve özellikleri için bkz. Microsoft.Kusto kaynak türleri.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "clusters_kustocluster_name": {
            "type": "string",
            "defaultValue": "[concat('kusto', uniqueString(resourceGroup().id))]",
            "metadata": {
                "description": "Name of the cluster to create"
            }
        },
        "databases_kustodb_name": {
            "type": "string",
            "defaultValue": "kustodb",
            "metadata": {
                "description": "Name of the database to create"
            }
        },
        "location": {
            "type": "string",
            "defaultValue": "[resourceGroup().location]",
            "metadata": {
                "description": "Location for all resources."
            }
        }
    },
    "variables": {},
    "resources": [
        {
            "name": "[parameters('clusters_kustocluster_name')]",
            "type": "Microsoft.Kusto/clusters",
            "sku": {
                "name": "Standard_E8ads_v5",
                "tier": "Standard",
                "capacity": 2
            },
            "apiVersion": "2022-12-29",
            "location": "[parameters('location')]",
            "tags": {
                "Created By": "GitHub quickstart template"
            },
            "properties": {
                "trustedExternalTenants": [],
                "optimizedAutoscale": {
                    "version": 1,
                    "isEnabled": true,
                    "minimum": 2,
                    "maximum": 10
                },
                "enableDiskEncryption": false,
                "enableStreamingIngest": false,
                "virtualNetworkConfiguration": {
                    "subnetId": "<subnet resource id>",
                    "enginePublicIpId": "<Engine service's public IP address resource id>",
                    "dataManagementPublicIpId": "<Data management's service public IP address resource id>"
                },
                "keyVaultProperties": {
                    "keyName": "<Key name>",
                    "keyVaultUri": "<Key vault uri>",
                    "userIdentity": "<ResourceId of user assigned managed identity>"
                },
                "enablePurge": false,
                "enableDoubleEncryption": false,
                "engineType": "V3"
            },
            "identity": {
                "type": "SystemAssigned, UserAssigned",
                "userAssignedIdentities": {
                    "<ResourceId of managed identity>": {}
                }
            }
        },
        {
            "name": "[concat(parameters('clusters_kustocluster_name'), '/', parameters('databases_kustodb_name'))]",
            "type": "Microsoft.Kusto/clusters/databases",
            "apiVersion": "2022-12-29",
            "location": "[parameters('location')]",
            "dependsOn": [
                "[resourceId('Microsoft.Kusto/clusters', parameters('clusters_kustocluster_name'))]"
            ],
            "properties": {
                "softDeletePeriodInDays": 365,
                "hotCachePeriodInDays": 31
            }
        }
    ]
}

ARM şablonunu kullanma

Aşağıdaki adımlarda PowerShell kullanarak ARM şablonunun nasıl dağıtılacağı açıklanmaktadır.

Azure Cloud Shell'i açın ve oturum açmak için yönergeleri izleyin.

PowerShell betiğini kopyalamak için Kopyala'yı seçin.

$projectName = Read-Host -Prompt "Enter a project name that is used for generating resource names"
$location = Read-Host -Prompt "Enter the location (i.e. centralus)"
$resourceGroupName = "${projectName}rg"
$clusterName = "${projectName}cluster"
$parameters = @{}
$parameters.Add("clusters_kustocluster_name", $clusterName)
$templateUri = "https://azure.microsoft.com/resources/templates/kusto-cluster-database/"
New-AzResourceGroup -Name $resourceGroupName -Location $location
New-AzResourceGroupDeployment -ResourceGroupName $resourceGroupName -TemplateUri $templateUri -TemplateParameterObject $parameters
Write-Host "Press [ENTER] to continue ..."

Kabuk konsoluna sağ tıklayın ve Yapıştır'ı seçin.

Not

Azure Veri Gezgini kümesi ve veritabanı oluşturmak birkaç dakika sürer.

Dağıtımı doğrulamak için aşağıdaki Azure PowerShell betiğini kullanın. Cloud Shell hala açıksa, ilk satırı (Read-Host) kopyalamanıza veya çalıştırmanıza gerek yok.

$projectName = Read-Host -Prompt "Enter the same project name that you used in the last procedure"

Install-Module -Name Az.Kusto
$resourceGroupName = "${projectName}rg"
$clusterName = "${projectName}cluster"

Get-AzKustoCluster -ResourceGroupName $resourceGroupName -Name $clusterName
Write-Host "Press [ENTER] to continue ..."

Azure Veri Gezgini veritabanı oluşturma

Bu bölümde, önceki bölümde oluşturulan küme içinde bir veritabanı oluşturacaksınız.

Aşağıdaki kodu kullanarak veritabanınızı oluşturun:

var databaseName = "mykustodatabase";
var softDeletePeriod = TimeSpan.FromDays(3650);
var hotCachePeriod = TimeSpan.FromDays(3650);
var databaseData = new ReadWriteDatabase(
    location: clusterData.Location, softDeletePeriod: softDeletePeriod, hotCachePeriod: hotCachePeriod
);
await kustoManagementClient.Databases.CreateOrUpdateAsync(resourceGroupName, clusterName, databaseName, databaseData);

Not

C# sürüm 2.0.0 veya üzerini kullanıyorsanız ReadWriteDatabase yerine Veritabanı'nı kullanın.

Ayarlar	Önerilen değer	Alan açıklaması
kümeAdı	mykustocluster	Veritabanının oluşturulacağı kümenizin adı.
veritabanıAdı	mykustodatabase	Veritabanınızın adı.
kaynakGrupAdı	testrg	Kümenin oluşturulacağı kaynak grubu adı.
yumuşak silme dönemi	3650:00:00:00	Verilerin sorgulanabilir durumda tutulacağı süre.
hotCachePeriod	3650:00:00:00	Verilerin önbellekte tutulacağı süre.

Oluşturduğunuz veritabanını görmek için aşağıdaki komutu çalıştırın:

databaseData = await kustoManagementClient.Databases.GetAsync(resourceGroupName, clusterName, databaseName) as ReadWriteDatabase;

Aşağıdaki komutu kullanarak veritabanınızı oluşturun:

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

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

location = 'Central US'
resource_group_name = 'testrg'
cluster_name = 'mykustocluster'
soft_delete_period = timedelta(days=3650)
hot_cache_period = timedelta(days=3650)
database_name = "mykustodatabase"

kusto_management_client = KustoManagementClient(credentials, subscription_id)

database_operations = kusto_management_client.databases
database = ReadWriteDatabase(location=location,
      soft_delete_period=soft_delete_period,
      hot_cache_period=hot_cache_period)

poller = database_operations.begin_create_or_update(resource_group_name = resource_group_name, cluster_name = cluster_name, database_name = database_name, parameters = database)
poller.wait()

Not

Python sürüm 0.4.0 veya üzerini kullanıyorsanız ReadWriteDatabase yerine Veritabanı'nı kullanın.

Ayarlar	Önerilen değer	Alan açıklaması
cluster_adı	mykustocluster	Veritabanının oluşturulacağı kümenizin adı.
veritabanı_adı	mykustodatabase	Veritabanınızın adı.
kaynak_grup_adı	testrg	Kümenin oluşturulacağı kaynak grubu adı.
yumuşak_silme_süresi	3650 gün, 0:00:00	Verilerin sorgulanabilir durumda tutulacağı süre.
sıcak önbellek dönemi	3650 gün, 0:00:00	Verilerin önbellekte tutulacağı süre.

Oluşturduğunuz veritabanını görmek için aşağıdaki komutu çalıştırın:

database_operations.get(resource_group_name = resource_group_name, cluster_name = cluster_name, database_name = database_name)

Aşağıdaki kodda veritabanı oluşturma gösterilmektedir. Paket içeri aktarmaları ve ortam değişkeni başlatma işlemi önceki bölümdekiyle aynıdır. Kod deposunu kopyalamak için bkz. Azure Go SDK kullanarak Azure Veri Gezgini kümesini yönetme.

Veritabanını oluşturmak için aşağıdaki kodu çalıştırın:

func createDatabase(sub, rgName, clusterName, location, dbName string) {
 ctx := context.Background()

 client := getDBClient(sub)
 future, err := client.BeginCreateOrUpdate(ctx, rgName, clusterName, dbName, &armkusto.ReadWriteDatabase{Kind: to.Ptr(armkusto.KindReadWrite), Location: &location}, nil)

 if err != nil {
  log.Fatal("failed to start database creation ", err)
 }

 log.Printf("waiting for database creation to complete - %s\n", dbName)
 resp, err := future.PollUntilDone(ctx, nil)
 if err != nil {
  log.Fatal(err)
 }

 kdb := resp.GetDatabase()
 log.Printf("created DB %s with ID %s and type %s\n", *kdb.Name, *kdb.ID, *kdb.Type)
}

createDatabase(subscription, rgName, clusterNamePrefix+clusterName, location, dbNamePrefix+databaseName)

Başarıyla oluşturulduğundan emin olmak için veritabanlarını listeleyin:

func listDatabases(sub, rgName, clusterName string) {
 log.Printf("listing databases in cluster %s\n", clusterName)

 ctx := context.Background()
 result := getDBClient(sub).NewListByClusterPager(rgName, clusterName, nil)

 data := [][]string{}

 for result.More() {
  temp, err := result.NextPage(ctx)
  if err != nil {
   log.Fatal(err)
  }
  for _, db := range temp.Value {
   if *db.GetDatabase().Kind == armkusto.KindReadWrite {
    data = append(data, []string{*db.GetDatabase().Name, string(*db.GetDatabase().Kind), *db.GetDatabase().Location, *db.GetDatabase().Type})
   }
  }
 }

 table := tablewriter.NewWriter(os.Stdout)
 table.SetHeader([]string{"Name", "State", "Location", "Type"})

 for _, v := range data {
  table.Append(v)
 }
 table.Render()
}

listDatabases(subscription, rgName, clusterNamePrefix+clusterName)

Aşağıdaki komutu kullanarak veritabanınızı oluşturun:

az kusto database create --cluster-name azureclitest --database-name clidatabase --resource-group testrg --read-write-database soft-delete-period=P365D hot-cache-period=P31D location=westus

Ayarlar	Önerilen değer	Alan açıklaması
küme adı	azureclitest	Veritabanının oluşturulacağı kümenizin adı.
veritabanı adı	clidatabase	Veritabanınızın adı.
kaynak grubu	testrg	Kümenin oluşturulacağı kaynak grubu adı.
okuma-yazma-veritabanı	P365DP31Dwestus	Veritabanı türü. Parametreler: geçici silme dönemi - Verilerin sorgulanabilir durumda tutulacağı süreyi belirtir. Daha fazla bilgi için bkz. bekletme ilkesi . hot-cache-period - Verilerin önbellekte tutulacağı süreyi belirtir. Daha fazla bilgi için bkz. önbellek ilkesi . konumu -The veritabanının oluşturulacağı konum.

Oluşturduğunuz veritabanını görmek için aşağıdaki komutu çalıştırın:

az kusto database show --database-name clidatabase --resource-group testrg --cluster-name azureclitest

Aşağıdaki komutu kullanarak veritabanınızı oluşturun:

New-AzKustoDatabase -ResourceGroupName testrg -ClusterName mykustocluster -Name mykustodatabase -SoftDeletePeriod 3650:00:00:00 -HotCachePeriod 3650:00:00:00

Ayarlama	Önerilen değer	Alan açıklaması
Küme Adı	mykustocluster	Veritabanının oluşturulacağı kümenizin adı.
İsim	mykustodatabase	Veritabanınızın adı.
KaynakGrupAdı	testrg	Kümenin oluşturulacağı kaynak grubu adı.
Yumuşak Silme Süresi	3650:00:00:00	Verilerin sorgulanabilir durumda tutulacağı süre.
Sıcak Önbellek Süresi	3650:00:00:00	Verilerin önbellekte tutulacağı süre.

Oluşturduğunuz veritabanını görmek için aşağıdaki komutu çalıştırın:

Get-AzKustoDatabase -ClusterName mykustocluster -ResourceGroupName testrg -Name mykustodatabase

Sonraki adımlar

Last updated on 2023-05-08

Aracılığıyla paylaş

Azure Veri Gezgini kümesi ve veritabanı oluşturma

Önkoşullar

Azure Veri Gezgini kümesi oluşturma

Azure Veri Gezgini veritabanı oluşturma

Sonraki adımlar

Ek kaynaklar