dta ユーティリティ

[アーティクル]
03/06/2017

dta ユーティリティは、データベースエンジンチューニングアドバイザーのコマンドプロンプトバージョンです。 dta ユーティリティは、データベースエンジンチューニングアドバイザーの機能をアプリケーションとスクリプトで使用するために作成されました。

データベースエンジンチューニングアドバイザーと同様、 dta ユーティリティは、ワークロードを分析し、そのワークロードに対するサーバーパフォーマンスを向上するために推奨される物理デザイン構造を提示します。ワークロードには、プランキャッシュ、SQL Server プロファイラーのトレースファイルやトレーステーブル、または Transact-SQL スクリプトを指定できます。物理デザイン構造には、インデックス、インデックス付きビュー、およびパーティション分割が含まれます。ワークロードの分析後、 dta ユーティリティは、データベースの物理デザインに対する推奨設定を作成します。また、その推奨設定を実装するために必要なスクリプトを生成することができます。ワークロードは、 -if 引数または -it 引数を使用してコマンドプロンプトから指定できます。 -ix 引数を使用して、コマンドプロンプトから XML 入力ファイルを指定することもできます。その場合、ワークロードは XML 入力ファイルで指定します。

構文

  
      dta  
[ -? ] |  
[  
      [ -S server_name[ \instance ] ]  
      { { -U login_id [-P password ] } | -E  }  
      { -D database_name [ ,...n ] }  
      [ -ddatabase_name ]   
      [ -Tltable_list | -Tf table_list_file ]  
      { -if workload_file | -it workload_trace_table_name  |   
        -ip | -ipf }  
      { -ssession_name | -IDsession_ID }  
      [ -F ]  
      [ -of output_script_file_name ]  
      [ -oroutput_xml_report_file_name ]  
      [ -ox output_XML_file_name ]  
      [ -rl analysis_report_list [ ,...n ] ]  
      [ -ix input_XML_file_name ]  
      [ -A time_for_tuning_in_minutes ]  
      [ -nnumber_of_events ]  
      [ -m minimum_improvement ]  
      [ -fa physical_design_structures_to_add ]  
      [ -fi ]  
      [ -fppartitioning_strategy ]  
      [ -fk keep_existing_option ]  
      [ -fxdrop_only_mode ]  
      [ -B storage_size ]  
      [ -cmax_key_columns_in_index ]  
      [ -C max_columns_in_index ]  
      [ -e | -e tuning_log_name ]  
      [ -N online_option]  
      [ -q ]  
      [ -u ]  
      [ -x ]  
      [ -a ]  
]

引数

-?
使用方法に関する情報を表示します。

-A time_for_tuning_in_minutes
チューニングの制限時間を分単位で指定します。 dta は、指定された時間を使用してワークロードをチューニングし、推奨される物理デザインに変更するスクリプトを生成します。既定では、 dta は、チューニング時間を 8 時間と想定します。 0 を指定すると、チューニング時間を無制限になります。 dta では、制限時間に達する前にワークロード全体のチューニングを終了する場合があります。ワークロード全体を確実にチューニングするためには、チューニング時間を無制限に指定 (-A 0) することをお勧めします。

-a
ワークロードをチューニングし、確認のプロンプトを表示せずに推奨設定を適用します。

-B storage_size
推奨されるインデックスとパーティション分割で使用できる最大容量を MB 単位で指定します。複数のデータベースをチューニングする場合は、すべてのデータベースの推奨設定が容量計算の対象になります。既定では、 dta は、次のストレージサイズより小さいサイズを想定します。

現在の生データサイズの 3 倍。このサイズには、データベース内のテーブルのヒープとクラスター化インデックスの合計サイズが含まれます。
アタッチ先のすべてのディスクドライブの空き容量に生データのサイズを加算した値

既定の記憶領域サイズには、非クラスター化インデックスとインデックス付きビューは含まれません。

-C max_columns_in_index
dta が提示する、インデックス内に含まれる列の最大数を指定します。最大値は 1024 です。既定では、この引数は 16 に設定されています。

-c max_key_columns_in_index
dta が提示する、インデックス内に含まれるキー列の最大数を指定します。既定値は 16 (許可される最大値) です。 dta では、付加列を使用するインデックスの作成も考慮されます。付加列を使用するインデックス推奨設定は、この引数で指定される列数を超える場合があります。

