CREATE STATISTICS (Transact-SQL)

[アーティクル]
05/23/2024

適用対象:SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Microsoft Fabric の SQL 分析エンドポイント Microsoft Fabric のウェアハウス

テーブル、インデックス付きビュー、または、外部テーブルの 1 つまたは複数の列に関するクエリ最適化の統計を作成します。ほとんどのクエリでは、クエリオプティマイザーによって、高品質のクエリプランに必要な統計が既に生成されています。場合によっては、クエリのパフォーマンスを向上させるために、クエリデザインを使用 CREATE STATISTICS して追加の統計を作成または変更する必要があります。

詳しくは、「統計」をご覧ください。

Note

Microsoft Fabric の統計の詳細については、「Fabric データウェアハウスの統計」を参照してください。

Transact-SQL 構文表記規則

構文

SQL Server、Azure SQL Database、および Azure SQL Managed Instance の構文。

-- Create statistics on an external table
CREATE STATISTICS statistics_name
ON { table_or_indexed_view_name } ( column [ , ...n ] )
    [ WITH FULLSCAN ] ;

-- Create statistics on a regular table or indexed view
CREATE STATISTICS statistics_name
ON { table_or_indexed_view_name } ( column [ , ...n ] )
    [ WHERE <filter_predicate> ]
    [ WITH
        [ FULLSCAN
            [ [ , ] PERSIST_SAMPLE_PERCENT = { ON | OFF } ]
          | SAMPLE number { PERCENT | ROWS }
            [ [ , ] PERSIST_SAMPLE_PERCENT = { ON | OFF } ]
          | <update_stats_stream_option> [ , ...n ]
        [ [ , ] NORECOMPUTE ]
        [ [ , ] INCREMENTAL = { ON | OFF } ]
        [ [ , ] MAXDOP = max_degree_of_parallelism ]
        [ [ , ] AUTO_DROP = { ON | OFF } ]
        ]
    ];

<filter_predicate> ::=
    <conjunct> [ AND <conjunct> ]

<conjunct> ::=
    <disjunct> | <comparison>

<disjunct> ::=
        column_name IN (constant , ...)

<comparison> ::=
        column_name <comparison_op> constant

<comparison_op> ::=
    IS | IS NOT | = | <> | != | > | >= | !> | < | <= | !<

<update_stats_stream_option> ::=
    [ STATS_STREAM = stats_stream ]
    [ ROWCOUNT = numeric_constant ]
    [ PAGECOUNT = numeric_contant ]

Azure Synapse Analytics および Analytics Platform System (PDW) の構文。

CREATE STATISTICS statistics_name
    ON { database_name.schema_name.table_name | schema_name.table_name | table_name }
    ( column_name  [ , ...n ] )
    [ WHERE <filter_predicate> ]
    [ WITH {
           FULLSCAN
           | SAMPLE number PERCENT
      }
    ]
[ ; ]

<filter_predicate> ::=
    <conjunct> [ AND <conjunct> ]

<conjunct> ::=
    <disjunct> | <comparison>

<disjunct> ::=
        column_name IN (constant , ...)

<comparison> ::=
        column_name <comparison_op> constant

<comparison_op> ::=
    IS | IS NOT | = | <> | != | > | >= | !> | < | <= | !<

Microsoft Fabric の構文。

CREATE STATISTICS statistics_name
    ON { database_name.schema_name.table_name | schema_name.table_name | table_name }
    ( column_name )
    [ WITH {
           FULLSCAN
           | SAMPLE number PERCENT
      }
    ]
[ ; ]

Note

SQL Server 2014 (12.x) 以前のバージョンの Transact-SQL 構文を確認するには、以前のバージョンのドキュメントを参照してください。

引数

statistics_name

作成する統計の名前。

table_or_indexed_view_name

統計を作成するテーブル、インデックス付きビュー、または外部テーブルの名前。別のデータベースの統計を作成するには、修飾テーブル名を指定します。

column [ ,...n]

統計に含める 1 つまたは複数の列。列は、左から右への優先順位にする必要があります。ヒストグラムの作成には最初の列のみが使用されます。すべての列は、密度と呼ばれる列間の相関統計に使用されます。

インデックスキー列として指定できる任意の列を指定できますが、次の例外があります。

xml、フルテキスト、FILESTREAM の列は指定できません。
計算列は、データベースQUOTED_IDENTIFIER設定ONが ARITHABORT .
CLR ユーザー定義型の列は、データ型でバイナリ順がサポートされている場合に指定できます。ユーザー定義型列のメソッド呼び出しとして定義されている計算列は、メソッドが決定的とマークされている場合に指定できます。

