Udostępnij przez


Klastry/bazy danych Microsoft.Kusto

Definicja zasobu Bicep

Typ zasobu klastrów/baz danych 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, dodaj następujący kod Bicep do szablonu.

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

Microsoft.Kusto/clusters/databases objects

Ustaw właściwość typu , aby określić typ obiektu.

W przypadku ReadOnlyFollowingużyj:

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

W przypadku ReadWrite użyj:

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

Wartości właściwości

Microsoft.Kusto/clusters/databases

Nazwa Opis Wartość
rodzaj Ustaw wartość "ReadOnlyFollowing" dla typu ReadOnlyFollowingDatabase. Ustaw wartość "ReadWrite" dla typu ReadWriteDatabase. "ReadOnlyFollowing"
"ReadWrite" (wymagane)
lokalizacja Lokalizacja zasobu. ciąg
nazwa Nazwa zasobu struna

Ograniczenia:
Wzorzec = ^.*$ (wymagane)
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: klastrów

Właściwości KeyVaultProperties

Nazwa Opis Wartość
keyName (nazwa_klucza) Nazwa klucza magazynu kluczy. ciąg
identyfikator keyVaultUri Identyfikator URI magazynu kluczy. ciąg
keyVersion (wersja klucza) Wersja klucza magazynu kluczy. ciąg
Tożsamość użytkownika Tożsamość przypisana przez użytkownika (identyfikator zasobu usługi ARM), która ma dostęp do klucza. ciąg

ReadOnlyFollowingDatabase

Nazwa Opis Wartość
rodzaj Rodzaj bazy danych "ReadOnlyFollowing" (wymagane)
Właściwości Właściwości bazy danych. ReadOnlyFollowingDatabaseProperties

ReadOnlyFollowingDatabaseProperties

Nazwa Opis Wartość
hotCachePeriod (okres buforowania) Czas przechowywania danych w pamięci podręcznej na potrzeby szybkich zapytań w funkcji TimeSpan. ciąg

ReadWriteDatabase

Nazwa Opis Wartość
rodzaj Rodzaj bazy danych "ReadWrite" (wymagane)
Właściwości Właściwości bazy danych. readWriteDatabaseProperties

ReadWriteDatabaseProperties

Nazwa Opis Wartość
hotCachePeriod (okres buforowania) Czas przechowywania danych w pamięci podręcznej na potrzeby szybkich zapytań w funkcji TimeSpan. ciąg
keyVaultProperties (właściwości klucza) Właściwości usługi KeyVault dla szyfrowania bazy danych. Właściwości KeyVaultProperties
okres miękkiego usuwania Czas, przez jaki dane powinny być przechowywane, zanim przestaną być dostępne dla zapytań w okienku TimeSpan. ciąg

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
usługi Azure Digital Twins z połączeniem historii danych czasowych Ten szablon tworzy wystąpienie usługi Azure Digital Twins skonfigurowane przy użyciu połączenia historii danych szeregów czasowych. Aby utworzyć połączenie, należy utworzyć inne zasoby, takie jak przestrzeń nazw usługi Event Hubs, centrum zdarzeń, klaster usługi Azure Data Explorer i baza danych. Dane są wysyłane do centrum zdarzeń, które ostatecznie przekazuje dane do klastra usługi Azure Data Explorer. Dane są przechowywane w tabeli bazy danych w klastrze
Tworzenie obserwatora bazy danych Ten przykład tworzy obserwatora bazy danych dla usługi Azure SQL i konfiguruje magazyn danych, obiekty docelowe SQL i zarządzane prywatne punkty końcowe
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 FinOps 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 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, dodaj następujący kod JSON do szablonu.

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

Microsoft.Kusto/clusters/databases objects

Ustaw właściwość typu , aby określić typ obiektu.

W przypadku ReadOnlyFollowingużyj:

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

W przypadku ReadWrite użyj:

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

Wartości właściwości

Microsoft.Kusto/clusters/databases

Nazwa Opis Wartość
apiVersion (wersja interfejsu api) Wersja interfejsu API '2024-04-13'
rodzaj Ustaw wartość "ReadOnlyFollowing" dla typu ReadOnlyFollowingDatabase. Ustaw wartość "ReadWrite" dla typu ReadWriteDatabase. "ReadOnlyFollowing"
"ReadWrite" (wymagane)
lokalizacja Lokalizacja zasobu. ciąg
nazwa Nazwa zasobu struna

Ograniczenia:
Wzorzec = ^.*$ (wymagane)
typ Typ zasobu "Microsoft.Kusto/clusters/databases"

Właściwości KeyVaultProperties

Nazwa Opis Wartość
keyName (nazwa_klucza) Nazwa klucza magazynu kluczy. ciąg
identyfikator keyVaultUri Identyfikator URI magazynu kluczy. ciąg
keyVersion (wersja klucza) Wersja klucza magazynu kluczy. ciąg
Tożsamość użytkownika Tożsamość przypisana przez użytkownika (identyfikator zasobu usługi ARM), która ma dostęp do klucza. ciąg

ReadOnlyFollowingDatabase

Nazwa Opis Wartość
rodzaj Rodzaj bazy danych "ReadOnlyFollowing" (wymagane)
Właściwości Właściwości bazy danych. ReadOnlyFollowingDatabaseProperties

ReadOnlyFollowingDatabaseProperties

Nazwa Opis Wartość
hotCachePeriod (okres buforowania) Czas przechowywania danych w pamięci podręcznej na potrzeby szybkich zapytań w funkcji TimeSpan. ciąg

