Partager via

Clusters/bases de données/scripts Microsoft.Kusto 2024-04-13

  • Article

Définition de ressource Bicep

Le type de ressource clusters/bases de données/scripts 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/scripts, ajoutez le bicep suivant à votre modèle.

resource symbolicname 'Microsoft.Kusto/clusters/databases/scripts@2024-04-13' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    continueOnErrors: bool
    forceUpdateTag: 'string'
    principalPermissionsAction: 'string'
    scriptContent: 'string'
    scriptLevel: 'string'
    scriptUrl: 'string'
    scriptUrlSasToken: 'string'
  }
}

Valeurs de propriété

Microsoft.Kusto/clusters/databases/scripts

Nom Description Valeur
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/bases de données
Propriétés Script de base de données. ScriptProperties

ScriptProperties

Nom Description Valeur
continueOnErrors Indicateur qui indique s’il faut continuer si l’une des commandes échoue. Bool
forceUpdateTag Chaîne unique. Si le script a été modifié, il sera appliqué à nouveau. corde
principalPermissionsAction Indique si les autorisations pour l’appelant de script sont conservées après la fin du script. 'RemovePermissionOnScriptCompletion'
'RetainPermissionOnScriptCompletion'
scriptContent Contenu du script. Cette propriété doit être utilisée lorsque le script est fourni inline et non via un fichier dans une signature d’accès partagé. Ne doit pas être utilisé avec les propriétés scriptUrl et scriptUrlSasToken. corde

Contraintes:
Valeur sensible. Passez en tant que paramètre sécurisé.
scriptLevel Différencie le type de commandes de script incluses : base de données ou cluster. La valeur par défaut est Database. 'Cluster'
'Database'
scriptUrl URL du fichier blob de script KQL. Ne doit pas être utilisé avec la propriété scriptContent corde
scriptUrlSasToken Jeton SaS qui fournit un accès en lecture au fichier qui contient le script. Doit être fourni lors de l’utilisation de la propriété scriptUrl. corde

Contraintes:
Valeur sensible. Passez en tant que paramètre sécurisé.

Exemples de démarrage rapide

Les exemples de démarrage rapide suivants déploient ce type de ressource.

Fichier Bicep Description
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.

Définition de ressource de modèle ARM

Le type de ressource clusters/bases de données/scripts 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/scripts, ajoutez le code JSON suivant à votre modèle.

{
  "type": "Microsoft.Kusto/clusters/databases/scripts",
  "apiVersion": "2024-04-13",
  "name": "string",
  "properties": {
    "continueOnErrors": "bool",
    "forceUpdateTag": "string",
    "principalPermissionsAction": "string",
    "scriptContent": "string",
    "scriptLevel": "string",
    "scriptUrl": "string",
    "scriptUrlSasToken": "string"
  }
}

Valeurs de propriété

Microsoft.Kusto/clusters/databases/scripts

Nom Description Valeur
apiVersion Version de l’API '2024-04-13'
nom Nom de la ressource corde

Contraintes:
Modèle = ^.*$ (obligatoire)
Propriétés Script de base de données. ScriptProperties
type Type de ressource 'Microsoft.Kusto/clusters/databases/scripts'

ScriptProperties

Nom Description Valeur
continueOnErrors Indicateur qui indique s’il faut continuer si l’une des commandes échoue. Bool
forceUpdateTag Chaîne unique. Si le script a été modifié, il sera appliqué à nouveau. corde
principalPermissionsAction Indique si les autorisations pour l’appelant de script sont conservées après la fin du script. 'RemovePermissionOnScriptCompletion'
'RetainPermissionOnScriptCompletion'
scriptContent Contenu du script. Cette propriété doit être utilisée lorsque le script est fourni inline et non via un fichier dans une signature d’accès partagé. Ne doit pas être utilisé avec les propriétés scriptUrl et scriptUrlSasToken. corde

Contraintes:
Valeur sensible. Passez en tant que paramètre sécurisé.
scriptLevel Différencie le type de commandes de script incluses : base de données ou cluster. La valeur par défaut est Database. 'Cluster'
'Database'
scriptUrl URL du fichier blob de script KQL. Ne doit pas être utilisé avec la propriété scriptContent corde
scriptUrlSasToken Jeton SaS qui fournit un accès en lecture au fichier qui contient le script. Doit être fourni lors de l’utilisation de la propriété scriptUrl. corde

Contraintes:
Valeur sensible. Passez en tant que paramètre sécurisé.

Modèles de démarrage rapide

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

Modèle Description
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.

Définition de ressource Terraform (fournisseur AzAPI)

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

  • groupes de ressources

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/scripts, ajoutez le terraform suivant à votre modèle.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Kusto/clusters/databases/scripts@2024-04-13"
  name = "string"
  body = jsonencode({
    properties = {
      continueOnErrors = bool
      forceUpdateTag = "string"
      principalPermissionsAction = "string"
      scriptContent = "string"
      scriptLevel = "string"
      scriptUrl = "string"
      scriptUrlSasToken = "string"
    }
  })
}

Valeurs de propriété

Microsoft.Kusto/clusters/databases/scripts

Nom Description Valeur
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/bases de données
Propriétés Script de base de données. ScriptProperties
type Type de ressource « Microsoft.Kusto/clusters/databases/scripts@2024-04-13 »

ScriptProperties

Nom Description Valeur
continueOnErrors Indicateur qui indique s’il faut continuer si l’une des commandes échoue. Bool
forceUpdateTag Chaîne unique. Si le script a été modifié, il sera appliqué à nouveau. corde
principalPermissionsAction Indique si les autorisations pour l’appelant de script sont conservées après la fin du script. 'RemovePermissionOnScriptCompletion'
'RetainPermissionOnScriptCompletion'
scriptContent Contenu du script. Cette propriété doit être utilisée lorsque le script est fourni inline et non via un fichier dans une signature d’accès partagé. Ne doit pas être utilisé avec les propriétés scriptUrl et scriptUrlSasToken. corde

Contraintes:
Valeur sensible. Passez en tant que paramètre sécurisé.
scriptLevel Différencie le type de commandes de script incluses : base de données ou cluster. La valeur par défaut est Database. 'Cluster'
'Database'
scriptUrl URL du fichier blob de script KQL. Ne doit pas être utilisé avec la propriété scriptContent corde
scriptUrlSasToken Jeton SaS qui fournit un accès en lecture au fichier qui contient le script. Doit être fourni lors de l’utilisation de la propriété scriptUrl. corde

Contraintes:
Valeur sensible. Passez en tant que paramètre sécurisé.