WHERE <filter_predicate>

統計オブジェクトを作成するときに含める行のサブセットを選択するための式を指定します。フィルター述語を使用して作成された統計は、フィルター選択された統計情報と呼ばれます。フィルター述語は単純な比較ロジックを使用し、計算列、UDT 列、空間データ型列、または hierarchyID データ型列を参照することはできません。リテラルを使用 NULL した比較は、比較演算子では使用できません。代わりに、IS NULL および IS NOT NULL 演算子を使用します。

次に、Production.BillOfMaterials テーブルのフィルター述語の例をいくつか示します。

WHERE StartDate > '20000101' AND EndDate <= '20000630'
WHERE ComponentID IN (533, 324, 753)
WHERE StartDate IN ('20000404', '20000905') AND EndDate IS NOT NULL

フィルター述語の詳細については、「フィルター選択されたインデックスの作成」を参照してください。

FULLSCAN

適用対象: SQL Server 2016 (13.x) SP 1 CU 4、SQL Server 2017 (14.x) CU 1 以降のバージョン

すべての行をスキャンして統計を計算します。 FULLSCAN 同 SAMPLE 100 PERCENT じ結果が得られます。 FULLSCAN はオプションと共に SAMPLE 使用できません。

省略すると、SQL Server ではサンプリングを使用して統計が作成され、高品質のクエリプランを作成するために必要なサンプルサイズが決定されます。

Microsoft Fabric の Warehouse では、単一列 FULLSCAN および単一列 SAMPLEベースの統計のみがサポートされています。オプションが含まれていない場合は、 SAMPLE 統計が作成されます。

SAMPLE number { PERCENT | ROWS }

クエリオプティマイザーが統計を作成するときに使用するテーブルまたはインデックス付きビューのおおよその割合 (行数) を指定します。のPERCENT場合、数値は 0 から 100 まで、数値ROWSは 0 から行の合計数まで指定できます。クエリオプティマイザーによってサンプリングされる行の実際の割合や行数が、指定した割合や行数と一致しない場合もあります。たとえば、データページではすべての行がスキャンされます。

SAMPLE は、既定のサンプリングに基づいてクエリプランが最適でない特殊な場合に役立ちます。ほとんどの場合、クエリオプティマイザーは既にサンプリングを使用し、高品質のクエリプランを作成するために必要な統計的に有意なサンプルサイズを既定で決定するため、指定 SAMPLE する必要はありません。

SAMPLE は FULLSCAN オプションと共に使用できません。指定した場合、またはFULLSCAN指定されていない場合SAMPLE、クエリオプティマイザーはサンプリングされたデータを使用し、既定でサンプルサイズを計算します。

0 PERCENT や 0 ROWS を指定することはお勧めしません。 0 ROWS指定された場合0 PERCENT、統計オブジェクトは作成されますが、統計データは含まれません。

Microsoft Fabric の Warehouse では、単一列 FULLSCAN および単一列 SAMPLEベースの統計のみがサポートされています。オプションが含まれていない場合は、 FULLSCAN 統計が作成されます。

PERSIST_SAMPLE_PERCENT = { ON | OFF }

この場合 ON、統計は、サンプリング率を明示的に指定しない後続の更新の作成サンプリング率を保持します。統計サンプリング率が、サンプリング率を明示的に指定しない後続の更新で既定のサンプリングにリセットされる場合 OFF。既定値は、OFF です。

Note

テーブルが切り捨てられた場合、切り捨てられた HoBT に基づいて作成されたすべての統計は、既定のサンプリング率を使用するように戻されます。

STATS_STREAM = stats_stream

単に情報を示すためだけに特定されます。サポートされていません。将来の互換性は保証されません。

NORECOMPUTE

statistics_nameの統計の自動更新オプションAUTO_STATISTICS_UPDATEを無効にします。このオプションを指定すると、statistics_name の進行中の更新は最後まで実行され、その後の更新が無効になります。

統計の更新を再度有効にするには、DROP STATISTICS を使用して統計を削除してから、オプションなしでNORECOMPUTE実行CREATE STATISTICSします。

警告

統計の自動更新を無効にすると、クエリオプティマイザーがテーブルを含むクエリの最適な実行プランを選択できなくなる可能性があります。このオプションは、資格のあるデータベース管理者のみが慎重に使用する必要があります。

