Modifying a Resource Pool

You can modify the parameters of a resource pool on the resource management page.

  1. Log in to the GaussDB(DWS) management console.
  2. Choose Clusters. Click the name of a cluster.
  3. Choose Resource Management Configurations.
  4. In the Resource Pools drop-down list, click the name of a resource pool. The following configuration areas are displayed, including Short Query Configuration, Resource Configuration, Exception Rule, and Associated User.

  5. Modify the short query configuration. Set the parameters as required and click Save on the right.

    Parameter

    Description

    Value

    Short Query Acceleration

    Whether to enable short query acceleration. This function is enabled by default.

    Enable

    Concurrent Short Queries

    A short query is a job whose estimated memory used for execution is less than 32 MB. The default value -1 indicates that the job is not controlled.

    10

  6. Modify the resource configuration.

    1. Click Edit on the right and modify the parameters according to Table 1.
      Table 1 Resource pool parameters

      Parameter

      Description

      Mandatory

      Default Value

      Name

      Resource pool name

      Yes

      -

      CPU Resource (%)
      • CPU share: Percentage of CPU time that can be used by users associated with the current resource pool to execute jobs. The value is an integer ranging from 1 to 99.
      • CPU limit: Maximum percentage of CPU cores used by a database user in a resource pool. The value is an integer ranging from 0 to 100. 0 indicates no limit.
      NOTE:
      • The sum of the parameter values of all the resource pools cannot exceed 99%. If there is only one resource pool, the CPU share parameter does not take effect.
      • The CPU share parameter takes effect only when CPU contention occurs. For example, resource pools A and B are bound to CPU 1. If A and B are both running, the parameter takes effect. If there is only A running, the parameter does not take effect.
      • The sum of the CPU limits of all the resource pools cannot exceed 100%. The default value is 0.
      • The CPU limit is supported only by clusters of version 8.1.3 or later.

      Yes

      -

      Memory Resource (%)

      Percentage of the memory that can be used by a resource pool.

      CAUTION:

      You can manage memory and query concurrency separately or jointly. Under joint management, jobs can be delivered only when both the memory and concurrency conditions are met.

      Yes

      0 (not limited)

      Storage Resource (MB)

      Size of the available space for permanent tables.

      CAUTION:

      This parameter indicates the total tablespace of all DNs in a resource pool. Available space of a single DN = Configured value/Number of DNs.

      Yes

      -1 (not limited)

      Complex Statement Concurrency

      Maximum number of concurrent queries in a resource pool.

      CAUTION:

      You can manage memory and query concurrency separately or jointly. Under joint management, jobs can be delivered only when both the memory and concurrency conditions are met.

      Yes

      10

      Network Bandwidth Weight

      Weight for network scheduling. The value is an integer ranging from 1 to 2147483647. The default value is -1.

      CAUTION:

      Only cluster 8.2.1 and later versions support the network bandwidth weight.

      Yes

      -1 (not limited)

      The CPU usage limit is supported only by clusters of version 8.1.3 or later.

    2. Click OK.

  7. Modify the exception rules.

    1. Modify rule parameters. See the following table for more information.
      Table 2 Exception rule parameters

      Parameter

      Description

      Value Range (0 Means No Limit)

      Operation

      Blocking Time

      Job blocking time. It refers to the total time spent in global and local concurrent queuing. The unit is second.

      For example, if the blocking time is set to 300s, a job executed by a user in the resource pool will be terminated after being blocked for 300 seconds.

      An integer in the range 1 to 2,147,483,647. The value 0 indicates no limit.

      Terminated, Downgraded, or Not limited

      Execution Time

      Time that has been spent in executing the job, in seconds.

      For example, if Time required for execution is set to 100s, a job executed by a user in the resource pool will be terminated after being executed for more than 100 seconds.

      An integer in the range 1 to 2,147,483,647. The value 0 indicates no limit.

      Terminated, Downgraded, or Not limited

      Total CPU time on all DNs.

      Total CPU time spent in executing a job on all DNs, in seconds.

      An integer in the range 1 to 2,147,483,647. The value 0 indicates no limit.

      Terminated, Downgraded, or Not limited

      Interval for Checking CPU Skew Rate

      Interval for checking the CPU skew, in seconds. This parameter must be set together with Total CPU Time on All DNs.

      An integer in the range 1 to 2,147,483,647. The value 0 indicates no limit.

      Terminated, Downgraded, or Not limited

      Total CPU Time Skew Rate on All DNs

      CPU time skew rate of a job executed on DNs. The value depends on the setting of Interval for Checking CPU Skew Rate.

      An integer in the range 1 to 100. The value 0 indicates no limit.

      Terminated, Downgraded, or Not limited

      Data Spilled to Disk Per DN

      Allowed maximum job data spilled to disks on a DN. The unit is MB.

      NOTE:

      This rule is supported only by clusters of version 8.2.0 or later.

      An integer in the range 1 to 2,147,483,647. The value 0 indicates no limit.

      Terminated, Downgraded, or Not limited

      Average CPU Usage Per DN

      Average CPU usage of a job on each DN. If Interval for Checking CPU Skew Rate is configured, the interval takes effect for this parameter. If the interval is not configured, the check interval is 30 seconds by default.

      NOTE:

      This rule is supported only by clusters of version 8.2.0 or later.

      An integer in the range 1 to 100. The value 0 indicates no limit.

      Terminated, Downgraded, or Not limited

      Maximum Bandwidth on a Single DN

      Maximum network bandwidth (MB) for a job on a single DN.

      NOTE:

      This rule is supported only by clusters of version 8.2.1 or later.

      An integer in the range 1 to 2,147,483,647. The value 0 indicates no limit.

      Terminated, Downgraded, or Not limited

      Exception rules allow you to control exceptions of jobs executed by users in a resource pool. Currently, you can configure the parameters listed in Table 2.

      • If you select Terminate, you need to set the corresponding time or percentage.
      • If you select No restriction, the corresponding execution rule does not take effect.
    2. Click Save.

  8. Associate users.

    • The resources used by a user to run jobs can be controlled only after the user is added to a resource pool.
    • A database user can be added to only one resource pool. Users removed from a resource pool can be added to another pool.
    • Database administrators cannot be associated.
    1. Click Add.
    2. Select the users to be added from the current user list. You can select multiple users at a time.

    3. Click OK.
    4. To remove a user, click Disassociate User in the Operation column of the user.

Parent topic: Resource Pool