Condividi tramite


Uso di file vari

Importante

Azure HDInsight su AKS è stato ritirato il 31 gennaio 2025. Scopri di più con questo annuncio.

È necessario eseguire la migrazione dei carichi di lavoro a Microsoft Fabric o a un prodotto Azure equivalente per evitare la chiusura brusca dei carichi di lavoro.

Importante

Questa funzionalità è attualmente in anteprima. Le condizioni supplementari per l'utilizzo per le anteprime di Microsoft Azure includono termini legali più validi applicabili alle funzionalità di Azure in versione beta, in anteprima o altrimenti non ancora rilasciate nella disponibilità generale. Per informazioni su questa anteprima specifica, vedere informazioni sull'anteprima di Azure HDInsight su AKS. Per domande o suggerimenti sulle funzionalità, inviare una richiesta in AskHDInsight con i dettagli e seguici per altri aggiornamenti su Community di Azure HDInsight.

Questo articolo fornisce informazioni dettagliate su come specificare e usare la configurazione di file vari.

È possibile aggiungere le configurazioni per l'uso di file vari nel cluster utilizzando un template ARM. Per esempi più ampi, vedere configurazione del servizio .

Prerequisiti

Aggiungere file esterni

Ogni specifica di file nel componente miscfiles in clusterProfile.serviceConfigsProfiles nel modello ARM richiede:

  • fileName: nome simbolico del file da usare come riferimento in altre configurazioni. Questo nome non è un nome di file fisico. Per utilizzare il file vario specificato in altre configurazioni, bisogna specificare ${MISC:\<fileName\>} e HDInsight in AKS sostituisce questo tag con il percorso file effettivo durante l'esecuzione. Il valore fornito deve soddisfare le seguenti condizioni:

    • Non contenere più di 253 caratteri
    • Contengono solo caratteri alfanumerici minuscoli, - o .
    • Inizio e fine con un carattere alfanumerico
  • path: percorso del file relativo, inclusi il nome file e l'estensione, se applicabile. Trino con HDInsight su AKS garantisce solo la posizione di ciascun file vario rispetto ad altri file vari, ovvero la directory di base può cambiare. Non è possibile presupporre nulla sul percorso assoluto dei file esterni, ad eccezione del fatto che termina con il valore specificato nella proprietà "path".

  • content: stringa con escape JSON del contenuto del file. Il formato del contenuto è specifico per determinate funzionalità di Trino e può variare, ad esempio json per gruppi di risorse.

Nota

La configurazione errata potrebbe impedire l'avvio del cluster Trino. Prestare attenzione all'aggiunta delle configurazioni.

Nell'esempio seguente viene illustrato

  • Aggiungere gruppi di risorse di esempio json e configurare per l'uso da parte del coordinatore.
"serviceConfigsProfiles": [
    {
        "serviceName": "trino",
        "configs": [
            {
                "component": "common",
                "files": [
                    {
                        "fileName": "resource-groups.properties",
                        "values": {
                            "resource-groups.configuration-manager": "file",
                            "resource-groups.config-file": "${MISC:resource-groups}"
                        }                                            
                    }
                ]
            },
            {
                "component": "miscfiles",
                "files": [
                    {
                        "fileName": "resource-groups",
                        "path": "/customDir/resource-groups.json",
                        "content": "{\"rootGroups\":[{\"name\":\"global\",\"softMemoryLimit\":\"80%\",\"hardConcurrencyLimit\":100,\"maxQueued\":1000,\"schedulingPolicy\":\"weighted\",\"jmxExport\":true,\"subGroups\":[{\"name\":\"data_definition\",\"softMemoryLimit\":\"10%\",\"hardConcurrencyLimit\":5,\"maxQueued\":100,\"schedulingWeight\":1},{\"name\":\"adhoc\",\"softMemoryLimit\":\"10%\",\"hardConcurrencyLimit\":50,\"maxQueued\":1,\"schedulingWeight\":10,\"subGroups\":[{\"name\":\"other\",\"softMemoryLimit\":\"10%\",\"hardConcurrencyLimit\":2,\"maxQueued\":1,\"schedulingWeight\":10,\"schedulingPolicy\":\"weighted_fair\",\"subGroups\":[{\"name\":\"${USER}\",\"softMemoryLimit\":\"10%\",\"hardConcurrencyLimit\":1,\"maxQueued\":100}]}]}]},{\"name\":\"admin\",\"softMemoryLimit\":\"100%\",\"hardConcurrencyLimit\":50,\"maxQueued\":100,\"schedulingPolicy\":\"query_priority\",\"jmxExport\":true}],\"selectors\":[{\"group\":\"global.adhoc.other.${USER}\"}],\"cpuQuotaPeriod\":\"1h\"}"
                    }
                ]
            }
        ]
    }

Distribuire il modello ARM aggiornato per riflettere le modifiche nel tuo cluster. Informazioni su come distribuire un modello ARM.