Propiedades de los grupos de recursos

Puede formatear el archivo JSON de grupo de recursos para que coincida con el archivo de grupo de recursos de muestra que puede descargar de la consola.

En las secciones siguientes se describen las propiedades de los grupos de recursos que se pueden configurar.

Propiedades principales

Propiedades principales
Nombre de propiedad Tipo Necesaria/Opcional Descripción
rootGroups Matriz Obligatorio Define las especificaciones de los grupos de recursos.
selectors Matriz Obligatorio Especifica las configuraciones del selector para los grupos de recursos.
cpuQuotaPeriod Serie Opcional Especifica el periodo de cuota de CPU. Esta propiedad debe coincidir con el patrón ^\d+(.\d+)?[smhd]$.

rootGroups propiedades

propiedades derootGroups
Nombre de propiedad Tipo Necesaria/Opcional Descripción
name Serie Obligatorio Nombre del grupo de recursos. Si el nombre contiene {, }, o $, el nombre debe estar en el patrón ${([a-zA-Z][a-zA-Z0-9]*)}. Se permiten espacios en blanco en el nombre. El nombre no puede contener un punto (.). No puede tener el mismo nombre para dos grupos hermanos. Un grupo raíz y un subgrupo pueden tener el mismo nombre.
softMemoryLimit Serie Obligatorio Especifica el límite de memoria blanda. Valor mínimo: 0%. Valor máximo: 999%.
maxQueued Entero Opcional Especifica el número máximo de solicitudes en cola. Valor mínimo: 0. Valor máximo: 2147483647. El valor no debe empezar por 0. Por ejemplo, 01, 05. Especifique los valores como 1, 5. 0 por sí solo es un valor válido.
softConcurrencyLimit Entero o nulo Opcional Especifica el límite suave de concurrencia. Valor mínimo: 0. Valor máximo: 2147483647. El valor no debe empezar por 0. Por ejemplo, 01, 05. Especifique los valores como 1, 5. 0 por sí solo es un valor válido.
maxRunning Entero o nulo Opcional Especifica el recuento máximo en funcionamiento. Valor mínimo: 0. Valor máximo: 2147483647. El valor no debe empezar por 0. Por ejemplo, 01, 05. Especifique los valores como 1, 5. 0 por sí solo es un valor válido.
hardConcurrencyLimit Entero Obligatorio (Si maxRunning valor está disponible, hardConcurrencyLimit toma ese valor. Si maxRunning no está establecido, debe establecer un valor para hardConcurrencyLimit) Especifica el límite de concurrencia dura. Valor mínimo: 0. Valor máximo: 2147483647. El valor debe ser mayor o igual que softConcurrencyLimit. No debe empezar por 0. Por ejemplo, 01, 05. Especifique los valores como 1, 5. 0 por sí solo es un valor válido.
schedulingPolicy Cadena (Los valores disponibles son los siguientes: fair, weighted, weighted_fair, query_priority. Estos valores no distinguen entre mayúsculas y minúsculas) Opcional Especifica la política de programación.
schedulingWeight Entero o nulo Opcional Especifica el peso de programación. Valores permitidos (de mínimo a máximo): 1 a 2147483647. El valor no debe empezar por 0. Por ejemplo, 01, 05. Especifique los valores como 1, 5. 0 por sí solo es un valor válido. Si un subgrupo tiene schedulingWeight, todos los hermanos correspondientes de ese subgrupo deben tener schedulingWeight.
subGroups Matriz o null Opcional Especifica los subgrupos dentro del grupo de recursos. Los subgrupos tienen las mismas reglas para las distintas propiedades que en el grupo de recursos.
jmxExport Booleano o nulo Opcional Indica si la exportación JMX está activada.
softCpuLimit Serie Opcional Especifica el límite suave de CPU. Debe coincidir con el patrón ^\d+(.\d+)?[smhd]$. Si se define hardCpuLimit, el valor de softCpuLimit debe ser menor o igual que hardCpuLimit.
hardCpuLimit Serie Opcional Especifica el límite duro de CPU. Debe coincidir con el patrón ^\d+(.\d+)?[smhd]$.
perQueryLimits Objecto Opcional Especifica los límites por consulta. Ejemplo: "perQueryLimits": { "executionTimeLimit": "30m", "totalMemoryLimit": "2GB", "cpuTimeLimit": "1h" }. El objeto puede tener uno, dos o tres de los siguientes límites. No se permiten valores negativos para ninguno de los siguientes límites. 1. executionTimeLimit (Tipo: Cadena, Patrón: Esta propiedad debe coincidir con el patrón ^\d+(.\d+)?[smhd]$.), 2. totalMemoryLimit (Tipo: Cadena, Patrón: Esta propiedad debe coincidir con el patrón ^\s*(\d+(?:.\d+)?)\s*([a-zA-Z]+)\s*$.), 3. cpuTimeLimit (Tipo: Cadena, Patrón: Esta propiedad debe coincidir con el patrón ^\d+(.\d+)?[smhd]$.)
workersPerQueryLimit Entero o nulo Opcional Especifica el límite de trabajadores por consulta. Valores permitidos (de mínimo a máximo): -2147483648 a 2147483647. El valor debe ser mayor o igual que softConcurrencyLimit. No debe empezar por 0. Por ejemplo, 01, 05. Especifique los valores como 1, 5. 0 por sí solo es un valor válido.

