Partager via


Clusters/bases de données Microsoft.Kusto

Définition de ressource Bicep

Le type de ressource clusters/bases de données peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.Kusto/clusters/databases, ajoutez le bicep suivant à votre modèle.

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

Objets Microsoft.Kusto/clusters/databases

Définissez le type propriété pour spécifier le type d’objet.

Pour ReadOnlyFollowing, utilisez :

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

Pour readWrite, utilisez :

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

Valeurs de propriété

Microsoft.Kusto/clusters/bases de données

Nom Descriptif Valeur
gentil Défini sur « ReadOnlyFollowing » pour le type ReadOnlyFollowingDatabase. Défini sur « ReadWrite » pour le type ReadWriteDatabase. 'ReadOnlyFollowing'
'ReadWrite' (obligatoire)
emplacement Emplacement des ressources. corde
nom Nom de la ressource corde

Contraintes:
Modèle = ^.*$ (obligatoire)
parent Dans Bicep, vous pouvez spécifier la ressource parente d’une ressource enfant. Vous devez uniquement ajouter cette propriété lorsque la ressource enfant est déclarée en dehors de la ressource parente.

Pour plus d’informations, consultez ressource enfant en dehors de la ressource parente.
Nom symbolique de la ressource de type : clusters

KeyVaultProperties

Nom Descriptif Valeur
keyName Nom de la clé du coffre de clés. corde
keyVaultUri URI du coffre de clés. corde
keyVersion Version de la clé du coffre de clés. corde
userIdentity Identité affectée par l’utilisateur (ID de ressource ARM) qui a accès à la clé. corde

Base de données ReadOnlyFollowingDatabase

Nom Descriptif Valeur
gentil Type de la base de données 'ReadOnlyFollowing' (obligatoire)
Propriétés Propriétés de la base de données. ReadOnlyFollowingDatabaseProperties

ReadOnlyFollowingDatabaseProperties

Nom Descriptif Valeur
hotCachePeriod Heure à laquelle les données doivent être conservées dans le cache pour les requêtes rapides dans TimeSpan. corde

ReadWriteDatabase

Nom Descriptif Valeur
gentil Type de la base de données 'ReadWrite' (obligatoire)
Propriétés Propriétés de la base de données. ReadWriteDatabaseProperties

ReadWriteDatabaseProperties

Nom Descriptif Valeur
hotCachePeriod Heure à laquelle les données doivent être conservées dans le cache pour les requêtes rapides dans TimeSpan. corde
keyVaultProperties Propriétés KeyVault pour le chiffrement de base de données. KeyVaultProperties
période de suppression douce Heure à laquelle les données doivent être conservées avant qu’elles ne soient plus accessibles aux requêtes dans TimeSpan. corde

Exemples d’utilisation

Exemples de démarrage rapide Azure

Les modèles de démarrage rapide Azure suivants contiennent des exemples Bicep pour le déploiement de ce type de ressource.

Fichier Bicep Descriptif
Azure Digital Twins avec de connexion d’historique des données temporelles Ce modèle crée une instance Azure Digital Twins configurée avec une connexion d’historique des données de série chronologique. Pour créer une connexion, d’autres ressources doivent être créées, telles qu’un espace de noms Event Hubs, un hub d’événements, un cluster Azure Data Explorer et une base de données. Les données sont envoyées à un hub d’événements qui transfère finalement les données au cluster Azure Data Explorer. Les données sont stockées dans une table de base de données dans le cluster
Créer un observateur de base de données Cet exemple crée un observateur de base de données pour Azure SQL et configure son magasin de données, ses cibles SQL et ses points de terminaison privés managés
Déployer Azure Data Explorer DB avec de connexion Cosmos DB Déployez Azure Data Explorer DB avec la connexion Cosmos DB.
Déployer une base de données Azure Data Explorer avec de connexion Event Grid Déployez la base de données Azure Data Explorer avec la connexion Event Grid.
Déployer une base de données Azure Data Explorer avec de connexion Event Hub Déployez la base de données Azure Data Explorer avec la connexion Event Hub.
hub FinOps Ce modèle crée une instance de hub FinOps, notamment Data Explorer, Data Lake Storage et Data Factory.

Définition de ressource de modèle ARM

Le type de ressource clusters/bases de données peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.Kusto/clusters/databases, ajoutez le code JSON suivant à votre modèle.

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

Objets Microsoft.Kusto/clusters/databases

Définissez le type propriété pour spécifier le type d’objet.

Pour ReadOnlyFollowing, utilisez :

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

Pour readWrite, utilisez :

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

Valeurs de propriété

Microsoft.Kusto/clusters/bases de données

Nom Descriptif Valeur
apiVersion Version de l’API '2024-04-13'
gentil Défini sur « ReadOnlyFollowing » pour le type ReadOnlyFollowingDatabase. Défini sur « ReadWrite » pour le type ReadWriteDatabase. 'ReadOnlyFollowing'
'ReadWrite' (obligatoire)
emplacement Emplacement des ressources. corde
nom Nom de la ressource corde

Contraintes:
Modèle = ^.*$ (obligatoire)
type Type de ressource 'Microsoft.Kusto/clusters/bases de données'

KeyVaultProperties

Nom Descriptif Valeur
keyName Nom de la clé du coffre de clés. corde
keyVaultUri URI du coffre de clés. corde
keyVersion Version de la clé du coffre de clés. corde
userIdentity Identité affectée par l’utilisateur (ID de ressource ARM) qui a accès à la clé. corde

