C OLAP_API_SESSION_INIT PL/SQLパッケージ
OLAP_API_SESSION_INIT
PL/SQLパッケージには、OLAP APIの初期化パラメータの表をメンテナンスするためのプロシージャが含まれています。
この章のトピックは、次のとおりです:
C.1 OLAP APIの初期化パラメータ
OLAP_API_SESSION_INIT
パッケージには、初期化パラメータの構成表をメンテナンスするためのプロシージャが含まれています。OLAP APIでセッションを開くと、指定したロールを持つユーザーに対して表にリストされているALTER SESSION
コマンドが実行されます。この表を使用するのはOLAP APIのみであり、他のアプリケーションではこの表に格納されたコマンドは実行されません。
この機能は、すべてのユーザーの環境を変更できるデータベース初期化ファイルやinit.ora
ファイルでこれらのパラメータを設定するかわりに使用できます。
構成表には、OLAP APIのパフォーマンスを向上できるALTER SESSION
コマンドがインストール時に移入されます。この構成表は、より有効な設定が新たに見つからないかぎり変更する必要はありません。
構成表内の情報は、この章で後述するALL_OLAP_ALTER_SESSION
ビューの別名から問い合せることができます。
注意:
このパッケージの所有者は、SYS
ユーザーです。このパッケージを使用するには、実行権限が明示的に付与されている必要があります。
C.2 構成表の表示
ALL_OLAP_ALTER_SESSION
は、OLAP$ALTER_SESSION
表のビューであるV$OLAP_ALTER_SESSION
のパブリック・シノニムです。ビューおよび表の所有者は、SYS
ユーザーです。
C.3 OLAP_API_SESSION_INITサブプログラムの概要
次の表で、OLAP_API_SESSION_INIT
に含まれるサブプログラムを説明します。
表C-2 OLAP_API_SESSION_INITサブプログラム
サブプログラム | 説明 |
---|---|
特定のデータベース・ロールを持つOLAP APIユーザーに対し、 |
|
孤立データ(データベースに定義されていないロールに対する |
|
特定のデータベース・ロールを持つOLAP APIユーザーに対して事前に定義された |
C.3.1 ADD_ALTER_SESSIONプロシージャ
このプロシージャは、特定のデータベース・ロールを持つOLAP APIユーザーに対し、ALTER SESSION
パラメータを指定します。OLAP$ALTER_SESSION
表に行を追加します。
構文
ADD_ALTER_SESSION ( role_name IN VARCHAR2, session_parameter IN VARCHAR2);
パラメータ
role_name
およびsession_parameter
が行としてOLAP$ALTER_SESSION
に追加されます。
表C-3 ADD_ALTER_SESSIONプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
データベースの有効なロールの名前。必須。 |
|
SQLの |
例
次の例では、OLAP_DBA
ロールを持つユーザーに対するクエリー・リライトを有効にするOLAP$ALTER_SESSION
に行を挿入します。
EXECUTE olap_api_session_init.add_alter_session('OLAP_DBA', 'SET QUERY_REWRITE_ENABLED=TRUE'); Row inserted SELECT * FROM all_olap_alter_session WHERE role='OLAP_DBA'; ROLE CLAUSE_TEXT ------------ ------------------------------------------------------------ OLAP_DBA ALTER SESSION SET QUERY_REWRITE_ENABLED=TRUE
C.3.3 DELETE_ALTER_SESSIONプロシージャ
このプロシージャは、特定のデータベース・ロールを持つOLAP APIユーザーに対して事前に定義されたALTER SESSION
パラメータを削除します。OLAP$ALTER_SESSION
表から行を削除します。
構文
DELETE_ALTER_SESSION ( role_name IN VARCHAR2, session_parameter IN VARCHAR2);
パラメータ
role_name
およびsession_parameter
の両方により、OLAP$ALTER_SESSION
の行が一意に識別されます。
表C-4 DELETE_ALTER_SESSIONプロシージャのパラメータ
パラメータ | 説明 |
---|---|
role_name |
データベースの有効なロールの名前。必須。 |
session_parameter |
SQLの |
例
次のコールによって、1列目にOLAP_DBA
、2列目にQUERY_REWRITE_ENABLED=TRUE
という値を含むOLAP$ALTER_SESSION
の行が削除されます。
EXECUTE olap_api_session_init.delete_alter_session('OLAP_DBA', 'SET QUERY_REWRITE_ENABLED=TRUE'); SELECT * FROM all_olap_alter_session WHERE role='OLAP_DBA'; no rows selected