Cluster Microsoft.Kusto/databases/scripts

Definizione di risorsa Bicep

Il tipo di risorsa cluster/databases/scripts può essere distribuito con operazioni destinate a:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Esempi di utilizzo

Esempi bicep

Esempio di base di distribuzione di script Kusto.

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

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

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

resource script 'Microsoft.Kusto/clusters/databases/scripts@2023-05-02' = {
  name: 'create-table-script'
  parent: database
  properties: {
    continueOnErrors: false
    forceUpdateTag: '9e2e7874-aa37-7041-81b7-06397f03a37d'
    scriptContent: '''.create table TestTable(Id:string, Name:string, _ts:long, _timestamp:datetime)
.create table TestTable ingestion json mapping "TestMapping"
''[''
''    {"column":"Id","path":"$.id"},''
''    {"column":"Name","path":"$.name"},''
''    {"column":"_ts","path":"$._ts"},''
''    {"column":"_timestamp","path":"$._ts", "transform":"DateTimeFromUnixSeconds"}''
'']''
.alter table TestTable policy ingestionbatching "{''MaximumBatchingTimeSpan'': ''0:0:10'', ''MaximumNumberOfItems'': 10000}"
'''
  }
}

Esempi di avvio rapido di Azure

I modelli di avvio rapido di Azure seguenti contengono esempi Bicep per la distribuzione di questo tipo di risorsa.

File bicipite Descrizione
Distribuire Esplora dati di Azure DB con la connessione di Cosmos DB Distribuire Esplora dati di Azure DB con la connessione Cosmos DB.
Distribuire il database di Esplora dati di Azure con la connessione di Griglia di eventi Distribuire il database di Esplora dati di Azure con connessione griglia di eventi.
Distribuire il database di Esplora dati di Azure con la connessione a Hub eventi Distribuire il database di Esplora dati di Azure con la connessione a Hub eventi.
hub FinOps Questo modello crea una nuova istanza dell'hub FinOps, tra cui Esplora dati, Data Lake Storage e Data Factory.

Formato risorsa

Per creare una risorsa Microsoft.Kusto/clusters/databases/scripts, aggiungere il bicep seguente al modello.

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

Valori delle proprietà

Microsoft.Kusto/clusters/databases/scripts

Nome Descrizione Valore
nome Nome della risorsa corda

Vincoli:
Pattern = ^.*$ (obbligatorio)
genitore In Bicep è possibile specificare la risorsa padre per una risorsa figlio. È necessario aggiungere questa proprietà solo quando la risorsa figlio viene dichiarata all'esterno della risorsa padre.

Per altre informazioni, vedere risorsa figlio all'esterno della risorsa padre.		 Nome simbolico per la risorsa di tipo: cluster/database
proprietà Script del database. proprietà script

Proprietà script

Nome Descrizione Valore
continueOnErrors Flag che indica se continuare se uno dei comandi ha esito negativo. Bool
forceUpdateTag Stringa univoca. Se è stato modificato, lo script verrà nuovamente applicato. corda
managedIdentityResourceId L'identificatore della risorsa dell'identità gestita da utilizzare. Quando fornita, l'identità gestita verrà utilizzata per leggere il contenuto dello script dallo scriptUrl. corda
principalPermissionsAction Indica se le autorizzazioni per il chiamante dello script vengono mantenute dopo il completamento dello script. 'RemovePermissionOnScriptCompletion'
'RetainPermissionOnScriptCompletion'
scriptContent Contenuto dello script. Questa proprietà deve essere usata quando lo script è inline e non tramite il file in un sa. Non deve essere usato insieme alle proprietà scriptUrl e scriptUrlSasToken. corda

Vincoli:
Valore sensibile. Passare come parametro sicuro.
scriptLevel Distingue il tipo di comandi di script inclusi - Database o Cluster. Il valore predefinito è Database. 'Cluster'
'Database'
scriptUrl URL del file BLOB di script KQL. Non deve essere usato insieme alla proprietà scriptContent corda
scriptUrlSasToken Token SaS che fornisce l'accesso in lettura al file che contiene lo script. Deve essere specificato quando si usa la proprietà scriptUrl. corda

Vincoli:
Valore sensibile. Passare come parametro sicuro.

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa cluster/databases/scripts può essere distribuito con operazioni destinate a:

