| Oracle® Database PL/SQLパッケージおよびタイプ・リファレンス 11g リリース2(11.2) B56262-06 |
|
 前 |
 次 |
このパッケージは、PL/SQLからSQL ALTER SESSION文とSET ROLE文へのアクセスおよび他のセッション情報へのアクセスを提供します。DBMS_SESSIONを使用すると、作業環境とセキュリティ・レベルを設定できます。
この章では、次の項目について説明します。
セキュリティ・モデル
使用上の注意
表132-1 DBMS_SESSIONパッケージのサブプログラム
| サブプログラム | 説明 |
|---|---|
|
|
すべてのコンテキスト情報を消去します。 |
|
|
コンテキストを消去します。 |
|
|
識別子を消去します。 |
|
|
データベース・リンクをクローズします。 |
|
|
大量のメモリーが必要な操作を実行した後で未使用のメモリーを再要求できます。 |
|
GET_PACKAGE_MEMORY_UTILIZATIONプロシージャ |
静的パッケージのメモリー使用量を示します。 |
|
|
指定のロールがセッションで使用可能かどうかを判別します。 |
|
|
指定されたセッションがアクティブかどうかを判別します。 |
|
|
現行のセッションについて、アクティブなネームスペースとコンテキストのリストを戻します。 |
|
|
このプロシージャは、セッションでアクティブなすべてのPL/SQLプログラム・ユニットのセッション状態で、 |
|
|
コール元のセッションに対するセッション・レベルのSQLトレースを再設定します。 |
|
|
コール元のセッションに対するセッション・レベルのSQLトレースを使用可能にします。 |
|
|
セッション内のすべてのパッケージのインスタンス化を解除します。 |
|
|
コンテキスト属性の値を設定または再設定します。 |
|
|
指定したエディションへの切替えを要求します。 |
|
|
識別子を設定します。 |
|
|
グローバリゼーション・サポート(NLS)を設定します。 |
|
|
ロールを設定します。 |
|
|
トレースをオンまたはオフにします。 |
|
SWITCH_CURRENT_CONSUMER_GROUPプロシージャ |
ユーザーの現行のセッションでの、現行のリソース・コンシューマ・グループの変更を容易にします。 |
|
|
データベースに現在接続しているすべてのセッションに対して一意の識別子を戻します。 |
パラメータ
表132-3 CLEAR_CONTEXTプロシージャのパラメータ
| パラメータ | 説明 |
|---|---|
|
|
アプリケーション・コンテキストを消去するネームスペース。必須です。 セッション・ローカル・コンテキストの場合、 グローバルにアクセスされるコンテキストの場合、 |
|
|
グローバル・コンテキストに適用され、その他のタイプのコンテキストではオプションです(最大64バイト)。 |
|
|
消去するネームスペース内の特定の属性(オプション)。デフォルトは |
このプロシージャは、オープンしているデータベース・リンクをクローズします。これは、次のSQL文と同じです。
ALTER SESSION CLOSE DATABASE LINK <name>
このプロシージャは、大量のメモリー(100Kを超えるメモリー)が必要な操作の実行後、未使用のメモリーを再要求します。
大量のメモリーを使用する操作の例を次に示します。
sort_area_size全部を使用し、sort_area_sizeが数百KBになる大規模なソート処理
大規模なPL/SQLパッケージ、プロシージャまたはファンクションのコンパイル処理
PL/SQL索引表内にある数百KBのデータを格納する処理
v$sesstat固定ビューまたはv$statname固定ビューにある統計情報「セッションUGAメモリー」と「セッションPGAメモリー」を追跡調査して、ユーザー・メモリーを監視できます。これらの統計情報の監視では、このプロシージャが解放したメモリー量も表示されます。
|
注意: このプロシージャは、メモリーが非常に不足している場合のみ使用してください。頻繁には使用せず、慎重に使用してください。 |
戻り値
このプロシージャの動作は、クライアントのかわりに稼働しているサーバーの構成によって決まります。
専用サーバー: 使用されていないPGAメモリーとセッション・メモリーをオペレーティング・システムに戻します。セッション・メモリーは、この構成内のPGAから割り当てられます。
共有サーバー: 使用されていないセッション・メモリーをshared_poolに戻します。セッション・メモリーは、この構成内のshared_poolから割り当てられます。
使用上の注意
このプロシージャを使用してメモリーを解放するためには、そのメモリーが使用中でないことが必要です。
ある操作でメモリーを割り当てた後は、同じタイプの操作でのみ、割り当てられたメモリーを再利用できます。たとえば、ソート用に割り当てられたメモリーは、ソート完了後にそのメモリーが使用されなくなると、別のソート処理でのみ再利用できます。ソートとコンパイルについては、操作の完了後にメモリーが使用されなくなると、ユーザーはこのプロシージャをコールして、この未使用メモリーを解放できます。
索引表にはメモリーが暗黙的に割り当てられ、その索引表の要素に割り当てられた値が格納されます。したがって、索引表内の要素が多いほど、RDBMSは多くのメモリーを索引表に割り当てます。索引表に要素がある間は、索引表に関連するメモリーは使用中になります。
索引表の有効範囲によって、メモリーの使用期間が決まります。グローバルに宣言された索引表は、パッケージまたはパッケージ本体で宣言された索引表です。これらの索引表には、セッション・メモリーからメモリーが割り当てられます。グローバルに宣言された索引表では、メモリーは、ユーザーのログイン中(ユーザーのセッションの間)は使用中のままとなり、Oracleから切断された後に解放されます。
ローカルで宣言された索引表は、ファンクション、プロシージャまたは無名ブロック内で宣言された索引表です。このような索引表には、PGAメモリーからメモリーが割り当てられます。ローカルに宣言された索引表については、索引表が宣言されたプロシージャ、ファンクションまたは無名ブロックをユーザーが実行しているかぎり、メモリーは使用中のままになります。プロシージャ、ファンクションまたは無名ブロックの実行が完了すると、そのメモリーはローカルに宣言された他の索引表で使用可能になります(すなわち、メモリーは使用中ではなくなります)。
初期化されていない空の索引表を既存の索引表に割り当てることは、索引表とその索引表に関連付けられたメモリーを明示的に再初期化するための1つの方法です。この操作を行うと、索引表に関連付けられているメモリーは使用中ではなくなり、このプロシージャをコールして解放できます。この方法は、グローバルに宣言した索引表がユーザー・セッションの期間中に大きくなる可能性があり、ユーザーが索引表の内容を必要としない場合は、特に役立ちます。
索引表の有効範囲に関連するメモリー・ルールは適用されたままです。しかし、この方法とプロシージャによって、ユーザーが介入して、索引表に関連付けられているメモリーを明示的に解放できます。
例
次のPL/SQLは、この方法とFREE_UNUSED_USER_MEMORYプロシージャの使用方法を示します。
CREATE PACKAGE foobar
type number_idx_tbl is table of number indexed by binary_integer;
store1_table number_idx_tbl; -- PL/SQL indexed table
store2_table number_idx_tbl; -- PL/SQL indexed table
store3_table number_idx_tbl; -- PL/SQL indexed table
...
END; -- end of foobar
DECLARE
...
empty_table number_idx_tbl; -- uninitialized ("empty") version
BEGIN
FOR i in 1..1000000 loop
store1_table(i) := i; -- load data
END LOOP;
...
store1_table := empty_table; -- "truncate" the indexed table
...
-
dbms_session.free_unused_user_memory; -- give memory back to system
store1_table(1) := 100; -- index tables still declared;
store2_table(2) := 200; -- but truncated.
...
END;
このプロシージャは、静的パッケージのメモリー使用量を示します。
出力コレクションは、インスタンス化された各パッケージでのメモリー使用量を示します。各パッケージは、所有者名、パッケージ名、使用しているメモリー量および未使用の割り当てられたメモリー量によって示されます。メモリーの断片化のため、また一度使用された空きメモリー・チャンクはまずパッケージ・メモリー・ヒープが所有する空きリストに移動されるため、未使用のメモリー量はゼロより大きくなります。FREE_UNUSED_USER_MEMORYプロシージャが起動された場合のみ解放され、親ヒープに戻ります。
このプロシージャは、現行のセッションに関するアクティブなネームスペースとコンテキストのリストを戻します。
構文
TYPE AppCtxRecTyp IS RECORD ( namespace VARCHAR2(30), attribute VARCHAR2(30), value VARCHAR2(256)); TYPE AppCtxTabTyp IS TABLE OF AppCtxRecTyp INDEX BY BINARY_INTEGER; DBMS_SESSION.LIST_CONTEXT ( list OUT AppCtxTabTyp, size OUT NUMBER);
このプロシージャは、セッションでアクティブなすべてのPL/SQLプログラム・ユニットのセッション状態で、action_flagsパラメータで指定された様々なアクションを実行するために使用します。このプロシージャは、PL/SQLコールで実行中の現行の起動が終了すると、有効になります。このプロシージャでは、表132-13に示すDBMS_SESSION定数が使用されます。
パラメータ
表132-12 MODIFY_PACKAGE_STATEプロシージャのパラメータ
| パラメータ | 説明 |
|---|---|
|
|
PL/SQLプログラム・ユニットで実行するアクションを判別するビット・フラグ。
ただし、次の理由により、
|
使用上の注意
各フラグの相違点およびDBMS_SESSION.REINITIALIZEがDBMS_SESSION.FREE_ALL_RESOURCESよりも高いパフォーマンスを示す理由は、表132-14のパラメータの説明を参照してください。
表132-13 MODIFY_PACKAGE_STATEのAction_flags定数
| 定数 | 説明 |
|---|---|
|
|
|
|
|
|
再初期化とは、すべてのパッケージ変数を初期値に再設定するプロセス、およびパッケージ本体の初期化ブロック(存在する場合)を実行するプロセスのことです。次のパッケージを想定します。
package P is
n number;
m number := P2.foo;
d date := SYSDATE;
cursor c is select * from emp;
procedure bar;
end P;
/
package body P is
v varchar2(20) := 'hello';
procedure bar is
begin
...
end;
procedure init_pkg is
begin
....
end;
begin
-- initialization block
init_pkg;
...
...
end P;
/
パッケージPでは、再初期化で次の処理を行います。
P.nをNULLに設定する。
ファンクションP2.fooを起動し、P.mにP2.fooから戻された値を設定する。
P.dにSYSDATE組込みの戻り値を設定する。
カーソルP.cが事前にオープンしている場合は、これをクローズする。
P.vを'hello'に設定する。
パッケージ本体の初期化ブロックを実行する。
パッケージの再初期化は、その後パッケージが実際に参照された場合のみ実行されます。さらに、パッケージは参照された順に再初期化されます。
FREE_ALL_RESOURCESまたはREINITIALIZEを使用する場合は、パッケージ変数値のリセットによって、アプリケーションに影響を与えないようにしてください。
DBMS_SESSION.REINITIALIZEは、実際にすべてのパッケージ状態を解放するとはかぎらず、場合によっては、FREE_ALL_RESOURCESフラグやRESET_PACKAGEプロシージャを使用した場合よりも、はるかに大量のセッション・メモリーがアプリケーションで使用されます。たとえばDBMS_SESSION.MODIFY_PACKAGE_STATE(DBMS_SESSION.REINITIALIZE)の実行後、アプリケーションが以前に参照されたパッケージの多くを参照しない場合、これらのパッケージのセッション・メモリーは、セッションの終了まで(またはDBMS_SESSION.RESET_PACKAGEがコールされるまで)保持されます。
クライアント側のPL/SQLコードは、リモート・パッケージの変数または定数を参照できないため、定数の値を明示的に使用する必要があります。たとえば、DBMS_SESSION.MODIFY_PACKAGE_STATE(DBMS_SESSION.REINITIALIZE)は、定数DBMS_SESSION.REINITIALIZEを使用しているため、クライアント側ではコンパイルしません。
かわりに、クライアント側ではDBMS_SESSION.MODIFY_PACKAGE_STATE(2)を使用します。これは、引数が明示的に指定されているためです。
例
ここでは、DBMS_SESSION.MODIFY_PACKAGE_STATEの使用例を示します。グローバルな状態(カーソルはc、変数値はcnt)のパッケージPを想定します。パッケージの最初の初期化では、パッケージ変数cntは0、カーソルcはCLOSEDです。次に、セッションで、cntの値が111に変更され、OPEN操作もカーソルで実行されます。print_statusをコールしてパッケージの状態を表示すると、cntが111で、カーソルがOPENであることを確認できます。次に、DBMS_SESSION.MODIFY_PACKAGE_STATEをコールします。print_statusを使用してパッケージPの状態を再度出力すると、cntが再度0になり、カーソルがCLOSEDされていることを確認できます。DBMS_SESSION.MODIFY_PACKAGE_STATEのコールが行われなかった場合は、2番目のprint_statusによって、111およびOPENが出力されます。
create or replace package P is
cnt number := 0;
cursor c is select * from emp;
procedure print_status;
end P;
/
show errors;
create or replace package body P is
procedure print_status is
begin
dbms_output.put_line('P.cnt = ' || cnt);
if c%ISOPEN then
dbms_output.put_line('P.c is OPEN');
else
dbms_output.put_line('P.c is CLOSED');
end if;
end;
end P;
/
show errors;
SQL> set serveroutput on;
SQL> begin
2 P.cnt := 111;
3 open p.c;
4 P.print_status;
5 end;
6 /
P.cnt = 111
P.c is OPEN
PL/SQL procedure successfully completed.
SQL> begin
2 dbms_session.modify_package_state(dbms_session.reinitialize);
3 end;
4 /
PL/SQL procedure successfully completed.
SQL> set serveroutput on;
SQL>
SQL> begin
2 P.print_status;
3 end;
4 /
P.cnt = 0
P.c is CLOSED
PL/SQL procedure successfully completed.
このプロシージャは、コール元のセッションに対するセッション・レベルのSQLトレースを再設定します。クライアントID、およびサービス、モジュール、アクションのトレースは影響を受けません。
このプロシージャは、コール元のセッションに対するセッション・レベルのSQLトレースを使用可能にします。このプロシージャを起動すると、セッションによって発行されたすべてのSQL文のSQLトレースが実行されます。
このプロシージャは、このセッションのすべてのパッケージのインスタンス化を解除します。これは、パッケージ状態を解放します。
|
注意: 「SESSION _TRACE_ENABLEプロシージャ」を参照してください。Oracle9iで導入されているMODIFY_PACKAGE_STATEインタフェースでは、RESET_PACKAGEと同一の機能が提供されます。これは、このセッションのあらゆるPL/SQLパッケージの状態を再初期化するための、効率的で軽量なバリアントです。 |
実行状態をキャッシュするために使用するメモリーは、セッションで実行されたPL/SQLファンクション、プロシージャおよびパッケージに関連付けられています。
パッケージに関して、このメモリーのコレクションはパッケージ変数の現行の値を保持し、各PL/SQLプログラムによってオープンされたカーソルのキャッシュを制御します。RESET_PACKAGEへのコールは、以前実行した各PL/SQLプログラムに関連付けられていたメモリーをセッションから解放し、この結果、グローバルなパッケージの現行の値は消去され、キャッシュされたカーソルはクローズされます。
RESET_PACKAGEは、セッションで失敗したプログラムを確実に再起動するためにも使用できます。パッケージ変数を含んだプログラムが失敗すると、どの変数を初期化しなおす必要があるかを判別することは困難です。RESET_PACKAGEは、すべてのパッケージ変数が初期値に再設定されることを保証します。
使用上の注意
すべての実行PL/SQLが消費するメモリーは大量になるため、RESET_PACKAGEを使用して、データベース・アプリケーション内のある時点でセッション・メモリー・フットプリントを削減できます。ただし、パッケージ変数値の再設定がアプリケーションに影響を与えないことを確認してください。また、キャッシュしたメモリーとカーソルのないプログラムを後で実行すると、解放されたメモリーとカーソルを再作成する必要があるため、実行速度が遅くなることに留意してください。
RESET_PACKAGEは、メモリー、カーソルおよびパッケージ変数をコール直後に解放しません。
|
注意: RESET_PACKAGEは、起動したPL/SQLコールの実行が完了した後でのみ、メモリー、カーソルおよびパッケージ変数を解放します。 |
たとえば、PL/SQLプロシージャP1がPL/SQLプロシージャP2をコールし、P2がRESET_PACKAGEをコールしたとします。プロシージャP1の実行が完了するまで(PL/SQLコールが終了するまで)、RESET_PACKAGEの処理は行われません。
このプロシージャは、4つのタイプのコンテキスト(セッション・ローカル、グローバルな初期化、外部的な初期化およびグローバルなアクセス)を設定します。
次の5つのパラメータのうち最初の3つのみが必須となっており、後の2つはオプションでグローバルにアクセスされるコンテキストのみで使用されます。パラメータ情報の詳細は、パラメータ表および「使用上の注意」に示されています。
構文
DBMS_SESSION.SET_CONTEXT ( namespace VARCHAR2, attribute VARCHAR2, value VARCHAR2, username VARCHAR2, client_id VARCHAR2 );
使用上の注意
最初の3つのパラメータは、すべてのコンテキスト・タイプに対して必須です。
usernameパラメータは、有効なSQL識別子である必要があります。
client_idパラメータは、最大64バイトの文字列である必要があります。これは大/小文字を区別し、set_identifierに対して提供される引数と一致させる必要があります。
ネームスペース・パラメータがグローバル・コンテキストのネームスペースである場合、usernameパラメータはセッションの現行のデータベース・ユーザー名と一致し、client_idパラメータはセッションの現行のclient_idと一致します。これらのパラメータが設定されていない場合はNULLとみなされるため、どのユーザーもコンテキスト値を表示することができます。
このプロシージャは、信頼されたパッケージで直接的または間接的に起動する必要があります。
SET_CONTEXTのコール元は、CREATE CONTEXT文を介してコンテキスト・ネームスペースに関連付けられたプロシージャのコール・スタックに存在する必要があります。コール・スタックのチェックは、DBMSの境界を越えません。
ネームスペースに設定できる属性の数に制限はありません。属性は、ユーザーによってリセットされないかぎり、ユーザーのセッション時に値を保持します。
パラメータの値がネームスペースで設定されている場合、SET_CONTEXTがこの値を上書きします。
コンテキスト値の変更はただちに反映され、SYS_CONTEXTによるこの値への後続のコールは最新の値を戻します。
|
関連項目: 次の詳細は、『Oracle Databaseセキュリティ・ガイド』を参照してください。
|
このプロシージャは、グローバリゼーション・サポート(NLS)を設定します。これは、次のSQL文と同じです。
ALTER SESSION SET <nls_parameter> = <value>
このプロシージャは、ユーザーの現行のセッションでの現行のリソース・コンシューマ・グループを変更します。
ある特定のグループに対して切替え権限がある場合は、コンシューマ・グループを切り替えることができます。コール元が別のプロシージャの場合、ユーザーは、そのプロシージャの所有者が切替え権限を持っているコンシューマ・グループに切り替えることができます。
構文
DBMS_SESSION.switch_current_consumer_group ( new_consumer_group IN VARCHAR2, old_consumer_group OUT VARCHAR2, initial_group_on_error IN BOOLEAN);
戻り値
このプロシージャは、old_consumer_groupパラメータにある、ユーザーの古いコンシューマ・グループを出力します。
|
注意: old_consumer_groupで戻された値を使用して、古いコンシューマ・グループに後で切り替えることができます。 |
使用上の注意
プロシージャの所有者には、ユーザーを古いコンシューマ・グループに再切替えするために、ユーザーの古いグループ(old_consumer_group)に対する権限が必要です。このプロシージャには1つの例外があり、ユーザーを初期コンシューマ・グループにいつでも切り替えることができます(権限チェックはスキップ)。
initial_group_on_errorをTRUEに設定すると、SWITCH_CURRENT_CONSUMER_GROUPプロシージャは、new_consumer_groupが指定したグループに現行のセッションを設定できない場合、そのセッションをデフォルト・グループに設定します。現行のコンシューマ・グループが初期コンシューマ・グループに変更されていても、new_consumer_groupへのセッションの移動に関連するエラーは発生します。
例
CREATE OR REPLACE PROCEDURE high_priority_task is
old_group varchar2(30);
prev_group varchar2(30);
curr_user varchar2(30);
BEGIN
-- switch invoker to privileged consumer group. If we fail to do so, an
-- error is thrown, but the consumer group does not change
-- because 'initial_group_on_error' is set to FALSE
dbms_session.switch_current_consumer_group('tkrogrp1', old_group, FALSE);
-- set up exception handler (in the event of an error, we do not want to
-- return to caller while leaving the session still in the privileged
-- group)
BEGIN
-- perform some operations while under privileged group
EXCEPTION
WHEN OTHERS THEN
-- It is possible that the procedure owner does not have privileges
-- on old_group. 'initial_group_on_error' is set to TRUE to make sure
-- that the user is moved out of the privileged group in such a
-- situation
dbms_session.switch_current_consumer_group(old_group,prev_group,TRUE);
RAISE;
END;
-- we've succeeded. Now switch to old_group, or if cannot do so, switch
-- to caller's initial consumer group
dbms_session.switch_current_consumer_group(old_group,prev_group,TRUE);
END high_priority_task;
/
