Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Definizione di risorsa Bicep
Il tipo di risorsa cluster/database può essere distribuito con operazioni destinate a:
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 del database Kusto/Esplora dati.
param resourceName string = 'acctest0001'
param location string = 'westeurope'
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: {}
}
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 |
|---|---|
| Gemelli digitali di Azure con connessione cronologia dati temporali | Questo modello crea un'istanza di Gemelli digitali di Azure configurata con una connessione cronologia dati di serie temporali. Per creare una connessione, è necessario creare altre risorse, ad esempio uno spazio dei nomi di Hub eventi, un hub eventi, un cluster di Esplora dati di Azure e un database. I dati vengono inviati a un hub eventi che inoltra infine i dati al cluster di Esplora dati di Azure. I dati vengono archiviati in una tabella di database nel cluster |
| Creare un watcher di database | Questo esempio crea un watcher del database per SQL di Azure e configura l'archivio dati, le destinazioni SQL e gli endpoint privati gestiti |
| 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, aggiungere il bicep seguente al modello.
resource symbolicname 'Microsoft.Kusto/clusters/databases@2025-02-14' = {
location: 'string'
name: 'string'
kind: 'string'
// For remaining properties, see Microsoft.Kusto/clusters/databases objects
}
Oggetti Microsoft.Kusto/clusters/databases
Impostare la proprietà tipo di
Per ReadOnlyFollowing, usare:
{
kind: 'ReadOnlyFollowing'
properties: {
hotCachePeriod: 'string'
}
}
Per ReadWrite, usare:
{
kind: 'ReadWrite'
properties: {
hotCachePeriod: 'string'
keyVaultProperties: {
federatedIdentityClientId: 'string'
keyName: 'string'
keyVaultUri: 'string'
keyVersion: 'string'
userIdentity: 'string'
}
softDeletePeriod: 'string'
}
}
Valori delle proprietà
Microsoft.Kusto/clusters/databases
| Nome | Descrizione | Valore |
|---|---|---|
| gentile | Impostare su 'ReadOnlyFollowing' per il tipo ReadOnlyFollowingDatabase. Impostare su "ReadWrite" per il tipo ReadWriteDatabase. | 'ReadOnlyFollowing' 'ReadWrite' (obbligatorio) |
| ubicazione | Percorso della risorsa. | corda |
| 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 |
KeyVaultProperties
| Nome | Descrizione | Valore |
|---|---|---|
| federatedIdentityClientId | L'ID dell'applicazione (client) dell'applicazione multi-tenant Microsoft Entra. Utilizzato per scenari di chiave gestite dal cliente cross-tenant in cui la chiave di crittografia è memorizzata in un tenant diverso rispetto al cluster. L'applicazione deve essere configurata con l'identità gestita assegnata dall'utente come credenziale di identità federata. | corda |
| keyName | Nome della chiave dell'insieme di credenziali delle chiavi. | corda |
| keyVaultUri | URI dell'insieme di credenziali delle chiavi. | corda |
| keyVersion | Versione della chiave dell'insieme di credenziali delle chiavi. | corda |
| Identità utente | Identità assegnata dall'utente (ID risorsa ARM) che ha accesso alla chiave. L'identità deve avere i permessi 'Get', 'Wrap Key' e 'Unwrap Key' sulla chiave di Key Vault, oppure deve essere assegnata al ruolo 'Key Vault Crypto Service Encryption User'. | corda |
Database ReadOnlyFollowingFollowingReadOnlyFollowingReadOnlyFollowingDatabase
| Nome | Descrizione | Valore |
|---|---|---|
| gentile | Tipo di database | 'ReadOnlyFollowing' (obbligatorio) |
| proprietà | Proprietà del database. | Proprietà del database ReadOnlyFollowingFollowingReadOnlyFollowingReadFollowingIndexReadFollowingIndexReadT |
Proprietà del database ReadOnlyFollowingFollowingReadOnlyFollowingReadFollowingIndexReadFollowingIndexReadT
| Nome | Descrizione | Valore |
|---|---|---|
| hotCachePeriod | Ora in cui i dati devono essere mantenuti nella cache per query veloci in TimeSpan. | corda |
ReadWriteDatabase
| Nome | Descrizione | Valore |
|---|---|---|
| gentile | Tipo di database | 'ReadWrite' (obbligatorio) |
| proprietà | Proprietà del database. | Proprietà del database ReadWriteDatabaseReadWrite |
Proprietà del database ReadWriteDatabaseReadWrite
| Nome | Descrizione | Valore |
|---|---|---|
| hotCachePeriod | Ora in cui i dati devono essere mantenuti nella cache per query veloci in TimeSpan. | corda |
| keyVaultProperties | Proprietà dell'insieme di credenziali delle chiavi per la crittografia del database. | KeyVaultProperties |
| softDeletePeriod | Ora in cui i dati devono essere mantenuti prima che non siano accessibili alle query in TimeSpan. | corda |
Definizione di risorsa del modello di Resource Manager
Il tipo di risorsa cluster/database può essere distribuito con operazioni destinate a:
- Gruppi di risorse - Vedi comandi di distribuzione dei gruppi di risorse Per un elenco delle proprietà modificate in ciascuna versione API, vedi registro delle modifiche.
Esempi di utilizzo
Modelli di avvio rapido di Azure
I modelli di avvio rapido di Azure seguenti distribuire questo tipo di risorsa.
| Sagoma | Descrizione |
|---|---|
|
Gemelli digitali di Azure con connessione cronologia dati temporali |
Questo modello crea un'istanza di Gemelli digitali di Azure configurata con una connessione cronologia dati di serie temporali. Per creare una connessione, è necessario creare altre risorse, ad esempio uno spazio dei nomi di Hub eventi, un hub eventi, un cluster di Esplora dati di Azure e un database. I dati vengono inviati a un hub eventi che inoltra infine i dati al cluster di Esplora dati di Azure. I dati vengono archiviati in una tabella di database nel cluster |
|
Creare un cluster di un database |
Questo modello consente di creare un cluster e un database. |
|
Creare un watcher di database |
Questo esempio crea un watcher del database per SQL di Azure e configura l'archivio dati, le destinazioni SQL e gli endpoint privati gestiti |
|
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, aggiungere il codice JSON seguente al modello.
{
"location": "string",
"name": "string",
"kind": "string"
// For remaining properties, see Microsoft.Kusto/clusters/databases objects
}
Oggetti Microsoft.Kusto/clusters/databases
Impostare la proprietà tipo di
Per ReadOnlyFollowing, usare:
{
"kind": "ReadOnlyFollowing",
"properties": {
"hotCachePeriod": "string"
}
}
Per ReadWrite, usare:
{
"kind": "ReadWrite",
"properties": {
"hotCachePeriod": "string",
"keyVaultProperties": {
"federatedIdentityClientId": "string",
"keyName": "string",
"keyVaultUri": "string",
"keyVersion": "string",
"userIdentity": "string"
},
"softDeletePeriod": "string"
}
}
Valori delle proprietà
Microsoft.Kusto/clusters/databases
| Nome | Descrizione | Valore |
|---|---|---|
| versione dell'API | Versione dell'API | '2025-02-14' |
| gentile | Impostare su 'ReadOnlyFollowing' per il tipo ReadOnlyFollowingDatabase. Impostare su "ReadWrite" per il tipo ReadWriteDatabase. | 'ReadOnlyFollowing' 'ReadWrite' (obbligatorio) |
| ubicazione | Percorso della risorsa. | corda |
| nome | Nome della risorsa | corda Vincoli: Pattern = ^.*$ (obbligatorio) |
| digitare | Tipo di risorsa | 'Microsoft.Kusto/clusters/databases' |
KeyVaultProperties
| Nome | Descrizione | Valore |
|---|---|---|
| federatedIdentityClientId | L'ID dell'applicazione (client) dell'applicazione multi-tenant Microsoft Entra. Utilizzato per scenari di chiave gestite dal cliente cross-tenant in cui la chiave di crittografia è memorizzata in un tenant diverso rispetto al cluster. L'applicazione deve essere configurata con l'identità gestita assegnata dall'utente come credenziale di identità federata. | corda |
| keyName | Nome della chiave dell'insieme di credenziali delle chiavi. | corda |
| keyVaultUri | URI dell'insieme di credenziali delle chiavi. | corda |
| keyVersion | Versione della chiave dell'insieme di credenziali delle chiavi. | corda |
| Identità utente | Identità assegnata dall'utente (ID risorsa ARM) che ha accesso alla chiave. L'identità deve avere i permessi 'Get', 'Wrap Key' e 'Unwrap Key' sulla chiave di Key Vault, oppure deve essere assegnata al ruolo 'Key Vault Crypto Service Encryption User'. | corda |
Database ReadOnlyFollowingFollowingReadOnlyFollowingReadOnlyFollowingDatabase
| Nome | Descrizione | Valore |
|---|---|---|
| gentile | Tipo di database | 'ReadOnlyFollowing' (obbligatorio) |
| proprietà | Proprietà del database. | Proprietà del database ReadOnlyFollowingFollowingReadOnlyFollowingReadFollowingIndexReadFollowingIndexReadT |
Proprietà del database ReadOnlyFollowingFollowingReadOnlyFollowingReadFollowingIndexReadFollowingIndexReadT
| Nome | Descrizione | Valore |
|---|---|---|
| hotCachePeriod | Ora in cui i dati devono essere mantenuti nella cache per query veloci in TimeSpan. | corda |
ReadWriteDatabase
| Nome | Descrizione | Valore |
|---|---|---|
| gentile | Tipo di database | 'ReadWrite' (obbligatorio) |
| proprietà | Proprietà del database. | Proprietà del database ReadWriteDatabaseReadWrite |
Proprietà del database ReadWriteDatabaseReadWrite
| Nome | Descrizione | Valore |
|---|---|---|
| hotCachePeriod | Ora in cui i dati devono essere mantenuti nella cache per query veloci in TimeSpan. | corda |
| keyVaultProperties | Proprietà dell'insieme di credenziali delle chiavi per la crittografia del database. | KeyVaultProperties |
| softDeletePeriod | Ora in cui i dati devono essere mantenuti prima che non siano accessibili alle query in TimeSpan. | corda |
Definizione di risorsa Terraform (provider AzAPI)
Il tipo di risorsa cluster/database 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 del database Kusto/Esplora dati.
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 = ["*"]
}
Esempio di base di distribuzione del database Kusto/Esplora dati.
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 = ["*"]
}
Formato risorsa
Per creare una risorsa Microsoft.Kusto/clusters/databases, aggiungere il file Terraform seguente al modello.
resource "azapi_resource" "symbolicname" {
location = "string"
name = "string"
kind = "string"
// For remaining properties, see Microsoft.Kusto/clusters/databases objects
}
Oggetti Microsoft.Kusto/clusters/databases
Impostare la proprietà tipo di
Per ReadOnlyFollowing, usare:
{
kind = "ReadOnlyFollowing"
properties = {
hotCachePeriod = "string"
}
}
Per ReadWrite, usare:
{
kind = "ReadWrite"
properties = {
hotCachePeriod = "string"
keyVaultProperties = {
federatedIdentityClientId = "string"
keyName = "string"
keyVaultUri = "string"
keyVersion = "string"
userIdentity = "string"
}
softDeletePeriod = "string"
}
}
Valori delle proprietà
Microsoft.Kusto/clusters/databases
| Nome | Descrizione | Valore |
|---|---|---|
| gentile | Impostare su 'ReadOnlyFollowing' per il tipo ReadOnlyFollowingDatabase. Impostare su "ReadWrite" per il tipo ReadWriteDatabase. | 'ReadOnlyFollowing' 'ReadWrite' (obbligatorio) |
| ubicazione | Percorso della risorsa. | corda |
| nome | Nome della risorsa | corda Vincoli: Pattern = ^.*$ (obbligatorio) |
| parent_id | ID della risorsa padre per questa risorsa. | ID per la risorsa di tipo: cluster |
| digitare | Tipo di risorsa | "Microsoft.Kusto/clusters/databases@2025-02-14" |
KeyVaultProperties
| Nome | Descrizione | Valore |
|---|---|---|
| federatedIdentityClientId | L'ID dell'applicazione (client) dell'applicazione multi-tenant Microsoft Entra. Utilizzato per scenari di chiave gestite dal cliente cross-tenant in cui la chiave di crittografia è memorizzata in un tenant diverso rispetto al cluster. L'applicazione deve essere configurata con l'identità gestita assegnata dall'utente come credenziale di identità federata. | corda |
| keyName | Nome della chiave dell'insieme di credenziali delle chiavi. | corda |
| keyVaultUri | URI dell'insieme di credenziali delle chiavi. | corda |
| keyVersion | Versione della chiave dell'insieme di credenziali delle chiavi. | corda |
| Identità utente | Identità assegnata dall'utente (ID risorsa ARM) che ha accesso alla chiave. L'identità deve avere i permessi 'Get', 'Wrap Key' e 'Unwrap Key' sulla chiave di Key Vault, oppure deve essere assegnata al ruolo 'Key Vault Crypto Service Encryption User'. | corda |
Database ReadOnlyFollowingFollowingReadOnlyFollowingReadOnlyFollowingDatabase
| Nome | Descrizione | Valore |
|---|---|---|
| gentile | Tipo di database | 'ReadOnlyFollowing' (obbligatorio) |
| proprietà | Proprietà del database. | Proprietà del database ReadOnlyFollowingFollowingReadOnlyFollowingReadFollowingIndexReadFollowingIndexReadT |
Proprietà del database ReadOnlyFollowingFollowingReadOnlyFollowingReadFollowingIndexReadFollowingIndexReadT
| Nome | Descrizione | Valore |
|---|---|---|
| hotCachePeriod | Ora in cui i dati devono essere mantenuti nella cache per query veloci in TimeSpan. | corda |
ReadWriteDatabase
| Nome | Descrizione | Valore |
|---|---|---|
| gentile | Tipo di database | 'ReadWrite' (obbligatorio) |
| proprietà | Proprietà del database. | Proprietà del database ReadWriteDatabaseReadWrite |
Proprietà del database ReadWriteDatabaseReadWrite
| Nome | Descrizione | Valore |
|---|---|---|
| hotCachePeriod | Ora in cui i dati devono essere mantenuti nella cache per query veloci in TimeSpan. | corda |
| keyVaultProperties | Proprietà dell'insieme di credenziali delle chiavi per la crittografia del database. | KeyVaultProperties |
| softDeletePeriod | Ora in cui i dati devono essere mantenuti prima che non siano accessibili alle query in TimeSpan. | corda |