Microsoft.Kusto Cluster/Datenbanken 2025-02-14

Bicep-Ressourcendefinition

Der Cluster-/Datenbankressourcentyp kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.Kusto/clusters/databases-Ressource zu erstellen, fügen Sie Der Vorlage den folgenden Bicep hinzu.

resource symbolicname 'Microsoft.Kusto/clusters/databases@2025-02-14' = {
  location: 'string'
  name: 'string'
  kind: 'string'
  // For remaining properties, see Microsoft.Kusto/clusters/databases objects
}

Microsoft.Kusto/clusters/databases-Objekte

Legen Sie die kind-Eigenschaft fest, um den Typ des Objekts anzugeben.

Verwenden Sie für ReadOnlyFollowing:

{
  kind: 'ReadOnlyFollowing'
  properties: {
    hotCachePeriod: 'string'
  }
}

Verwenden Sie für ReadWrite-:

{
  kind: 'ReadWrite'
  properties: {
    hotCachePeriod: 'string'
    keyVaultProperties: {
      federatedIdentityClientId: 'string'
      keyName: 'string'
      keyVaultUri: 'string'
      keyVersion: 'string'
      userIdentity: 'string'
    }
    softDeletePeriod: 'string'
  }
}

Eigenschaftswerte

Microsoft.Kusto/clusters/databases

Name Beschreibung Wert
freundlich Legen Sie für den Typ ReadOnlyFollowingDatabaseauf "ReadOnlyFollowingDatabase" fest. Legen Sie den Wert auf 'ReadWrite' für den Typ ReadWriteDatabase fest. "ReadOnlyFollowing"
'ReadWrite' (erforderlich)
location Ressourcenspeicherort. Schnur
Name Der Ressourcenname string

Zwänge:
Pattern = ^.*$ (erforderlich)
parent In Bicep können Sie die übergeordnete Ressource für eine untergeordnete Ressource angeben. Sie müssen diese Eigenschaft nur hinzufügen, wenn die untergeordnete Ressource außerhalb der übergeordneten Ressource deklariert wird.

Weitere Informationen finden Sie unter Untergeordnete Ressource außerhalb der übergeordneten Ressource.
Symbolischer Name für Die Ressource des Typs: Cluster

KeyVault-Eigenschaften

Name Beschreibung Wert
federatedIdentityClientId Die Anwendungs-(Client-)ID der Multi-Tenant-Microsoft Entra-Anwendung. Verwendet für Szenarien mit kundenverwalteten Schlüsseln über verschiedene Mieter, bei denen der Verschlüsselungsschlüssel in einem anderen Tenant als der Cluster gespeichert wird. Die Anwendung muss mit der vom Benutzer zugewiesenen verwalteten Identität als föderierten Identitätszugangsnachweis konfiguriert sein. Schnur
Schlüsselname Der Name des Schlüsseltresorschlüssels. Schnur
keyVaultUri Der URI des Schlüsseltresors. Schnur
Schlüsselversion Die Version des Schlüsseltresorschlüssels. Schnur
BenutzerIdentität Die vom Benutzer zugewiesene Identität (ARM-Ressourcen-ID), die Zugriff auf den Schlüssel hat. Die Identität muss die Berechtigungen 'Get', 'Wrap Key' und 'Unwrap Key' auf dem Key Vault Key Key haben oder die Rolle 'Key Vault Crypto Service Encryption User' zugewiesen werden. Schnur

ReadOnlyFollowingDatabase

Name Beschreibung Wert
freundlich Art der Datenbank "ReadOnlyFollowing" (erforderlich)
properties Die Datenbankeigenschaften. ReadOnlyFollowingDatabaseProperties

ReadOnlyFollowingDatabaseProperties

Name Beschreibung Wert
hotCachePeriod Die Zeit, zu der die Daten im Cache für schnelle Abfragen in TimeSpan gespeichert werden sollen. Schnur

ReadWriteDatabase (Englisch)

Name Beschreibung Wert
freundlich Art der Datenbank 'ReadWrite' (erforderlich)
properties Die Datenbankeigenschaften. ReadWriteDatabase-Eigenschaften