このオプションの詳細AUTO_STATISTICS_UPDATEについては、ALTER DATABA Standard Edition Standard Edition T オプションを参照してください。統計の更新の無効化および再有効化について詳しくは、「統計」をご覧ください。

INCREMENTAL = { ON | OFF }

適用対象: SQL Server 2014 (12.x) 以降のバージョン

作成 ONされる統計は、パーティションごとの統計です。この場合 OFF、すべてのパーティションに対して統計が結合されます。既定値は、OFF です。

パーティションごとの統計がサポートされていない場合は、エラーが生成されます。次の種類の統計では、増分統計がサポートされていません。

ベーステーブルにパーティションで固定されていないインデックスを使用して作成された統計。
Always On の読み取り可能なセカンダリデータベースに対して作成された統計。
読み取り専用のデータベースに対して作成された統計。
フィルター選択されたインデックスに対して作成された統計。
ビューに対して作成された統計。
内部テーブルに対して作成された統計。
空間インデックスまたは XML インデックスを使用して作成された統計。

MAXDOP = max_degree_of_parallelism

適用対象: SQL Server 2016 (13.x) SP 2、SQL Server 2017 (14.x) CU 3 以降のバージョン

統計操作中に 並列処理の 最大次数構成オプションをオーバーライドします。詳細については、「並列処理の最大限度の構成 (サーバー構成オプション)」を参照してください。並列プランの実行で使用されるプロセッサの数を制限するために使用 MAXDOP します。最大数は 64 プロセッサです。

max_degree_of_parallelism は次のように指定できます。

1: 並列プランの生成を抑制します。
>1: 並列インデックス操作で使用されるプロセッサの最大数を、指定した数に制限します。
0 (既定値): 現在のシステムワークロードに基づいて、プロセッサの実際の数以下を使用します。

update_stats_stream_option

単に情報を示すためだけに特定されます。サポートされていません。将来の互換性は保証されません。

AUTO_DROP = { ON | OFF }

適用対象: SQL Server 2022 (16.x) 以降のバージョン、および Azure SQL Database、Azure SQL Managed Instance

SQL Server 2022 (16.x) より前では、統計がユーザーデータベース上のユーザーまたはサードパーティのツールによって手動で作成される場合、これらの統計オブジェクトは、顧客が望むスキーマ変更をブロックまたは妨害する可能性があります。

SQL Server 2022 (16.x) 以降では、 AUTO_DROP このオプションは、新しいデータベースと移行されたすべてのデータベースで既定で有効になっています。この AUTO_DROP プロパティを使用すると、以降のスキーマ変更 が統計オブジェクトによってブロックされるのではなく 、必要に応じて統計が削除されるように、モードで統計オブジェクトを作成できます。この方法では、自動作成された統計と同様に、有効な状態で手動で AUTO_DROP 作成された統計が動作します。

Note

自動作成された統計で Auto_Drop プロパティを設定または設定解除しようとすると、エラーが発生する可能性があります。自動作成された統計では、常に自動削除が使用されます。復元時に、一部のバックアップでは、統計オブジェクトが次回更新されるまで (手動または自動で) このプロパティが正しく設定されていない可能性があります。ただし、自動作成された統計は、自動削除の統計と同様に動作します。以前のバージョンから SQL Server 2022 (16.x) にデータベースを復元する場合は、データベースで実行 sp_updatestats し、統計 AUTO_DROP 機能の適切なメタデータを設定することをお勧めします。

詳細については、「AUTO_DROP オプション」を参照してください。

アクセス許可

これらのアクセス許可のいずれかが必要です。

ALTER TABLE
ユーザーがテーブルの所有者です
db_ddladmin 固定データベースロールのメンバーシップ

解説

SQL Server で tempdb を使用すると、統計を構築する前に、サンプリングされた行を並べ替えることができます。

外部テーブルの統計

外部テーブルの統計を作成する場合は、SQL Server を使用すると、外部テーブルが SQL Server の一時テーブルにインポートされ、統計が作成されます。サンプルの統計の場合は、サンプリングされた行のみがインポートされます。大きな外部テーブルがある場合は、フルスキャンオプションではなく、既定のサンプリングを使用する方が高速です。

外部テーブルがデータ型として DELIMITEDTEXT、CSV、PARQUET、または DELTA を使用している場合、外部テーブルは CREATE STATISTICS コマンドごとに 1 列の統計のみをサポートします。　

条件がフィルター選択された統計情報