Base de données ReadOnlyFollowingDatabase

Nom Descriptif Valeur
gentil Type de la base de données 'ReadOnlyFollowing' (obligatoire)
Propriétés Propriétés de la base de données. ReadOnlyFollowingDatabaseProperties

ReadOnlyFollowingDatabaseProperties

Nom Descriptif Valeur
hotCachePeriod Heure à laquelle les données doivent être conservées dans le cache pour les requêtes rapides dans TimeSpan. corde

ReadWriteDatabase

Nom Descriptif Valeur
gentil Type de la base de données 'ReadWrite' (obligatoire)
Propriétés Propriétés de la base de données. ReadWriteDatabaseProperties

ReadWriteDatabaseProperties

Nom Descriptif Valeur
hotCachePeriod Heure à laquelle les données doivent être conservées dans le cache pour les requêtes rapides dans TimeSpan. corde
keyVaultProperties Propriétés KeyVault pour le chiffrement de base de données. KeyVaultProperties
période de suppression douce Heure à laquelle les données doivent être conservées avant qu’elles ne soient plus accessibles aux requêtes dans TimeSpan. corde

Exemples d’utilisation

Modèles de démarrage rapide Azure

Les modèles de démarrage rapide Azure suivants déployer ce type de ressource.

Modèle Descriptif
Azure Digital Twins avec de connexion d’historique des données temporelles

Déployer sur Azure
Ce modèle crée une instance Azure Digital Twins configurée avec une connexion d’historique des données de série chronologique. Pour créer une connexion, d’autres ressources doivent être créées, telles qu’un espace de noms Event Hubs, un hub d’événements, un cluster Azure Data Explorer et une base de données. Les données sont envoyées à un hub d’événements qui transfère finalement les données au cluster Azure Data Explorer. Les données sont stockées dans une table de base de données dans le cluster
Créer un cluster d’une base de données

Déployer sur Azure
Ce modèle vous permet de créer un cluster et une base de données.
Créer un observateur de base de données

Déployer sur Azure
Cet exemple crée un observateur de base de données pour Azure SQL et configure son magasin de données, ses cibles SQL et ses points de terminaison privés managés
Déployer Azure Data Explorer DB avec de connexion Cosmos DB

Déployer sur Azure
Déployez Azure Data Explorer DB avec la connexion Cosmos DB.
Déployer une base de données Azure Data Explorer avec de connexion Event Grid

Déployer sur Azure
Déployez la base de données Azure Data Explorer avec la connexion Event Grid.
Déployer une base de données Azure Data Explorer avec de connexion Event Hub

Déployer sur Azure
Déployez la base de données Azure Data Explorer avec la connexion Event Hub.
hub FinOps

Déployer sur Azure
Ce modèle crée une instance de hub FinOps, notamment Data Explorer, Data Lake Storage et Data Factory.

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource clusters/bases de données peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.Kusto/clusters/databases, ajoutez le terraform suivant à votre modèle.

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

Objets Microsoft.Kusto/clusters/databases

Définissez le type propriété pour spécifier le type d’objet.

Pour ReadOnlyFollowing, utilisez :

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

Pour readWrite, utilisez :

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

Valeurs de propriété

Microsoft.Kusto/clusters/bases de données

Nom Descriptif Valeur
gentil Défini sur « ReadOnlyFollowing » pour le type ReadOnlyFollowingDatabase. Défini sur « ReadWrite » pour le type ReadWriteDatabase. 'ReadOnlyFollowing'
'ReadWrite' (obligatoire)
emplacement Emplacement des ressources. corde
nom Nom de la ressource corde

Contraintes:
Modèle = ^.*$ (obligatoire)
parent_id ID de la ressource qui est le parent de cette ressource. ID de ressource de type : clusters
type Type de ressource « Microsoft.Kusto/clusters/databases@2024-04-13 »

KeyVaultProperties

Nom Descriptif Valeur
keyName Nom de la clé du coffre de clés. corde
keyVaultUri URI du coffre de clés. corde
keyVersion Version de la clé du coffre de clés. corde
userIdentity Identité affectée par l’utilisateur (ID de ressource ARM) qui a accès à la clé. corde

Base de données ReadOnlyFollowingDatabase

Nom Descriptif Valeur
gentil Type de la base de données 'ReadOnlyFollowing' (obligatoire)
Propriétés Propriétés de la base de données. ReadOnlyFollowingDatabaseProperties

ReadOnlyFollowingDatabaseProperties

Nom Descriptif Valeur
hotCachePeriod Heure à laquelle les données doivent être conservées dans le cache pour les requêtes rapides dans TimeSpan. corde

ReadWriteDatabase

Nom Descriptif Valeur
gentil Type de la base de données 'ReadWrite' (obligatoire)
Propriétés Propriétés de la base de données. ReadWriteDatabaseProperties

ReadWriteDatabaseProperties

Nom Descriptif Valeur
hotCachePeriod Heure à laquelle les données doivent être conservées dans le cache pour les requêtes rapides dans TimeSpan. corde
keyVaultProperties Propriétés KeyVault pour le chiffrement de base de données. KeyVaultProperties
période de suppression douce Heure à laquelle les données doivent être conservées avant qu’elles ne soient plus accessibles aux requêtes dans TimeSpan. corde

Exemples d’utilisation

Échantillons Terraform

Un exemple de base de déploiement de la base de données Kusto / Data Explorer.

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    = ["*"]
}

Un exemple de base de déploiement de la base de données Kusto / Data Explorer.

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    = ["*"]
}