Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Definicja zasobu Bicep
Typ zasobu klastrów/baz danych/skryptów można wdrożyć przy użyciu operacji docelowych:
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.
Format zasobu
Aby utworzyć zasób Microsoft.Kusto/clusters/databases/scripts, dodaj następujący kod Bicep do szablonu.
resource symbolicname 'Microsoft.Kusto/clusters/databases/scripts@2022-07-07' = {
parent: resourceSymbolicName
name: 'string'
properties: {
continueOnErrors: bool
forceUpdateTag: 'string'
scriptContent: 'string'
scriptUrl: 'string'
scriptUrlSasToken: 'string'
}
}
Wartości właściwości
Microsoft.Kusto/clusters/databases/scripts
| Nazwa | Opis | Wartość |
|---|---|---|
| nazwa | Nazwa zasobu | ciąg (wymagany) |
| nadrzędny | W Bicep można określić zasób nadrzędny dla zasobu podrzędnego. Tę właściwość należy dodać tylko wtedy, gdy zasób podrzędny jest zadeklarowany poza zasobem nadrzędnym. Aby uzyskać więcej informacji, zobacz Zasób podrzędny poza zasobem nadrzędnym. |
Nazwa symboliczna zasobu typu: klastry/bazy danych |
| Właściwości | Skrypt bazy danych. | Właściwości skryptów |
Właściwości skryptów
| Nazwa | Opis | Wartość |
|---|---|---|
| continueOnErrors | Flaga wskazująca, czy kontynuować, jeśli jedno z poleceń zakończy się niepowodzeniem. | Bool |
| forceUpdateTag | Unikatowy ciąg. Jeśli skrypt zostanie zmieniony, zostanie ponownie zastosowany. | ciąg |
| scriptContent | Zawartość skryptu. Ta właściwość powinna być używana, gdy skrypt jest wbudowany, a nie za pośrednictwem pliku w sa. Nie można używać razem z właściwościami scriptUrl i scriptUrlSasToken. | struna Ograniczenia: Wartość wrażliwa. Przekaż jako bezpieczny parametr. |
| scriptUrl | Adres URL do pliku obiektu blob skryptu języka KQL. Nie można używać razem z właściwością scriptContent | ciąg |
| scriptUrlSasToken | Token saS, który zapewnia dostęp do odczytu do pliku zawierającego skrypt. Należy podać w przypadku używania właściwości scriptUrl. | struna Ograniczenia: Wartość wrażliwa. Przekaż jako bezpieczny parametr. |
Przykłady użycia
Przykłady szybkiego startu platformy Azure
Poniższe szablony szybkiego startu platformy Azure zawierają przykłady Bicep na potrzeby wdrażania tego typu zasobu.
| Plik Bicep | Opis |
|---|---|
| wdrażanie usługi Azure Data Explorer DB przy użyciu połączenia usługi Cosmos DB | Wdrażanie bazy danych usługi Azure Data Explorer przy użyciu połączenia usługi Cosmos DB. |
| wdrażanie bazy danych usługi Azure Data Explorer przy użyciu połączenia usługi Event Grid | Wdrażanie bazy danych usługi Azure Data Explorer za pomocą połączenia usługi Event Grid. |
| wdrażanie bazy danych usługi Azure Data Explorer przy użyciu połączenia centrum zdarzeń | Wdrażanie bazy danych usługi Azure Data Explorer za pomocą połączenia centrum zdarzeń. |
| centrum |
Ten szablon tworzy nowe wystąpienie centrum FinOps, w tym Eksplorator danych, Magazyn usługi Data Lake i usługę Data Factory. |
Definicja zasobu szablonu usługi ARM
Typ zasobu klastrów/baz danych/skryptów można wdrożyć przy użyciu operacji docelowych:
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.
Format zasobu
Aby utworzyć zasób Microsoft.Kusto/clusters/databases/scripts, dodaj następujący kod JSON do szablonu.
{
"type": "Microsoft.Kusto/clusters/databases/scripts",
"apiVersion": "2022-07-07",
"name": "string",
"properties": {
"continueOnErrors": "bool",
"forceUpdateTag": "string",
"scriptContent": "string",
"scriptUrl": "string",
"scriptUrlSasToken": "string"
}
}
Wartości właściwości
Microsoft.Kusto/clusters/databases/scripts
| Nazwa | Opis | Wartość |
|---|---|---|
| apiVersion | Wersja interfejsu API | '2022-07-07' |
| nazwa | Nazwa zasobu | ciąg (wymagany) |
| Właściwości | Skrypt bazy danych. | Właściwości skryptów |
| typ | Typ zasobu | "Microsoft.Kusto/clusters/databases/scripts" |
Właściwości skryptów
| Nazwa | Opis | Wartość |
|---|---|---|
| continueOnErrors | Flaga wskazująca, czy kontynuować, jeśli jedno z poleceń zakończy się niepowodzeniem. | Bool |
| forceUpdateTag | Unikatowy ciąg. Jeśli skrypt zostanie zmieniony, zostanie ponownie zastosowany. | ciąg |
| scriptContent | Zawartość skryptu. Ta właściwość powinna być używana, gdy skrypt jest wbudowany, a nie za pośrednictwem pliku w sa. Nie można używać razem z właściwościami scriptUrl i scriptUrlSasToken. | struna Ograniczenia: Wartość wrażliwa. Przekaż jako bezpieczny parametr. |
| scriptUrl | Adres URL do pliku obiektu blob skryptu języka KQL. Nie można używać razem z właściwością scriptContent | ciąg |
| scriptUrlSasToken | Token saS, który zapewnia dostęp do odczytu do pliku zawierającego skrypt. Należy podać w przypadku używania właściwości scriptUrl. | struna Ograniczenia: Wartość wrażliwa. Przekaż jako bezpieczny parametr. |
Przykłady użycia
Szablony szybkiego startu platformy Azure
Następujące szablony szybkiego startu platformy Azure wdrożyć ten typ zasobu.
| Szablon | Opis |
|---|---|
|
wdrażanie usługi Azure Data Explorer DB przy użyciu połączenia usługi Cosmos DB wdrażanie |
Wdrażanie bazy danych usługi Azure Data Explorer przy użyciu połączenia usługi Cosmos DB. |
|
wdrażanie bazy danych usługi Azure Data Explorer przy użyciu połączenia usługi Event Grid wdrażanie |
Wdrażanie bazy danych usługi Azure Data Explorer za pomocą połączenia usługi Event Grid. |
|
wdrażanie bazy danych usługi Azure Data Explorer przy użyciu połączenia centrum zdarzeń wdrażanie |
Wdrażanie bazy danych usługi Azure Data Explorer za pomocą połączenia centrum zdarzeń. |
| centrum wdrażanie |
Ten szablon tworzy nowe wystąpienie centrum FinOps, w tym Eksplorator danych, Magazyn usługi Data Lake i usługę Data Factory. |
Definicja zasobu narzędzia Terraform (dostawcy AzAPI)
Typ zasobu klastrów/baz danych/skryptów można wdrożyć przy użyciu operacji docelowych:
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.
Format zasobu
Aby utworzyć zasób Microsoft.Kusto/clusters/databases/scripts, dodaj następujący program Terraform do szablonu.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Kusto/clusters/databases/scripts@2022-07-07"
name = "string"
parent_id = "string"
body = {
properties = {
continueOnErrors = bool
forceUpdateTag = "string"
scriptContent = "string"
scriptUrl = "string"
scriptUrlSasToken = "string"
}
}
}
Wartości właściwości
Microsoft.Kusto/clusters/databases/scripts
| Nazwa | Opis | Wartość |
|---|---|---|
| nazwa | Nazwa zasobu | ciąg (wymagany) |
| parent_id | Identyfikator zasobu, który jest elementem nadrzędnym dla tego zasobu. | Identyfikator zasobu typu: klastry/bazy danych |
| Właściwości | Skrypt bazy danych. | Właściwości skryptów |
| typ | Typ zasobu | "Microsoft.Kusto/clusters/databases/scripts@2022-07-07" |
Właściwości skryptów
| Nazwa | Opis | Wartość |
|---|---|---|
| continueOnErrors | Flaga wskazująca, czy kontynuować, jeśli jedno z poleceń zakończy się niepowodzeniem. | Bool |
| forceUpdateTag | Unikatowy ciąg. Jeśli skrypt zostanie zmieniony, zostanie ponownie zastosowany. | ciąg |
| scriptContent | Zawartość skryptu. Ta właściwość powinna być używana, gdy skrypt jest wbudowany, a nie za pośrednictwem pliku w sa. Nie można używać razem z właściwościami scriptUrl i scriptUrlSasToken. | struna Ograniczenia: Wartość wrażliwa. Przekaż jako bezpieczny parametr. |
| scriptUrl | Adres URL do pliku obiektu blob skryptu języka KQL. Nie można używać razem z właściwością scriptContent | ciąg |
| scriptUrlSasToken | Token saS, który zapewnia dostęp do odczytu do pliku zawierającego skrypt. Należy podać w przypadku używania właściwości scriptUrl. | struna Ograniczenia: Wartość wrażliwa. Przekaż jako bezpieczny parametr. |
Przykłady użycia
Przykłady programu Terraform
Podstawowy przykład wdrażania skryptu 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 = ["*"]
}
Podstawowy przykład wdrażania skryptu 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 = ["*"]
}