ReadWriteDatabase-Eigenschaften

Name Beschreibung Wert
hotCachePeriod Die Zeit, zu der die Daten im Cache für schnelle Abfragen in TimeSpan gespeichert werden sollen. Schnur
keyVault-Eigenschaften KeyVault-Eigenschaften für die Datenbankverschlüsselung. KeyVault-Eigenschaften
Zeitraum für weiche Löschung Die Zeit, zu der die Daten aufbewahrt werden sollen, bevor der Zugriff auf Abfragen in TimeSpan beendet wird. Schnur

Verwendungsbeispiele

Beispiele für Bicep

Ein grundlegendes Beispiel für die Bereitstellung von Kusto/Data Explorer-Datenbanken.

param resourceName string = 'acctest0001'
param location string = 'westeurope'

resource cluster 'Microsoft.Kusto/clusters@2023-05-02' = {
  name: resourceName
  location: location
  properties: {
    enableAutoStop: true
    enableDiskEncryption: false
    enableDoubleEncryption: false
    enablePurge: false
    enableStreamingIngest: false
    engineType: 'V2'
    publicIPType: 'IPv4'
    publicNetworkAccess: 'Enabled'
    restrictOutboundNetworkAccess: 'Disabled'
    trustedExternalTenants: []
  }
  sku: {
    capacity: 1
    name: 'Dev(No SLA)_Standard_D11_v2'
    tier: 'Basic'
  }
}

resource database 'Microsoft.Kusto/clusters/databases@2023-05-02' = {
  parent: cluster
  name: resourceName
  location: location
  kind: 'ReadWrite'
  properties: {}
}

Azure-Schnellstartbeispiele

Die folgenden Azure-Schnellstartvorlagen Bicep-Beispiele für die Bereitstellung dieses Ressourcentyps enthalten.

Bicep-Datei Beschreibung
Azure Digital Twins mit Zeitdatenverlaufsverbindung Diese Vorlage erstellt eine Azure Digital Twins-Instanz, die mit einer Zeitreihen-Datenverlaufsverbindung konfiguriert ist. Um eine Verbindung zu erstellen, müssen andere Ressourcen erstellt werden, z. B. einen Event Hubs-Namespace, einen Event Hub, einen Azure Data Explorer-Cluster und eine Datenbank. Daten werden an einen Event Hub gesendet, der die Daten schließlich an den Azure Data Explorer-Cluster weiterleitet. Daten werden in einer Datenbanktabelle im Cluster gespeichert.
Erstellen einer Datenbanküberwachungs- In diesem Beispiel wird eine Datenbanküberwachung für Azure SQL erstellt und deren Datenspeicher, SQL-Ziele und verwaltete private Endpunkte konfiguriert.
Bereitstellen Sie Azure Data Explorer Datenbank mit Cosmos-DB-Verbindung Bereite die Azure Data Explorer Datenbank mit Cosmos DB-Verbindung bereit.
Bereitstellen von Azure Data Explorer db mit Ereignisrasterverbindung Bereitstellen von Azure Data Explorer db mit Event Grid-Verbindung.
Bereitstellen von Azure Data Explorer db mit Event Hub-Verbindung Bereitstellen von Azure Data Explorer db mit Event Hub-Verbindung.
FinOps-Hub Diese Vorlage erstellt eine neue FinOps-Hubinstanz, einschließlich Data Explorer, Data Lake Storage und Data Factory.

ARM-Vorlagenressourcendefinition

Der Cluster-/Datenbankressourcentyp kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.Kusto/clusters/databases-Ressource zu erstellen, fügen Sie Der Vorlage den folgenden JSON-Code hinzu.

{
  "location": "string",
  "name": "string",
  "kind": "string"
  // For remaining properties, see Microsoft.Kusto/clusters/databases objects
}

Microsoft.Kusto/clusters/databases-Objekte

Legen Sie die kind-Eigenschaft fest, um den Typ des Objekts anzugeben.

Verwenden Sie für ReadOnlyFollowing:

{
  "kind": "ReadOnlyFollowing",
  "properties": {
    "hotCachePeriod": "string"
  }
}

Verwenden Sie für ReadWrite-:

{
  "kind": "ReadWrite",
  "properties": {
    "hotCachePeriod": "string",
    "keyVaultProperties": {
      "federatedIdentityClientId": "string",
      "keyName": "string",
      "keyVaultUri": "string",
      "keyVersion": "string",
      "userIdentity": "string"
    },
    "softDeletePeriod": "string"
  }
}

Eigenschaftswerte

Microsoft.Kusto/clusters/databases

Name Beschreibung Wert
apiVersion Die API-Version '2025-02-14'
freundlich Legen Sie für den Typ ReadOnlyFollowingDatabaseauf "ReadOnlyFollowingDatabase" fest. Legen Sie den Wert auf 'ReadWrite' für den Typ ReadWriteDatabase fest. "ReadOnlyFollowing"
'ReadWrite' (erforderlich)
location Ressourcenspeicherort. Schnur
Name Der Ressourcenname string

Zwänge:
Pattern = ^.*$ (erforderlich)
Typ Der Ressourcentyp 'Microsoft.Kusto/clusters/databases'

KeyVault-Eigenschaften

Name Beschreibung Wert
federatedIdentityClientId Die Anwendungs-(Client-)ID der Multi-Tenant-Microsoft Entra-Anwendung. Verwendet für Szenarien mit kundenverwalteten Schlüsseln über verschiedene Mieter, bei denen der Verschlüsselungsschlüssel in einem anderen Tenant als der Cluster gespeichert wird. Die Anwendung muss mit der vom Benutzer zugewiesenen verwalteten Identität als föderierten Identitätszugangsnachweis konfiguriert sein. Schnur
Schlüsselname Der Name des Schlüsseltresorschlüssels. Schnur
keyVaultUri Der URI des Schlüsseltresors. Schnur
Schlüsselversion Die Version des Schlüsseltresorschlüssels. Schnur
BenutzerIdentität Die vom Benutzer zugewiesene Identität (ARM-Ressourcen-ID), die Zugriff auf den Schlüssel hat. Die Identität muss die Berechtigungen 'Get', 'Wrap Key' und 'Unwrap Key' auf dem Key Vault Key Key haben oder die Rolle 'Key Vault Crypto Service Encryption User' zugewiesen werden. Schnur

ReadOnlyFollowingDatabase

Name Beschreibung Wert
freundlich Art der Datenbank "ReadOnlyFollowing" (erforderlich)
properties Die Datenbankeigenschaften. ReadOnlyFollowingDatabaseProperties

ReadOnlyFollowingDatabaseProperties

Name Beschreibung Wert
hotCachePeriod Die Zeit, zu der die Daten im Cache für schnelle Abfragen in TimeSpan gespeichert werden sollen. Schnur

ReadWriteDatabase (Englisch)

Name Beschreibung Wert
freundlich Art der Datenbank 'ReadWrite' (erforderlich)
properties Die Datenbankeigenschaften. ReadWriteDatabase-Eigenschaften

ReadWriteDatabase-Eigenschaften

Name Beschreibung Wert
hotCachePeriod Die Zeit, zu der die Daten im Cache für schnelle Abfragen in TimeSpan gespeichert werden sollen. Schnur
keyVault-Eigenschaften KeyVault-Eigenschaften für die Datenbankverschlüsselung. KeyVault-Eigenschaften
Zeitraum für weiche Löschung Die Zeit, zu der die Daten aufbewahrt werden sollen, bevor der Zugriff auf Abfragen in TimeSpan beendet wird. Schnur

Verwendungsbeispiele

Azure-Schnellstartvorlagen

Die folgenden Azure-Schnellstartvorlagen diesen Ressourcentyp bereitstellen.

Vorlage Beschreibung
Azure Digital Twins mit Zeitdatenverlaufsverbindung