Esempi di utilizzo

Modelli di avvio rapido di Azure

I modelli di avvio rapido di Azure seguenti distribuire questo tipo di risorsa.

Sagoma Descrizione
Distribuire Esplora dati di Azure DB con la connessione di Cosmos DB

Distribuire in Azure 		Distribuire Esplora dati di Azure DB con la connessione Cosmos DB.
Distribuire il database di Esplora dati di Azure con la connessione di Griglia di eventi

Distribuire in Azure 		Distribuire il database di Esplora dati di Azure con connessione griglia di eventi.
Distribuire il database di Esplora dati di Azure con la connessione a Hub eventi

Distribuire in Azure 		Distribuire il database di Esplora dati di Azure con la connessione a Hub eventi.
hub FinOps

Distribuire in Azure 		Questo modello crea una nuova istanza dell'hub FinOps, tra cui Esplora dati, Data Lake Storage e Data Factory.

Formato risorsa

Per creare una risorsa Microsoft.Kusto/clusters/databases/scripts, aggiungere il codice JSON seguente al modello.

{
  "type": "Microsoft.Kusto/clusters/databases/scripts",
  "apiVersion": "2025-02-14",
  "name": "string",
  "properties": {
    "continueOnErrors": "bool",
    "forceUpdateTag": "string",
    "managedIdentityResourceId": "string",
    "principalPermissionsAction": "string",
    "scriptContent": "string",
    "scriptLevel": "string",
    "scriptUrl": "string",
    "scriptUrlSasToken": "string"
  }
}

Valori delle proprietà

Microsoft.Kusto/clusters/databases/scripts

Nome Descrizione Valore
apiVersion Versione dell'API '2025-02-14'
nome Nome della risorsa corda

Vincoli:
Pattern = ^.*$ (obbligatorio)
proprietà Script del database. proprietà script
digitare Tipo di risorsa 'Microsoft.Kusto/clusters/databases/scripts'

Proprietà script

Nome Descrizione Valore
continueOnErrors Flag che indica se continuare se uno dei comandi ha esito negativo. Bool
forceUpdateTag Stringa univoca. Se è stato modificato, lo script verrà nuovamente applicato. corda
managedIdentityResourceId L'identificatore della risorsa dell'identità gestita da utilizzare. Quando fornita, l'identità gestita verrà utilizzata per leggere il contenuto dello script dallo scriptUrl. corda
principalPermissionsAction Indica se le autorizzazioni per il chiamante dello script vengono mantenute dopo il completamento dello script. 'RemovePermissionOnScriptCompletion'
'RetainPermissionOnScriptCompletion'
scriptContent Contenuto dello script. Questa proprietà deve essere usata quando lo script è inline e non tramite il file in un sa. Non deve essere usato insieme alle proprietà scriptUrl e scriptUrlSasToken. corda

Vincoli:
Valore sensibile. Passare come parametro sicuro.
scriptLevel Distingue il tipo di comandi di script inclusi - Database o Cluster. Il valore predefinito è Database. 'Cluster'
'Database'
scriptUrl URL del file BLOB di script KQL. Non deve essere usato insieme alla proprietà scriptContent corda
scriptUrlSasToken Token SaS che fornisce l'accesso in lettura al file che contiene lo script. Deve essere specificato quando si usa la proprietà scriptUrl. corda

Vincoli:
Valore sensibile. Passare come parametro sicuro.

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa cluster/databases/scripts può essere distribuito con operazioni destinate a:

  • Gruppi di risorse Per un elenco delle proprietà modificate in ogni versione dell'API, vedi il registro modifiche.

Esempi di utilizzo

Esempi di Terraform

Esempio di base di distribuzione di script Kusto.

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
  identity {
    type         = "SystemAssigned"
    identity_ids = []
  }
  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    = ["*"]
}

