Compartir a través de

Clústeres/bases de datos/scripts de Microsoft.Kusto 27/08/2021

Definición de recursos de Bicep

El tipo de recurso clusters,databases/scripts se puede implementar con operaciones que tienen como destino:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Kusto/clusters/databases/scripts, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.Kusto/clusters/databases/scripts@2021-08-27' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    continueOnErrors: bool
    forceUpdateTag: 'string'
    scriptUrl: 'string'
    scriptUrlSasToken: 'string'
  }
}

Valores de propiedad

Microsoft.Kusto/clusters/databases/scripts

Nombre Descripción Valor
nombre El nombre del recurso string (obligatorio)
padre En Bicep, puede especificar el recurso primario para un recurso secundario. Solo tiene que agregar esta propiedad cuando el recurso secundario se declara fuera del recurso primario.

Para obtener más información, consulte recurso secundario fuera del recurso primario.		 Nombre simbólico del recurso de tipo: clústeres o bases de datos
Propiedades Script de base de datos. scriptProperties

ScriptProperties

Nombre Descripción Valor
continueOnErrors Marca que indica si se va a continuar si se produce un error en uno de los comandos. Bool
forceUpdateTag Cadena única. Si se cambia el script se volverá a aplicar. cuerda
scriptUrl Dirección URL al archivo de blob de script KQL. string (obligatorio)
scriptUrlSasToken Token de SaS. cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro. (obligatorio)

Ejemplos de uso

Ejemplos de inicio rápido de Azure

Los siguientes plantillas de inicio rápido de Azure contienen ejemplos de Bicep para implementar este tipo de recurso.

Archivo de Bicep Descripción
Implementación de Azure Data Explorer DB con de conexión de Cosmos DB Implemente Azure Data Explorer DB con conexión de Cosmos DB.
implementación de la base de datos de Azure Data Explorer con de conexión de Event Grid Implemente la base de datos de Azure Data Explorer con la conexión de Event Grid.
Implementación de la base de datos de Azure Data Explorer con de conexión del centro de eventos Implemente la base de datos de Azure Data Explorer con la conexión del centro de eventos.
del centro de FinOps de Esta plantilla crea una nueva instancia del centro de FinOps, incluido el Explorador de datos, el almacenamiento de Data Lake y Data Factory.

Definición de recursos de plantilla de ARM

El tipo de recurso clusters,databases/scripts se puede implementar con operaciones que tienen como destino:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Kusto/clusters/databases/scripts, agregue el siguiente JSON a la plantilla.

{
  "type": "Microsoft.Kusto/clusters/databases/scripts",
  "apiVersion": "2021-08-27",
  "name": "string",
  "properties": {
    "continueOnErrors": "bool",
    "forceUpdateTag": "string",
    "scriptUrl": "string",
    "scriptUrlSasToken": "string"
  }
}

Valores de propiedad

Microsoft.Kusto/clusters/databases/scripts

Nombre Descripción Valor
apiVersion La versión de api '2021-08-27'
nombre El nombre del recurso string (obligatorio)
Propiedades Script de base de datos. scriptProperties
tipo El tipo de recurso "Microsoft.Kusto/clusters/databases/scripts"

ScriptProperties

Nombre Descripción Valor
continueOnErrors Marca que indica si se va a continuar si se produce un error en uno de los comandos. Bool
forceUpdateTag Cadena única. Si se cambia el script se volverá a aplicar. cuerda
scriptUrl Dirección URL al archivo de blob de script KQL. string (obligatorio)
scriptUrlSasToken Token de SaS. cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro. (obligatorio)

Ejemplos de uso

Plantillas de inicio rápido de Azure

Los siguientes plantillas de inicio rápido de Azure implementar este tipo de recurso.

Plantilla Descripción
Implementación de Azure Data Explorer DB con de conexión de Cosmos DB

Implementación en Azure 		Implemente Azure Data Explorer DB con conexión de Cosmos DB.
implementación de la base de datos de Azure Data Explorer con de conexión de Event Grid

Implementación en Azure 		Implemente la base de datos de Azure Data Explorer con la conexión de Event Grid.
Implementación de la base de datos de Azure Data Explorer con de conexión del centro de eventos

Implementación en Azure 		Implemente la base de datos de Azure Data Explorer con la conexión del centro de eventos.
del centro de FinOps de

Implementación en Azure 		Esta plantilla crea una nueva instancia del centro de FinOps, incluido el Explorador de datos, el almacenamiento de Data Lake y Data Factory.

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso clusters,databases/scripts se puede implementar con operaciones que tienen como destino:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Kusto/clusters/databases/scripts, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Kusto/clusters/databases/scripts@2021-08-27"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      continueOnErrors = bool
      forceUpdateTag = "string"
      scriptUrl = "string"
      scriptUrlSasToken = "string"
    }
  }
}

Valores de propiedad

Microsoft.Kusto/clusters/databases/scripts

Nombre Descripción Valor
nombre El nombre del recurso string (obligatorio)
parent_id Identificador del recurso que es el elemento primario de este recurso. Identificador del recurso de tipo: clústeres o bases de datos
Propiedades Script de base de datos. scriptProperties
tipo El tipo de recurso "Microsoft.Kusto/clusters/databases/scripts@2021-08-27"

ScriptProperties

Nombre Descripción Valor
continueOnErrors Marca que indica si se va a continuar si se produce un error en uno de los comandos. Bool
forceUpdateTag Cadena única. Si se cambia el script se volverá a aplicar. cuerda
scriptUrl Dirección URL al archivo de blob de script KQL. string (obligatorio)
scriptUrlSasToken Token de SaS. cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro. (obligatorio)

Ejemplos de uso

Ejemplos de Terraform

Un ejemplo básico de implementación de Kusto Script.

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

Un ejemplo básico de implementación de Kusto Script.

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    = ["*"]
}
  • Last updated on