==========
ALTER RESOURCE QUEUE 
==========


.. container:: refentry
   :name: SQL-ALTERRESQUEUE

   .. container:: titlepage

   .. container:: refnamediv

      .. rubric:: ALTER RESOURCE QUEUE
         :name: alter-resqueue

      ALTER RESOURCE QUEUE — 更改一个资源队列

   .. container:: refsynopsisdiv

      .. rubric:: 大纲
         :name: 大纲

      .. code:: synopsis

         ALTER RESOURCE QUEUE <name> WITH ( <queue_attribute>=<value> [, ... ] ) 

         其中 option 可以是：

            ACTIVE_STATEMENTS=<integer>
            MEMORY_LIMIT='<memory_units>'
            MIN_COST=<float>

   .. container:: refsect1

      .. rubric:: 描述
         :name: 描述

      ``ALTER RESOURCE QUEUE`` 更改资源队列的限制。只有超级用户可以更改资源队列。

   .. container:: refsect1

      .. rubric:: 参数
         :name: 参数

      .. container:: variablelist

         ``name``
            要修改的资源队列的名称。由 <vcname>.<queuename> 组成，其中 vcname 为虚拟集群名称，queuename 为队列子名称。

         ``ACTIVE_STATEMENTS``
            系统允许此资源队列中用户同时提交的活动语句数。ACTIVE_STATEMENTS 的值应为大于 0 的整数。要将 ACTIVE_STATEMENTS 重置为无限制，请输入值 -1。

         ``MEMORY_LIMIT``
            设置此资源队列中用户提交的所有语句的总内存配额。内存单位可以是 KB、MB 或 GB。资源队列的最小内存配额为 10MB。没有最大值；但是查询执行时的上限受段主机的物理内存限制。

         ``MIN_COST``
            被视为小查询的最小查询成本限制。成本低于此限制的查询将不会排队并立即运行。成本以查询规划器确定的查询估计总成本来衡量（如查询的 EXPLAIN 输出中所示）。因此，管理员必须熟悉系统上通常运行的查询，以便为被视为小查询的查询设置适当的成本。

   .. container:: refsect1

      .. rubric:: 示例
         :name: 示例

      更改资源队列的活动查询限制：

      .. code:: programlisting

         ALTER RESOURCE QUEUE myvc.myqueue WITH (ACTIVE_STATEMENTS=20);

      更改资源队列的内存限制：

       .. code:: programlisting

         ALTER RESOURCE QUEUE myvc.myqueue WITH (MEMORY_LIMIT='20GB');

   .. container:: refsect1

      .. rubric:: 兼容性
         :name: 兼容性

      ``ALTER RESOURCE QUEUE`` 是 OushuDB 数据库扩展。SQL 标准中没有关于资源队列或资源管理的规定。

   .. container:: refsect1

      .. rubric:: 参见
         :name: 参见

      `CREATE RESOURCE QUEUE <sql-createresqueue.html>`__, 
      `DROP RESOURCE QUEUE <sql-dropresqueue.html>`__,