In Azure bereitstellen
Diese Vorlage erstellt eine Azure Digital Twins-Instanz, die mit einer Zeitreihen-Datenverlaufsverbindung konfiguriert ist. Um eine Verbindung zu erstellen, müssen andere Ressourcen erstellt werden, z. B. einen Event Hubs-Namespace, einen Event Hub, einen Azure Data Explorer-Cluster und eine Datenbank. Daten werden an einen Event Hub gesendet, der die Daten schließlich an den Azure Data Explorer-Cluster weiterleitet. Daten werden in einer Datenbanktabelle im Cluster gespeichert.
Erstellen eines Clusters einer Datenbank

In Azure bereitstellen
Mit dieser Vorlage können Sie einen Cluster und eine Datenbank erstellen.
Erstellen einer Datenbanküberwachungs-

In Azure bereitstellen
In diesem Beispiel wird eine Datenbanküberwachung für Azure SQL erstellt und deren Datenspeicher, SQL-Ziele und verwaltete private Endpunkte konfiguriert.
Bereitstellen Sie Azure Data Explorer Datenbank mit Cosmos-DB-Verbindung

In Azure bereitstellen
Bereite die Azure Data Explorer Datenbank mit Cosmos DB-Verbindung bereit.
Bereitstellen von Azure Data Explorer db mit Ereignisrasterverbindung

In Azure bereitstellen
Bereitstellen von Azure Data Explorer db mit Event Grid-Verbindung.
Bereitstellen von Azure Data Explorer db mit Event Hub-Verbindung

In Azure bereitstellen
Bereitstellen von Azure Data Explorer db mit Event Hub-Verbindung.
FinOps-Hub

In Azure bereitstellen
Diese Vorlage erstellt eine neue FinOps-Hubinstanz, einschließlich Data Explorer, Data Lake Storage und Data Factory.

Terraform -Ressourcendefinition (AzAPI-Anbieter)

Der Cluster-/Datenbankressourcentyp kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

  • Ressourcengruppen

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.Kusto/clusters/databases-Ressource zu erstellen, fügen Sie Ihrer Vorlage die folgende Terraform hinzu.

resource "azapi_resource" "symbolicname" {
  location = "string"
  name = "string"
  kind = "string"
  // For remaining properties, see Microsoft.Kusto/clusters/databases objects
}

Microsoft.Kusto/clusters/databases-Objekte

Legen Sie die kind-Eigenschaft fest, um den Typ des Objekts anzugeben.

Verwenden Sie für ReadOnlyFollowing:

{
  kind = "ReadOnlyFollowing"
  properties = {
    hotCachePeriod = "string"
  }
}

Verwenden Sie für ReadWrite-:

{
  kind = "ReadWrite"
  properties = {
    hotCachePeriod = "string"
    keyVaultProperties = {
      federatedIdentityClientId = "string"
      keyName = "string"
      keyVaultUri = "string"
      keyVersion = "string"
      userIdentity = "string"
    }
    softDeletePeriod = "string"
  }
}

Eigenschaftswerte

Microsoft.Kusto/clusters/databases

Name Beschreibung Wert
freundlich Legen Sie für den Typ ReadOnlyFollowingDatabaseauf "ReadOnlyFollowingDatabase" fest. Legen Sie den Wert auf 'ReadWrite' für den Typ ReadWriteDatabase fest. "ReadOnlyFollowing"
'ReadWrite' (erforderlich)
location Ressourcenspeicherort. Schnur
Name Der Ressourcenname string

Zwänge:
Pattern = ^.*$ (erforderlich)
parent_id Die ID der Ressource, die das übergeordnete Element für diese Ressource ist. ID für Ressource vom Typ: Cluster
Typ Der Ressourcentyp "Microsoft.Kusto/clusters/databases@2025-02-14"

KeyVault-Eigenschaften

