DBMS_HEAT_MAP

98 DBMS_HEAT_MAP_ADMIN

DBMS_HEAT_MAP_ADMINパッケージは、保持時間の構成やヒート・マップ・トラッキングの有効化または無効化など、データベースのヒート・マップ設定を管理するための管理インタフェースを提供します。このパッケージは、ヒート・マップ・データの収集および保守方法を制御する必要があるデータベース管理者を対象としています。

この章のトピックは、次のとおりです:

参照:

Oracle AI Database VLDBおよびパーティショニング・ガイドのヒート・マップ
Oracle AI Database VLDBおよびパーティショニング・ガイドのヒート・マップ保持時間の設定
DBMS_ILM
DBMS_ILM_ADMIN

98.1 DBMS_HEAT_MAP_ADMINの概要

DBMS_HEAT_MAP_ADMINパッケージは、データベースのヒート・マップ・データ保持を構成および管理するためのインタフェースを提供します。

DBMS_HEAT_MAP_ADMINパッケージには、データベース内のヒート・マップ・データ保持を管理するためのサブプログラムが用意されています。ヒート・マップは、ILMのデータ変更アクティビティを追跡します。このパッケージを使用すると、バックグラウンドのヒート・マップ削除サービスによって自動的に削除されるまでのヒート・マップ・データの保持期間を指定できます。適切な保存期間を設定することで、ストレージ使用量を最適化し、ヒート・マップ表が無期限に増加しないようにできます。

パッケージには、保存時間を設定および取得するためのプロシージャおよびファンクションが含まれています。バックグラウンド削除サービスはデフォルトで無効になっており、有効な保存期間が指定されると自動的に有効になります。

98.2 DBMS_HEAT_MAP_ADMINセキュリティ・モデル

サブプログラムを使用するには、DBMS_HEAT_MAP_ADMINパッケージに対するEXECUTE権限が必要です。

デフォルトでは、この権限はDBAロールに付与されます。ヒート・マップの保存設定を変更する必要があるユーザーには、この権限を直接または継承するロールを介して付与する必要があります。

98.3 DBMS_HEAT_MAP_ADMINサブプログラムの要約

この表では、DBMS_HEAT_MAP_ADMINパッケージのサブプログラムをリストし、簡単に説明します。

表98-1 DBMS_HEAT_MAP_ADMINパッケージのサブプログラム

サブプログラム	説明
GET_RETENTION_TIMEファンクション	ヒート・マップ・データの現在の保存時間値を日数で返します。
SET_RETENTION_TIMEプロシージャ	バックグラウンドのヒート・マップ削除サービスを有効にし、ヒート・マップ・データが保持される日数を設定します。

98.3.1 GET_RETENTION_TIMEファンクション

この関数は、ヒート・マップ・データの現在の保存時間値を日数で返します。

構文

DBMS_HEAT_MAP_ADMIN.GET_RETENTION_TIME
   RETURN NUMBER;

戻り値

ヒート・マップの保持時間を日数で返します。

デフォルト値は4,294,967,295で、バックグラウンド・ヒート・マップ削除サービスが無効であることを示します。
SET_RETENTION_TIMEを使用して有効な保存時間が設定されている場合、このファンクションはその値を返します。

使用上のノート

この関数を使用して、現在のヒート・マップ保持時間構成を確認します。
サービスが無効になっている場合、戻り値を保存を有効にする前に確認として使用できます。

98.3.2 SET_RETENTION_TIMEプロシージャ

このプロシージャは、バックグラウンドのヒート・マップ削除サービスを有効にし、ヒート・マップ・データが保持される日数を設定します。

構文

DBMS_HEAT_MAP_ADMIN.SET_RETENTION_TIME (
   days IN NUMBER);

パラメータ

表98-2 SET_RETENTION_TIMEプロシージャのパラメータ

パラメータ	説明
`days`	ヒート・マップ・データを保持する日数を指定します。有効な値の範囲は1 ~ 4,294,967,294です。値4,294,967,295は、バックグラウンド・ヒート・マップ削除サービスを無効にします。無効な値(負、0またはNULL)を指定すると、`INVALID_ARGUMENT_VALUE`エラーが発生します。