-D database_name
チューニングする各データベースの名前を指定します。最初のデータベースは既定のデータベースです。データベース名をコンマで区切り、複数のデータベースを指定することができます。次に例を示します。

dta -D database_name1, database_name2...

または、各データベース名に対して -D 引数を使用することで、複数のデータベースを指定できます。次に例を示します。

dta -D database_name1 -D database_name2... n

-D 引数は必須です。 -d 引数が指定されていない場合、 dta は、ワークロードの最初の USE database_name 句で指定されるデータベースに最初に接続します。ワークロードに明示的な USE database_name 句がない場合、 -d 引数を使用する必要があります。

たとえば、明示的な USE database_name 句を含まないワークロードで、次のような dta コマンドを使用する場合、推奨設定は生成されません。

dta -D db_name1, db_name2...

しかし、同じワークロードを使用して、 -d 引数を使用した次のような dta コマンドを使用すると、推奨設定が生成されます:

dta -D db_name1, db_name2 -d db_name1

-d database_name
ワークロードをチューニングするときに、 dta が最初に接続するデータベースを指定します。この引数で指定できるデータベースは 1 つだけです。次に例を示します。

dta -d AdventureWorks2012 ...

複数のデータベース名を指定すると、 dta はエラーを返します。 -d 引数は省略可能です。

XML 入力ファイルを使用している場合は、TuningOptions要素の下にある DatabaseToConnect 要素を使用して、dta が接続する最初のデータベースを指定できます。詳細については、「 Database Engine Tuning Advisor」を参照してください。

データベースを 1 つだけチューニングする場合、 -d 引数は sqlcmd ユーティリティの -d 引数と同様の機能を提供しますが、USE database_name ステートメントは実行しません。詳細については、「 sqlcmd Utility」を参照してください。

-E
パスワードを要求せずに、セキュリティ接続を使用します。ログイン ID を指定する -E 引数または -U 引数のいずれかを使用する必要があります。

-e tuning_log_name
dta がチューニングできなかったイベントを記録するテーブル名またはファイル名を指定します。このテーブルは、チューニングが行われるサーバー上に作成されます。

テーブルを使用する場合、 [database_name].[owner_name].table_nameの形式で名前を指定します。次の表は、各パラメーターの既定値を示しています。

パラメーター	既定値
database_name	-D オプションで指定された database_name
owner_name	dbo 注: owner_name は dbo である必要があります。それ以外の値を指定すると、 dta の実行は失敗し、エラーが返されます。
table_name	なし

ファイルを使用する場合、拡張子として .xml を指定します。たとえば、TuningLog.xml です。

Note

dta ユーティリティは、セッションを削除する際に、ユーザー指定のチューニングログテーブルの内容を削除しません。大量のワークロードをチューニングするときは、テーブルをチューニングログ専用にすることを推奨します。大量のワークロードをチューニングすると、チューニングログが大きくなり、テーブルが急速に消費され、セッションが削除される可能性があります。

-F
既存の出力ファイルの上書きを dta に許可します。同じ名前の出力ファイルが既に存在し、 -F が指定されていない場合、 dtaはエラーを返します。 -F と -of、 -or、または -oxを同時に使用することができます。

-fa physical_design_structures_to_add
dta が推奨設定に含む必要がある物理デザイン構造の種類を指定します。次の表は、この引数で指定できる値の一覧と説明です。値が指定されていない場合、 dta は既定の -faIDX を使用します。

Value	説明
IDX_IV	インデックスおよびインデックス付きビュー。
IDX	インデックスのみ。
IV	インデックス付きビューのみ。
NCL_IDX	非クラスター化インデックスのみ。

-fi
フィルター選択されたインデックスが新しい推奨設定用と見なされるように指定します。詳細については、「 Create Filtered Indexes」を参照してください。

-fk keep_existing_option
推奨設定を生成する際に dta が保持する必要のある既存の物理デザイン構造を指定します。次の表は、この引数で指定できる値の一覧と説明です。

値	説明
NONE	既存の構造なし
ALL	既存のすべての構造
ALIGNED	パーティションで固定された構造をすべて保持します。
CL_IDX	テーブル上にあるクラスター化されたすべてのインデックス
IDX	テーブル上にある、クラスター化されたすべてのインデックスおよびすべての非クラスター化インデックス

-fp partitioning_strategy
dta によって提示される新しい物理デザイン構造 (インデックスおよびインデックス付きビュー) をパーティション分割する必要があるかどうか、およびパーティション分割の方法を指定します。次の表は、この引数で指定できる値の一覧と説明です。