Name Beschreibung Wert
federatedIdentityClientId Die Anwendungs-(Client-)ID der Multi-Tenant-Microsoft Entra-Anwendung. Verwendet für Szenarien mit kundenverwalteten Schlüsseln über verschiedene Mieter, bei denen der Verschlüsselungsschlüssel in einem anderen Tenant als der Cluster gespeichert wird. Die Anwendung muss mit der vom Benutzer zugewiesenen verwalteten Identität als föderierten Identitätszugangsnachweis konfiguriert sein. Schnur
Schlüsselname Der Name des Schlüsseltresorschlüssels. Schnur
keyVaultUri Der URI des Schlüsseltresors. Schnur
Schlüsselversion Die Version des Schlüsseltresorschlüssels. Schnur
BenutzerIdentität Die vom Benutzer zugewiesene Identität (ARM-Ressourcen-ID), die Zugriff auf den Schlüssel hat. Die Identität muss die Berechtigungen 'Get', 'Wrap Key' und 'Unwrap Key' auf dem Key Vault Key Key haben oder die Rolle 'Key Vault Crypto Service Encryption User' zugewiesen werden. Schnur

ReadOnlyFollowingDatabase

Name Beschreibung Wert
freundlich Art der Datenbank "ReadOnlyFollowing" (erforderlich)
properties Die Datenbankeigenschaften. ReadOnlyFollowingDatabaseProperties

ReadOnlyFollowingDatabaseProperties

Name Beschreibung Wert
hotCachePeriod Die Zeit, zu der die Daten im Cache für schnelle Abfragen in TimeSpan gespeichert werden sollen. Schnur

ReadWriteDatabase (Englisch)

Name Beschreibung Wert
freundlich Art der Datenbank 'ReadWrite' (erforderlich)
properties Die Datenbankeigenschaften. ReadWriteDatabase-Eigenschaften

ReadWriteDatabase-Eigenschaften

Name Beschreibung Wert
hotCachePeriod Die Zeit, zu der die Daten im Cache für schnelle Abfragen in TimeSpan gespeichert werden sollen. Schnur
keyVault-Eigenschaften KeyVault-Eigenschaften für die Datenbankverschlüsselung. KeyVault-Eigenschaften
Zeitraum für weiche Löschung Die Zeit, zu der die Daten aufbewahrt werden sollen, bevor der Zugriff auf Abfragen in TimeSpan beendet wird. Schnur

Verwendungsbeispiele

Terraform-Beispiele

Ein grundlegendes Beispiel für die Bereitstellung von Kusto/Data Explorer-Datenbanken.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "cluster" {
  type      = "Microsoft.Kusto/clusters@2023-05-02"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      enableAutoStop                = true
      enableDiskEncryption          = false
      enableDoubleEncryption        = false
      enablePurge                   = false
      enableStreamingIngest         = false
      engineType                    = "V2"
      publicIPType                  = "IPv4"
      publicNetworkAccess           = "Enabled"
      restrictOutboundNetworkAccess = "Disabled"
      trustedExternalTenants = [
      ]
    }
    sku = {
      capacity = 1
      name     = "Dev(No SLA)_Standard_D11_v2"
      tier     = "Basic"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "database" {
  type      = "Microsoft.Kusto/clusters/databases@2023-05-02"
  parent_id = azapi_resource.cluster.id
  name      = var.resource_name
  location  = var.location
  body = {
    kind = "ReadWrite"
    properties = {
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

Ein grundlegendes Beispiel für die Bereitstellung von Kusto/Data Explorer-Datenbanken.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "cluster" {
  type      = "Microsoft.Kusto/clusters@2023-05-02"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      enableAutoStop                = true
      enableDiskEncryption          = false
      enableDoubleEncryption        = false
      enablePurge                   = false
      enableStreamingIngest         = false
      engineType                    = "V2"
      publicIPType                  = "IPv4"
      publicNetworkAccess           = "Enabled"
      restrictOutboundNetworkAccess = "Disabled"
      trustedExternalTenants = [
      ]
    }
    sku = {
      capacity = 1
      name     = "Dev(No SLA)_Standard_D11_v2"
      tier     = "Basic"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "database" {
  type      = "Microsoft.Kusto/clusters/databases@2023-05-02"
  parent_id = azapi_resource.cluster.id
  name      = var.resource_name
  location  = var.location
  body = {
    kind = "ReadWrite"
    properties = {
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}