16.20 - INSERT EXPLAIN - Teradata Database - Teradata Vantage NewSQL Engine

Teradata Vantage™ SQLデータ操作言語

Product
Teradata Database
Teradata Vantage NewSQL Engine
Release Number
16.20
Release Date
2019年3月
Content Type
プログラミング リファレンス
Publication ID
B035-1146-162K-JPN
Language
日本語 (日本)

目的

クエリーについての最適化ルーチンの空白ツリー情報をキャプチャして、ユーザー定義のクエリー キャプチャ データベース(オプションでXMLドキュメントとして)にその情報を書き込みます。

インデックス分析の詳細は、以下を参照してください。
  • <Teradata Vantage™ SQLデータ定義言語 - 構文規則および例、B035-1144>の「BEGIN QUERY LOGGING」と「REPLACE QUERY LOGGING」を参照してください。
  • COLLECT DEMOGRAPHICS
  • COLLECT STATISTICS(QCD形式)
  • DUMP EXPLAIN
  • INSERT EXPLAIN
  • INITIATE INDEX ANALYSIS
  • RESTART INDEX ANALYSIS
  • Teradata Vantage™ SQLリクエストおよびトランザクション処理、B035-1142
  • Teradata Vantage™ - データベースの設計、B035-1094
  • Teradata® Index Wizardユーザー ガイド、B035-2506
  • Teradata® Viewpointユーザー ガイド、B035-2206、統計マネージャーのトピック
  • Teradata® Visual Explainユーザー ガイド、B035-2504
  • Teradata® System Emulation Toolユーザー ガイド、B035-2492

必要な権限

ユーザー定義の問合わせキャプチャ データベースのすべてのテーブルに対するINSERT権限が必要です。

データ デモグラフィックおよび列統計をキャプチャするために参照されるすべてのテーブルに対するSELECT権限も必要です。

構文



構文要素

WITH STATISTICS
SQL_statement内に指定されるWHERE句の条件列に関する統計をキャプチャすることを指定します。
IN XMLオプションとWITH STATISTICSは同時に指定できません。
このオプションを指定することは、問合わせテーブルの列に対してCOLLECT STATISTICS (QCD形式)を実行することと同じです。
QCDに挿入される列は、Teradata Index Wizardによってインデックス候補として判別される列です。
USING SAMPLE percentage
USING SAMPLE percentage PERCENT
統計収集のために読み込むデータのパーセンテージ。
この句を指定しないと、システムはテーブルの基数に基づいてサンプル サイズを自動的に選択します。
IN XML句とUSING SAMPLE句は同時に指定できません。
有効範囲は1以上100以下です。
WITH NO STATISTICS
SQL_statement内に指定されるWHERE句の条件列に関する統計をキャプチャしないことを指定します。
AND DEMOGRAPHICS
統計だけではなくテーブル レベルのデモグラフィックも収集します。
このオプションを指定することは、問合わせテーブルに対してCOLLECT DEMOGRAPHICSリクエストを実行することと同じです。COLLECT DEMOGRAPHICSを参照してください。
このオプションを指定しない場合は、システムはテーブル レベルのデモグラフィックを収集しません。
FOR table_name
FOR database_name.table_name
FOR user_name.table_name
WITH STATISTICSオプションを指定したかWITH NO STATISTICSオプションを指定したかに基づいて、データ デモグラフィックと統計の詳細をTeradata Index Wizardによる分析から除外する(または分析に含める)テーブルのセットを指定します。
インデックス候補の列に関する統計、および以下の場合には、SQL_statementの値で明示的に参照されているすべての列およびインデックスに関する統計が収集されます。候補インデックス列は、指定されたQCDのFieldテーブルに格納されている値または結合範囲アクセス頻度が0より大きい列として定義されます。指定内容:
  • WITH STATISTICSの場合、Teradata Databaseは問合わせで参照されるすべてのテーブルについて統計を収集します。
  • WITH STATISTICS … FOR table_nameの場合、Teradata DatabaseはFOR table_name句にも指定されている問合わせで参照されるテーブルについてのみ統計を収集します。
  • WITH NO STATISTICS … FOR table_nameの場合、Teradata DatabaseはFOR table_name句にリストされていないクエリーで参照されるテーブルについてのみ統計を収集します。