適切に定義されたデータのサブセットから選択するクエリでは、フィルター選択された統計情報を使用するとクエリのパフォーマンスを向上させることができます。フィルター選択された統計情報では、統計情報に含まれるデータのサブセットを選択するために WHERE 句でフィルター述語を使用します。

CREATE STATISTICS を使用する場合

CREATE STATISTICS を使用する場合の詳細については、「統計」を参照してください。

フィルター選択された統計の依存関係を参照する

sys.sql_expression_dependencies カタログビューでは、フィルター選択された統計情報の述語の各列を、参照による依存関係として追跡します。フィルター選択された統計を作成する前に、テーブル列に対して実行する操作を検討してください。フィルター選択された統計述語で定義されているテーブル列の定義を削除、名前変更、または変更することはできません。

制限事項

テーブルの外部では、統計を更新することはできません。外部テーブルの統計を更新するには、統計を削除して再作成します。
統計オブジェクトごとに最大 64 列の一覧を取得できます。
このオプションはMAXDOP、およびオプションとSTATS_STREAMROWCOUNTPAGECOUNT互換性がありません。
MAXDOP オプションは、Resource Governor ワークロードグループの MAX_DOP の設定によって制限されます (使用されている場合)。
CREATE および DROP STATISTICS 外部テーブルでは、Azure SQL Database ではサポートされていません。

例

この記事の Transact-SQL コードサンプルは AdventureWorks2022 サンプルデータベースを使用します。このサンプルデータベースは、Microsoft SQL Server サンプルとコミュニティプロジェクトのホームページからダウンロードできます。

A. CREATE STATISTICS を SAMPLE number PERCENT と共に使用する

次の例では、AdventureWorks2022 データベースの Person テーブルの BusinessEntityID 列と EmailPromotion 列の 5% のランダムなサンプルを使って、ContactMail1 統計を作成します。

CREATE STATISTICS ContactMail1
    ON Person.Person (BusinessEntityID, EmailPromotion)
    WITH SAMPLE 5 PERCENT;

B. CREATE STATISTICS を FULLSCAN および NORECOMPUTE と共に使用する

次の例では、NamePurchase テーブルの BusinessEntityID 列と EmailPromotion 列のすべての行を対象に、Person 統計情報を作成し、統計の自動再計算を無効にします。

CREATE STATISTICS NamePurchase
    ON AdventureWorks2022.Person.Person (BusinessEntityID, EmailPromotion)
    WITH FULLSCAN, NORECOMPUTE;

C. CREATE STATISTICS を使用してフィルター選択された統計を作成する

次の例では、フィルター選択された統計情報 ContactPromotion1 を作成します。データベースエンジンによって、データの 50% がサンプリングされた後、EmailPromotion が 2 に等しい行が選択されます。

CREATE STATISTICS ContactPromotion1
    ON Person.Person (BusinessEntityID, LastName, EmailPromotion)
WHERE EmailPromotion = 2
WITH SAMPLE 50 PERCENT;
GO

D. 外部テーブルの統計を作成する

列の一覧を指定する以外に、外部テーブルの統計を作成するときに必要な決定事項は、統計を作成する際に行をサンプリングするか、すべての行をスキャンするかという点のみです。 CREATE および DROP STATISTICS 外部テーブルでは、Azure SQL Database ではサポートされていません。

SQL Server によってデータが外部テーブルから一時テーブルにインポートされて統計が作成されるため、フルスキャンのオプションを実行する場合は時間がかかります。大きなテーブルの場合、通常は既定のサンプリング方法で十分です。

--Create statistics on an external table and use default sampling.
CREATE STATISTICS CustomerStats1 ON DimCustomer (CustomerKey, EmailAddress);

--Create statistics on an external table and scan all the rows
CREATE STATISTICS CustomerStats1 ON DimCustomer (CustomerKey, EmailAddress) WITH FULLSCAN;

E. CREATE STATISTICS を FULLSCAN および PERSIST_SAMPLE_PERCENT と共に使用する

次の例では、テーブルとEmailPromotion列のすべての行のPerson統計をBusinessEntityID作成NamePurchaseし、サンプリング率を明示的に指定しない後続のすべての更新のサンプリング率を 100% に設定します。

CREATE STATISTICS NamePurchase
    ON AdventureWorks2022.Person.Person (BusinessEntityID, EmailPromotion)
    WITH FULLSCAN, PERSIST_SAMPLE_PERCENT = ON;

AdventureWorksDW データベースの使用例

