カテゴリ:

システム関数 (システム情報)

SYSTEM$ESTIMATE_SEARCH_OPTIMIZATION_COSTS

指定されたテーブルに 検索最適化 を追加するための推定コストを返します。

構文

SYSTEM$ESTIMATE_SEARCH_OPTIMIZATION_COSTS('<table_name>')

引数

テーブル名

検索最適化コストを見積もるテーブル。

テーブル名が完全修飾されていない場合( データベース名.スキーマ名.テーブル名 または スキーマ名.テーブル名 の形式)、関数はセッションの現在のスキーマのテーブルを探します。

名前全体を一重引用符で囲む必要があります。

出力

この関数は、以下に説明するプロパティを持つ JSON オブジェクトを返します。

プロパティ

説明

tableName

テーブルの名前。

searchOptimizationEnabled

テーブルに検索最適化プロパティが設定されている場合は true。それ以外の場合は false

costPositions

テーブルに検索最適化を追加するための予測コストを説明する、オブジェクトの配列。

costPositions 配列の各オブジェクトは、異なるタイプのコスト見積もりを表します。

...
"costPositions" : [
  {
    "name" : "BuildCosts",
    ...
  }, {
    "name" : "StorageCosts",
    ...
  }, {
    "name" : "Benefit",
    ...
  }, {
    "name" : "MaintenanceCosts",
    ...
  }
]
...

name プロパティは、オブジェクトが表すコストのタイプを識別します。 name は次のいずれかです。

name オブジェクトの costPositions

説明

BuildCosts

このオブジェクトは、テーブルの検索アクセスパスを構築するための予測コストを記述します。検索最適化がすでにテーブルに追加されている場合、このオブジェクトにはコスト情報が含まれません。

StorageCosts

このオブジェクトは、テーブルの検索アクセスパスに必要な予測ストレージ容量(単位: TB)を記述します。 . 検索最適化がすでにテーブルに追加されている場合、このオブジェクトは検索アクセスパスで使用されている現在の容量を示します。

Benefit

現時点では、このオブジェクトにはコスト情報が含まれていません。

MaintenanceCosts

このオブジェクトは、テーブルの検索アクセスパスを維持するための予測コストを記述します。このテーブルが最近作成された場合、このオブジェクトにはコスト情報が含まれていません。

costPositions 配列の各オブジェクトは、次のプロパティを持つことができます。

プロパティ

説明

name

このオブジェクトが表すコスト情報のタイプを識別する 名前

costs

次のプロパティの観点から予測コストを説明するオブジェクト。

value

予測コストの金額。

unit

コストの測定単位(例:コンピューティングコストの「クレジット」、ストレージコストの「TB」)。

perTimeUnit

メンテナンスコストの場合、見積もりコストがカバーする時間の単位(たとえば、月あたりのコストの "MONTH")。

computationMethod

複数の方法が利用可能な場合、コストの見積もりに使用される方法。

comment

推定コストに関する追加情報。

使用上の注意

  • 構築コストの場合、この関数はコストの推定上限を返します。実際のコストは、それよりも低くなる可能性があります。

  • メンテナンスコストの場合、この関数は、テーブルに加えられた最近の変更(時間の経過に伴うバイトの変更)に基づいて見積もります。

次の例は、テーブルに検索最適化を追加する場合の推定コストを示しています。

select SYSTEM$ESTIMATE_SEARCH_OPTIMIZATION_COSTS('TABLE_WITHOUT_SEARCH_OPT');

+---------------------------------------------------------------------------+
| SYSTEM$ESTIMATE_SEARCH_OPTIMIZATION_COSTS('TABLE_WITHOUT_SEARCH_OPT')     |
|---------------------------------------------------------------------------|
| {                                                                         |
|   "tableName" : "TABLE_WITHOUT_SEARCH_OPT",                               |
|   "searchOptimizationEnabled" : false,                                    |
|   "costPositions" : [ {                                                   |
|     "name" : "BuildCosts",                                                |
|     "costs" : {                                                           |
|       "value" : 11.279,                                                   |
|       "unit" : "Credits"                                                  |
|     },                                                                    |
|     "computationMethod" : "EstimatedUpperBound"                           |
|   }, {                                                                    |
|     "name" : "StorageCosts",                                              |
|     "costs" : {                                                           |
|       "value" : 0.070493,                                                 |
|       "unit" : "TB"                                                       |
|     },                                                                    |
|     "computationMethod" : "EstimatedUpperBound"                           |
|   }, {                                                                    |
|     "name" : "MaintenanceCosts",                                          |
|     "costs" : {                                                           |
|       "value" : 30.296,                                                   |
|       "unit" : "Credits",                                                 |
|       "perTimeUnit" : "MONTH"                                             |
|     },                                                                    |
|     "computationMethod" : "EstimatedUpperBound",                          |
|     "comment" : "Estimated from historic change rate over last ~11 days." |
|   } ]                                                                     |
| }                                                                         |
+---------------------------------------------------------------------------+

次の例は、すでに検索最適化が行われているテーブルに対するこの関数の出力を示しています。

select SYSTEM$ESTIMATE_SEARCH_OPTIMIZATION_COSTS('TABLE_WITH_SEARCH_OPT');
+---------------------------------------------------------------------------+
| SYSTEM$ESTIMATE_SEARCH_OPTIMIZATION_COSTS('TABLE_WITH_SEARCH_OPT')        |
|---------------------------------------------------------------------------|
| {                                                                         |
|   "tableName" : "TABLE_WITH_SEARCH_OPT",                                  |
|   "searchOptimizationEnabled" : true,                                     |
|   "costPositions" : [ {                                                   |
|     "name" : "BuildCosts",                                                |
|     "computationMethod" : "NotAvailable",                                 |
|     "comment" : "Search optimization is already enabled."                 |
|   }, {                                                                    |
|     "name" : "StorageCosts",                                              |
|     "costs" : {                                                           |
|       "value" : 0.052048,                                                 |
|       "unit" : "TB"                                                       |
|     },                                                                    |
|     "computationMethod" : "Measured"                                      |
|   }, {                                                                    |
|     "name" : "Benefit",                                                   |
|     "computationMethod" : "NotAvailable",                                 |
|     "comment" : "Currently not supported."                                |
|   }, {                                                                    |
|     "name" : "MaintenanceCosts",                                          |
|     "costs" : {                                                           |
|       "value" : 30.248,                                                   |
|       "unit" : "Credits",                                                 |
|       "perTimeUnit" : "MONTH"                                             |
|     },                                                                    |
|     "computationMethod" : "EstimatedUpperBound",                          |
|     "comment" : "Estimated from historic change rate over last ~11 days." |
|   } ]                                                                     |
| }                                                                         |
+---------------------------------------------------------------------------+