エラスティック・プールでの問合せオフロードの使用に関する情報を提供し、問合せオフロード機能について説明します。

エラスティック・プール問合せオフロードでは、1つ以上のリフレッシュ可能クローンでエラスティック・プール・リーダーの問合せを処理できるため、パフォーマンス上の利点が得られます。この機能では、問合せ(読取り)需要の増加に対応するために、リフレッシュ可能クローンを追加することもできます。問合せをオフロードすると、アプリケーションは水平方向にスケーリングできます。この場合、リフレッシュ可能クローンを追加して、問合せリクエスト・ボリュームを満たすために必要に応じてシステム全体のパフォーマンスを維持できます。

問合せオフロードが有効な場合、問合せはエラスティック・プール・リーダーに送信され、使用可能な1つ以上のリフレッシュ可能クローンが問合せオフロードの候補になります。さらに、リフレッシュ可能クローンの追加時に、問合せオフロードは動的に調整され、新しいリソースが利用されます。

問合せオフロードの1つのユース・ケースは、ピーク時にこの機能を有効にして、エラスティック・プール・リーダーの負荷を軽減することです。停止時間中は、問合せオフロードを無効にして、リフレッシュ可能クローンのリフレッシュなどのメンテナンス操作を実行できます。

デフォルトでは、問合せオフロードは任意のセッションからの問合せを考慮します。または、モジュール名またはアクション名で指定したセッションのリストから問合せをオフロードできます。

図autonomous-elastic-pool-leader-query-offload.pngの説明

リフレッシュ可能クローンのデータは、各リフレッシュ可能クローンの最終リフレッシュ時間に基づいて最新です。つまり、問合せオフロードが有効な場合、エラスティック・プール・リーダーに対してすべてのDDL、DMLおよびPL/SQL操作を実行します。その後、リフレッシュ可能クローンがリフレッシュされると、変更はリフレッシュ可能クローンに反映されます。

詳細は、Autonomous Databaseでのリフレッシュ可能クローンの使用を参照してください。

エラスティック・プール・リーダーに対して問合せオフロードを有効にする方法について説明します。

1. Autonomous Databaseインスタンスがエラスティック・プール・リーダーであることを確認します。

   次の問合せを使用して、インスタンスがエラスティック・プール・リーダーであることを確認します。

   SELECT sys_context('userenv', 'is_elastic_pool_leader') FROM DUAL;

   この問合せは、YESを返します。

   ノート
   
   エラスティック・プールが最近作成または変更された場合、sys_context値がエラスティック・プール・リーダーの現在の値を反映する遅延が最大15分になることがあります。
2. エラスティック・プール・リーダーに対して問合せオフロードを有効にします。

   選択肢は2つあります。セッションからの問合せの問合せオフロードを有効にするか、モジュール名またはアクション名で指定したセッションに問合せオフロードを制限できます。

   • すべてのセッションの問合せオフロードを有効にするには、パラメータなしでDBMS_PROXY_SQL.ENABLE_READ_ONLY_OFFLOADを実行します。たとえば:

     EXEC DBMS_PROXY_SQL.ENABLE_READ_ONLY_OFFLOAD;

   • モジュール名またはアクション名で特定のセッションの問合せオフロードを有効にするには、module_nameまたはaction_nameパラメータを指定してDBMS_PROXY_SQL.ENABLE_READ_ONLY_OFFLOADを実行します。

     詳細は、名前付きモジュールまたはアクションのエラスティック・プール・リーダーに対する問合せオフロードの有効化を参照してください。

SELECT sys_context('userenv', 'con_name') FROM DUAL;

• 名前付きモジュールまたはアクションのエラスティック・プール・リーダーに対する問合せオフロードの有効化
  名前付きモジュールまたはアクションを持つセッションに対してエラスティック・プール・リーダーに対する問合せオフロードを有効にする方法について説明します。

エラスティック・プール・リーダーの問合せオフロードを無効にする方法について説明します。

EXEC DBMS_PROXY_SQL.DISABLE_READ_ONLY_OFFLOAD;

問合せオフロードが有効な場合、問合せがPL/SQL内に埋め込まれていても、問合せはリフレッシュ可能クローンにオフロードされます。PL/SQLは、ストアド・プロシージャ、ファンクション、パッケージまたは無名ブロックです。

たとえば、特定のモジュールおよびアクションに対して問合せオフロードを有効にすると、リフレッシュ可能クローンにオフロードされる問合せをデモンストレーションできます。この例では、リーダーのデータが更新され、リフレッシュ可能クローンがまだ更新されていない(リフレッシュ可能クローンのデータが古く、異なる)とします。この例では、エラスティック・プール・リーダーとリフレッシュ可能クローンの値が異なるため、データがリーダーまたはリフレッシュ可能クローンのいずれかから取得されるタイミングを確認できます。