ReadWriteDatabase

Nazwa Opis Wartość
rodzaj Rodzaj bazy danych "ReadWrite" (wymagane)
Właściwości Właściwości bazy danych. readWriteDatabaseProperties

ReadWriteDatabaseProperties

Nazwa Opis Wartość
hotCachePeriod (okres buforowania) Czas przechowywania danych w pamięci podręcznej na potrzeby szybkich zapytań w funkcji TimeSpan. ciąg
keyVaultProperties (właściwości klucza) Właściwości usługi KeyVault dla szyfrowania bazy danych. Właściwości KeyVaultProperties
okres miękkiego usuwania Czas, przez jaki dane powinny być przechowywane, zanim przestaną być dostępne dla zapytań w okienku TimeSpan. ciąg

Przykłady użycia

Szablony szybkiego startu platformy Azure

Następujące szablony szybkiego startu platformy Azure wdrożyć ten typ zasobu.

Szablon Opis
usługi Azure Digital Twins z połączeniem historii danych czasowych

wdrażanie w usłudze Azure
Ten szablon tworzy wystąpienie usługi Azure Digital Twins skonfigurowane przy użyciu połączenia historii danych szeregów czasowych. Aby utworzyć połączenie, należy utworzyć inne zasoby, takie jak przestrzeń nazw usługi Event Hubs, centrum zdarzeń, klaster usługi Azure Data Explorer i baza danych. Dane są wysyłane do centrum zdarzeń, które ostatecznie przekazuje dane do klastra usługi Azure Data Explorer. Dane są przechowywane w tabeli bazy danych w klastrze
Tworzenie klastra bazy danych

wdrażanie w usłudze Azure
Ten szablon umożliwia utworzenie klastra i bazy danych.
Tworzenie obserwatora bazy danych

wdrażanie w usłudze Azure
Ten przykład tworzy obserwatora bazy danych dla usługi Azure SQL i konfiguruje magazyn danych, obiekty docelowe SQL i zarządzane prywatne punkty końcowe
wdrażanie usługi Azure Data Explorer DB przy użyciu połączenia usługi Cosmos DB

wdrażanie w usłudze Azure
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 w usłudze Azure
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 w usłudze Azure
Wdrażanie bazy danych usługi Azure Data Explorer za pomocą połączenia centrum zdarzeń.
centrum FinOps

wdrażanie w usłudze Azure
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 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, dodaj następujący program Terraform do szablonu.

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

Microsoft.Kusto/clusters/databases objects

Ustaw właściwość typu , aby określić typ obiektu.

W przypadku ReadOnlyFollowingużyj:

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

W przypadku ReadWrite użyj:

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

Wartości właściwości

Microsoft.Kusto/clusters/databases

Nazwa Opis Wartość
rodzaj Ustaw wartość "ReadOnlyFollowing" dla typu ReadOnlyFollowingDatabase. Ustaw wartość "ReadWrite" dla typu ReadWriteDatabase. "ReadOnlyFollowing"
"ReadWrite" (wymagane)
lokalizacja Lokalizacja zasobu. ciąg
nazwa Nazwa zasobu struna

Ograniczenia:
Wzorzec = ^.*$ (wymagane)
parent_id (identyfikator rodzica) Identyfikator zasobu, który jest elementem nadrzędnym dla tego zasobu. Identyfikator zasobu typu: klastrów
typ Typ zasobu "Microsoft.Kusto/clusters/databases@2024-04-13"

Właściwości KeyVaultProperties

Nazwa Opis Wartość
keyName (nazwa_klucza) Nazwa klucza magazynu kluczy. ciąg
identyfikator keyVaultUri Identyfikator URI magazynu kluczy. ciąg
keyVersion (wersja klucza) Wersja klucza magazynu kluczy. ciąg
Tożsamość użytkownika Tożsamość przypisana przez użytkownika (identyfikator zasobu usługi ARM), która ma dostęp do klucza. ciąg

ReadOnlyFollowingDatabase

Nazwa Opis Wartość
rodzaj Rodzaj bazy danych "ReadOnlyFollowing" (wymagane)
Właściwości Właściwości bazy danych. ReadOnlyFollowingDatabaseProperties

ReadOnlyFollowingDatabaseProperties

Nazwa Opis Wartość
hotCachePeriod (okres buforowania) Czas przechowywania danych w pamięci podręcznej na potrzeby szybkich zapytań w funkcji TimeSpan. ciąg

ReadWriteDatabase

Nazwa Opis Wartość
rodzaj Rodzaj bazy danych "ReadWrite" (wymagane)
Właściwości Właściwości bazy danych. readWriteDatabaseProperties

ReadWriteDatabaseProperties

Nazwa Opis Wartość
hotCachePeriod (okres buforowania) Czas przechowywania danych w pamięci podręcznej na potrzeby szybkich zapytań w funkcji TimeSpan. ciąg
keyVaultProperties (właściwości klucza) Właściwości usługi KeyVault dla szyfrowania bazy danych. Właściwości KeyVaultProperties
okres miękkiego usuwania Czas, przez jaki dane powinny być przechowywane, zanim przestaną być dostępne dla zapytań w okienku TimeSpan. ciąg

Przykłady użycia

Przykłady programu Terraform

Podstawowy przykład wdrażania Kusto/Data Explorer Database.

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

Podstawowy przykład wdrażania Kusto/Data Explorer Database.

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