F. 2 つの列の統計を作成する

次の例では、DimCustomer テーブルの CustomerKey 列と EmailAddress 列に基づいて、CustomerStats1 統計を作成します。統計は、Customer テーブルの行の統計的に優位なサンプリングに基づいて作成されます。

CREATE STATISTICS CustomerStats1 ON DimCustomer (CustomerKey, EmailAddress);

G. フルスキャンを使用して統計を作成する

次の例では、DimCustomer テーブルのすべての行のスキャンに基づいて CustomerStatsFullScan 統計を作成します。

CREATE STATISTICS CustomerStatsFullScan
ON DimCustomer (CustomerKey, EmailAddress) WITH FULLSCAN;

H. サンプル率を指定して統計を作成する

次の例では、DimCustomer テーブルの行の 50 パーセントのスキャンに基づいて CustomerStatsSampleScan 統計を作成します。

CREATE STATISTICS CustomerStatsSampleScan
ON DimCustomer (CustomerKey, EmailAddress) WITH SAMPLE 50 PERCENT;

I. AUTO_DROP で CREATE STATISTICS を使用する

自動削除の統計を使用するには、統計の作成または更新の "WITH" 句に、単に次を追加します。

CREATE STATISTICS CustomerStats1 ON DimCustomer (CustomerKey, EmailAddress) WITH AUTO_DROP = ON

既存の統計の自動削除設定を評価するには、sys.stats の auto_drop 列を使用します。

SELECT object_id, [name], auto_drop
FROM sys.stats;

Share via

CREATE STATISTICS (Transact-SQL)

構文

引数

statistics_name

table_or_indexed_view_name

column [ ,...n]

WHERE <filter_predicate>

FULLSCAN

SAMPLE number { PERCENT | ROWS }

PERSIST_SAMPLE_PERCENT = { ON | OFF }

STATS_STREAM = stats_stream

NORECOMPUTE

INCREMENTAL = { ON | OFF }

MAXDOP = max_degree_of_parallelism

update_stats_stream_option

AUTO_DROP = { ON | OFF }

アクセス許可

解説

外部テーブルの統計

条件がフィルター選択された統計情報

CREATE STATISTICS を使用する場合

フィルター選択された統計の依存関係を参照する

制限事項

例

A. CREATE STATISTICS を SAMPLE number PERCENT と共に使用する

B. CREATE STATISTICS を FULLSCAN および NORECOMPUTE と共に使用する

C. CREATE STATISTICS を使用してフィルター選択された統計を作成する

D. 外部テーブルの統計を作成する

E. CREATE STATISTICS を FULLSCAN および PERSIST_SAMPLE_PERCENT と共に使用する

AdventureWorksDW データベースの使用例

F. 2 つの列の統計を作成する

G. フルスキャンを使用して統計を作成する

H. サンプル率を指定して統計を作成する

I. AUTO_DROP で CREATE STATISTICS を使用する

フィードバック

フィードバック

その他のリソース

Share via

CREATE STATISTICS (Transact-SQL)

構文

引数

statistics_name

table_or_indexed_view_name

column [ ,...n]

WHERE <filter_predicate>

FULLSCAN

SAMPLE number { PERCENT | ROWS }

PERSIST_SAMPLE_PERCENT = { ON | OFF }

STATS_STREAM = stats_stream

NORECOMPUTE

INCREMENTAL = { ON | OFF }

MAXDOP = max_degree_of_parallelism

update_stats_stream_option

AUTO_DROP = { ON | OFF }

アクセス許可

解説

外部テーブルの統計

条件がフィルター選択された統計情報

CREATE STATISTICS を使用する場合

フィルター選択された統計の依存関係を参照する

制限事項

例

A. CREATE STATISTICS を SAMPLE number PERCENT と共に使用する

B. CREATE STATISTICS を FULLSCAN および NORECOMPUTE と共に使用する

C. CREATE STATISTICS を使用してフィルター選択された統計を作成する

D. 外部テーブルの統計を作成する

E. CREATE STATISTICS を FULLSCAN および PERSIST_SAMPLE_PERCENT と共に使用する

AdventureWorksDW データベースの使用例

F. 2 つの列の統計を作成する

G. フル スキャンを使用して統計を作成する

H. サンプル率を指定して統計を作成する

I. AUTO_DROP で CREATE STATISTICS を使用する

関連するコンテンツ

フィードバック

フィードバック

その他のリソース

G. フルスキャンを使用して統計を作成する