値	説明
NONE	パーティション分割しない。
FULL	完全パーティション分割 (選択するとパフォーマンスが向上します)。
ALIGNED	固定パーティション分割 (選択すると管理機能が強化されます)。

ALIGNED は、 dta によって生成された推奨設定では、提示されるすべてのインデックスが、インデックス定義の基になるテーブルとまったく同じ方法でパーティション分割されることを意味します。インデックス付きビューの非クラスター化インデックスは、インデックス付きビューに準じます。この引数で指定できる値は 1 つだけです。既定値は -fpNONE です。

-fx drop_only_mode
dta が、既存の物理デザイン構造の削除のみを考慮することを指定します。新しい物理デザイン構造は考慮されません。このオプションを指定すると、 dta は既存の物理デザイン構造の有用性を評価し、その後、使用頻度の低い構造を削除する推奨設定を提示します。この引数は値を取りません。この引数と -fa、 -fp、または -fk ALL 引数を同時に使用することはできません

-ID session_ID
チューニングセッションの識別子を数値で指定します。指定しない場合、 dta は ID 番号を生成します。この識別子を使用して、既存のチューニングセッションの情報を表示することができます。 -IDに値を指定しない場合は、セッション名を -sで指定する必要があります。

-ip
プランキャッシュをワークロードとして使用することを指定します。明示的に選択したデータベースの上位 1,000 個のプランキャッシュイベントが分析されます。この値は -n オプションを使用して変更できます。

-ipf
プランキャッシュをワークロードとして使用することを指定します。すべてのデータベースの上位 1,000 個のプランキャッシュイベントが分析されます。この値は -n オプションを使用して変更できます。

-if workload_file
チューニングの入力として使用するワークロードファイルのパスとファイルの名前を指定します。ファイルは、.trc (SQL Server プロファイラートレースファイル)、.sql (SQL ファイル)、または .log (SQL Server トレースファイル) のいずれかの形式である必要があります。ワークロードファイル、またはワークロードテーブルを 1 つ指定する必要があります。

-it workload_trace_table_name
チューニングのワークロードトレースを含むテーブルの名前を指定します。名前は [database_name] . [owner_name] .table_nameの形式で指定します。

次の表は、各パラメーターの既定値を示しています。

パラメーター	既定値
database_name	-D オプションで指定された database_name。
owner_name	dbo。
table_name	[なし] :

Note

owner_name は必ず dboとしてください。それ以外の値を指定すると、 dta の実行は失敗し、エラーが返されます。ワークロードファイルまたはワークロードテーブルを 1 つ指定する必要があることにも注意してください。

-ix input_XML_file_name
dta の入力情報を含む XML ファイルの名前を指定します。これは、DTASchema.xsd に従った有効な XML ドキュメントであることが必要です。チューニングオプションのコマンドプロンプトから指定した引数と競合する場合、この XML ファイルの対応する値がオーバーライドされます。唯一の例外は、ユーザー定義の構成が XML 入力ファイルに評価モードで入力されている場合だけです。たとえば、XML 入力ファイルの Configuration 要素に構成が入力されており、EvaluateConfiguration 要素も同様にチューニングオプションの 1 つとして指定されている場合、XML 入力ファイルで指定されたチューニングオプションは、コマンドプロンプトから入力されるいずれのチューニングオプションをオーバーライドします。

-m minimum_improvement
推奨構成が満たす必要がある、最小向上率を指定します。

-N online_option
物理デザイン構造をオンラインで作成するかどうかを指定します。次の表は、この引数で指定できる値の一覧と説明です。

値	説明
OFF	推奨される物理デザイン構造をオンラインで作成しません。
ON	推奨される物理デザイン構造をすべてオンラインで作成します。
混合	データベースエンジンチューニングアドバイザーは、可能な場合にオンラインで作成できる物理デザイン構造を推奨します。

インデックスがオンラインで作成される場合、このオブジェクト定義には ONLINE = ON が追加されます。

-n number_of_events
dta がチューニングする必要があるワークロード内のイベント数を指定します。この引数が指定され、ワークロードが実行時間の情報を含むトレースファイルの場合、 dta は、実行時間の長いものから順にイベントをチューニングします。この引数は、物理デザイン構造の 2 つの構成を比較する場合に利用できます。 2 つの構成を比較するには、両方の構成でチューニングする同じイベント数を指定し、次に示すように両方のチューニング時間を無制限に指定します。