1. エラスティック・プール・リーダーの問合せオフロードを有効にし、モジュール名およびアクション名で適格なセッションを指定します。たとえば、'mod1'、'act1'です。

   DECLARE 
      mod_values clob := to_clob('["mod1"]');
      act_values clob := to_clob('["act1"]');
   BEGIN 
      DBMS_PROXY_SQL.ENABLE_READ_ONLY_OFFLOAD(
         module_name => mod_values,                                          
         action_name => act_values);
   END;
   /

2. 問合せオフロードをテストするファンクションf1を定義します。

   SQL> create or replace function f1 (n number)
     2  return number
     3  as
     4    l_cnt number;
     5  begin
     6    select sum(c1) into l_cnt from u2.tab1;
     7    return l_cnt;
     8  end;
     9  /
    
   Function created.

3. ファンクションf1を実行します。関数f1の問合せは、エラスティック・プール・リーダーで実行されます。このセッションは、ステップ1で問合せオフロードに指定されたものと一致しない未指定のモジュールおよびアクション名で実行されます。

   SQL> -- expected to fetch from Elastic Pool Leader and returns value 40
   SQL> select f1(3) from dual;
        F1(3)
   ----------
           40
    
   1 row selected.

4. ステップ1で指定した名前と一致するセッションのモジュール名およびアクション名を指定します。このセッションからの問合せは、リフレッシュ可能クローンへのオフロードに適格になりました。

   SQL> exec dbms_application_info.set_module('mod1', 'act1');
    
   PL/SQL procedure successfully completed.

5. ファンクションf1を再度実行します。この場合、モジュール名とアクション名は、ステップ1で指定した名前と一致します。関数f1の問合せは、リフレッシュ可能クローンにオフロードされます。

   SQL> -- Expected to fetch from Refreshable Clone and returns value 10
   SQL> select f1(3) from dual;
    
        F1(3)
   ----------
           10
    
   1 row selected.

6. モジュール名およびアクション名は、mod1およびact1以外のものとして指定します。モジュール名およびアクション名がステップ1で指定された名前と一致しないため、このセッションからの問合せは、リフレッシュ可能クローンへのオフロードに適格ではなくなりました。

   SQL> exec dbms_application_info.set_module('random', 'random');
    
   PL/SQL procedure successfully completed.

7. ファンクションf1を使用して問合せを実行します。このセッションのモジュールおよびアクション名がステップ1で設定されたものと一致しないため、この問合せはオフロードされず、エラスティック・プール・リーダーで実行されます。

   SQL> -- expected to fetch from Elastic Pool Leader and returns value 40
   SQL> select f1(3) from dual;
        F1(3)
   ----------
           40
    
   1 row selected.

問合せオフロードが有効な場合、Oracle Schedulerジョブ・アクション内からの問合せは、リフレッシュ可能クローンにオフロードされます。ジョブがフォアグラウンドで実行されるかバックグラウンドで実行されるかに関係なく、問合せはオフロードされます。

たとえば、PL/SQLの前の例と同様に、Oracle Schedulerジョブの問合せオフロードを有効にすると、リフレッシュ可能クローンにオフロードされる問合せを示すことができます。この例では、リーダーのデータが更新され、リフレッシュ可能クローンがまだ更新されていない(リフレッシュ可能クローンのデータが古く、異なる)とします。この例では、エラスティック・プール・リーダーとリフレッシュ可能クローンの値が異なるため、データがリーダーまたはリフレッシュ可能クローンのいずれかから取得されるタイミングを確認できます。

SQL> create or replace procedure sproc1 (n number)
  2  as
  3    l_cnt number;
  4  begin
  5    select sum(c1) into l_cnt from u2.tab1;
  6    dbms_output.put_line('l_cnt is ' || l_cnt);
  7  end;
  8  /
 
Procedure created.

Offload Queries from Elastic Pool Leader to Member Refreshable Clones

SQL> create or replace procedure sproc1 (n number)
  2  as
  3    l_cnt number;
  4  begin
  5    select sum(c1) into l_cnt from u2.tab1;
  6    dbms_output.put_line('l_cnt is ' || l_cnt);
  7  end;
  8  /
 
Procedure created.
 
SQL>
SQL> BEGIN
  2    dbms_scheduler.create_job(job_name    => 'PROXYTEST1',
  3                              job_type    => 'PLSQL_BLOCK',
  4                              job_action  => 'BEGIN sproc1(3); END;',
  5                              enabled     => FALSE);
  6  END;
  7  /
 