IN XML句はFOR table_name句と同時に指定できません。
INTO QCD_name
ユーザー定義の問合わせキャプチャ データベース。
QCD_nameで名前が指定されたデータベースは存在しなければなりません。そうでない場合、リクエストはアボートし、エラーが返されます。
Visual Explainツールのコントロール センター機能を使用するのが、QCDデータベースを作成する最も簡単な方法です。
AS query_plan_name
問合わせ計画情報を格納するオプションのユーザー定義の名前を指定します。オブジェクト命名ルールの詳細については、<Teradata Vantage™ SQL基礎、B035-1141>を参照してください。
query_plan_nameを指定しない場合は、クエリー計画情報は名前なしで格納されます。各クエリー計画は固有な非NULLクエリーID付きで格納されるので、特定のデータベース内でさまざまなクエリー計画を区別できます。<Teradata Vantage™ SQLリクエストおよびトランザクション処理、B035-1142>を参照してください。クエリーIDは複数のデータベースに渡って固有ではありません。
query_plan_nameは、固有である必要はありません。
query_plan_namequery_plan_nameとして格納できます。ただし、その場合は埋め込み文字で分離された語を"query plan name"のように単一引用符で囲む必要があります。
LIMIT
LIMIT SQL
LIMIT SQL = n
Query、Relation、およびViewTextのそれぞれのQCDテーブルについてキャプチャされる問合わせ、DDL、およびビュー テキストのサイズを制限します。
この句を指定しないと、システムは完全なSQLテキストをキャプチャします。
nの値は、キャプチャするテキストの量の上限を表わします。
LIMITだけを指定するかLIMIT SQLに値を指定しない場合、この句はLIMIT SQL = 0と同じであり、テキストはキャプチャされません。
FOR SQL_statement
SQL_statementが通常は識別されたワークロードの間に実行される回数を指定します。
この値は、Teradata Index Wizardユーティリティによって計算されるインデックス推奨事項に含めるように分析された各列のそれぞれの利点に重みを付けるために使用されます。
4バイトまでの正の整数が有効です。
IN XML句はFOR SQL_statement句と同時に指定できません。
この句を指定しない場合は、SQL_statementの値はデフォルトで1になります。
CHECK STATISTICS
StatsRecs QCDテーブル内のSQL_statementのためのCOLLECT STATISTICS推奨事項をキャプチャすることを指定します。<Teradata Vantage™ SQLリクエストおよびトランザクション処理、B035-1142>を参照してください。
IN XMLオプションとCHECK STATISTICSは同時に指定できません。
IN XML
出力をXMLドキュメントとしてキャプチャします。
このドキュメントは、XMLQCDという名前のQCDテーブルに保管されます。
次に示すオプションのいずれかを指定している場合には、IN XML句を指定できません。
  • USING SAMPLE
  • FOR table_name
  • FOR SQL_statement
IN XMLオプションを指定するときには、それと同時にNODDLTEXTオプションも指定できます。
IN XMLオプションは、次のどのオプションとも同時に指定できません。
  • CHECK STATISTICS
  • WITH STATISTICS
NODDLTEXT
qcd.XMLQCDに格納されるXMLドキュメントのDDLテキストをキャプチャしません。
SQL_request
最適化ルーチンの空白ツリー情報をキャプチャしてQCDに書き込む対象となるDMLリクエストを指定します。
SQL_requestは、次に示す文に限定されます。
  • DELETE
  • EXEC (マクロ形式)
  • INSERT
  • MERGE
  • SELECT
  • UPDATE

ANSI準拠

INSERT EXPLAINは、ANSI SQL:2011規格に対するTeradataの拡張機能です。