dta -n number_of_events -A 0

この場合、チューニング時間を無制限 (-A 0) に指定することが重要です。無制限に指定しない場合、データベースエンジンチューニングアドバイザーでは、既定の 8 時間のチューニング時間が前提となります。

-of output_script_file_name
dta が、指定したファイル名と出力先にレコメンデーションを Transact-SQL スクリプトとして書き込むことを指定します。

このオプションと -F を同時に使用することができます。特に -or および -oxも使用している場合は、ファイル名が一意であることを確認してください。

-or output_xml_report_file_name
dta が、XML 形式の出力レポートに推奨設定を書き込むことを指定します。ファイル名を指定した場合、推奨設定はその出力先へ書き込まれます。ファイル名を指定しない場合、 dta はセッション名を使用してファイル名を生成し、それを現在のディレクトリに書き込みます。

このオプションと -F を同時に使用することができます。特に -of および -oxも使用している場合は、ファイル名が一意であることを確認してください。

-ox output_XML_file_name
dta が、指定したファイル名と出力先に推奨設定を XML ファイルとして書き込むことを指定します。データベースエンジンチューニングアドバイザーには、宛先ディレクトリへの書き込み権限があることを確認してください。

このオプションと -F を同時に使用することができます。特に -of および -orも使用している場合は、ファイル名が一意であることを確認してください。

-P password
ログイン ID のパスワードを指定します。このオプションを使用しない場合、 dta はパスワードの入力を要求します。

-q
非表示モードを設定します。進行状況やヘッダー情報を含め、コンソールには情報が一切表示されません。

-rl analysis_report_list
生成する分析レポートのリストを指定します。次の表は、この引数で指定できる値の一覧を示しています。

値	レポート
ALL	すべての分析レポート
STMT_COST	ステートメントコストレポート
EVT_FREQ	イベント頻度レポート
STMT_DET	ステートメントの詳細レポート
CUR_STMT_IDX	ステートメントとインデックスのリレーションレポート (現在の構成)
REC_STMT_IDX	ステートメントとインデックスのリレーションレポート (推奨構成)
STMT_COSTRANGE	ステートメントコスト範囲レポート
CUR_IDX_USAGE	インデックス使用状況レポート (現在の構成)
REC_IDX_USAGE	インデックス使用状況レポート (推奨構成)
CUR_IDX_DET	インデックスの詳細レポート (現在の構成)
REC_IDX_DET	インデックスの詳細レポート (推奨構成)
VIW_TAB	ビューとテーブルのリレーションレポート
WKLD_ANL	ワークロード分析レポート
DB_ACCESS	データベースアクセスレポート
TAB_ACCESS	テーブルのアクセスレポート
COL_ACCESS	列のアクセスレポート

値をコンマで区切って複数のレポートを指定します。次に例を示します。

... -rl EVT_FREQ, VIW_TAB, WKLD_ANL ...

-S server_name[ \instance]
接続先となる SQL Server のコンピューターとインスタンスの名前を指定します。 server_name を指定しない場合、 dta はローカルコンピューター上にある SQL Server の既定のインスタンスに接続します。名前付きインスタンスに接続する場合、またはネットワーク上のリモートコンピューターから dta を実行する場合、このオプションは必須です。

-s session_name
チューニングセッションの名前を指定します。 -ID を指定しない場合、これは必須です。

-Tf table_list_file
チューニングするテーブルの一覧が含まれているファイルの名前を指定します。このファイル内では、各テーブルをそれぞれ行を変えて指定します。テーブル名は、 AdventureWorks2012.HumanResources.Departmentのように、3 つの部分から構成されます。必要に応じてテーブルスケーリング機能を呼び出すには、既存のテーブル名の後に、テーブル内の行の予測数を示す数字を指定します。データベースエンジンチューニングアドバイザーでは、これらのテーブルを参照するワークロード内にあるステートメントのチューニングや評価を行うときに、行の予測数を考慮します。 number_of_rows と table_nameの間には 1 つ以上の空白がある場合があることに注意してください。

次に、 table_list_fileファイルのフォーマットを示します。

database_name.[schema_name].table_name [number_of_rows]

この引数は、コマンドプロンプトでテーブルの一覧 ( -Tl) を入力する代わりに使用します。 -Tlを使用する場合は、テーブルの一覧ファイル ( -Tf) を使用しないでください。両方の引数を使用すると、 dta は失敗し、エラーを返します。