selectors propiedades

propiedades de los selectores
Nombre de propiedad Tipo Necesaria/Opcional Descripción
user Cadena o null (Las cadenas pueden tener cualquier expresión regular válida (.*).) Opcional Especifica el patrón regex del usuario.
source Cadena o null (Las cadenas pueden tener cualquier expresión regular válida (.*).) Opcional Especifica el patrón regex de origen.
queryType Cadena o nulo. (Los valores posibles son data_definition, delete, describe, explain, analyze, insert, select, control y update. Estos valores no distinguen entre mayúsculas y minúsculas) Opcional Especifica el tipo de consulta.
clientTags Lista de cadenas o null (Ejemplo: "clientTags": ["resourceGroup1","resourceGroup2"]. storageStrings puede tener cualquier expresión regular válida (.*) Opcional Especifica las etiquetas del cliente.
selectorResourceEstimate Objeto o null Opcional Especifica la estimación de recursos del selector. Ejemplo: "selectorResourceEstimate": {"executionTime": {"min": "5m", "max": "10m"}, "cpuTime": {"min": "30m", "max": "1h"}, "peakMemory": {"min": "512MB", "max": "2GB"}}. El objeto puede tener uno, dos o tres de los límites. También puede utilizar los parámetros min, max o ambos para los tres límites. Por ejemplo, "selectorResourceEstimate": {"executionTime": {"min": "5m"}. No se permiten valores negativos para ninguno de los límites. Para obtener más información sobre los límites, consulte selectorResourceEstimate límites.
clientInfo Cadena o null (Las cadenas pueden tener cualquier expresión regular válida (.*).) Opcional Especifica el patrón regex de información del cliente.
schema Cadena o null (Las cadenas pueden tener cualquier expresión regular válida (.*).) Opcional Especifica el esquema.
principal Cadena o null (Las cadenas pueden tener cualquier expresión regular válida (.*).) Opcional Especifica el patrón regex principal.
group Serie Obligatorio El nombre del grupo debe ser uno de los nombres disponibles en el grupo de recursos. Para redirigir a un subgrupo, utilice "group": "groupname.subgroupname". También puede utilizar valores dinámicos como ${SOURCE}, ${USER} y ${SCHEMA} como los utilizados en los nombres de grupos raíz. No puede tener null en group.

En los regex source y user, puede utilizar el nombre proporcionado en el formato (?<sampleName>.*) como nombre de grupo dinámico. Por ejemplo:

{
            "source": "(?<sampleName>.*)",
            "clientTags": [
                "hipri"
            ],
            "group": "bi-${sampleName}"
}and there is a group as ,{
            "name": "bi-${sampleName}",
            "softMemoryLimit": "80%",
            "hardConcurrencyLimit": 100,
            "maxQueued": 1000,
            "schedulingPolicy": "weighted",
            "jmxExport": true
}

En este ejemplo, sampleName es un valor dinámico. No se permiten caracteres especiales en el nombre. Puede añadir otros valores como ${SOURCE}, ${USER}, o ${SCHEMA}. El nombre del grupo distingue entre mayúsculas y minúsculas. Puede tener valores antes y después de la variable dinámica. Por ejemplo, abc-${SOURCE} o ${toolname}-xyz.

selectorResourceEstimate límites

  • executionTime

    • min: El tipo de propiedad es cadena. Esta propiedad debe coincidir con el patrón ^\\d+(\\.\\d+)?[smhd]$.
    • max: El tipo de propiedad es cadena. Esta propiedad debe coincidir con el patrón ^\\d+(\\.\\d+)?[smhd]$.

  • peakMemory

    • min: El tipo de propiedad es cadena. Esta propiedad debe coincidir con el patrón ^\s*(\d+(?:\.\d+)?)\s*([a-zA-Z]+)\s*$.
    • max El tipo de propiedad es cadena. Esta propiedad debe coincidir con el patrón ^\s*(\d+(?:\.\d+)?)\s*([a-zA-Z]+)\s*$.

  • cpuTime

    • min: El tipo de propiedad es cadena. Esta propiedad debe coincidir con el patrón ^\\d+(\\.\\d+)?[smhd]$.
    • max: El tipo de propiedad es cadena. Esta propiedad debe coincidir con el patrón ^\\d+(\\.\\d+)?[smhd]$.

cpuQuotaPeriod propiedades

propiedades de los selectores
Nombre de propiedad Tipo Necesaria/Opcional Descripción
cpuQuotaPeriod Serie Opcional Especifica el periodo de cuota de CPU. Esta propiedad debe coincidir con el patrón ^\d+(\.\d+)?[smhd]$