ALTER OUTLINE · k8s原理與實踐

[TOC] # ALTER OUTLINE ## 描述該語句僅支持使用SQL\_TEXT創建的 OUTLINE，可用于添加綁定OUTLINE和限流規則。 ## 格式 ~~~ ALTER OUTLINE outline_name ADD stmt [ TO target_stmt ] ~~~ ## 參數解釋 <table data-tag="table" id="table-ile-ffg-9vh" class="table"><colgroup width="360" span="1" data-tag="col" id="col-5lj-jyf-apm" colwidth="1*" colnum="1" colname="col1" style="width:50%" class="col"></colgroup><colgroup width="360" span="1" data-tag="col" id="col-05f-eqc-fkp" colwidth="1*" colnum="2" colname="col2" style="width:50%" class="col"></colgroup><thead id="thead-c0x-8z0-edx" class="thead"><tr id="tr-8c7-0n1-nh0"><th id="td-93a-6z5-p89"><p id="p-04v-qyq-klp"><b>參數</b></p></th><th id="td-jvb-6pw-he8"><p id="p-jc8-gwr-dkg"><b>描述</b></p></th></tr></thead><tbody data-tag="tbody" id="tbody-wj5-nz8-py5" class="tbody"><tr data-tag="tr" id="tr-vdi-no2-t9k" class="tr"><td data-tag="td" id="td-obe-c9w-dt0" class="td"><p id="p-yy0-mxg-487">outline_name</p></td><td data-tag="td" id="td-fq8-fsc-hd3" class="td"><p data-tag="p" id="p-umi-70r-va8" class="p">指定要創建的 OUTLINE 名稱。</p></td></tr><tr data-tag="tr" id="tr-7dx-0h5-dbc" class="tr"><td data-tag="td" id="td-z9h-55b-946" class="td"><p id="p-oq2-wjv-yf8">stmt</p></td><td data-tag="td" id="td-fal-trt-epr" class="td"><p id="p-k71-28d-he5">一般為一個帶有 hint 和原始參數的 DML 語句。</p></td></tr><tr data-tag="tr" id="tr-cd3-z1z-9i4" class="tr"><td data-tag="td" id="td-kpz-646-caz" class="td"><p id="p-7x7-ej1-g87">TO target_stmt</p></td><td data-tag="td" id="td-kxt-yon-9pk" class="td"><p data-tag="p" id="p-o4j-hlb-eo7" class="p">如果不指定 TO target_stmt，則表示如果數據庫接受的SQL參數化后與stmt去掉hint參數化文本相同，則將該SQL綁定stmt中hint生成執行計劃；如果期望對含有hint的語句進行固定計劃，則需要 TO target_stmt 來指明原始的SQL。</p><p data-tag="p" id="p-wtx-eyt-za6" class="p"><span data-mce-style="font-size: 11px" data-tag="span" id="span-1c0-lgb-oav" class="span"><b></b></span></p><div type="notice" id="note-lik-m43-yny" class="note note-notice"><div class="note-icon-wrapper"><i class="icon-note note notice"></i></div><div class="noteContentSpan"><strong>注意 </strong><p id="p-nq1-8z2-z7g"></p><p id="p-67p-m27-px7">在使用target_stmt時，嚴格要求stmt與target_stmt在去掉hint后完全匹配。</p></div></div><p></p><p data-tag="p" id="p-wtx-eyt-za6" class="p"></p></td></tr></tbody></table> ## 示例 * 通過ALTER OUTLINE來添加限流規則。 ~~~ OceanBase (root@oceanbase)> alter outline ol_1 add select /*+max_concurrent(1)*/ * from t1 where c1 = 1 and c2 = ?; OceanBase (root@oceanbase)> alter outline ol_1 add select /*+max_concurrent(1)*/ * from t1 where c1 = ? and c2 = 1; ~~~ * 通過ALTER OUTLINE來添加執行計劃。 ~~~ OceanBase (root@oceanbase)> create outline ol_2 on select /*+max_concurrent(1)*/ * from t1,t2 where t1.c1 = 1; OceanBase (root@oceanbase)> alter outline ol_2 add select /*+use_nl(t2)*/ * from t1,t2 where t1.c1 = 1; ~~~ ## 注意事項 * 同一個outline\_name 只能指定一個執行計劃。如果通過create outline語句指定了執行計劃，則無法通過執行alter outline時再添加。 * 同create outline類似，在alter outline時不能同時指定限流規則和執行計劃。 * 執行alter outline時，需要outline\_name和signature同時匹配。