resource "azapi_resource" "script" {
  type      = "Microsoft.Kusto/clusters/databases/scripts@2023-05-02"
  parent_id = azapi_resource.database.id
  name      = "create-table-script"
  body = {
    properties = {
      continueOnErrors = false
      forceUpdateTag   = "9e2e7874-aa37-7041-81b7-06397f03a37d"
      scriptContent    = ".create table TestTable(Id:string, Name:string, _ts:long, _timestamp:datetime)\n.create table TestTable ingestion json mapping \"TestMapping\"\n'['\n'    {\"column\":\"Id\",\"path\":\"$.id\"},'\n'    {\"column\":\"Name\",\"path\":\"$.name\"},'\n'    {\"column\":\"_ts\",\"path\":\"$._ts\"},'\n'    {\"column\":\"_timestamp\",\"path\":\"$._ts\", \"transform\":\"DateTimeFromUnixSeconds\"}'\n']'\n.alter table TestTable policy ingestionbatching \"{'MaximumBatchingTimeSpan': '0:0:10', 'MaximumNumberOfItems': 10000}\"\n"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

Esempio di base di distribuzione di script Kusto.

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
  identity {
    type         = "SystemAssigned"
    identity_ids = []
  }
  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    = ["*"]
}

resource "azapi_resource" "script" {
  type      = "Microsoft.Kusto/clusters/databases/scripts@2023-05-02"
  parent_id = azapi_resource.database.id
  name      = "create-table-script"
  body = {
    properties = {
      continueOnErrors = false
      forceUpdateTag   = "9e2e7874-aa37-7041-81b7-06397f03a37d"
      scriptContent    = ".create table TestTable(Id:string, Name:string, _ts:long, _timestamp:datetime)\n.create table TestTable ingestion json mapping \"TestMapping\"\n'['\n'    {\"column\":\"Id\",\"path\":\"$.id\"},'\n'    {\"column\":\"Name\",\"path\":\"$.name\"},'\n'    {\"column\":\"_ts\",\"path\":\"$._ts\"},'\n'    {\"column\":\"_timestamp\",\"path\":\"$._ts\", \"transform\":\"DateTimeFromUnixSeconds\"}'\n']'\n.alter table TestTable policy ingestionbatching \"{'MaximumBatchingTimeSpan': '0:0:10', 'MaximumNumberOfItems': 10000}\"\n"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

Formato risorsa

Per creare una risorsa Microsoft.Kusto/clusters/databases/scripts, aggiungere il codice Terraform seguente al modello.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Kusto/clusters/databases/scripts@2025-02-14"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      continueOnErrors = bool
      forceUpdateTag = "string"
      managedIdentityResourceId = "string"
      principalPermissionsAction = "string"
      scriptContent = "string"
      scriptLevel = "string"
      scriptUrl = "string"
      scriptUrlSasToken = "string"
    }
  }
}

Valori delle proprietà

Microsoft.Kusto/clusters/databases/scripts

Nome Descrizione Valore
nome Nome della risorsa corda

Vincoli:
Pattern = ^.*$ (obbligatorio)
parent_id ID della risorsa padre per questa risorsa. ID per la risorsa di tipo: cluster/database
proprietà Script del database. proprietà script
digitare Tipo di risorsa "Microsoft.Kusto/clusters/databases/scripts@2025-02-14"

Proprietà script

Nome Descrizione Valore
continueOnErrors Flag che indica se continuare se uno dei comandi ha esito negativo. Bool
forceUpdateTag Stringa univoca. Se è stato modificato, lo script verrà nuovamente applicato. corda
managedIdentityResourceId L'identificatore della risorsa dell'identità gestita da utilizzare. Quando fornita, l'identità gestita verrà utilizzata per leggere il contenuto dello script dallo scriptUrl. corda
principalPermissionsAction Indica se le autorizzazioni per il chiamante dello script vengono mantenute dopo il completamento dello script. 'RemovePermissionOnScriptCompletion'
'RetainPermissionOnScriptCompletion'
scriptContent Contenuto dello script. Questa proprietà deve essere usata quando lo script è inline e non tramite il file in un sa. Non deve essere usato insieme alle proprietà scriptUrl e scriptUrlSasToken. corda

Vincoli:
Valore sensibile. Passare come parametro sicuro.
scriptLevel Distingue il tipo di comandi di script inclusi - Database o Cluster. Il valore predefinito è Database. 'Cluster'
'Database'
scriptUrl URL del file BLOB di script KQL. Non deve essere usato insieme alla proprietà scriptContent corda
scriptUrlSasToken Token SaS che fornisce l'accesso in lettura al file che contiene lo script. Deve essere specificato quando si usa la proprietà scriptUrl. corda

Vincoli:
Valore sensibile. Passare come parametro sicuro.
  • Last updated on