-Tf 引数および -Tl 引数を省略した場合、指定されたデータベース内のすべてのユーザーテーブルをチューニングするものと見なされます。

-Tl table_list
コマンドプロンプトでチューニングするテーブルの一覧を指定します。テーブル名の間にコンマを挿入して区切ります。 -D 引数で 1 つのデータベースのみを指定する場合、テーブル名をデータベース名で修飾する必要はありません。それ以外の場合、各テーブルには database_name.schema_name.table_name の形式で、完全修飾名が必要となります。

この引数は、テーブルの一覧ファイル ( -Tf) の代わりに使用します。 -Tl と -Tf の両方を使用すると、 dta は失敗し、エラーを返します。

-U login_id
SQL Serverへの接続に使用されるログイン ID を指定します。

-u
データベースエンジンチューニングアドバイザー GUI を起動します。すべてのパラメーターは、ユーザーインターフェイスの初期設定として扱われます。

-x
チューニングセッションを開始し、終了します。

解説

Ctrl + C キーを 1 度押すと、チューニングセッションが停止し、 dta がこの時点までに完了した分析に基づいて、推奨設定が生成されます。推奨設定を生成するかどうかの確認が要求されます。 Ctrl + C キーをもう一度押すと、推奨設定を生成せずにチューニングセッションを停止します。

例

A. 推奨設定で、インデックスとインデックス付きビューを含んだワークロードをチューニングする

次の例では、セキュリティで保護された接続 (-E) を使用して MyServer の tpcd1G データベースに接続し、ワークロードの分析と推奨設定の作成を行います。出力結果は script.sql という名前のスクリプトファイルへ書き込まれます。 script.sql が既に存在する場合は、 引数が指定されているため、 dta -F はファイルを上書きします。チューニングセッションは、ワークロードの分析を完全に終了するように時間制限なしで実行されます (-A 0)。推奨設定の最小向上率は 5% を指定する必要があります (-m 5)。 dta では、最終的な推奨設定にインデックスおよびインデックス付きビューが含まれます (-fa IDX_IV)。

dta -S MyServer -E -D tpcd1G -if tpcd_22.sql -F -of script.sql -A 0 -m 5 -fa IDX_IV

B. ディスク使用量を制限する

次の例では、生データと追加のインデックスを含むデータベースの合計サイズを 3 GB までに制限し (-B 3000)、出力先には d:\result_dir\script1.sql を指定しています。実行は、1 時間以内です (-A 60)。

dta -D tpcd1G -if tpcd_22.sql -B 3000 -of "d:\result_dir\script1.sql" -A 60

C. チューニングするクエリの数を制限する

次の例では、orders_wkld.sql ファイルから読み取るクエリの数を最大 10 に制限し (-n 10)、15 分間実行します (-A 15)。どちらを先に指定しても同じです。 10 個のクエリすべてをチューニングするために、-A 0 を使用してチューニング時間を無制限に指定します。時間が重要な場合は、この例で示すように -A 引数でチューニングできる時間数を指定して、適切な制限時間を指定します。

dta -D orders -if orders_wkld.sql -of script.sql -A 15 -n 10

D. ファイル内に指定されている特定のテーブルをチューニングする

次の例では、 table_list_file ( -Tf 引数) の使用方法を示しています。 table_list.txt ファイルの内容は、次のとおりです。

AdventureWorks2012.Sales.Customer  100000  
AdventureWorks2012.Sales.Store  
AdventureWorks2012.Production.Product  2000000

table_list.txt 内には、次の内容が指定されています。

データベース内にある Customer、 Store、および Product テーブルのみをチューニングの対象とする。
Customer 、 Product テーブルの列数は、それぞれ 100,000 と 2,000,000 と想定する。
Store の行数は、このテーブル内の現在の行数と同じと想定する。

table_list_fileでは、行数とテーブル名の間には 1 つ以上の空白がある場合があることに注意してください。

チューニング時間は 2 時間 (-A 120) で、出力は XML ファイルに書き込まれます (-ox XMLTune.xml)。

dta -D pubs -if pubs_wkld.sql -ox XMLTune.xml -A 120 -Tf table_list.txt

参照

コマンドプロンプトユーティリティリファレンス (データベースエンジン)
Database Engine Tuning Advisor

次の方法で共有

dta ユーティリティ

構文

引数

解説

例

参照

その他のリソース