PL/SQL procedure successfully completed.
 
SQL>
SQL> -- Job runs in the foreground in the current session
SQL> -- expected to fetch from Leader: 40
SQL> exec dbms_scheduler.RUN_JOB(job_name => 'PROXYTEST1', use_current_session => true);
l_cnt is 40
 
PL/SQL procedure successfully completed.
 
SQL>
SQL> exec dbms_proxy_sql.enable_read_only_offload;
 
PL/SQL procedure successfully completed.
 
SQL> show con_name
 
CON_NAME
------------------------------
CDB1_PDB1
SQL> 
SQL> set serveroutput on
SQL> -- Job runs in the foreground in the current session
SQL> -- expected to fetch from Refreshable Clone: 10
SQL> exec dbms_scheduler.RUN_JOB(job_name => 'PROXYTEST1', use_current_session => true);
l_cnt is 10
 
PL/SQL procedure successfully completed.
 
SQL>
SQL> -- Job runs in the background and is expected to fetch from Refreshable Clone: 10
SQL> exec dbms_scheduler.RUN_JOB(job_name => 'PROXYTEST1', use_current_session => false);
 
PL/SQL procedure successfully completed.

問合せオフロード機能の追加ノートを提供します。

問合せオフロードに関するノート:

• リフレッシュ可能クローンの追加または削除: リフレッシュ可能クローンをエラスティック・プール・メンバーとして追加すると、追加がエラスティック・プール・リーダーに反映されるまで最大15分の遅延が発生する可能性があります。新しく追加されたリフレッシュ可能クローンは、リーダーが新しく追加されたエラスティック・プール・メンバーを認識するまで、問合せオフロードのターゲットとみなされません。

  同様に、リフレッシュ可能クローンがエラスティック・プールから削除されると、削除がエラスティック・プール・リーダーに反映されるまで最大15分の遅延が発生する可能性があります。削除されたリフレッシュ可能クローンは、メンバーがエラスティック・プールから削除されたことをリーダーが認識するまで、問合せオフロードのターゲットとみなされます。

• リフレッシュ可能クローンのリフレッシュ: リフレッシュ可能クローンがリフレッシュされると、リフレッシュ可能クローンにオフロードされる問合せが遅延する可能性があります。

• パブリック・エンドポイントおよびプライベート・エンドポイントのサポート: 問合せオフロードは、パブリック・エンドポイント上のインスタンスおよびプライベート・エンドポイント上のインスタンスでサポートされます。

• 切断されたリフレッシュ可能クローン: リフレッシュ可能クローンが切断されると、問合せオフロードのターゲットとして適格ではなくなります。エラスティック・プール・リーダーがリフレッシュ可能クローンが切断されたことを検出し、問合せのオフロードを停止するまで、最大15分の遅延が発生する可能性があります。

  リフレッシュ可能クローンを問合せオフロードに使用できるようにするには、自動リフレッシュを有効にするか、リフレッシュ可能クローンを定期的に手動でリフレッシュします。

  詳細は、Autonomous Databaseでのリフレッシュ可能クローンのリフレッシュを参照してください。

• 大/小文字を区別するモジュール名およびアクション名: モジュール名またはアクション名で指定したセッションのリストから問合せをオフロードする場合、DBMS_APPLICATION_INFOで設定されたモジュール名およびアクション名では大/小文字が区別されます。DBMS_PROXY_SQL.ENABLE_READ_ONLY_OFFLOADは、この大/小文字を区別する動作に従います。たとえば、セッションに小文字のモジュール名または大/小文字のモジュール名が混在している場合、DBMS_PROXY_SQL.ENABLE_READ_ONLY_OFFLOADで問合せオフロードを有効にし、module_nameまたはaction_nameパラメータを含めると、大/小文字がパラメータ値と一致する必要があります。

  DBMS_APPLICATION_INFO.READ_MODULEを使用して、現在のセッションのモジュール名およびアクション名を確認できます:

  set serveroutput on;
  declare
    l_mod varchar2(50);
    l_act varchar2(50);
  BEGIN
  DBMS_APPLICATION_INFO.READ_MODULE(l_mod, l_act);
    DBMS_OUTPUT.PUT_LINE('l_mod: ' || l_mod);
    DBMS_OUTPUT.PUT_LINE('l_act: ' || l_act);
  END;
  /

• 一般的なユース・ケース: 問合せオフロードの1つのユース・ケースは、ピーク時にこの機能を有効にして、エラスティック・プール・リーダーの負荷を軽減することです。停止時間中は、問合せオフロードを無効にして、リフレッシュ可能クローンのリフレッシュなどのメンテナンス操作を実行できます。