Condividi tramite


Clusterpools/cluster Microsoft.HDInsight 2023-06-01-preview

Definizione di risorsa Bicep

Il tipo di risorsa clusterpools/clusters 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.

Formato risorsa

Per creare una risorsa Microsoft.HDInsight/clusterpools/clusters, aggiungere il bicep seguente al modello.

resource symbolicname 'Microsoft.HDInsight/clusterpools/clusters@2023-06-01-preview' = {
  parent: resourceSymbolicName
  location: 'string'
  name: 'string'
  properties: {
    clusterProfile: {
      authorizationProfile: {
        groupIds: [
          'string'
        ]
        userIds: [
          'string'
        ]
      }
      autoscaleProfile: {
        autoscaleType: 'string'
        enabled: bool
        gracefulDecommissionTimeout: int
        loadBasedConfig: {
          cooldownPeriod: int
          maxNodes: int
          minNodes: int
          pollInterval: int
          scalingRules: [
            {
              actionType: 'string'
              comparisonRule: {
                operator: 'string'
                threshold: int
              }
              evaluationCount: int
              scalingMetric: 'string'
            }
          ]
        }
        scheduleBasedConfig: {
          defaultCount: int
          schedules: [
            {
              count: int
              days: [
                'string'
              ]
              endTime: 'string'
              startTime: 'string'
            }
          ]
          timeZone: 'string'
        }
      }
      clusterVersion: 'string'
      flinkProfile: {
        catalogOptions: {
          hive: {
            metastoreDbConnectionPasswordSecret: 'string'
            metastoreDbConnectionURL: 'string'
            metastoreDbConnectionUserName: 'string'
          }
        }
        historyServer: {
          cpu: int
          memory: int
        }
        jobManager: {
          cpu: int
          memory: int
        }
        numReplicas: int
        storage: {
          storagekey: 'string'
          storageUri: 'string'
        }
        taskManager: {
          cpu: int
          memory: int
        }
      }
      identityProfile: {
        msiClientId: 'string'
        msiObjectId: 'string'
        msiResourceId: 'string'
      }
      kafkaProfile: {
        {customized property}: any(Azure.Bicep.Types.Concrete.AnyType)
      }
      llapProfile: {
        {customized property}: any(Azure.Bicep.Types.Concrete.AnyType)
      }
      logAnalyticsProfile: {
        applicationLogs: {
          stdErrorEnabled: bool
          stdOutEnabled: bool
        }
        enabled: bool
        metricsEnabled: bool
      }
      ossVersion: 'string'
      prometheusProfile: {
        enabled: bool
      }
      scriptActionProfiles: [
        {
          name: 'string'
          parameters: 'string'
          services: [
            'string'
          ]
          shouldPersist: bool
          timeoutInMinutes: int
          type: 'string'
          url: 'string'
        }
      ]
      secretsProfile: {
        keyVaultResourceId: 'string'
        secrets: [
          {
            keyVaultObjectName: 'string'
            referenceName: 'string'
            type: 'string'
            version: 'string'
          }
        ]
      }
      serviceConfigsProfiles: [
        {
          configs: [
            {
              component: 'string'
              files: [
                {
                  content: 'string'
                  encoding: 'string'
                  fileName: 'string'
                  path: 'string'
                  values: {
                    {customized property}: 'string'
                  }
                }
              ]
            }
          ]
          serviceName: 'string'
        }
      ]
      sparkProfile: {
        defaultStorageUrl: 'string'
        metastoreSpec: {
          dbName: 'string'
          dbPasswordSecretName: 'string'
          dbServerHost: 'string'
          dbUserName: 'string'
          keyVaultId: 'string'
          thriftUrl: 'string'
        }
        userPluginsSpec: {
          plugins: [
            {
              path: 'string'
            }
          ]
        }
      }
      sshProfile: {
        count: int
      }
      stubProfile: {
        {customized property}: any(Azure.Bicep.Types.Concrete.AnyType)
      }
      trinoProfile: {
        catalogOptions: {
          hive: [
            {
              catalogName: 'string'
              metastoreDbConnectionPasswordSecret: 'string'
              metastoreDbConnectionURL: 'string'
              metastoreDbConnectionUserName: 'string'
              metastoreWarehouseDir: 'string'
            }
          ]
        }
        coordinator: {
          debug: {
            enable: bool
            port: int
            suspend: bool
          }
          highAvailabilityEnabled: bool
        }
        userPluginsSpec: {
          plugins: [
            {
              enabled: bool
              name: 'string'
              path: 'string'
            }
          ]
        }
        userTelemetrySpec: {
          storage: {
            hivecatalogName: 'string'
            hivecatalogSchema: 'string'
            partitionRetentionInDays: int
            path: 'string'
          }
        }
        worker: {
          debug: {
            enable: bool
            port: int
            suspend: bool
          }
        }
      }
    }
    clusterType: 'string'
    computeProfile: {
      nodes: [
        {
          count: int
          type: 'string'
          vmSize: 'string'
        }
      ]
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Valori delle proprietà

AuthorizationProfile

Nome Descrizione Valore
groupIds ID gruppo AAD autorizzati per l'accesso al piano dati. string[]
userIds ID utente di AAD autorizzati per l'accesso al piano dati. string[]

AutoscaleProfile

Nome Descrizione Valore
autoscaleType Utente per specificare il tipo di scalabilità automatica da implementare: basato su base pianificata o basata sul carico. 'LoadBased'
'ScheduleBased'
Abilitato Indica se la scalabilità automatica è abilitata in HDInsight nel cluster del servizio Azure Kubernetes. bool (obbligatorio)
gracefulDecommissionTimeout Questa proprietà è per il timeout delle autorizzazioni normale; Ha un'impostazione predefinita di 3600 secondi prima dell'arresto forzato. Questo è il tempo massimo di attesa per il completamento dei contenitori e delle applicazioni in esecuzione prima della transizione di un nodo DECOMMISSIONING in DECOMMISSIONED. Il valore predefinito è 3600 secondi. Il valore negativo (ad esempio -1) viene gestito come timeout infinito. Int
loadBasedConfig Profili di scalabilità automatica basata sul carico. loadBasedConfig
scheduleBasedConfig Profili di scalabilità automatica basata su pianificazione. ScheduleBasedConfig

CatalogOptions

Nome Descrizione Valore
alveare Opzioni del catalogo hive. HiveCatalogOption[]

ClusterConfigFile

Nome Descrizione Valore
contenuto Contenuto in formato libero dell'intero file di configurazione. corda
codifica Questa proprietà indica se il contenuto è codificato e non fa distinzione tra maiuscole e minuscole. Impostare il valore su base64 se il contenuto è codificato in base64. Impostarlo su nessuno o ignorarlo se il contenuto è testo normale. 'Base64'
'Nessuno'
Filename Nome file di configurazione. stringa (obbligatorio)
sentiero Percorso del file di configurazione se è specificato il contenuto. corda
valori Elenco di coppie chiave-valore
dove key rappresenta un nome e un valore di configurazione del servizio validi rappresenta il valore della configurazione.
ClusterConfigFileValues

ClusterConfigFileValues

Nome Descrizione Valore

ClusterLogAnalyticsApplicationLogs

Nome Descrizione Valore
stdErrorEnabled True se stderror è abilitato; in caso contrario, false. Bool
stdOutEnabled True se stdout è abilitato; in caso contrario, false. Bool

ClusterLogAnalyticsProfile

Nome Descrizione Valore
applicationLogs Raccolta di log da abilitare o disabilitare per Log Analytics. ClusterLogAnalyticsApplicationLogs
Abilitato True se Log Analytics è abilitato per il cluster; in caso contrario, false. bool (obbligatorio)
metricsEnabled True se le metriche sono abilitate; in caso contrario, false. Bool

ClusterProfile

Nome Descrizione Valore
authorizationProfile Profilo di autorizzazione con i dettagli degli ID utente e degli ID gruppo di AAD autorizzati per l'accesso al piano dati. AuthorizationProfile (obbligatorio)
autoscaleProfile Si tratta del profilo di scalabilità automatica per il cluster. Ciò consentirà al cliente di creare un cluster abilitato con scalabilità automatica. AutoscaleProfile
clusterVersion Versione con 3/4 parte. corda

Vincoli:
Pattern = ^(0|[1-9][0-9]{0,18})\.(0|[1-9][0-9]{0,18})\.(0|[1-9][0-9]{0,18})(?:\.(0|[1-9][0-9]{0,18}))?$ (obbligatorio)
flinkProfile Profilo del cluster Flink. FlinkProfile
identityProfile Profilo di identità con i dettagli di un'identità del servizio gestito. IdentityProfile (obbligatorio)
kafkaProfile Profilo del cluster Kafka. clusterProfileKafkaProfile
llapProfile Profilo del cluster LLAP. clusterProfileLlapProfile
logAnalyticsProfile Profilo di Log Analytics del cluster per abilitare o disabilitare l'agente OMS per il cluster. clusterLogAnalyticsProfile
ossVersion Versione con tre parti. corda

Vincoli:
Pattern = ^(0|[1-9][0-9]{0,18})\.(0|[1-9][0-9]{0,18})\.(0|[1-9][0-9]{0,18})$ (obbligatorio)
prometheusProfile Profilo Prometheus del cluster. clusterPrometheusProfile
scriptActionProfiles Elenco dei profili di azione script. scriptActionProfile[]
secretsProfile Profilo segreto del cluster. SecretsProfile
serviceConfigsProfiles Profili di configurazione del servizio. ClusterServiceConfigsProfile[]
sparkProfile Profilo del cluster Spark. SparkProfile
sshProfile Profilo SSH per il cluster. SshProfile
stubProfile Profilo del cluster Stub. ClusterProfileStubProfileprofile
trinoProfile Profilo del cluster Trino. TrinoProfile

ClusterProfileKafkaProfile

Nome Descrizione Valore

ClusterProfileLlapProfile

Nome Descrizione Valore

ClusterProfileStubProfile

Nome Descrizione Valore

ClusterPrometheusProfile

Nome Descrizione Valore
Abilitato Abilitare Prometheus per il cluster o meno. bool (obbligatorio)

ClusterResourceProperties

Nome Descrizione Valore
clusterProfile Profilo del cluster. ClusterProfile (obbligatorio)
clusterType Tipo di cluster. corda

Vincoli:
Pattern = ^[a-zA-Z][a-zA-Z0-9]{0,31}$ (obbligatorio)
computeProfile Profilo di calcolo. ComputeProfile (obbligatorio)

ClusterServiceConfig

Nome Descrizione Valore
componente Nome del componente a cui devono essere applicati i file di configurazione. stringa (obbligatorio)
file Elenco dei file di configurazione. clusterConfigFile[] (obbligatorio)

ClusterServiceConfigsProfile

Nome Descrizione Valore
configurazioni Elenco delle configurazioni del servizio. clusterServiceConfig[] (obbligatorio)
serviceName Nome del servizio a cui applicare le configurazioni. stringa (obbligatorio)

ComparisonRule

Nome Descrizione Valore
operatore Operatore di confronto. 'greaterThan'
'greaterThanOrEqual'
'lessThan'
'lessThanOrEqual' (obbligatorio)
soglia Impostazione soglia. int (obbligatorio)

ComputeProfile

Nome Descrizione Valore
nodi Definizioni di nodi. NodeProfile[] (obbligatorio)

ComputeResourceDefinition

Nome Descrizione Valore
CPU CPU richiesta. int (obbligatorio)
memoria La memoria necessaria in MB, la memoria del contenitore sarà 110 percentile int (obbligatorio)

FlinkCatalogOptions

Nome Descrizione Valore
alveare Opzione catalogo Hive per il cluster Flink. FlinkHiveCatalogOption

FlinkHiveCatalogOption

Nome Descrizione Valore
metastoreDbConnectionPasswordSecret Nome di riferimento segreto da secretsProfile.secrets contenente la password per la connessione al database. stringa (obbligatorio)
metastoreDbConnectionURL Stringa di connessione per il database metastore Hive. stringa (obbligatorio)
metastoreDbConnectionUserName Nome utente per la connessione al database. stringa (obbligatorio)

FlinkProfile

Nome Descrizione Valore
catalogOptions Opzioni del catalogo cluster Flink. FlinkCatalogOptions
historyServer Requisiti di CPU e memoria del server cronologia/elaborazione ComputeResourceDefinition
jobManager Requisiti di CPU e memoria del contenitore di Job Manager/processo ComputeResourceDefinition (obbligatorio)
numReplicas Numero di task manager. Int
immagazzinamento Profilo di archiviazione FlinkStorageProfile (obbligatorio)
taskManager Requisiti di CPU e memoria del contenitore di Gestione attività/elaborazione ComputeResourceDefinition (obbligatorio)

FlinkStorageProfile

Nome Descrizione Valore
storagekey La chiave di archiviazione è necessaria solo per l'archiviazione wasb.storage key is only required for wasb/s storage. corda

Vincoli:
Valore sensibile. Passare come parametro sicuro.
storageUri URI dell'account di archiviazione usato per lo stato del punto di salvataggio e del checkpoint. corda

Vincoli:
Pattern = ^(\w{4,5})://(.*)@(.*).\b(blob|dfs)\b\.core\.windows\.net$ (obbligatorio)

HiveCatalogOption

Nome Descrizione Valore
catalogName Nome del catalogo trino che deve usare il metastore hive specificato. corda

Vincoli:
Lunghezza minima = 1 (obbligatorio)
metastoreDbConnectionPasswordSecret Nome di riferimento segreto da secretsProfile.secrets contenente la password per la connessione al database. stringa (obbligatorio)
metastoreDbConnectionURL Stringa di connessione per il database metastore Hive. stringa (obbligatorio)
metastoreDbConnectionUserName Nome utente per la connessione al database. stringa (obbligatorio)
metastoreWarehouseDir URI della directory radice metastore, formato: abfs[s]://<contenitore>@<account_name>percorso .dfs.core.windows.net/<>. Altri dettagli: /azure/storage/blobs/data-lake-storage-introduction-abfs-uri stringa (obbligatorio)

IdentityProfile

Nome Descrizione Valore
msiClientId ClientId dell'identità del servizio gestito. corda

Vincoli:
Pattern = ^[{(]?[0-9A-Fa-f]{8}[-]?(?:[0-9A-Fa-f]{4}[-]?){3}[0-9A-Fa-f]{12}[)}]?$ (obbligatorio)
msiObjectId ObjectId dell'identità del servizio gestito. corda

Vincoli:
Pattern = ^[{(]?[0-9A-Fa-f]{8}[-]?(?:[0-9A-Fa-f]{4}[-]?){3}[0-9A-Fa-f]{12}[)}]?$ (obbligatorio)
msiResourceId ResourceId dell'identità del servizio gestito. stringa (obbligatorio)

LoadBasedConfig

Nome Descrizione Valore
cooldownPeriod Si tratta di un periodo di raffreddamento, ovvero un periodo di tempo in secondi, che determina la quantità di tempo che deve trascorrere tra un'attività di ridimensionamento avviata da una regola e l'inizio dell'attività di ridimensionamento successiva, indipendentemente dalla regola che lo attiva. Il valore predefinito è 300 secondi. Int
maxNodes L'utente deve impostare il numero massimo di nodi per il ridimensionamento basato sul carico, il ridimensionamento basato sul carico userà questa opzione per aumentare e ridurre le prestazioni tra il numero minimo e il numero massimo di nodi. int (obbligatorio)
minNodes L'utente deve impostare il numero minimo di nodi per il ridimensionamento basato sul carico, il ridimensionamento basato sul carico userà questa opzione per aumentare e ridurre le prestazioni tra il numero minimo e il numero massimo di nodi. int (obbligatorio)
pollInterval L'utente può specificare l'intervallo di polling, ovvero il periodo di tempo (in secondi) dopo il quale viene eseguito il polling delle metriche di ridimensionamento per l'attivazione di un'operazione di ridimensionamento. Int
scalingRules Regole di ridimensionamento. ScalingRule[] (obbligatorio)

Microsoft.HDInsight/clusterpools/clusters

Nome Descrizione Valore
ubicazione Posizione geografica in cui risiede la risorsa stringa (obbligatorio)
nome Nome della risorsa stringa (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: clusterpools
proprietà Ottiene o imposta le proprietà. Definire proprietà specifiche del cluster. ClusterResourceProperties
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli

NodeProfile

Nome Descrizione Valore
contare Numero di macchine virtuali. Int

Vincoli:
Valore minimo = 1 (obbligatorio)
digitare Tipo di nodo. corda

Vincoli:
Pattern = ^(head|Head|HEAD|worker|Worker|WORKER)$ (obbligatorio)
vmSize SKU della macchina virtuale. corda

Vincoli:
Pattern = ^[a-zA-Z0-9_\-]{0,256}$ (obbligatorio)

ScalingRule

Nome Descrizione Valore
actionType Tipo di azione. 'scaledown'
'scaleup' (obbligatorio)
comparisonRule Regola di confronto. ComparisonRule (obbligatorio)
evaluationCount Si tratta di un conteggio di valutazione per una condizione di ridimensionamento, il numero di volte in cui una condizione di trigger deve avere esito positivo, prima che venga attivata l'attività di ridimensionamento. int (obbligatorio)
scalingMetric Nome delle metriche per singoli carichi di lavoro. Ad esempio: CPU stringa (obbligatorio)

Programma

Nome Descrizione Valore
contare L'utente deve impostare il numero di nodi previsto alla fine dell'operazione di ridimensionamento della configurazione della pianificazione corrente impostata, il formato è integer. int (obbligatorio)
Giorni L'utente deve impostare i giorni in cui è necessario impostare la pianificazione per l'operazione di scalabilità automatica. Matrice di stringhe contenente uno dei seguenti elementi:
'Friday'
'Monday'
'Saturday'
'Domenica'
'Giovedì'
'Martedì'
'Mercoledì' (obbligatorio)
endTime L'utente deve impostare l'ora di fine della configurazione della pianificazione corrente, come 10:30 (HH:MM). corda

Vincoli:
Pattern = ^([0-1]?[0-9]|2[0-3]):[0-5][0-9]$ (obbligatorio)
startTime L'utente deve impostare l'ora di inizio della configurazione della pianificazione corrente, come 10:30 (HH:MM). corda

Vincoli:
Pattern = ^([0-1]?[0-9]|2[0-3]):[0-5][0-9]$ (obbligatorio)

ScheduleBasedConfig

Nome Descrizione Valore
defaultCount Impostazione del numero di nodi predefinito della configurazione della pianificazione corrente. Il numero di nodi predefinito specifica il numero di nodi predefiniti quando viene eseguita un'operazione di ridimensionamento specificata (aumento/riduzione delle prestazioni) int (obbligatorio)
Orari Specifica le pianificazioni in cui abilitare la scalabilità automatica pianificata, l'utente ha la possibilità di impostare più regole all'interno della pianificazione tra giorni e ore (inizio/fine). pianificazione [] (obbligatorio)
timeZone L'utente deve specificare il fuso orario in cui deve essere impostata la pianificazione per la configurazione della scalabilità automatica basata sulla pianificazione. stringa (obbligatorio)

ScriptActionProfile

Nome Descrizione Valore
nome Nome script. stringa (obbligatorio)
Parametri Parametri aggiuntivi per l'azione script. Deve essere un elenco separato da spazi di argomenti necessari per l'esecuzione di script. corda
servizi Elenco di servizi da applicare all'azione script. string[] (obbligatorio)
shouldPersist Specificare se lo script deve essere persistente nel cluster. Bool
timeoutInMinutes Durata del timeout per l'azione script in minuti. Int
digitare Tipo dell'azione script. Il tipo supportato è script bash. stringa (obbligatorio)
URL URL del file di script. corda

Vincoli:
Pattern = ^(https)|(http)|(abfss)|(abfs)|(wasbs)|(wasb)://.*$ (obbligatorio)

SecretReference

Nome Descrizione Valore
keyVaultObjectName Nome dell'identificatore di oggetto del segreto nell'insieme di credenziali delle chiavi. corda

Vincoli:
Pattern = ^[a-zA-Z][a-zA-Z0-9-]{1,126}$ (obbligatorio)
referenceName Nome di riferimento del segreto da usare nelle configurazioni del servizio. stringa (obbligatorio)
digitare Tipo di oggetto insieme di credenziali delle chiavi: segreto, chiave o certificato. 'Certificate'
'Key'
'Secret' (obbligatorio)
Versione Versione del segreto nell'insieme di credenziali delle chiavi. corda

SecretsProfile

Nome Descrizione Valore
keyVaultResourceId Nome dell'insieme di credenziali delle chiavi dell'utente in cui sono archiviati tutti i segreti utente specifici del cluster. stringa (obbligatorio)
segreti Proprietà del segreto dell'insieme di credenziali delle chiavi. secretReference[]

SparkMetastoreSpec

Nome Descrizione Valore
dbName Nome del database. stringa (obbligatorio)
dbPasswordSecretName Nome del segreto che contiene la password utente del database. stringa (obbligatorio)
dbServerHost Host del server di database. stringa (obbligatorio)
dbUserName Nome utente del database. stringa (obbligatorio)
keyVaultId ID risorsa dell'insieme di credenziali delle chiavi. stringa (obbligatorio)
thriftUrl URL thrift. corda

SparkProfile

Nome Descrizione Valore
defaultStorageUrl URL di archiviazione predefinito. corda
metastoreSpec Specifica del metastore per il cluster Spark. sparkMetastoreSpec
userPluginsSpec Specifica dei plug-in utente Spark sparkUserPlugins

SparkUserPlugin

Nome Descrizione Valore
sentiero Percorso completo della cartella contenente i plug-in. corda

Vincoli:
Lunghezza minima = 1
Pattern = ^(https)|(abfss)://.*$ (obbligatorio)

SparkUserPlugins

Nome Descrizione Valore
plug-in Plug-in utente Spark. SparkUserPlugin[]

SshProfile

Nome Descrizione Valore
contare Numero di pod SSH per cluster. Int

Vincoli:
Valore minimo = 0
Valore massimo = 5 (obbligatorio)

TrackedResourceTags

Nome Descrizione Valore

TrinoCoordinator

Nome Descrizione Valore
debug Configurazione di debug trino. TrinoDebugConfig
highAvailabilityEnabled Flag che, se abilita la disponibilità elevata coordinatore, usa più repliche coordinatore con failover automatico, una per ogni nodo head. Impostazione predefinita: true. Bool

TrinoDebugConfig

Nome Descrizione Valore
abilitare Flag che se abilita o meno il debug. Bool
porto Porta di debug. Int
sospendere Flag che se sospende o meno il debug. Bool

TrinoProfile

Nome Descrizione Valore
catalogOptions Opzioni del catalogo cluster Trino. CatalogOptions
coordinatore Coordinatore Trino. TrinoCoordinator
userPluginsSpec Specifica plug-in utente trino TrinoUserPlugins
userTelemetrySpec Telemetria utente TrinoUserTelemetry
lavoratore Trino worker. TrinoWorker

TrinoTelemetryConfig

Nome Descrizione Valore
hivecatalogName Nome catalogo Hive usato per montare tabelle esterne nei log scritti da trino, se non specificato non vengono create tabelle. corda

Vincoli:
Lunghezza minima = 1
hivecatalogSchema Schema del catalogo precedente da usare per montare i log di query come tabelle esterne, se non specificate verranno montate in trinolog dello schema. corda
partitionRetentionInDays Il periodo di conservazione per le partizioni della tabella dei log delle query non influisce sui dati effettivi. Int
sentiero Percorso di archiviazione di Azure dei BLOB. corda

Vincoli:
Lunghezza minima = 1

TrinoUserPlugin

Nome Descrizione Valore
Abilitato Indica se il plug-in è attivo o meno. Bool
nome Questo campo esegue il mapping alla sottodirectory nella posizione dei plug-in trino, che conterrà tutti i plug-in nel percorso. corda

Vincoli:
Lunghezza minima = 1
sentiero Percorso completo della cartella contenente i plug-in. corda

Vincoli:
Lunghezza minima = 1
Pattern = ^(https)|(abfss)://.*$

TrinoUserPlugins

Nome Descrizione Valore
plug-in Plug-in utente trino. TrinoUserPlugin[]

TrinoUserTelemetry

Nome Descrizione Valore
immagazzinamento Definizione di telemetria utente Trino. TrinoTelemetryConfig

TrinoWorker

Nome Descrizione Valore
debug Configurazione di debug trino. TrinoDebugConfig

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa clusterpools/clusters 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.

Formato risorsa

Per creare una risorsa Microsoft.HDInsight/clusterpools/clusters, aggiungere il codice JSON seguente al modello.

{
  "type": "Microsoft.HDInsight/clusterpools/clusters",
  "apiVersion": "2023-06-01-preview",
  "name": "string",
  "location": "string",
  "properties": {
    "clusterProfile": {
      "authorizationProfile": {
        "groupIds": [ "string" ],
        "userIds": [ "string" ]
      },
      "autoscaleProfile": {
        "autoscaleType": "string",
        "enabled": "bool",
        "gracefulDecommissionTimeout": "int",
        "loadBasedConfig": {
          "cooldownPeriod": "int",
          "maxNodes": "int",
          "minNodes": "int",
          "pollInterval": "int",
          "scalingRules": [
            {
              "actionType": "string",
              "comparisonRule": {
                "operator": "string",
                "threshold": "int"
              },
              "evaluationCount": "int",
              "scalingMetric": "string"
            }
          ]
        },
        "scheduleBasedConfig": {
          "defaultCount": "int",
          "schedules": [
            {
              "count": "int",
              "days": [ "string" ],
              "endTime": "string",
              "startTime": "string"
            }
          ],
          "timeZone": "string"
        }
      },
      "clusterVersion": "string",
      "flinkProfile": {
        "catalogOptions": {
          "hive": {
            "metastoreDbConnectionPasswordSecret": "string",
            "metastoreDbConnectionURL": "string",
            "metastoreDbConnectionUserName": "string"
          }
        },
        "historyServer": {
          "cpu": "int",
          "memory": "int"
        },
        "jobManager": {
          "cpu": "int",
          "memory": "int"
        },
        "numReplicas": "int",
        "storage": {
          "storagekey": "string",
          "storageUri": "string"
        },
        "taskManager": {
          "cpu": "int",
          "memory": "int"
        }
      },
      "identityProfile": {
        "msiClientId": "string",
        "msiObjectId": "string",
        "msiResourceId": "string"
      },
      "kafkaProfile": {
        "{customized property}": {}
      },
      "llapProfile": {
        "{customized property}": {}
      },
      "logAnalyticsProfile": {
        "applicationLogs": {
          "stdErrorEnabled": "bool",
          "stdOutEnabled": "bool"
        },
        "enabled": "bool",
        "metricsEnabled": "bool"
      },
      "ossVersion": "string",
      "prometheusProfile": {
        "enabled": "bool"
      },
      "scriptActionProfiles": [
        {
          "name": "string",
          "parameters": "string",
          "services": [ "string" ],
          "shouldPersist": "bool",
          "timeoutInMinutes": "int",
          "type": "string",
          "url": "string"
        }
      ],
      "secretsProfile": {
        "keyVaultResourceId": "string",
        "secrets": [
          {
            "keyVaultObjectName": "string",
            "referenceName": "string",
            "type": "string",
            "version": "string"
          }
        ]
      },
      "serviceConfigsProfiles": [
        {
          "configs": [
            {
              "component": "string",
              "files": [
                {
                  "content": "string",
                  "encoding": "string",
                  "fileName": "string",
                  "path": "string",
                  "values": {
                    "{customized property}": "string"
                  }
                }
              ]
            }
          ],
          "serviceName": "string"
        }
      ],
      "sparkProfile": {
        "defaultStorageUrl": "string",
        "metastoreSpec": {
          "dbName": "string",
          "dbPasswordSecretName": "string",
          "dbServerHost": "string",
          "dbUserName": "string",
          "keyVaultId": "string",
          "thriftUrl": "string"
        },
        "userPluginsSpec": {
          "plugins": [
            {
              "path": "string"
            }
          ]
        }
      },
      "sshProfile": {
        "count": "int"
      },
      "stubProfile": {
        "{customized property}": {}
      },
      "trinoProfile": {
        "catalogOptions": {
          "hive": [
            {
              "catalogName": "string",
              "metastoreDbConnectionPasswordSecret": "string",
              "metastoreDbConnectionURL": "string",
              "metastoreDbConnectionUserName": "string",
              "metastoreWarehouseDir": "string"
            }
          ]
        },
        "coordinator": {
          "debug": {
            "enable": "bool",
            "port": "int",
            "suspend": "bool"
          },
          "highAvailabilityEnabled": "bool"
        },
        "userPluginsSpec": {
          "plugins": [
            {
              "enabled": "bool",
              "name": "string",
              "path": "string"
            }
          ]
        },
        "userTelemetrySpec": {
          "storage": {
            "hivecatalogName": "string",
            "hivecatalogSchema": "string",
            "partitionRetentionInDays": "int",
            "path": "string"
          }
        },
        "worker": {
          "debug": {
            "enable": "bool",
            "port": "int",
            "suspend": "bool"
          }
        }
      }
    },
    "clusterType": "string",
    "computeProfile": {
      "nodes": [
        {
          "count": "int",
          "type": "string",
          "vmSize": "string"
        }
      ]
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valori delle proprietà

AuthorizationProfile

Nome Descrizione Valore
groupIds ID gruppo AAD autorizzati per l'accesso al piano dati. string[]
userIds ID utente di AAD autorizzati per l'accesso al piano dati. string[]

AutoscaleProfile

Nome Descrizione Valore
autoscaleType Utente per specificare il tipo di scalabilità automatica da implementare: basato su base pianificata o basata sul carico. 'LoadBased'
'ScheduleBased'
Abilitato Indica se la scalabilità automatica è abilitata in HDInsight nel cluster del servizio Azure Kubernetes. bool (obbligatorio)
gracefulDecommissionTimeout Questa proprietà è per il timeout delle autorizzazioni normale; Ha un'impostazione predefinita di 3600 secondi prima dell'arresto forzato. Questo è il tempo massimo di attesa per il completamento dei contenitori e delle applicazioni in esecuzione prima della transizione di un nodo DECOMMISSIONING in DECOMMISSIONED. Il valore predefinito è 3600 secondi. Il valore negativo (ad esempio -1) viene gestito come timeout infinito. Int
loadBasedConfig Profili di scalabilità automatica basata sul carico. loadBasedConfig
scheduleBasedConfig Profili di scalabilità automatica basata su pianificazione. ScheduleBasedConfig

CatalogOptions

Nome Descrizione Valore
alveare Opzioni del catalogo hive. HiveCatalogOption[]

ClusterConfigFile

Nome Descrizione Valore
contenuto Contenuto in formato libero dell'intero file di configurazione. corda
codifica Questa proprietà indica se il contenuto è codificato e non fa distinzione tra maiuscole e minuscole. Impostare il valore su base64 se il contenuto è codificato in base64. Impostarlo su nessuno o ignorarlo se il contenuto è testo normale. 'Base64'
'Nessuno'
Filename Nome file di configurazione. stringa (obbligatorio)
sentiero Percorso del file di configurazione se è specificato il contenuto. corda
valori Elenco di coppie chiave-valore
dove key rappresenta un nome e un valore di configurazione del servizio validi rappresenta il valore della configurazione.
ClusterConfigFileValues

ClusterConfigFileValues

Nome Descrizione Valore

ClusterLogAnalyticsApplicationLogs

Nome Descrizione Valore
stdErrorEnabled True se stderror è abilitato; in caso contrario, false. Bool
stdOutEnabled True se stdout è abilitato; in caso contrario, false. Bool

ClusterLogAnalyticsProfile

Nome Descrizione Valore
applicationLogs Raccolta di log da abilitare o disabilitare per Log Analytics. ClusterLogAnalyticsApplicationLogs
Abilitato True se Log Analytics è abilitato per il cluster; in caso contrario, false. bool (obbligatorio)
metricsEnabled True se le metriche sono abilitate; in caso contrario, false. Bool

ClusterProfile

Nome Descrizione Valore
authorizationProfile Profilo di autorizzazione con i dettagli degli ID utente e degli ID gruppo di AAD autorizzati per l'accesso al piano dati. AuthorizationProfile (obbligatorio)
autoscaleProfile Si tratta del profilo di scalabilità automatica per il cluster. Ciò consentirà al cliente di creare un cluster abilitato con scalabilità automatica. AutoscaleProfile
clusterVersion Versione con 3/4 parte. corda

Vincoli:
Pattern = ^(0|[1-9][0-9]{0,18})\.(0|[1-9][0-9]{0,18})\.(0|[1-9][0-9]{0,18})(?:\.(0|[1-9][0-9]{0,18}))?$ (obbligatorio)
flinkProfile Profilo del cluster Flink. FlinkProfile
identityProfile Profilo di identità con i dettagli di un'identità del servizio gestito. IdentityProfile (obbligatorio)
kafkaProfile Profilo del cluster Kafka. clusterProfileKafkaProfile
llapProfile Profilo del cluster LLAP. clusterProfileLlapProfile
logAnalyticsProfile Profilo di Log Analytics del cluster per abilitare o disabilitare l'agente OMS per il cluster. clusterLogAnalyticsProfile
ossVersion Versione con tre parti. corda

Vincoli:
Pattern = ^(0|[1-9][0-9]{0,18})\.(0|[1-9][0-9]{0,18})\.(0|[1-9][0-9]{0,18})$ (obbligatorio)
prometheusProfile Profilo Prometheus del cluster. clusterPrometheusProfile
scriptActionProfiles Elenco dei profili di azione script. scriptActionProfile[]
secretsProfile Profilo segreto del cluster. SecretsProfile
serviceConfigsProfiles Profili di configurazione del servizio. ClusterServiceConfigsProfile[]
sparkProfile Profilo del cluster Spark. SparkProfile
sshProfile Profilo SSH per il cluster. SshProfile
stubProfile Profilo del cluster Stub. ClusterProfileStubProfileprofile
trinoProfile Profilo del cluster Trino. TrinoProfile

ClusterProfileKafkaProfile

Nome Descrizione Valore

ClusterProfileLlapProfile

Nome Descrizione Valore

ClusterProfileStubProfile

Nome Descrizione Valore

ClusterPrometheusProfile

Nome Descrizione Valore
Abilitato Abilitare Prometheus per il cluster o meno. bool (obbligatorio)

ClusterResourceProperties

Nome Descrizione Valore
clusterProfile Profilo del cluster. ClusterProfile (obbligatorio)
clusterType Tipo di cluster. corda

Vincoli:
Pattern = ^[a-zA-Z][a-zA-Z0-9]{0,31}$ (obbligatorio)
computeProfile Profilo di calcolo. ComputeProfile (obbligatorio)

ClusterServiceConfig

Nome Descrizione Valore
componente Nome del componente a cui devono essere applicati i file di configurazione. stringa (obbligatorio)
file Elenco dei file di configurazione. clusterConfigFile[] (obbligatorio)

ClusterServiceConfigsProfile

Nome Descrizione Valore
configurazioni Elenco delle configurazioni del servizio. clusterServiceConfig[] (obbligatorio)
serviceName Nome del servizio a cui applicare le configurazioni. stringa (obbligatorio)

ComparisonRule

Nome Descrizione Valore
operatore Operatore di confronto. 'greaterThan'
'greaterThanOrEqual'
'lessThan'
'lessThanOrEqual' (obbligatorio)
soglia Impostazione soglia. int (obbligatorio)

ComputeProfile

Nome Descrizione Valore
nodi Definizioni di nodi. NodeProfile[] (obbligatorio)

ComputeResourceDefinition

Nome Descrizione Valore
CPU CPU richiesta. int (obbligatorio)
memoria La memoria necessaria in MB, la memoria del contenitore sarà 110 percentile int (obbligatorio)

FlinkCatalogOptions

Nome Descrizione Valore
alveare Opzione catalogo Hive per il cluster Flink. FlinkHiveCatalogOption

FlinkHiveCatalogOption

Nome Descrizione Valore
metastoreDbConnectionPasswordSecret Nome di riferimento segreto da secretsProfile.secrets contenente la password per la connessione al database. stringa (obbligatorio)
metastoreDbConnectionURL Stringa di connessione per il database metastore Hive. stringa (obbligatorio)
metastoreDbConnectionUserName Nome utente per la connessione al database. stringa (obbligatorio)

FlinkProfile

Nome Descrizione Valore
catalogOptions Opzioni del catalogo cluster Flink. FlinkCatalogOptions
historyServer Requisiti di CPU e memoria del server cronologia/elaborazione ComputeResourceDefinition
jobManager Requisiti di CPU e memoria del contenitore di Job Manager/processo ComputeResourceDefinition (obbligatorio)
numReplicas Numero di task manager. Int
immagazzinamento Profilo di archiviazione FlinkStorageProfile (obbligatorio)
taskManager Requisiti di CPU e memoria del contenitore di Gestione attività/elaborazione ComputeResourceDefinition (obbligatorio)

FlinkStorageProfile

Nome Descrizione Valore
storagekey La chiave di archiviazione è necessaria solo per l'archiviazione wasb.storage key is only required for wasb/s storage. corda

Vincoli:
Valore sensibile. Passare come parametro sicuro.
storageUri URI dell'account di archiviazione usato per lo stato del punto di salvataggio e del checkpoint. corda

Vincoli:
Pattern = ^(\w{4,5})://(.*)@(.*).\b(blob|dfs)\b\.core\.windows\.net$ (obbligatorio)

HiveCatalogOption

Nome Descrizione Valore
catalogName Nome del catalogo trino che deve usare il metastore hive specificato. corda

Vincoli:
Lunghezza minima = 1 (obbligatorio)
metastoreDbConnectionPasswordSecret Nome di riferimento segreto da secretsProfile.secrets contenente la password per la connessione al database. stringa (obbligatorio)
metastoreDbConnectionURL Stringa di connessione per il database metastore Hive. stringa (obbligatorio)
metastoreDbConnectionUserName Nome utente per la connessione al database. stringa (obbligatorio)
metastoreWarehouseDir URI della directory radice metastore, formato: abfs[s]://<contenitore>@<account_name>percorso .dfs.core.windows.net/<>. Altri dettagli: /azure/storage/blobs/data-lake-storage-introduction-abfs-uri stringa (obbligatorio)

IdentityProfile

Nome Descrizione Valore
msiClientId ClientId dell'identità del servizio gestito. corda

Vincoli:
Pattern = ^[{(]?[0-9A-Fa-f]{8}[-]?(?:[0-9A-Fa-f]{4}[-]?){3}[0-9A-Fa-f]{12}[)}]?$ (obbligatorio)
msiObjectId ObjectId dell'identità del servizio gestito. corda

Vincoli:
Pattern = ^[{(]?[0-9A-Fa-f]{8}[-]?(?:[0-9A-Fa-f]{4}[-]?){3}[0-9A-Fa-f]{12}[)}]?$ (obbligatorio)
msiResourceId ResourceId dell'identità del servizio gestito. stringa (obbligatorio)

LoadBasedConfig

Nome Descrizione Valore
cooldownPeriod Si tratta di un periodo di raffreddamento, ovvero un periodo di tempo in secondi, che determina la quantità di tempo che deve trascorrere tra un'attività di ridimensionamento avviata da una regola e l'inizio dell'attività di ridimensionamento successiva, indipendentemente dalla regola che lo attiva. Il valore predefinito è 300 secondi. Int
maxNodes L'utente deve impostare il numero massimo di nodi per il ridimensionamento basato sul carico, il ridimensionamento basato sul carico userà questa opzione per aumentare e ridurre le prestazioni tra il numero minimo e il numero massimo di nodi. int (obbligatorio)
minNodes L'utente deve impostare il numero minimo di nodi per il ridimensionamento basato sul carico, il ridimensionamento basato sul carico userà questa opzione per aumentare e ridurre le prestazioni tra il numero minimo e il numero massimo di nodi. int (obbligatorio)
pollInterval L'utente può specificare l'intervallo di polling, ovvero il periodo di tempo (in secondi) dopo il quale viene eseguito il polling delle metriche di ridimensionamento per l'attivazione di un'operazione di ridimensionamento. Int
scalingRules Regole di ridimensionamento. ScalingRule[] (obbligatorio)

Microsoft.HDInsight/clusterpools/clusters

Nome Descrizione Valore
apiVersion Versione dell'API '2023-06-01-preview'
ubicazione Posizione geografica in cui risiede la risorsa stringa (obbligatorio)
nome Nome della risorsa stringa (obbligatorio)
proprietà Ottiene o imposta le proprietà. Definire proprietà specifiche del cluster. ClusterResourceProperties
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli
digitare Tipo di risorsa 'Microsoft.HDInsight/clusterpools/clusters'

NodeProfile

Nome Descrizione Valore
contare Numero di macchine virtuali. Int

Vincoli:
Valore minimo = 1 (obbligatorio)
digitare Tipo di nodo. corda

Vincoli:
Pattern = ^(head|Head|HEAD|worker|Worker|WORKER)$ (obbligatorio)
vmSize SKU della macchina virtuale. corda

Vincoli:
Pattern = ^[a-zA-Z0-9_\-]{0,256}$ (obbligatorio)

ScalingRule

Nome Descrizione Valore
actionType Tipo di azione. 'scaledown'
'scaleup' (obbligatorio)
comparisonRule Regola di confronto. ComparisonRule (obbligatorio)
evaluationCount Si tratta di un conteggio di valutazione per una condizione di ridimensionamento, il numero di volte in cui una condizione di trigger deve avere esito positivo, prima che venga attivata l'attività di ridimensionamento. int (obbligatorio)
scalingMetric Nome delle metriche per singoli carichi di lavoro. Ad esempio: CPU stringa (obbligatorio)

Programma

Nome Descrizione Valore
contare L'utente deve impostare il numero di nodi previsto alla fine dell'operazione di ridimensionamento della configurazione della pianificazione corrente impostata, il formato è integer. int (obbligatorio)
Giorni L'utente deve impostare i giorni in cui è necessario impostare la pianificazione per l'operazione di scalabilità automatica. Matrice di stringhe contenente uno dei seguenti elementi:
'Friday'
'Monday'
'Saturday'
'Domenica'
'Giovedì'
'Martedì'
'Mercoledì' (obbligatorio)
endTime L'utente deve impostare l'ora di fine della configurazione della pianificazione corrente, come 10:30 (HH:MM). corda

Vincoli:
Pattern = ^([0-1]?[0-9]|2[0-3]):[0-5][0-9]$ (obbligatorio)
startTime L'utente deve impostare l'ora di inizio della configurazione della pianificazione corrente, come 10:30 (HH:MM). corda

Vincoli:
Pattern = ^([0-1]?[0-9]|2[0-3]):[0-5][0-9]$ (obbligatorio)

ScheduleBasedConfig

Nome Descrizione Valore
defaultCount Impostazione del numero di nodi predefinito della configurazione della pianificazione corrente. Il numero di nodi predefinito specifica il numero di nodi predefiniti quando viene eseguita un'operazione di ridimensionamento specificata (aumento/riduzione delle prestazioni) int (obbligatorio)
Orari Specifica le pianificazioni in cui abilitare la scalabilità automatica pianificata, l'utente ha la possibilità di impostare più regole all'interno della pianificazione tra giorni e ore (inizio/fine). pianificazione [] (obbligatorio)
timeZone L'utente deve specificare il fuso orario in cui deve essere impostata la pianificazione per la configurazione della scalabilità automatica basata sulla pianificazione. stringa (obbligatorio)

ScriptActionProfile

Nome Descrizione Valore
nome Nome script. stringa (obbligatorio)
Parametri Parametri aggiuntivi per l'azione script. Deve essere un elenco separato da spazi di argomenti necessari per l'esecuzione di script. corda
servizi Elenco di servizi da applicare all'azione script. string[] (obbligatorio)
shouldPersist Specificare se lo script deve essere persistente nel cluster. Bool
timeoutInMinutes Durata del timeout per l'azione script in minuti. Int
digitare Tipo dell'azione script. Il tipo supportato è script bash. stringa (obbligatorio)
URL URL del file di script. corda

Vincoli:
Pattern = ^(https)|(http)|(abfss)|(abfs)|(wasbs)|(wasb)://.*$ (obbligatorio)

SecretReference

Nome Descrizione Valore
keyVaultObjectName Nome dell'identificatore di oggetto del segreto nell'insieme di credenziali delle chiavi. corda

Vincoli:
Pattern = ^[a-zA-Z][a-zA-Z0-9-]{1,126}$ (obbligatorio)
referenceName Nome di riferimento del segreto da usare nelle configurazioni del servizio. stringa (obbligatorio)
digitare Tipo di oggetto insieme di credenziali delle chiavi: segreto, chiave o certificato. 'Certificate'
'Key'
'Secret' (obbligatorio)
Versione Versione del segreto nell'insieme di credenziali delle chiavi. corda

SecretsProfile

Nome Descrizione Valore
keyVaultResourceId Nome dell'insieme di credenziali delle chiavi dell'utente in cui sono archiviati tutti i segreti utente specifici del cluster. stringa (obbligatorio)
segreti Proprietà del segreto dell'insieme di credenziali delle chiavi. secretReference[]

SparkMetastoreSpec

Nome Descrizione Valore
dbName Nome del database. stringa (obbligatorio)
dbPasswordSecretName Nome del segreto che contiene la password utente del database. stringa (obbligatorio)
dbServerHost Host del server di database. stringa (obbligatorio)
dbUserName Nome utente del database. stringa (obbligatorio)
keyVaultId ID risorsa dell'insieme di credenziali delle chiavi. stringa (obbligatorio)
thriftUrl URL thrift. corda

SparkProfile

Nome Descrizione Valore
defaultStorageUrl URL di archiviazione predefinito. corda
metastoreSpec Specifica del metastore per il cluster Spark. sparkMetastoreSpec
userPluginsSpec Specifica dei plug-in utente Spark sparkUserPlugins

SparkUserPlugin

Nome Descrizione Valore
sentiero Percorso completo della cartella contenente i plug-in. corda

Vincoli:
Lunghezza minima = 1
Pattern = ^(https)|(abfss)://.*$ (obbligatorio)

SparkUserPlugins

Nome Descrizione Valore
plug-in Plug-in utente Spark. SparkUserPlugin[]

SshProfile

Nome Descrizione Valore
contare Numero di pod SSH per cluster. Int

Vincoli:
Valore minimo = 0
Valore massimo = 5 (obbligatorio)

TrackedResourceTags

Nome Descrizione Valore

TrinoCoordinator

Nome Descrizione Valore
debug Configurazione di debug trino. TrinoDebugConfig
highAvailabilityEnabled Flag che, se abilita la disponibilità elevata coordinatore, usa più repliche coordinatore con failover automatico, una per ogni nodo head. Impostazione predefinita: true. Bool

TrinoDebugConfig

Nome Descrizione Valore
abilitare Flag che se abilita o meno il debug. Bool
porto Porta di debug. Int
sospendere Flag che se sospende o meno il debug. Bool

TrinoProfile

Nome Descrizione Valore
catalogOptions Opzioni del catalogo cluster Trino. CatalogOptions
coordinatore Coordinatore Trino. TrinoCoordinator
userPluginsSpec Specifica plug-in utente trino TrinoUserPlugins
userTelemetrySpec Telemetria utente TrinoUserTelemetry
lavoratore Trino worker. TrinoWorker

TrinoTelemetryConfig

Nome Descrizione Valore
hivecatalogName Nome catalogo Hive usato per montare tabelle esterne nei log scritti da trino, se non specificato non vengono create tabelle. corda

Vincoli:
Lunghezza minima = 1
hivecatalogSchema Schema del catalogo precedente da usare per montare i log di query come tabelle esterne, se non specificate verranno montate in trinolog dello schema. corda
partitionRetentionInDays Il periodo di conservazione per le partizioni della tabella dei log delle query non influisce sui dati effettivi. Int
sentiero Percorso di archiviazione di Azure dei BLOB. corda

Vincoli:
Lunghezza minima = 1

TrinoUserPlugin

Nome Descrizione Valore
Abilitato Indica se il plug-in è attivo o meno. Bool
nome Questo campo esegue il mapping alla sottodirectory nella posizione dei plug-in trino, che conterrà tutti i plug-in nel percorso. corda

Vincoli:
Lunghezza minima = 1
sentiero Percorso completo della cartella contenente i plug-in. corda

Vincoli:
Lunghezza minima = 1
Pattern = ^(https)|(abfss)://.*$

TrinoUserPlugins

Nome Descrizione Valore
plug-in Plug-in utente trino. TrinoUserPlugin[]

TrinoUserTelemetry

Nome Descrizione Valore
immagazzinamento Definizione di telemetria utente Trino. TrinoTelemetryConfig

TrinoWorker

Nome Descrizione Valore
debug Configurazione di debug trino. TrinoDebugConfig

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa clusterpools/clusters può essere distribuito con operazioni destinate a:

  • gruppi di risorse

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

Formato risorsa

Per creare una risorsa Microsoft.HDInsight/clusterpools/clusters, aggiungere il file Terraform seguente al modello.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.HDInsight/clusterpools/clusters@2023-06-01-preview"
  name = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      clusterProfile = {
        authorizationProfile = {
          groupIds = [
            "string"
          ]
          userIds = [
            "string"
          ]
        }
        autoscaleProfile = {
          autoscaleType = "string"
          enabled = bool
          gracefulDecommissionTimeout = int
          loadBasedConfig = {
            cooldownPeriod = int
            maxNodes = int
            minNodes = int
            pollInterval = int
            scalingRules = [
              {
                actionType = "string"
                comparisonRule = {
                  operator = "string"
                  threshold = int
                }
                evaluationCount = int
                scalingMetric = "string"
              }
            ]
          }
          scheduleBasedConfig = {
            defaultCount = int
            schedules = [
              {
                count = int
                days = [
                  "string"
                ]
                endTime = "string"
                startTime = "string"
              }
            ]
            timeZone = "string"
          }
        }
        clusterVersion = "string"
        flinkProfile = {
          catalogOptions = {
            hive = {
              metastoreDbConnectionPasswordSecret = "string"
              metastoreDbConnectionURL = "string"
              metastoreDbConnectionUserName = "string"
            }
          }
          historyServer = {
            cpu = int
            memory = int
          }
          jobManager = {
            cpu = int
            memory = int
          }
          numReplicas = int
          storage = {
            storagekey = "string"
            storageUri = "string"
          }
          taskManager = {
            cpu = int
            memory = int
          }
        }
        identityProfile = {
          msiClientId = "string"
          msiObjectId = "string"
          msiResourceId = "string"
        }
        kafkaProfile = {
          {customized property} = ?
        }
        llapProfile = {
          {customized property} = ?
        }
        logAnalyticsProfile = {
          applicationLogs = {
            stdErrorEnabled = bool
            stdOutEnabled = bool
          }
          enabled = bool
          metricsEnabled = bool
        }
        ossVersion = "string"
        prometheusProfile = {
          enabled = bool
        }
        scriptActionProfiles = [
          {
            name = "string"
            parameters = "string"
            services = [
              "string"
            ]
            shouldPersist = bool
            timeoutInMinutes = int
            type = "string"
            url = "string"
          }
        ]
        secretsProfile = {
          keyVaultResourceId = "string"
          secrets = [
            {
              keyVaultObjectName = "string"
              referenceName = "string"
              type = "string"
              version = "string"
            }
          ]
        }
        serviceConfigsProfiles = [
          {
            configs = [
              {
                component = "string"
                files = [
                  {
                    content = "string"
                    encoding = "string"
                    fileName = "string"
                    path = "string"
                    values = {
                      {customized property} = "string"
                    }
                  }
                ]
              }
            ]
            serviceName = "string"
          }
        ]
        sparkProfile = {
          defaultStorageUrl = "string"
          metastoreSpec = {
            dbName = "string"
            dbPasswordSecretName = "string"
            dbServerHost = "string"
            dbUserName = "string"
            keyVaultId = "string"
            thriftUrl = "string"
          }
          userPluginsSpec = {
            plugins = [
              {
                path = "string"
              }
            ]
          }
        }
        sshProfile = {
          count = int
        }
        stubProfile = {
          {customized property} = ?
        }
        trinoProfile = {
          catalogOptions = {
            hive = [
              {
                catalogName = "string"
                metastoreDbConnectionPasswordSecret = "string"
                metastoreDbConnectionURL = "string"
                metastoreDbConnectionUserName = "string"
                metastoreWarehouseDir = "string"
              }
            ]
          }
          coordinator = {
            debug = {
              enable = bool
              port = int
              suspend = bool
            }
            highAvailabilityEnabled = bool
          }
          userPluginsSpec = {
            plugins = [
              {
                enabled = bool
                name = "string"
                path = "string"
              }
            ]
          }
          userTelemetrySpec = {
            storage = {
              hivecatalogName = "string"
              hivecatalogSchema = "string"
              partitionRetentionInDays = int
              path = "string"
            }
          }
          worker = {
            debug = {
              enable = bool
              port = int
              suspend = bool
            }
          }
        }
      }
      clusterType = "string"
      computeProfile = {
        nodes = [
          {
            count = int
            type = "string"
            vmSize = "string"
          }
        ]
      }
    }
  })
}

Valori delle proprietà

AuthorizationProfile

Nome Descrizione Valore
groupIds ID gruppo AAD autorizzati per l'accesso al piano dati. string[]
userIds ID utente di AAD autorizzati per l'accesso al piano dati. string[]

AutoscaleProfile

Nome Descrizione Valore
autoscaleType Utente per specificare il tipo di scalabilità automatica da implementare: basato su base pianificata o basata sul carico. 'LoadBased'
'ScheduleBased'
Abilitato Indica se la scalabilità automatica è abilitata in HDInsight nel cluster del servizio Azure Kubernetes. bool (obbligatorio)
gracefulDecommissionTimeout Questa proprietà è per il timeout delle autorizzazioni normale; Ha un'impostazione predefinita di 3600 secondi prima dell'arresto forzato. Questo è il tempo massimo di attesa per il completamento dei contenitori e delle applicazioni in esecuzione prima della transizione di un nodo DECOMMISSIONING in DECOMMISSIONED. Il valore predefinito è 3600 secondi. Il valore negativo (ad esempio -1) viene gestito come timeout infinito. Int
loadBasedConfig Profili di scalabilità automatica basata sul carico. loadBasedConfig
scheduleBasedConfig Profili di scalabilità automatica basata su pianificazione. ScheduleBasedConfig

CatalogOptions

Nome Descrizione Valore
alveare Opzioni del catalogo hive. HiveCatalogOption[]

ClusterConfigFile

Nome Descrizione Valore
contenuto Contenuto in formato libero dell'intero file di configurazione. corda
codifica Questa proprietà indica se il contenuto è codificato e non fa distinzione tra maiuscole e minuscole. Impostare il valore su base64 se il contenuto è codificato in base64. Impostarlo su nessuno o ignorarlo se il contenuto è testo normale. 'Base64'
'Nessuno'
Filename Nome file di configurazione. stringa (obbligatorio)
sentiero Percorso del file di configurazione se è specificato il contenuto. corda
valori Elenco di coppie chiave-valore
dove key rappresenta un nome e un valore di configurazione del servizio validi rappresenta il valore della configurazione.
ClusterConfigFileValues

ClusterConfigFileValues

Nome Descrizione Valore

ClusterLogAnalyticsApplicationLogs

Nome Descrizione Valore
stdErrorEnabled True se stderror è abilitato; in caso contrario, false. Bool
stdOutEnabled True se stdout è abilitato; in caso contrario, false. Bool

ClusterLogAnalyticsProfile

Nome Descrizione Valore
applicationLogs Raccolta di log da abilitare o disabilitare per Log Analytics. ClusterLogAnalyticsApplicationLogs
Abilitato True se Log Analytics è abilitato per il cluster; in caso contrario, false. bool (obbligatorio)
metricsEnabled True se le metriche sono abilitate; in caso contrario, false. Bool

ClusterProfile

Nome Descrizione Valore
authorizationProfile Profilo di autorizzazione con i dettagli degli ID utente e degli ID gruppo di AAD autorizzati per l'accesso al piano dati. AuthorizationProfile (obbligatorio)
autoscaleProfile Si tratta del profilo di scalabilità automatica per il cluster. Ciò consentirà al cliente di creare un cluster abilitato con scalabilità automatica. AutoscaleProfile
clusterVersion Versione con 3/4 parte. corda

Vincoli:
Pattern = ^(0|[1-9][0-9]{0,18})\.(0|[1-9][0-9]{0,18})\.(0|[1-9][0-9]{0,18})(?:\.(0|[1-9][0-9]{0,18}))?$ (obbligatorio)
flinkProfile Profilo del cluster Flink. FlinkProfile
identityProfile Profilo di identità con i dettagli di un'identità del servizio gestito. IdentityProfile (obbligatorio)
kafkaProfile Profilo del cluster Kafka. clusterProfileKafkaProfile
llapProfile Profilo del cluster LLAP. clusterProfileLlapProfile
logAnalyticsProfile Profilo di Log Analytics del cluster per abilitare o disabilitare l'agente OMS per il cluster. clusterLogAnalyticsProfile
ossVersion Versione con tre parti. corda

Vincoli:
Pattern = ^(0|[1-9][0-9]{0,18})\.(0|[1-9][0-9]{0,18})\.(0|[1-9][0-9]{0,18})$ (obbligatorio)
prometheusProfile Profilo Prometheus del cluster. clusterPrometheusProfile
scriptActionProfiles Elenco dei profili di azione script. scriptActionProfile[]
secretsProfile Profilo segreto del cluster. SecretsProfile
serviceConfigsProfiles Profili di configurazione del servizio. ClusterServiceConfigsProfile[]
sparkProfile Profilo del cluster Spark. SparkProfile
sshProfile Profilo SSH per il cluster. SshProfile
stubProfile Profilo del cluster Stub. ClusterProfileStubProfileprofile
trinoProfile Profilo del cluster Trino. TrinoProfile

ClusterProfileKafkaProfile

Nome Descrizione Valore

ClusterProfileLlapProfile

Nome Descrizione Valore

ClusterProfileStubProfile

Nome Descrizione Valore

ClusterPrometheusProfile

Nome Descrizione Valore
Abilitato Abilitare Prometheus per il cluster o meno. bool (obbligatorio)

ClusterResourceProperties

Nome Descrizione Valore
clusterProfile Profilo del cluster. ClusterProfile (obbligatorio)
clusterType Tipo di cluster. corda

Vincoli:
Pattern = ^[a-zA-Z][a-zA-Z0-9]{0,31}$ (obbligatorio)
computeProfile Profilo di calcolo. ComputeProfile (obbligatorio)

ClusterServiceConfig

Nome Descrizione Valore
componente Nome del componente a cui devono essere applicati i file di configurazione. stringa (obbligatorio)
file Elenco dei file di configurazione. clusterConfigFile[] (obbligatorio)

ClusterServiceConfigsProfile

Nome Descrizione Valore
configurazioni Elenco delle configurazioni del servizio. clusterServiceConfig[] (obbligatorio)
serviceName Nome del servizio a cui applicare le configurazioni. stringa (obbligatorio)

ComparisonRule

Nome Descrizione Valore
operatore Operatore di confronto. 'greaterThan'
'greaterThanOrEqual'
'lessThan'
'lessThanOrEqual' (obbligatorio)
soglia Impostazione soglia. int (obbligatorio)

ComputeProfile

Nome Descrizione Valore
nodi Definizioni di nodi. NodeProfile[] (obbligatorio)

ComputeResourceDefinition

Nome Descrizione Valore
CPU CPU richiesta. int (obbligatorio)
memoria La memoria necessaria in MB, la memoria del contenitore sarà 110 percentile int (obbligatorio)

FlinkCatalogOptions

Nome Descrizione Valore
alveare Opzione catalogo Hive per il cluster Flink. FlinkHiveCatalogOption

FlinkHiveCatalogOption

Nome Descrizione Valore
metastoreDbConnectionPasswordSecret Nome di riferimento segreto da secretsProfile.secrets contenente la password per la connessione al database. stringa (obbligatorio)
metastoreDbConnectionURL Stringa di connessione per il database metastore Hive. stringa (obbligatorio)
metastoreDbConnectionUserName Nome utente per la connessione al database. stringa (obbligatorio)

FlinkProfile

Nome Descrizione Valore
catalogOptions Opzioni del catalogo cluster Flink. FlinkCatalogOptions
historyServer Requisiti di CPU e memoria del server cronologia/elaborazione ComputeResourceDefinition
jobManager Requisiti di CPU e memoria del contenitore di Job Manager/processo ComputeResourceDefinition (obbligatorio)
numReplicas Numero di task manager. Int
immagazzinamento Profilo di archiviazione FlinkStorageProfile (obbligatorio)
taskManager Requisiti di CPU e memoria del contenitore di Gestione attività/elaborazione ComputeResourceDefinition (obbligatorio)

FlinkStorageProfile

Nome Descrizione Valore
storagekey La chiave di archiviazione è necessaria solo per l'archiviazione wasb.storage key is only required for wasb/s storage. corda

Vincoli:
Valore sensibile. Passare come parametro sicuro.
storageUri URI dell'account di archiviazione usato per lo stato del punto di salvataggio e del checkpoint. corda

Vincoli:
Pattern = ^(\w{4,5})://(.*)@(.*).\b(blob|dfs)\b\.core\.windows\.net$ (obbligatorio)

HiveCatalogOption

Nome Descrizione Valore
catalogName Nome del catalogo trino che deve usare il metastore hive specificato. corda

Vincoli:
Lunghezza minima = 1 (obbligatorio)
metastoreDbConnectionPasswordSecret Nome di riferimento segreto da secretsProfile.secrets contenente la password per la connessione al database. stringa (obbligatorio)
metastoreDbConnectionURL Stringa di connessione per il database metastore Hive. stringa (obbligatorio)
metastoreDbConnectionUserName Nome utente per la connessione al database. stringa (obbligatorio)
metastoreWarehouseDir URI della directory radice metastore, formato: abfs[s]://<contenitore>@<account_name>percorso .dfs.core.windows.net/<>. Altri dettagli: /azure/storage/blobs/data-lake-storage-introduction-abfs-uri stringa (obbligatorio)

IdentityProfile

Nome Descrizione Valore
msiClientId ClientId dell'identità del servizio gestito. corda

Vincoli:
Pattern = ^[{(]?[0-9A-Fa-f]{8}[-]?(?:[0-9A-Fa-f]{4}[-]?){3}[0-9A-Fa-f]{12}[)}]?$ (obbligatorio)
msiObjectId ObjectId dell'identità del servizio gestito. corda

Vincoli:
Pattern = ^[{(]?[0-9A-Fa-f]{8}[-]?(?:[0-9A-Fa-f]{4}[-]?){3}[0-9A-Fa-f]{12}[)}]?$ (obbligatorio)
msiResourceId ResourceId dell'identità del servizio gestito. stringa (obbligatorio)

LoadBasedConfig

Nome Descrizione Valore
cooldownPeriod Si tratta di un periodo di raffreddamento, ovvero un periodo di tempo in secondi, che determina la quantità di tempo che deve trascorrere tra un'attività di ridimensionamento avviata da una regola e l'inizio dell'attività di ridimensionamento successiva, indipendentemente dalla regola che lo attiva. Il valore predefinito è 300 secondi. Int
maxNodes L'utente deve impostare il numero massimo di nodi per il ridimensionamento basato sul carico, il ridimensionamento basato sul carico userà questa opzione per aumentare e ridurre le prestazioni tra il numero minimo e il numero massimo di nodi. int (obbligatorio)
minNodes L'utente deve impostare il numero minimo di nodi per il ridimensionamento basato sul carico, il ridimensionamento basato sul carico userà questa opzione per aumentare e ridurre le prestazioni tra il numero minimo e il numero massimo di nodi. int (obbligatorio)
pollInterval L'utente può specificare l'intervallo di polling, ovvero il periodo di tempo (in secondi) dopo il quale viene eseguito il polling delle metriche di ridimensionamento per l'attivazione di un'operazione di ridimensionamento. Int
scalingRules Regole di ridimensionamento. ScalingRule[] (obbligatorio)

Microsoft.HDInsight/clusterpools/clusters

Nome Descrizione Valore
ubicazione Posizione geografica in cui risiede la risorsa stringa (obbligatorio)
nome Nome della risorsa stringa (obbligatorio)
parent_id ID della risorsa padre per questa risorsa. ID per la risorsa di tipo: pool di cluster
proprietà Ottiene o imposta le proprietà. Definire proprietà specifiche del cluster. ClusterResourceProperties
Tag Tag delle risorse Dizionario di nomi e valori di tag.
digitare Tipo di risorsa "Microsoft.HDInsight/clusterpools/clusters@2023-06-01-preview"

NodeProfile

Nome Descrizione Valore
contare Numero di macchine virtuali. Int

Vincoli:
Valore minimo = 1 (obbligatorio)
digitare Tipo di nodo. corda

Vincoli:
Pattern = ^(head|Head|HEAD|worker|Worker|WORKER)$ (obbligatorio)
vmSize SKU della macchina virtuale. corda

Vincoli:
Pattern = ^[a-zA-Z0-9_\-]{0,256}$ (obbligatorio)

ScalingRule

Nome Descrizione Valore
actionType Tipo di azione. 'scaledown'
'scaleup' (obbligatorio)
comparisonRule Regola di confronto. ComparisonRule (obbligatorio)
evaluationCount Si tratta di un conteggio di valutazione per una condizione di ridimensionamento, il numero di volte in cui una condizione di trigger deve avere esito positivo, prima che venga attivata l'attività di ridimensionamento. int (obbligatorio)
scalingMetric Nome delle metriche per singoli carichi di lavoro. Ad esempio: CPU stringa (obbligatorio)

Programma

Nome Descrizione Valore
contare L'utente deve impostare il numero di nodi previsto alla fine dell'operazione di ridimensionamento della configurazione della pianificazione corrente impostata, il formato è integer. int (obbligatorio)
Giorni L'utente deve impostare i giorni in cui è necessario impostare la pianificazione per l'operazione di scalabilità automatica. Matrice di stringhe contenente uno dei seguenti elementi:
'Friday'
'Monday'
'Saturday'
'Domenica'
'Giovedì'
'Martedì'
'Mercoledì' (obbligatorio)
endTime L'utente deve impostare l'ora di fine della configurazione della pianificazione corrente, come 10:30 (HH:MM). corda

Vincoli:
Pattern = ^([0-1]?[0-9]|2[0-3]):[0-5][0-9]$ (obbligatorio)
startTime L'utente deve impostare l'ora di inizio della configurazione della pianificazione corrente, come 10:30 (HH:MM). corda

Vincoli:
Pattern = ^([0-1]?[0-9]|2[0-3]):[0-5][0-9]$ (obbligatorio)

ScheduleBasedConfig

Nome Descrizione Valore
defaultCount Impostazione del numero di nodi predefinito della configurazione della pianificazione corrente. Il numero di nodi predefinito specifica il numero di nodi predefiniti quando viene eseguita un'operazione di ridimensionamento specificata (aumento/riduzione delle prestazioni) int (obbligatorio)
Orari Specifica le pianificazioni in cui abilitare la scalabilità automatica pianificata, l'utente ha la possibilità di impostare più regole all'interno della pianificazione tra giorni e ore (inizio/fine). pianificazione [] (obbligatorio)
timeZone L'utente deve specificare il fuso orario in cui deve essere impostata la pianificazione per la configurazione della scalabilità automatica basata sulla pianificazione. stringa (obbligatorio)

ScriptActionProfile

Nome Descrizione Valore
nome Nome script. stringa (obbligatorio)
Parametri Parametri aggiuntivi per l'azione script. Deve essere un elenco separato da spazi di argomenti necessari per l'esecuzione di script. corda
servizi Elenco di servizi da applicare all'azione script. string[] (obbligatorio)
shouldPersist Specificare se lo script deve essere persistente nel cluster. Bool
timeoutInMinutes Durata del timeout per l'azione script in minuti. Int
digitare Tipo dell'azione script. Il tipo supportato è script bash. stringa (obbligatorio)
URL URL del file di script. corda

Vincoli:
Pattern = ^(https)|(http)|(abfss)|(abfs)|(wasbs)|(wasb)://.*$ (obbligatorio)

SecretReference

Nome Descrizione Valore
keyVaultObjectName Nome dell'identificatore di oggetto del segreto nell'insieme di credenziali delle chiavi. corda

Vincoli:
Pattern = ^[a-zA-Z][a-zA-Z0-9-]{1,126}$ (obbligatorio)
referenceName Nome di riferimento del segreto da usare nelle configurazioni del servizio. stringa (obbligatorio)
digitare Tipo di oggetto insieme di credenziali delle chiavi: segreto, chiave o certificato. 'Certificate'
'Key'
'Secret' (obbligatorio)
Versione Versione del segreto nell'insieme di credenziali delle chiavi. corda

SecretsProfile

Nome Descrizione Valore
keyVaultResourceId Nome dell'insieme di credenziali delle chiavi dell'utente in cui sono archiviati tutti i segreti utente specifici del cluster. stringa (obbligatorio)
segreti Proprietà del segreto dell'insieme di credenziali delle chiavi. secretReference[]

SparkMetastoreSpec

Nome Descrizione Valore
dbName Nome del database. stringa (obbligatorio)
dbPasswordSecretName Nome del segreto che contiene la password utente del database. stringa (obbligatorio)
dbServerHost Host del server di database. stringa (obbligatorio)
dbUserName Nome utente del database. stringa (obbligatorio)
keyVaultId ID risorsa dell'insieme di credenziali delle chiavi. stringa (obbligatorio)
thriftUrl URL thrift. corda

SparkProfile

Nome Descrizione Valore
defaultStorageUrl URL di archiviazione predefinito. corda
metastoreSpec Specifica del metastore per il cluster Spark. sparkMetastoreSpec
userPluginsSpec Specifica dei plug-in utente Spark sparkUserPlugins

SparkUserPlugin

Nome Descrizione Valore
sentiero Percorso completo della cartella contenente i plug-in. corda

Vincoli:
Lunghezza minima = 1
Pattern = ^(https)|(abfss)://.*$ (obbligatorio)

SparkUserPlugins

Nome Descrizione Valore
plug-in Plug-in utente Spark. SparkUserPlugin[]

SshProfile

Nome Descrizione Valore
contare Numero di pod SSH per cluster. Int

Vincoli:
Valore minimo = 0
Valore massimo = 5 (obbligatorio)

TrackedResourceTags

Nome Descrizione Valore

TrinoCoordinator

Nome Descrizione Valore
debug Configurazione di debug trino. TrinoDebugConfig
highAvailabilityEnabled Flag che, se abilita la disponibilità elevata coordinatore, usa più repliche coordinatore con failover automatico, una per ogni nodo head. Impostazione predefinita: true. Bool

TrinoDebugConfig

Nome Descrizione Valore
abilitare Flag che se abilita o meno il debug. Bool
porto Porta di debug. Int
sospendere Flag che se sospende o meno il debug. Bool

TrinoProfile

Nome Descrizione Valore
catalogOptions Opzioni del catalogo cluster Trino. CatalogOptions
coordinatore Coordinatore Trino. TrinoCoordinator
userPluginsSpec Specifica plug-in utente trino TrinoUserPlugins
userTelemetrySpec Telemetria utente TrinoUserTelemetry
lavoratore Trino worker. TrinoWorker

TrinoTelemetryConfig

Nome Descrizione Valore
hivecatalogName Nome catalogo Hive usato per montare tabelle esterne nei log scritti da trino, se non specificato non vengono create tabelle. corda

Vincoli:
Lunghezza minima = 1
hivecatalogSchema Schema del catalogo precedente da usare per montare i log di query come tabelle esterne, se non specificate verranno montate in trinolog dello schema. corda
partitionRetentionInDays Il periodo di conservazione per le partizioni della tabella dei log delle query non influisce sui dati effettivi. Int
sentiero Percorso di archiviazione di Azure dei BLOB. corda

Vincoli:
Lunghezza minima = 1

TrinoUserPlugin

Nome Descrizione Valore
Abilitato Indica se il plug-in è attivo o meno. Bool
nome Questo campo esegue il mapping alla sottodirectory nella posizione dei plug-in trino, che conterrà tutti i plug-in nel percorso. corda

Vincoli:
Lunghezza minima = 1
sentiero Percorso completo della cartella contenente i plug-in. corda

Vincoli:
Lunghezza minima = 1
Pattern = ^(https)|(abfss)://.*$

TrinoUserPlugins

Nome Descrizione Valore
plug-in Plug-in utente trino. TrinoUserPlugin[]

TrinoUserTelemetry

Nome Descrizione Valore
immagazzinamento Definizione di telemetria utente Trino. TrinoTelemetryConfig

TrinoWorker

Nome Descrizione Valore
debug Configurazione di debug trino. TrinoDebugConfig