ALTER DATABASE の SET オプション (Transact-SQL)

2025-07-24

Microsoft SQL Server、Azure SQL データベース、Azure Synapse Analytics でデータベースオプションを設定します。 For other ALTER DATABASE options, see ALTER DATABASE.

Note

ALTER DATABASE で一部のオプションを設定するには、排他データベースアクセスが必要になる場合があります。 ALTER DATABASE ステートメントがタイムリーに完了しない場合は、データベース内の他のセッションが ALTER DATABASE セッションをブロックしているかどうかを確認してください。

構文表記規則の詳細については、「Transact-SQL 構文表記規則」を参照してください。

製品を選択する

次の行から関心がある製品名を選択してみてください。この Web ページでは、選択した製品に合わせて、異なるコンテンツが表示されます。

* SQL Server *

SQL Database

SQL Managed Instance

Azure Synapse
Analytics

Microsoft Fabric

SQL Server

データベースミラーリング、Always On 可用性グループ、および互換性レベルは SET オプションですが、長くなるため別の記事で説明します。詳しくは、「ALTER DATABASE データベースミラーリング」、「ALTER DATABASE SET HADR」、「ALTER DATABASE 互換性レベル」をご覧ください。

データベーススコープ構成は、複数のデータベース構成を個々のデータベースレベルで設定するために使用されます。詳細については、「ALTER DATABASE SCOPED CONFIGURATION」を参照してください。

Note

Many database set options can be configured for the current session by using SET statements and are often configured by applications when they connect. セッションレベルの SET オプションでは ALTER DATABASE SET の値がオーバーライドされます。次のセクションで説明されているデータベースオプションは、セッション用に設定できる値であり、他の SET オプションの値は明示的に指定されていません。

Syntax

ALTER DATABASE { database_name | CURRENT }
SET
{
    <option_spec> [ ,...n ] [ WITH <termination> ]
}

<option_spec> ::=
{
    <accelerated_database_recovery>
  | <auto_option>
  | <automatic_tuning_option>
  | <change_tracking_option>
  | <containment_option>
  | <cursor_option>
  | <data_retention_policy>
  | <database_mirroring_option>
  | <date_correlation_optimization_option>
  | <db_encryption_option>
  | <db_state_option>
  | <db_update_option>
  | <db_user_access_option>
  | <delayed_durability_option>
  | <external_access_option>
  | FILESTREAM ( <FILESTREAM_option> )
  | <HADR_options>
  | <mixed_page_allocation_option>
  | <optimized_locking>
  | <parameterization_option>
  | <query_store_options>
  | <recovery_option>
  | <remote_data_archive_option>
  | <persistent_log_buffer_option>
  | <service_broker_option>
  | <snapshot_option>
  | <sql_option>
  | <suspend_for_snapshot_backup>
  | <target_recovery_time_option>
  | <termination>
  | <temporal_history_retention>
}
;

<accelerated_database_recovery> ::=
{
    ACCELERATED_DATABASE_RECOVERY = { ON | OFF }
     [ ( PERSISTENT_VERSION_STORE_FILEGROUP = { filegroup name } ) ]
}

<auto_option> ::=
{
    AUTO_CLOSE { ON | OFF }
  | AUTO_CREATE_STATISTICS { OFF | ON [ ( INCREMENTAL = { ON | OFF } ) ] }
  | AUTO_SHRINK { ON | OFF }
  | AUTO_UPDATE_STATISTICS { ON | OFF }
  | AUTO_UPDATE_STATISTICS_ASYNC { ON | OFF }
}

<automatic_tuning_option> ::=
{
    AUTOMATIC_TUNING ( FORCE_LAST_GOOD_PLAN = { DEFAULT | ON | OFF } )
}

<change_tracking_option> ::=
{
    CHANGE_TRACKING
   {
       = OFF
     | = ON [ ( <change_tracking_option_list > [,...n] ) ]
     | ( <change_tracking_option_list> [,...n] )
   }
}

<change_tracking_option_list> ::=
{
   AUTO_CLEANUP = { ON | OFF }
 | CHANGE_RETENTION = retention_period { DAYS | HOURS | MINUTES }
}

<containment_option> ::=
   CONTAINMENT = { NONE | PARTIAL }

<cursor_option> ::=
{
    CURSOR_CLOSE_ON_COMMIT { ON | OFF }
  | CURSOR_DEFAULT { LOCAL | GLOBAL }
}

<database_mirroring_option>
  ALTER DATABASE Database Mirroring

<date_correlation_optimization_option> ::=
    DATE_CORRELATION_OPTIMIZATION { ON | OFF }

<db_encryption_option> ::=
    ENCRYPTION { ON | OFF | SUSPEND | RESUME }

<db_state_option> ::=
    { ONLINE | OFFLINE | EMERGENCY }

<db_update_option> ::=
    { READ_ONLY | READ_WRITE }

<db_user_access_option> ::=
    { SINGLE_USER | RESTRICTED_USER | MULTI_USER }

<delayed_durability_option> ::=
    DELAYED_DURABILITY = { DISABLED | ALLOWED | FORCED }

<external_access_option> ::=
{
    DB_CHAINING { ON | OFF }
  | TRUSTWORTHY { ON | OFF }
  | DEFAULT_FULLTEXT_LANGUAGE = { <lcid> | <language name> | <language alias> }
  | DEFAULT_LANGUAGE = { <lcid> | <language name> | <language alias> }
  | NESTED_TRIGGERS = { OFF | ON }
  | TRANSFORM_NOISE_WORDS = { OFF | ON }
  | TWO_DIGIT_YEAR_CUTOFF = { 1753, ..., 2049, ..., 9999 }
}

<FILESTREAM_option> ::=
{
    NON_TRANSACTED_ACCESS = { OFF | READ_ONLY | FULL
  | DIRECTORY_NAME = <directory_name>
}

<HADR_options> ::=
    ALTER DATABASE SET HADR

<mixed_page_allocation_option> ::=
    MIXED_PAGE_ALLOCATION { OFF | ON }

<parameterization_option> ::=
    PARAMETERIZATION { SIMPLE | FORCED }

<query_store_options> ::=
{
    QUERY_STORE
    {
          = OFF [ ( FORCED ) ]
        | = ON [ ( <query_store_option_list> [,...n] ) ]
        | ( < query_store_option_list> [,...n] )
        | CLEAR [ ALL ]
    }
}

<query_store_option_list> ::=
{
      OPERATION_MODE = { READ_WRITE | READ_ONLY }
    | CLEANUP_POLICY = ( STALE_QUERY_THRESHOLD_DAYS = number )
    | DATA_FLUSH_INTERVAL_SECONDS = number
    | MAX_STORAGE_SIZE_MB = number
    | INTERVAL_LENGTH_MINUTES = number
    | SIZE_BASED_CLEANUP_MODE = { AUTO | OFF }
    | QUERY_CAPTURE_MODE = { ALL | AUTO | CUSTOM | NONE }
    | MAX_PLANS_PER_QUERY = number
    | WAIT_STATS_CAPTURE_MODE = { ON | OFF }
    | QUERY_CAPTURE_POLICY = ( <query_capture_policy_option_list> [,...n] )
}

<query_capture_policy_option_list> :: =
{
      STALE_CAPTURE_POLICY_THRESHOLD = number { DAYS | HOURS }
    | EXECUTION_COUNT = number
    | TOTAL_COMPILE_CPU_TIME_MS = number
    | TOTAL_EXECUTION_CPU_TIME_MS = number
}

<recovery_option> ::=
{
    RECOVERY { FULL | BULK_LOGGED | SIMPLE }
  | TORN_PAGE_DETECTION { ON | OFF }
  | PAGE_VERIFY { CHECKSUM | TORN_PAGE_DETECTION | NONE }
}

<remote_data_archive_option> ::=
{
    REMOTE_DATA_ARCHIVE =
    {
        ON ( SERVER = <server_name>,
             {
                  CREDENTIAL = <db_scoped_credential_name>
                  | FEDERATED_SERVICE_ACCOUNT = ON | OFF
             }
        )
        | OFF
    }
}

<persistent_log_buffer_option> ::=
{
    PERSISTENT_LOG_BUFFER 
    {
          = ON (DIRECTORY_NAME= 'path-to-directory-on-a-DAX-volume')
        | = OFF
    }
}

<service_broker_option> ::=
{
    ENABLE_BROKER
  | DISABLE_BROKER
  | NEW_BROKER
  | ERROR_BROKER_CONVERSATIONS
  | HONOR_BROKER_PRIORITY { ON | OFF }
}

<snapshot_option> ::=
{
    ALLOW_SNAPSHOT_ISOLATION { ON | OFF }
  | READ_COMMITTED_SNAPSHOT { ON | OFF }
  | MEMORY_OPTIMIZED_ELEVATE_TO_SNAPSHOT = { ON | OFF }
}

<sql_option> ::=
{
    ANSI_NULL_DEFAULT { ON | OFF }
  | ANSI_NULLS { ON | OFF }
  | ANSI_PADDING { ON | OFF }
  | ANSI_WARNINGS { ON | OFF }
  | ARITHABORT { ON | OFF }
  | COMPATIBILITY_LEVEL = { 170 | 160 | 150 | 140 | 130 | 120 | 110 | 100 }
  | CONCAT_NULL_YIELDS_NULL { ON | OFF }
  | NUMERIC_ROUNDABORT { ON | OFF }
  | QUOTED_IDENTIFIER { ON | OFF }
  | RECURSIVE_TRIGGERS { ON | OFF }
}

<suspend_for_snapshot_backup> ::=
    SET SUSPEND_FOR_SNAPSHOT_BACKUP = { ON | OFF } [ ( MODE = COPY_ONLY ) ]

<target_recovery_time_option> ::=
    TARGET_RECOVERY_TIME = target_recovery_time { SECONDS | MINUTES }

<termination>::=
{
    ROLLBACK AFTER number [ SECONDS ]
  | ROLLBACK IMMEDIATE
  | NO_WAIT
}

<temporal_history_retention> ::=
    TEMPORAL_HISTORY_RETENTION { ON | OFF }

<data_retention_policy> ::=
    DATA_RETENTION { ON | OFF }

<optimized_locking> ::=
{
    OPTIMIZED_LOCKING = { ON | OFF }
}

Arguments

database_name

変更するデータベースの名前。

CURRENT

Applies to: SQL Server (Starting with SQL Server 2012 (11.x))

現在のデータベースでアクションが実行されます。 CURRENT は、すべてのコンテキスト内のすべてのオプションでサポートされるわけではありません。 CURRENT でエラーが発生した場合は、データベース名を指定してください。

<accelerated_database_recovery> ::=

Applies to: SQL Server (Starting with SQL Server 2019 (15.x))

高速データベース復旧 (ADR)有効にします。 SQL Server 2019 (15.x) 以降では、ADR は既定で OFF に設定されています。この構文を使用すると、永続バージョンストア (PVS) データの特定のファイルグループを指定できます。ファイルグループが指定されていない場合、PVS は PRIMARY ファイルグループを使用します。詳細については、「高速データベース復旧の管理」を参照してください。

ACCELERATED_DATABASE_RECOVERYをオンまたはオフに設定するには、ALTER DATABASE コマンドを実行する接続を除き、データベースへのアクティブな接続が存在しない必要があります。データベースがシングルユーザーモードになっている必要はありません。データベースが ONLINE でない限り、このオプションの状態を変更することはできません。

<auto_option> ::=

自動オプションを制御します。

AUTO_CLOSE { ON |OFF }

ON

データベースが正常にシャットダウンされ、最後のユーザーが終了した後、データベースのリソースが解放されます。

ユーザーが再びそのデータベースを使用しようとすると、そのデータベースが自動的に再度開かれます。たとえば、この動作は、ユーザーが USE database_name ステートメントを発行したときに発生します。 AUTO_CLOSEが ON に設定されている状態で、データベースが正常にシャットダウンされる場合があります。その場合、ユーザーが次回データベースエンジンを再起動したときにデータベースを使用するまで、データベースは再度開きません。

あるデータベースをシャットダウンした後、そのデータベースの使用がアプリケーションで次回試行されるとき、そのデータベースを最初に開き、状態をオンラインに変更する必要があります。これには時間がかかる場合があり、アプリケーションのタイムアウトが発生する可能性があります。
OFF

最後のユーザーが終了した後も、データベースは開いたままになります。

AUTO_CLOSE オプションを使用すると、データベースファイルを通常のファイルとして管理できるため、デスクトップデータベースには便利なオプションです。普通のファイルと同じように、移動、コピーによるバックアップ作成、他のユーザーへの電子メール送信が可能です。 AUTO_CLOSE は非同期プロセスであるため、データベースを開いたり閉じたりする操作を繰り返しても、パフォーマンスは低下しません。

Note

AUTO_CLOSE オプションは、包含データベースまたは SQL Database では使用できません。 You can determine this option's status by examining the is_auto_close_on column in the sys.databases catalog view or the IsAutoClose property of the DATABASEPROPERTYEX function.

When AUTO_CLOSE is set to ON, some columns in the sys.databases catalog view and the DATABASEPROPERTYEX function returns NULL because the database is unavailable to retrieve the data. この問題を解決するには、USE ステートメントを実行してデータベースを開きます。

データベースをミラー化するには、AUTO_CLOSE を OFF に設定する必要があります。

データベースを AUTOCLOSE = ON に設定すると、データベースの自動シャットダウンを開始する操作によって、SQL Server のインスタンスのプランキャッシュが消去されます。プランキャッシュが消去されると、後続のすべての実行プランが再コンパイルされ、場合によっては、クエリパフォーマンスが一時的に急激に低下します。 SQL Server 2005 (9.x) Service Pack 2 以降では、プランキャッシュ内のキャッシュストアが消去されるたびに、SQL Server エラーログに SQL Server has encountered %d occurrence(s) of cachestore flush for the '%s' cachestore (part of plan cache) due to some database maintenance or reconfigure operations という通知メッセージが記録されます。このメッセージは、5 分以内にキャッシュがフラッシュされる限り、5 分間隔でログに記録されます。

AUTO_CLOSE設定は、少数のデータベースで安定して動作するのに十分なメモリがない SQL Server インスタンスや、データベースの数が多いレガシ 32 ビット SQL Server インスタンスなど、まれな状況で便利な機能です。このようなシナリオでは、AUTO_CLOSEを有効にし、データベースを使用するアプリケーションがない場合にデータベースを開いたままにするために必要なメモリリソースを節約すると便利な場合があります。データベースが開いているときは、一部の既定のメモリ割り当てが必要になります (たとえば、さまざまなデータベースメタデータオブジェクトとトランザクションログバッファーを表す内部構造)。

AUTO_CREATE_STATISTICS { ON |OFF }

ON

クエリプランを改善してクエリのパフォーマンスを向上させるために、クエリオプティマイザーが必要に応じてクエリ述語内の列に対して 1 列ずつ統計を作成します。これらの 1 列ずつの統計は、クエリオプティマイザーがクエリをコンパイルする場合に作成されます。 1 列ずつの統計は、まだ既存の統計オブジェクトの最初の列になっていない列についてのみ作成されます。

既定の設定は ON です。ほとんどのデータベースで既定の設定を使用することをお勧めします。
OFF

クエリオプティマイザーがクエリをコンパイルするときにクエリ述語内の列の 1 列ずつの統計が作成されません。このオプションを OFF に設定すると、最適ではないクエリプランが作成されて、クエリのパフォーマンスが低下することがあります。

You can determine this option's status by examining the is_auto_create_stats_on column in the sys.databases catalog view. You can also determine the status by examining the IsAutoCreateStatistics property of the DATABASEPROPERTYEX function.

For more information, see the section "Using the Database-wide statistics options" in Statistics.

INCREMENTAL = ON |オフ

Applies to: SQL Server (Starting with SQL Server 2014 (12.x)) and Azure SQL Database

AUTO_CREATE_STATISTICS を ON に設定し、INCREMENTAL を ON に設定します。これにより、増分統計がサポートされている場合は常に、自動的に作成された統計情報が増分として設定されます。既定値は OFF です。 For more information, see CREATE STATISTICS.

AUTO_SHRINK { ON |OFF }

ON

データベースファイルを定期的な圧縮処理の対象とします。特定の要件がない限り、AUTO_SHRINK データベースオプションを ON に設定しないでください。詳細については、「データベースの圧縮」を参照してください。

データファイルとログファイルの両方を、自動的に圧縮できます。 AUTO_SHRINK では、データベースを単純復旧モデルに設定している場合、またはログをバックアップしている場合にのみ、トランザクションログのサイズが圧縮されます。 AUTO_SHRINK を OFF に設定すると、未使用領域の定期チェックの際、データベースファイルは自動的に圧縮されません。

AUTO_SHRINK オプションを使用すると、ファイル領域の 25% を超える領域が未使用の場合にファイルが圧縮されます。ファイルは次の 2 つのサイズのいずれかに圧縮されます (どちらか大きい方)。
- ファイルの 25% が未使用領域であるサイズ
- ファイルが作成されたときのサイズ
読み取り専用データベースは圧縮できません。
OFF

データベースファイルは、未使用領域の定期的なチェック中に自動的に圧縮されることはありません。

You can determine this option's status by examining the is_auto_shrink_on column in the sys.databases catalog view. You can also determine the status by examining the IsAutoShrink property of the DATABASEPROPERTYEX function.

Note

AUTO_SHRINK オプションは、包含データベースでは使用できません。

AUTO_UPDATE_STATISTICS { ON |OFF }

ON

クエリで使用される場合、および統計が古くなっている可能性がある場合に、クエリオプティマイザーによって更新されるように指定します。挿入、更新、削除、またはマージの各操作によってテーブルまたはインデックス付きビューのデータの分布が変わると、統計は古くなったと判断されます。クエリオプティマイザーでは、統計が前回更新されてから発生したデータ変更の数をカウントし、その変更の数をしきい値と比較することで、統計が古くなっている可能性がないかを判断します。このしきい値は、テーブルまたはインデックス付きビューの行数に基づいて決められます。

クエリオプティマイザーによる古い統計の確認は、クエリをコンパイルする前と、キャッシュされたクエリプランを実行する前に行われます。クエリオプティマイザーでは、古くなっている可能性がある統計を判断するため、クエリ述語内の列、テーブル、インデックス付きビューが使用されます。この情報は、クエリがコンパイルされる前にクエリオプティマイザーによって判断されます。キャッシュされたクエリプランを実行する前は、データベースエンジンで、クエリプランが最新の統計を参照しているかどうかが確認されます。

AUTO_UPDATE_STATISTICS オプションは、インデックスに対して作成された統計、クエリ述語内の列に対して 1 列ずつ作成された統計、および CREATE STATISTICS ステートメントを使用して作成された統計に適用されます。また、フィルター選択された統計情報にも適用されます。

既定値は ON です。ほとんどのデータベースで既定の設定を使用することをお勧めします。

統計を同期的に更新するか非同期的に更新するかを指定するには、AUTO_UPDATE_STATISTICS_ASYNC オプションを使用します。
OFF

統計がクエリで使用されるときに、クエリオプティマイザーによって統計が更新されないことを指定します。また、統計が古くなっている可能性がある場合は、クエリオプティマイザーによって更新されません。このオプションを OFF に設定すると、最適ではないクエリプランが作成されて、クエリのパフォーマンスが低下することがあります。

You can determine this option's status by examining the is_auto_update_stats_on column in the sys.databases catalog view. You can also determine the status by examining the IsAutoUpdateStatistics property of the DATABASEPROPERTYEX function.

For more information, see the section "Using the Database-wide statistics options" in Statistics.

AUTO_UPDATE_STATISTICS_ASYNC { ON |OFF }

ON

AUTO_UPDATE_STATISTICS オプションの統計の更新を非同期更新にするように指定します。クエリオプティマイザーでは、統計の更新が完了するのを待たずにクエリをコンパイルします。

AUTO_UPDATE_STATISTICS が ON に設定されていなければ、このオプションを ON に設定しても、効果はありません。

既定では、AUTO_UPDATE_STATISTICS_ASYNC オプションは OFF であり、クエリオプティマイザーによる統計は同期更新となります。
OFF

AUTO_UPDATE_STATISTICS オプションの統計の更新を同期更新にするように指定します。クエリオプティマイザーでは、統計の更新が完了するのを待ってからクエリをコンパイルします。

Note

AUTO_UPDATE_STATISTICS が ON に設定されていなければ、このオプションを OFF に設定しても、効果はありません。

You can determine this option's status by examining the is_auto_update_stats_async_on column in the sys.databases catalog view.

For more information that describes when to use synchronous or asynchronous statistics updates, see the "Statistics options" section in Statistics.

<automatic_tuning_option> ::=

Applies to: SQL Server (Starting with SQL Server 2017 (14.x))

Enables or disables FORCE_LAST_GOOD_PLANAutomatic tuning option. このオプションの状態は、ビュー sys.database_automatic_tuning_options で確認できます。

FORCE_LAST_GOOD_PLAN = { DEFAULT |ON |OFF }

DEFAULT

SQL Server の既定値は OFF です。
ON

新しいクエリプランがパフォーマンスの低下を引き起こしている Transact-SQL クエリに対して、データベースエンジンでは最後の既知の正常なプランが自動的に強制されます。データベースエンジンでは、強制プランを使用する Transact-SQL クエリのクエリパフォーマンスが継続的に監視されます。

パフォーマンスの向上がある場合、データベースエンジンでは、最新の既知の適切なプランが引き続き使用されます。パフォーマンスの向上が検出されない場合、データベースエンジンによって新しいクエリプランが生成されます。 The statement fails if the Query Store isn't enabled or if the Query Store isn't in Read-Write mode.
OFF

The Database Engine reports potential query performance regressions caused by query plan changes in sys.dm_db_tuning_recommendations view. ただし、これらの推奨事項は自動的には適用されません。ユーザーは、ビューに表示される Transact-SQL スクリプトを適用することによって、アクティブな推奨事項を監視し、特定された問題を解決できます。既定値は OFF です。

<change_tracking_option> ::=

Applies to: SQL Server and Azure SQL Database

変更の追跡のオプションを制御します。変更の追跡の有効化、オプションの設定、オプションの変更、および変更の追跡の無効化が可能です。 For examples, see the Examples section later in this article.

ON

データベースの変更の追跡を有効にします。変更の追跡を有効にすると、AUTO CLEANUP オプションと CHANGE RETENTION オプションも設定できます。
AUTO_CLEANUP = { ON |OFF }
- ON
  
  指定した保有期間を過ぎると、変更追跡情報が自動的に削除されます。
- OFF
  
  変更追跡データがデータベースから自動的に削除されることはありません。
CHANGE_RETENTION = retention_period { DAYS | HOURS | MINUTES }

データベースに変更追跡情報を保持する最低限の期間を指定します。データは、AUTO_CLEANUP の値が ON のときにのみ削除されます。

retention_period is an integer that specifies the numerical component of the retention period.

The default retention period is 2 days. 最小保有期間は 1 分です。 The default retention type is DAYS.
OFF: データベースの変更の追跡は無効になります。データベースの変更の追跡を無効にする前に、すべてのテーブルで変更の追跡を無効にしてください。

<containment_option> ::=

Applies to: SQL Server (Starting with SQL Server 2012 (11.x))

データベースの包含オプションを制御します。

CONTAINMENT = { NONE |PARTIAL}

NONE

データベースは非包含データベースです。
PARTIAL

データベースは包含データベースです。データベースにレプリケーション、変更データキャプチャ、または変更追跡が有効になっている場合、データベースの包含を部分的に設定すると失敗します。エラーチェックは、エラーを 1 つ検出すると停止します。 For more information about contained databases, see Contained Databases.

<cursor_option> ::=

カーソルオプションを制御します。

CURSOR_CLOSE_ON_COMMIT { ON |OFF }

ON

トランザクションをコミットまたはロールバックしたときに開いていたカーソルはすべて閉じられます。
OFF

トランザクションがコミットされると、カーソルは開いたままです。トランザクションをロールバックすると、INSENSITIVE または STATIC として定義されているカーソルを除き、カーソルはすべて閉じます。

SET ステートメントを使用した接続レベルの設定は、CURSOR_CLOSE_ON_COMMIT の既定のデータベース設定をオーバーライドします。既定では、ODBC クライアントと OLE DB クライアントは、セッションの CURSOR_CLOSE_ON_COMMIT を OFF に設定する接続レベルの SET ステートメントを発行します。 SQL Server のインスタンスに接続すると、クライアントはステートメントを実行します。 For more information, see SET CURSOR_CLOSE_ON_COMMIT.

CURSOR_DEFAULT { LOCAL |GLOBAL }

Applies to: SQL Server

カーソルのスコープを LOCAL と GLOBAL のどちらにするかを制御します。

LOCAL

LOCAL を指定し、カーソルを作成するときにカーソルを GLOBAL と定義しないと、カーソルのスコープはローカルになります。具体的には、スコープは、カーソルを作成したバッチ、ストアドプロシージャ、またはトリガーに対してローカルです。カーソル名はこのスコープ内だけで有効です。

カーソルは、バッチ、ストアドプロシージャ、またはトリガー内のローカルカーソル変数からか、ストアドプロシージャの OUTPUT パラメーターから参照できます。バッチ、ストアドプロシージャ、またはトリガーが終了すると、カーソルは暗黙的に割り当てを解除されます。カーソルが OUTPUT パラメーターで戻されない限り、カーソルは割り当てを解除されます。カーソルは OUTPUT パラメーターで戻すことができます。カーソルがこの方法で戻された場合は、カーソルを参照している最後の変数が割り当て解除されるか、スコープ外になったときに、カーソルの割り当てが解除されます。
GLOBAL

カーソルが作成時に LOCAL として定義されていない場合、カーソルのスコープはその接続に対してグローバルになります。カーソル名は、その接続によって実行されるストアドプロシージャやバッチの中で参照できます。

接続が切断されたときだけカーソルが暗黙的に割り当てを解除されます。 For more information, see DECLARE CURSOR.

You can determine this option's status by examining the is_local_cursor_default column in the sys.databases catalog view. You can also determine the status by examining the IsLocalCursorsDefault property of the DATABASEPROPERTYEX function.

<temporal_history_retention> ::=

TEMPORAL_HISTORY_RETENTION { ON |OFF }

ただし、既定では、ON はポイントインタイムリストア操作の後、自動的にOFF に設定されます。この設定を有効にする方法など、詳細については、「リテンションポリシーの構成方法」を参照してください。

ON

Default. テンポラルテーブルの保持ポリシーを有効にします。詳細については、「システムバージョン管理されたテンポラルテーブルの履歴データの保有期間管理」を参照してください。
OFF

一時的な履歴保持ポリシーは実行しないでください。

<data_retention_policy> ::=

Applies to: Azure SQL Edge only.

DATA_RETENTION { ON |OFF }

ON

データベースでデータ保持ポリシーを使用したクリーンアップを有効にします。
OFF

データベースでデータ保持ポリシーを使用したクリーンアップを無効にします。

<database_mirroring>

Applies to: SQL Server

引数の説明については、「ALTER DATABASE データベースミラーリング」をご覧ください。

<date_correlation_optimization_option> ::=

Applies to: SQL Server

date_correlation_optimization オプションを制御します。

DATE_CORRELATION_OPTIMIZATION { ON |OFF }

ON

SQL Server maintains correlation statistics where a FOREIGN KEY constraint links any two tables in the database and the tables have datetime columns.
OFF

関連付けの統計は維持されません。

DATE_CORRELATION_OPTIMIZATION を ON に設定するには、データベースに対するアクティブな接続が、ALTER DATABASE ステートメントを実行する接続の他には存在しないようにします。設定後、複数の接続がサポートされます。

The current setting of this option can be determined by examining the is_date_correlation_on column in the sys.databases catalog view.

<db_encryption_option> ::=

データベース暗号化の状態を制御します。

ENCRYPTION { ON |OFF |SUSPEND |RESUME }

ON

暗号化するデータベースを設定します。
OFF

暗号化しないデータベースを設定します。
SUSPEND

Applies to: SQL Server (Starting with SQL Server 2019 (15.x))

透過的なデータ暗号化が有効または無効になった後、または暗号化キーが変更された後に、暗号化スキャンを一時停止するために使用できます。
RESUME

Applies to: SQL Server (Starting with SQL Server 2019 (15.x))

以前に一時停止した暗号化スキャンを再開するために使用できます。

データベース暗号化の詳細については、「Transparent Data Encryption (TDE)」および「Azure SQL Database、Azure SQL Managed Instance、および Azure Synapse Analyticsの Transparent Data Encryption をする」を参照してください。

データベースレベルで暗号化を有効にすると、すべてのファイルグループが暗号化されます。新しいファイルグループは、暗号化されたプロパティを継承します。データベース内のファイルグループが READ ONLY に設定されている場合、データベース暗号化操作は失敗します。

You can see the encryption state of the database and the state of the encryption scan by using the sys.dm_database_encryption_keys dynamic management view.

<db_state_option> ::=

Applies to: SQL Server

データベースの状態を制御します。

OFFLINE

データベースが閉じ、正常にシャットダウンされ、オフラインとしてマークされます。データベースがオフラインのときはデータベースを変更できません。
ONLINE

データベースが開き、使用可能になります。
EMERGENCY

データベースは READ_ONLY に設定され、ログ記録が無効になり、アクセスが sysadmin 固定サーバーロールのメンバーに制限されます。 EMERGENCY は、主にトラブルシューティングの目的で使用されます。たとえば、破損したログファイルが原因で問題ありとマークされたデータベースを EMERGENCY 状態に設定できます。この設定で、システム管理者はデータベースに読み取り専用でアクセスできるようになります。 sysadmin 固定サーバーロールのメンバーのみが、データベースを EMERGENCY 状態に設定できます。

データベースをオフラインまたは EMERGENCY 状態に変更するにはサブジェクトデータベースの ALTER DATABASE 権限が、データベースをオフラインからオンラインに変更するには ALTER ANY DATABASE 権限が必要になります。

You can determine this option's status by examining the state and state_desc columns in the sys.databases catalog view. You can also determine the status by examining the Status property of the DATABASEPROPERTYEX function. For more information, see Database States.

RESTORING とマークされたデータベースを OFFLINE、ONLINE、または EMERGENCY に設定することはできません。アクティブな復元操作中、またはバックアップファイルが破損しているためにデータベースまたはログファイルの復元操作が失敗した場合に、データベースが RESTORING 状態になる可能性があります。

<db_update_option> ::=

データベースで更新を許可するかどうかを制御します。

READ_ONLY

ユーザーは、データベースのデータを読み取ることができますが、変更はできません。

Note

クエリのパフォーマンスを向上させるには、データベースを READ_ONLY に設定する前に統計を更新します。データベースをREAD_ONLYに設定した後に追加の統計が必要な場合、データベースエンジンは tempdb システムデータベースに統計を作成します。 For more information about statistics for a read-only database, see Statistics.
READ_WRITE

データベースに対して読み取りおよび書き込み操作を行うことができます。

この状態を変更するには、データベースに対する排他的アクセスが必要になります。詳細については、SINGLE_USER 句をご覧ください。

Note

Azure SQL データベースフェデレーションデータベースでは、SET { READ_ONLY | READ_WRITE } は無効になっています。

<db_user_access_option> ::=

データベースへのユーザーアクセスを制御します。

SINGLE_USER

Applies to: SQL Server

一度に 1 人のユーザーだけがデータベースにアクセスできます。 SINGLE_USER を指定し、別のユーザーがデータベースに接続する場合、指定したデータベースからすべてのユーザーが接続解除するまで、ALTER DATABASE ステートメントはブロックされます。この動作をオーバーライドする場合は、WITH <termination> 句を確認します。

このオプションを設定したユーザーがサインアウトしても、データベースは SINGLE_USER モードのままです。そのユーザーがログオフした時点で、他のユーザーが 1 人だけデータベースに接続できます。

データベースを SINGLE_USER に設定する前に、AUTO_UPDATE_STATISTICS_ASYNC オプションが OFF に設定されていることを確認します。 ON に設定すると、統計の更新に使用されるバックグラウンドスレッドはデータベースに対する接続を取得し、シングルユーザーモードではデータベースにアクセスできません。 To view the status of this option, query the is_auto_update_stats_async_on column in the sys.databases catalog view. このオプションが ON に設定されている場合、次の作業を行います。

AUTO_UPDATE_STATISTICS_ASYNC を OFF に設定します。
Check for active asynchronous statistics jobs by querying the sys.dm_exec_background_job_queue dynamic management view.

アクティブなジョブがある場合、それらのジョブが完了するまで待つか、KILL STATS JOB を使用して手動でジョブを終了します。

RESTRICTED_USER

db_owner 固定データベースロール、および dbcreator と sysadmin の固定サーバーロールのメンバーだけにデータベースへの接続を許可します。 RESTRICTED_USER に接続数の制限はありません。データベースに対するすべての接続は、ALTER DATABASE ステートメントの終了句で指定した時間枠を使用して接続解除されます。データベースが RESTRICTED_USER 状態に移行すると、資格のないユーザーによる接続の試みは拒否されます。

MULTI_USER

データベースに接続するための適切な権限を持つすべてのユーザーが許可されます。 You can determine this option's status by examining the user_access column in the sys.databases catalog view. You can also determine the status by examining the UserAccess property of the DATABASEPROPERTYEX function.

<delayed_durability_option> ::=

Applies to: SQL Server (Starting with SQL Server 2014 (12.x))

トランザクションを完全持続性または遅延持続性のどちらとしてコミットするかどうかを制御します。

DISABLED

SET DISABLED 以後のトランザクションはすべて完全持続性になります。 ATOMIC ブロックまたは COMMIT ステートメントで設定された持続性オプションは無視されます。
ALLOWED

SET ALLOWED 以後のトランザクションはすべて、ATOMIC ブロックまたは COMMIT ステートメントで設定された持続性オプションに応じて、完全持続性または遅延持続性になります。
FORCED

SET FORCED 以後のトランザクションはすべて遅延持続性になります。 ATOMIC ブロックまたは COMMIT ステートメントで設定された持続性オプションは無視されます。

<external_access_option> ::=

Applies to: SQL Server

別のデータベースのオブジェクトなど、外部リソースからデータベースにアクセスできるかどうかを制御します。

DB_CHAINING { ON |OFF }

ON

複数データベースの組み合わせ所有権のソースデータベースまたは対象データベースとしてこのデータベースを使用できます。
OFF

データベースは、複数データベースの組み合わせ所有権に参加できません。

Important

クロス db 所有権サーバーオプションが 0 (OFF) の場合、SQL Server のインスタンスはこの設定を認識します。 cross db ownership chaining が 1 (ON) の場合は、このオプションの値にかかわらず、すべてのユーザーデータベースが複数データベースの組み合わせ所有権に参加できます。 This option is set by using sp_configure.

このオプションを設定するには、データベースに対する CONTROL SERVER 権限が必要です。

master、model、および tempdb システムデータベースでは、DB_CHAINING オプションを設定できません。

You can determine this option's status by examining the is_db_chaining_on column in the sys.databases catalog view.

TRUSTWORTHY { ON |OFF }

ON

権限借用コンテキストを使用するデータベースモジュール (ユーザー定義関数やストアドプロシージャなど) は、データベース外部のリソースにアクセスできます。
OFF

権限借用のコンテキスト内のデータベースモジュールは、データベース外のリソースにアクセスできません。

データベースがアタッチされている場合は常に、TRUSTWORTHY は OFF に設定されます。

既定では、msdb データベースを除くすべてのシステムデータベースで TRUSTWORTHY は OFF に設定されています。 model および tempdb データベースではこの値を変更できません。 master データベースでは、TRUSTWORTHY オプションを ON に設定しないことを強くお勧めします。

このオプションを設定するには、データベースに対する CONTROL SERVER 権限が必要です。

You can determine this option's status by examining the is_trustworthy_on column in the sys.databases catalog view.

DEFAULT_FULLTEXT_LANGUAGE

Applies to: SQL Server (Starting with SQL Server 2012 (11.x))

フルテキストインデックス列に、既定の言語の値を指定します。

Important

このオプションは、CONTAINMENT が PARTIAL に設定されている場合にのみ使用できます。 CONTAINMENT が NONE に設定されている場合、エラーが発生します。

DEFAULT_LANGUAGE

Applies to: SQL Server (Starting with SQL Server 2012 (11.x))

新しく作成するすべてのログインの既定の言語を指定します。ローカル ID (LCID)、言語の名前、または言語のエイリアスを提供することで言語を指定することができます。 For a list of acceptable language names and aliases, see sys.syslanguages. このオプションは、CONTAINMENT が PARTIAL に設定されている場合にのみ使用できます。 CONTAINMENT が NONE に設定されている場合、エラーが発生します。

NESTED_TRIGGERS

Applies to: SQL Server (Starting with SQL Server 2012 (11.x))

AFTER トリガーを連鎖できるかどうかを指定します。つまり、1 つの操作が別のトリガーを開始し、開始されたトリガーからさらに別のトリガーを開始するなどの動作ができるかどうかを制御します。このオプションは、CONTAINMENT が PARTIAL に設定されている場合にのみ使用できます。 CONTAINMENT が NONE に設定されている場合、エラーが発生します。

TRANSFORM_NOISE_WORDS

Applies to: SQL Server (Starting with SQL Server 2012 (11.x))

ノイズワード (ストップワード) が原因でフルテキストクエリのブール演算が失敗する場合に、エラーメッセージを非表示にします。このオプションは、CONTAINMENT が PARTIAL に設定されている場合にのみ使用できます。 CONTAINMENT が NONE に設定されている場合、エラーが発生します。

TWO_DIGIT_YEAR_CUTOFF

Applies to: SQL Server (Starting with SQL Server 2012 (11.x))

2 桁の数字を 4 桁の西暦として解釈する場合に、世紀の解釈の区切りとする年を 1753 ～ 9999 範囲の整数で指定します。このオプションは、CONTAINMENT が PARTIAL に設定されている場合にのみ使用できます。 CONTAINMENT が NONE に設定されている場合、エラーが発生します。

<FILESTREAM_option> ::=

Applies to: SQL Server (Starting with SQL Server 2012 (11.x))

FileTable の設定を制御します。

NON_TRANSACTED_ACCESS = { オフ |READ_ONLY |フル }

OFF

FileTable データに対する非トランザクションアクセスは無効になります。
READ_ONLY

このデータベース内の FileTable の FILESTREAM データは、非トランザクションプロセスによって読み取ることができます。
FULL

FileTable の FILESTREAM データに対する完全な非トランザクションアクセスが有効になります。

DIRECTORY_NAME = <directory_name>

Windows と互換性のあるディレクトリ名です。この名前は、SQL Server インスタンス内のすべてのデータベースレベルのディレクトリ名の中で一意である必要があります。一意性の比較では、照合順序の設定とは関係なく、大文字と小文字は区別されません。このオプションは、このデータベース内に FileTable を作成する前に設定する必要があります。

<HADR_options> ::=

Applies to: SQL Server

「ALTER DATABASE SET HADR」をご覧ください。

<mixed_page_allocation_option> ::=

Applies to: SQL Server (Starting with SQL Server 2016 (13.x))

データベースが、テーブルまたはインデックスの最初の 8 ページに対して混合エクステントを使用して、最初のページを作成できるかどうかを制御します。

MIXED_PAGE_ALLOCATION { OFF |ON }

OFF

データベースは、常に単一エクステントを使用して最初のページを作成します。既定値は OFF です。
ON

データベースは、混合エクステントを使用して最初のページを作成できます。

この設定は、常に OFF になっている tempdb を除くすべてのシステムデータベースに対して常に ON になります。システムデータベースの設定を変更することはできません。

<PARAMETERIZATION_option> ::=

パラメーター化オプションを制御します。パラメーター化の詳細については、「クエリ処理アーキテクチャガイド」をご覧ください。

パラメーター化 { 単純 |FORCED }

SIMPLE

クエリは、データベースの既定の動作に基づいてパラメーター化されます。
FORCED

SQL Server は、データベース内にあるすべてのクエリをパラメーター化します。

The current setting of this option can be determined by examining the is_parameterization_forced column in the sys.databases catalog view.

<query_store_options> ::=

Applies to: SQL Server (Starting with SQL Server 2016 (13.x))

ON |OFF [ ( FORCED ) ] |CLEAR [ すべて ]

このデータベースでクエリストアを有効にするかどうかを制御します。また、クエリストアの内容の削除も制御します。詳細については、「クエリストアの使用シナリオ」を参照してください。

ON

クエリのストアを有効にします。

クエリストアヒント、CE フィードバック、並列処理の程度 (DOP) フィードバック、メモリ付与フィードバック (MGF) 永続化など、SQL Server 2022 (16.x) の多くの新しいパフォーマンス機能ではクエリストアを有効にする必要がありました。他の SQL Server インスタンスから復元されたデータベースと、インプレースアップグレードから SQL Server 2022 (16.x) にアップグレードされたデータベースの場合、これらのデータベースは以前のクエリストア設定を保持します。クエリストアが導入できるオーバーヘッドが懸念される場合、管理者は、でカスタムキャプチャポリシーを利用できます。 For examples of how to enable the Query Store with custom capture policy options, see the Examples section later in this article.
OFF [ ( FORCED ) ]

クエリのストアを無効にします。 FORCED は省略可能です。 FORCED は、実行中のすべてのクエリストアバックグラウンドタスクを中止し、クエリストアがオフになっている場合は同期フラッシュをスキップします。クエリストアが可能な限り早くシャットダウンされます。 FORCED は、SQL Server 2016 (13.x) SP2 CU14、SQL Server 2017 (14.x) CU21、SQL Server 2019 (15.x) CU6 以降のビルドに適用されます。

Note

Azure SQL Database でクエリストアを無効にすることはできません。 ALTER DATABASE [database] SET QUERY_STORE = OFF を実行すると、警告 'QUERY_STORE=OFF' is not supported in this version of SQL Server.が返されます。
CLEAR [ すべて ]

クエリ関連のデータをクエリストアから削除します。 ALL は省略可能です。 ALL を指定すると、クエリ関連のデータとメタデータがクエリストアから削除されます。

OPERATION_MODE { READ_ONLY |READ_WRITE }

クエリのストアの操作モードについて説明します。

READ_WRITE

クエリストアでクエリプランとランタイム実行の統計情報が収集され、保持されます。

READ_ONLY

クエリストアから情報を読み取ることはできますが、新しい情報は追加されません。クエリストアの最大発行領域が使い果たされた場合、クエリストアは操作モードを READ_ONLY に変更します。

CLEANUP_POLICY

クエリストアのデータ保持ポリシーを表します。 STALE_QUERY_THRESHOLD_DAYS により、クエリストアにクエリの情報が保持される日数が決定されます。 STALE_QUERY_THRESHOLD_DAYS is type bigint. 既定値は 30 です。

DATA_FLUSH_INTERVAL_SECONDS

クエリストアに書き込まれるデータがディスクに永続化される頻度を決定します。パフォーマンスを最適化するため、クエリストアで収集したデータは非同期的にディスクに書き込まれます。この非同期転送の頻度は、DATA_FLUSH_INTERVAL_SECONDS 引数を使用して構成します。 DATA_FLUSH_INTERVAL_SECONDS is type bigint. The default value is 900 (15 min).

MAX_STORAGE_SIZE_MB

クエリストアに発行される領域を示します。 MAX_STORAGE_SIZE_MB is type bigint. The default value is 100 MB for SQL Server (SQL Server 2016 (13.x) through SQL Server 2017 (14.x)). Starting with SQL Server 2019 (15.x), the default value is 1000 MB.

クエリストアがストレージサイズチェック間の MAX_STORAGE_SIZE_MB 制限に違反した場合、読み取り専用モードに移行します。 SIZE_BASED_CLEANUP_MODE が有効になっている場合は、MAX_STORAGE_SIZE_MB の制限を適用するクリーンアップメカニズムもトリガーされます。

十分な領域がクリアされると、クエリストアモードは自動的に読み取り/書き込みに切り替わります。

Important

If you think that your workload capture needs more than 10 GB of disk space, you should probably rethink and optimize your workload to reuse query plans (for example using forced parameterization, or adjust the Query Store configurations. SQL Server 2019 (15.x) 以降および Azure SQL データベースでは、QUERY_CAPTURE_MODE を CUSTOM に設定して、クエリキャプチャポリシーをさらに制御することができます。

INTERVAL_LENGTH_MINUTES

クエリのストアにランタイムの実行の統計データを集計する時間間隔を決定します。領域使用量を最適化するため、ランタイム統計情報ストアのランタイム実行統計情報は、一定の時間枠で集計されます。この固定間隔の構成に、INTERVAL_LENGTH_MINUTES 引数を使用します。 INTERVAL_LENGTH_MINUTES is type bigint. The default value is 60.

SIZE_BASED_CLEANUP_MODE { AUTO |OFF }

データの総量が最大サイズに近づいたときにクリーンアップを自動的にアクティブにするかどうかを制御します。

AUTO

Size-based cleanup is automatically activated when size on disk reaches 90% of MAX_STORAGE_SIZE_MB. サイズのクリーンアップでは、まず最も安価で最も古いクエリを削除します。 It stops at approximately 80% of MAX_STORAGE_SIZE_MB. この値は既定の構成値です。
OFF

サイズベースのクリーンアップは自動的にアクティブ化されません。

SIZE_BASED_CLEANUP_MODE is type nvarchar.

QUERY_CAPTURE_MODE { ALL |AUTO |CUSTOM |NONE }

現在アクティブなクエリのキャプチャモードを指定します。各モードでは、特定のクエリキャプチャポリシーを定義します。 QUERY_CAPTURE_MODE is type nvarchar.

Note

クエリキャプチャモードが ALL、AUTO、または CUSTOM に設定されている場合、カーソル、ストアドプロシージャ内のクエリ、およびネイティブコンパイル済みのクエリは常にキャプチャされます。

ALL

すべてのクエリをキャプチャします。 ALL is the default configuration value for SQL Server (SQL Server 2016 (13.x) through SQL Server 2017 (14.x)).
AUTO

実行の数とリソースの消費量に基づいて関連するクエリがキャプチャされます。これは SQL Server (SQL Server 2019 (15.x) 以降) と Azure SQL データベースの既定の構成値です。
NONE

新しいクエリのキャプチャを停止します。クエリストアは、既にキャプチャされたクエリのコンパイルとランタイムの統計を引き続き収集します。重要なクエリのキャプチャが間違う可能性があるため、この構成は慎重に使用してください。
CUSTOM

Applies to: SQL Server (Starting with SQL Server 2019 (15.x))

Allows control over the QUERY_CAPTURE_POLICY options. カスタムキャプチャポリシーは、ワークロードで最も重要なクエリをクエリストアでキャプチャするのに役立つ場合があります。カスタマイズ可能なオプションについては、<query_capture_policy_option_list> を参照してください。

MAX_PLANS_PER_QUERY

各クエリに対して保持するプランの最大数を定義します。 MAX_PLANS_PER_QUERY is type int. The default value is 200.

WAIT_STATS_CAPTURE_MODE { ON |OFF }

Applies to: SQL Server (Starting with SQL Server 2017 (14.x)))

待機統計をクエリごとにキャプチャするかどうかを制御します。

ON

クエリごとの待機統計情報がキャプチャされます。この値は既定の構成値です。
OFF

クエリごとの待機統計情報はキャプチャされません。

<query_capture_policy_option_list> :: =

Applies to: SQL Server (Starting with SQL Server 2019 (15.x))

Controls the Query Store capture policy options. STALE_CAPTURE_POLICY_THRESHOLD を除き、これらのオプションでは、定義された古いキャプチャポリシーのしきい値でクエリがキャプチャされるために必要な OR 条件が定義されます。

SQL Server 2019 (15.x) 以降、QUERY_CAPTURE_MODE = AUTO設定では、次のいずれかのしきい値に達したときにクエリストア詳細がキャプチャされます。

EXECUTION_COUNT = 30 実行 = 実行数
TOTAL_COMPILE_CPU_TIME_MS = 1 秒 = ミリ秒単位のコンパイル時間
TOTAL_EXECUTION_CPU_TIME_MS = 100 ms = ミリ秒単位の実行 CPU 時間

For example:

EXECUTION_COUNT = 30,
TOTAL_COMPILE_CPU_TIME_MS = 1000,
TOTAL_EXECUTION_CPU_TIME_MS = 100

QUERY_CAPTURE_MODE = CUSTOM でこれらのオプションをカスタマイズできます。

STALE_CAPTURE_POLICY_THRESHOLD = integer { DAYS | HOURS }

クエリをキャプチャすべきかどうかを決定する評価の間隔を定義します。既定値は 1 日で、1 時間から 7 日に設定できます。
EXECUTION_COUNT = integer

評価期間中、クエリを実行する回数を定義します。既定値は 30 です。これは、既定の古いキャプチャポリシーのしきい値に対して、クエリがクエリストアに保存されるためには、1 日で 30 回以上実行される必要があることを意味します。 EXECUTION_COUNT is type int.
TOTAL_COMPILE_CPU_TIME_MS = integer

評価期間中、クエリで使用されるコンパイル CPU 時間の合計経過時間を定義します。既定値は 1000 です。これは、既定の古いキャプチャポリシーのしきい値の場合、クエリがクエリストアに保存されるためには、1 日でクエリのコンパイル時に費やされる CPU 時間の合計が 1 秒以上である必要があることを意味します。 TOTAL_COMPILE_CPU_TIME_MS is type int.
TOTAL_EXECUTION_CPU_TIME_MS = integer

評価期間中、クエリによって使用される実行 CPU の合計経過時間を定義します。既定値は 100 です。これは、既定の古いキャプチャポリシーのしきい値に対して、クエリがクエリストアに保存されるためには、1 日で実行に費やされる CPU 時間の合計が 100 ミリ秒以上である必要があることを意味します。 TOTAL_EXECUTION_CPU_TIME_MS is type int.

<recovery_option> ::=

Applies to: SQL Server

データベース復旧オプションおよびディスク I/O エラーチェックを制御します。

FULL

メディア障害が発生した後に、トランザクションログのバックアップを使用して、完全復旧を行います。データファイルが破損した場合、メディアの復旧によって、コミットされたすべてのトランザクションを復元できます。 For more information, see Recovery models.
BULK_LOGGED

メディア障害が発生した後に復旧が行われます。特定の大規模操作または一括操作に使用するログ領域が最も少なく、パフォーマンスが最もよくなる方法で実行されます。最小ログ記録できる操作の詳細については、「トランザクションログ」を参照してください。 BULK_LOGGED 復旧モデルでは、これらの操作に関するログ記録は最小になります。 For more information, see Recovery models.
SIMPLE

最小のログ領域を使用する、単純なバックアップ方法が実行されます。ログ領域は、サーバー障害の復旧での使用が終わると自動的に再利用できるようになります。 For more information, see Recovery models.

Important

単純復旧モデルは、他の 2 つのモデルよりも管理が簡単ですが、データファイルが破損した場合にデータが失われる危険性が高くなります。前回のデータベースのバックアップ作成や差分バックアップ作成の後に行った変更はすべて失われるため、手作業で入力し直す必要があります。

既定の復旧モデルは、model システムデータベースの復旧モデルによって決定されます。 For more information about selecting the appropriate recovery model, see Recovery models.

You can determine this option's status by examining the recovery_model and recovery_model_desc columns in the sys.databases catalog view. You can also determine the status by examining the Recovery property of the DATABASEPROPERTYEX function.

TORN_PAGE_DETECTION { ON |OFF }

ON

データベースエンジンによって、不完全なページを検出できます。
OFF

データベースエンジンによって、不完全なページを検出できません。

Important

構文構造 TORN_PAGE_DETECTION ON | OFF は、将来のバージョンの SQL Server では削除される予定です。新しい開発作業ではこの構文構造の使用を避け、現在この構文構造を使用しているアプリケーションは修正するようにしてください。代わりに、PAGE_VERIFY オプションを使用してください。

PAGE_VERIFY { CHECKSUM |TORN_PAGE_DETECTION |NONE }

ディスク I/O パスのエラーが原因で破損したデータベースページを検出します。ディスク I/O パスのエラーは、データベース破損問題の原因となる可能性があります。このようなエラーは、主にページがディスクに書き込まれている最中に発生した電源障害やディスクのハードウェア障害によって引き起こされます。

CHECKSUM

ページ全体の内容についてチェックサムを計算し、ページがディスクに書き込まれるときに、その値をページヘッダーに格納します。ページがディスクから読み取られるときに、チェックサムが再計算され、ページヘッダーに格納されているチェックサムの値と比較されます。両方の値が一致しない場合は、SQL Server エラーログと Windows イベントログの両方に、エラーメッセージ 824 (チェックサムエラーを示す) がレポートされます。チェックサムエラーは、I/O パスに問題があることを示します。根本的な原因を確認するには、ハードウェア、ファームウェアドライバー、BIOS、フィルタードライバー (ウイルス対策ソフトウェアなど)、およびその他の I/O パスコンポーネントを点検する必要があります。
TORN_PAGE_DETECTION

8 KB のデータベースページに含まれる 512 バイトのセクターごとに特定の 2 ビットパターンを保存し、ページがディスクに書き込まれるときに、データベースページヘッダーに格納します。そのページがディスクから読み取られるときに、ページヘッダーに保存されている各セクターの破損ビットと、実際のページセクター情報とが比較されます。

値が一致しない場合は、ページの一部だけがディスクに書き込まれたことを示しています。この場合、SQL Server エラーログと Windows イベントログの両方に、エラーメッセージ 824 (破損ページエラーを示す) がレポートされます。ページの不完全書き込みにより破損したページは、通常はデータベース復旧時に検出されます。ただし、その他の I/O パス障害によっても、破損ページが発生する可能性があります。
NONE

データベースページの書き込みでは、CHECKSUM 値やTORN_PAGE_DETECTION値は生成されません。ページヘッダーに CHECKSUM またはTORN_PAGE_DETECTION値が存在する場合でも、SQL Server は読み取り中にチェックサムまたは破損ページを検証しません。

PAGE_VERIFY オプションを使用する場合は、次に示す重要な点を考慮してください。

The default is CHECKSUM.
ユーザーデータベースまたはシステムデータベースを SQL Server 2005 (9.x) 以降のバージョンにアップグレードしても、PAGE_VERIFY 値 (NONE または TORN_PAGE_DETECTION) は変更されません。 CHECKSUM に変更することをお勧めします。

Note

SQL Server の以前のバージョンでは、PAGE_VERIFY データベースオプションは tempdb データベースについては NONE に設定されており、変更できません。 SQL Server 2008 (10.0.x) 以降では、SQL Server の新規インストールに対する tempdb データベースの既定値は CHECKSUM です。インストール済みの SQL Server をアップグレードした場合、既定値は NONE のままです。このオプションは変更できます。 tempdb データベースでは CHECKSUM を使用することをお勧めします。
TORN_PAGE_DETECTION使用するリソースは少なくなりますが、CHECKSUM 保護のサブセットは最小限に抑えられます。
PAGE_VERIFY は、データベースをオフラインにしたり、データベースをロックしたりなど、そのデータベース上でのコンカレンシーを妨げるような措置を取らずに設定できます。
CHECKSUM は、TORN_PAGE_DETECTION と共存できません。両方のオプションを同時に有効化することはできません。

破損ページまたはチェックサムエラーが検出された場合には、データを復元することで復旧できます。障害がインデックスページだけに限られていれば、インデックスを再構築することで復旧できる可能性があります。チェックサムエラーが発生した場合、影響を受けるデータベースページの種類を判別するには、DBCC CHECKDB を実行します。 For more information about restore options, see RESTORE Arguments. データを復元するとデータ破損の問題が解決されますが、エラーが続かないように、根本原因 (ディスクハードウェアの障害など) をできるだけ早く診断して修正する必要があります。

SQL Server は、チェックサム、破損ページ、またはその他の I/O エラーで失敗した読み取りを 4 回再試行します。いずれかの再試行で読み取りに成功した場合には、エラーログにメッセージが書き込まれます。読み取りをトリガーしたコマンドは続行されます。再試行が失敗した場合、コマンドはエラーメッセージ 824 で失敗します。

エラーメッセージ 823、824、および 825 の詳細については、以下を参照してください。

MSSQLSERVER エラー 823 のトラブルシューティング
MSSQLSERVER エラー 824 のトラブルシューティング
MSSQLSERVER エラー 825 (読み取り再試行)のトラブルシューティングを行います。

The current setting of this option can be determined by examining the page_verify_option column in the sys.databases catalog view or the IsTornPageDetectionEnabled property of the DATABASEPROPERTYEX function.

<remote_data_archive_option> ::=

Applies to: SQL Server (Starting with SQL Server 2016 (13.x))

そのデータベースについて Stretch Database を有効または無効にします。 For more info, see Stretch Database.

Important

拡張データベースは、SQL Server 2022 (16.x) および Azure SQL Database では非推奨になります。この機能は、データベースエンジンの将来のバージョンで削除される予定です。新規の開発作業ではこの機能を使用しないようにし、現在この機能を使用しているアプリケーションは修正することを検討してください。

REMOTE_DATA_ARCHIVE = { ON ( SERVER = <server_name>, { CREDENTIAL = <db_scoped_credential_name> |FEDERATED_SERVICE_ACCOUNT = ON |OFF } ) |オフ

ON

データベースの Stretch Database を有効にします。追加の前提条件を含む詳細については、「データベースに対して Stretch Database を有効にする」を参照してください。

テーブルの Stretch Database を有効にするには db_owner 権限が必要です。テーブルの Stretch Database を有効にするには db_owner 権限と CONTROL DATABASE 権限が必要です。
- SERVER = <server_name>
  
  Azure サーバーのアドレスを指定します。名前の .database.windows.net の部分を含めます。たとえば、「 MyStretchDatabaseServer.database.windows.net 」のように入力します。
- CREDENTIAL = <db_scoped_credential_name>
  
  SQL Server のインスタンスが Azure サーバーに接続するために使用する、データベーススコープ資格情報を指定します。このコマンドを実行する前に、資格情報が存在することを確認してください。詳しくは、「CREATE DATABASE SCOPED CREDENTIAL」をご覧ください。
- FEDERATED_SERVICE_ACCOUNT = { ON |OFF }
  
  以下の条件をすべて満たす場合、オンプレミスの SQL Server のフェデレーションサービスアカウントを使用して、リモート Azure サーバーと通信できます。
  - SQL Server のインスタンスを実行しているサービスアカウントがドメインアカウントである。
  - ドメインアカウントは、Active Directory が Microsoft Entra ID とフェデレーションされているドメインに属しています。
  - Microsoft Entra 認証をサポートするように、リモート Azure サーバーが構成されている。
  - SQL Server のインスタンスを実行しているサービスアカウントが、リモート Azure サーバー上で dbmanager または sysadmin アカウントとして構成されている。
  フェデレーションサービスアカウントを ON に指定している場合は、CREDENTIAL 引数も指定できません。 OFF を指定する場合は、CREDENTIAL 引数を指定してください。
OFF

データベースの Stretch Database は無効になります。詳細については、「 Stretch Database を無効にして、リモートデータを戻す」を参照してください。

データベースの Stretch Database を無効にするには、Stretch Database に対して有効なテーブルがデータベースに含まれていない状態にする必要があります。 Stretch Database を無効にすると、データ移行は停止します。また、クエリ結果にリモートテーブルの結果が含まれなくなります。

Stretch Database を無効にしても、リモートデータベースは削除されません。リモートデータベースを削除するには、Azure portal を使用してそれを削除します。

PERSISTENT_LOG_BUFFER

Applies to: SQL Server 2017 (14.x) and later.

このオプションを指定すると、トランザクションログバッファーは、永続ログバッファーとも呼ばれるストレージクラスメモリ (不揮発性ストレージNVDIMM-N) によってサポートされるディスクデバイス上にあるボリュームに作成されます。詳細については、「ストレージクラスメモリを使用したトランザクションコミット待機時間の高速化の」および「永続ログバッファーをデータベースに追加する」を参照してください。

<service_broker_option> ::=

Applies to: SQL Server

次の Service Broker オプション (メッセージ配信の有効化または無効化、新しい Service Broker 識別子の設定、メッセージ交換の優先度の ON または OFF への設定) を制御します。

ENABLE_BROKER

指定したデータベースに対して Service Broker を有効にします。 Message delivery is started, and the is_broker_enabled flag is set to true in the sys.databases catalog view. データベースは、既存の Service Broker 識別子を保持します。 Service Broker は、データベースがデータベースミラーリング構成でプリンシパルである間は有効にすることができません。

Note

ENABLE_BROKER には排他的データベースロックが必要です。他のセッションがデータベース内のリソースをロックしている場合、ENABLE_BROKERは他のセッションがロックを解放するまで待機します。ユーザーデータベースで Service Broker を有効にするには、データベースをシングルユーザーモードに設定するなどして、他のセッションがそのデータベースを使用しないようにしてから ALTER DATABASE SET ENABLE_BROKER ステートメントを実行する必要があります。 msdb データベースで Service Broker を有効にするには、SQL Server で必要なロックを取得できるように、まず Service Broker エージェントを停止します。

DISABLE_BROKER

指定したデータベースに対して Service Broker を無効にします。 Message delivery is stopped, and the is_broker_enabled flag is set to false in the sys.databases catalog view. データベースは、既存の Service Broker 識別子を保持します。

NEW_BROKER

データベースは新しいブローカー識別子を受信するように指定します。データベースは、新しい Service Broker として動作します。そのため、データベースにおける既存のすべてのメッセージ交換は、終了ダイアログメッセージを生成せずに、直ちに削除されます。古い Service Broker 識別子を参照するルートは、新しい識別子を使用して作成し直す必要があります。

ERROR_BROKER_CONVERSATIONS

Service Broker メッセージ配信を有効にします。この設定は、データベースの既存の Service Broker 識別子を保持します。 Service Broker により、データベース内のメッセージ交換がすべて終了し、エラーが返されます。この設定により、アプリケーションは既存のメッセージ交換に対して通常のクリーンアップを実行できるようになります。

HONOR_BROKER_PRIORITY { ON |OFF }

ON

メッセージ交換に割り当てられた優先度が、送信操作で考慮されます。優先度が高いメッセージ交換のメッセージは、低い優先度が割り当てられたメッセージ交換のメッセージよりも先に送信されます。
OFF

すべてのメッセージ交換が既定の優先度レベルを持つと見なして、送信操作が実行されます。

新しいダイアログや、送信待ちメッセージがないダイアログでは、HONOR_BROKER_PRIORITY オプションに対する変更が直ちに有効になります。 ALTER DATABASE の実行時に送信されるメッセージを含むダイアログでは、ダイアログの一部のメッセージが送信されるまで、新しい設定は取得されません。すべてのダイアログで新しい設定が使用されるようになるまでの時間は、場合により大幅に異なります。

The current setting of this property is reported in the is_broker_priority_honored column in the sys.databases catalog view.

<snapshot_option> ::=

トランザクション分離レベルを計算します。

ALLOW_SNAPSHOT_ISOLATION { ON |OFF }

ON

データベースレベルでのスナップショットオプションを有効にします。有効にした場合、スナップショット分離を使用するトランザクションがなくても、DML ステートメントによって、行バージョンの生成が開始されます。このオプションを有効にすると、トランザクションで SNAPSHOT トランザクション分離レベルを指定できます。 SNAPSHOT 分離レベルでトランザクションが実行されると、すべてのステートメントはトランザクション開始時のデータのスナップショットを参照します。 SNAPSHOT 分離レベルで実行されているトランザクションが複数のデータベースのデータにアクセスする場合は、すべてのデータベースで ALLOW_SNAPSHOT_ISOLATION が ON に設定されている必要があります。ALLOW_SNAPSHOT_ISOLATION が OFF になっているデータベース内のテーブルにアクセスする場合は、トランザクション内の各ステートメントで、FROM 句内のすべての参照に対してロックヒントを使用する必要があります。
OFF

データベースレベルでのスナップショットオプションを無効にします。トランザクションでは、SNAPSHOT トランザクション分離レベルを指定できません。

ALLOW_SNAPSHOT_ISOLATION を新しい状態に (ON から OFF へ、または OFF から ON へ) 設定した場合、ALTER DATABASE は、データベース内にあるすべての既存のトランザクションがコミットされるまで、呼び出し元に制御を返しません。データベースが既に ALTER DATABASE ステートメントで指定した状態にある場合には、制御は呼び出し元に直ちに返されます。 If the ALTER DATABASE statement doesn't return quickly, use sys.dm_tran_active_snapshot_database_transactions to determine whether there are long-running transactions. ALTER DATABASE ステートメントが取り消された場合、データベースは、ALTER DATABASE が開始された時点での状態に留まります。 The sys.databases catalog view indicates the state of snapshot-isolation transactions in the database. snapshot_isolation_state_desc = IN_TRANSITION_TO_ONの場合、コマンド ALTER DATABASE ... ALLOW_SNAPSHOT_ISOLATION OFF 6 秒間一時停止し、操作を再試行します。

データベースが OFFLINE の場合には、ALLOW_SNAPSHOT_ISOLATION の状態を変更できません。

READ_ONLY データベースでALLOW_SNAPSHOT_ISOLATIONを設定した場合、データベースが後で READ_WRITE に設定されている場合、設定は保持されます。

master、model、msdb、および tempdb データベースでは、ALLOW_SNAPSHOT_ISOLATION 設定を変更できます。 tempdb でこの設定を変更すると、この設定は、データベースエンジンのインスタンスが停止および再起動されるたびに保持されます。 model でこの設定を変更すると、この設定は、作成されたすべての新しいデータベース (tempdb を除く) の既定値となります。

master および msdb データベースでは、このオプションは既定で ON になります。

The current setting of this option can be determined by examining the snapshot_isolation_state column in the sys.databases catalog view.

READ_COMMITTED_SNAPSHOT { ON |OFF }

ON

データベースレベルでの Read Committed スナップショットオプションを有効にします。有効にした場合、スナップショット分離を使用するトランザクションがなくても、DML ステートメントによって、行バージョンの生成が開始されます。このオプションを有効にすると、READ COMMITTED 分離レベルを指定しているトランザクションは、ロックではなく、行のバージョン管理を使用します。トランザクションが READ COMMITTED 分離レベルで実行されている場合、すべてのステートメントは、ステートメントの開始時に存在していたデータのスナップショットを参照します。
OFF

データベースレベルでの Read Committed スナップショットオプションを無効にします。 READ COMMITTED 分離レベルを指定しているトランザクションは、ロックを使用します。

READ_COMMITTED_SNAPSHOT を ON または OFF に設定するには、ALTER DATABASE コマンドを実行している接続以外にデータベースへのアクティブな接続が存在しないようにする必要があります。データベースがシングルユーザーモードになっている必要はありません。データベースが OFFLINE の場合には、このオプションの状態は変更できません。

READ_ONLY データベースでREAD_COMMITTED_SNAPSHOTを設定した場合、データベースが後で READ_WRITE に設定されたときに設定が保持されます。

master、tempdb、または msdb システムデータベースでは、READ_COMMITTED_SNAPSHOT を ON に設定することはできません。 model でこの設定を変更すると、この設定は、作成されたすべての新しいデータベース (tempdb を除く) の既定値となります。

The current setting of this option can be determined by examining the is_read_committed_snapshot_on column in the sys.databases catalog view.

Warning

DURABILITY = SCHEMA_ONLYでテーブルが作成され、その後 ALTER DATABASEを使用して READ_COMMITTED_SNAPSHOT 変更されると、テーブル内のデータは失われます。

MEMORY_OPTIMIZED_ELEVATE_TO_SNAPSHOT { ON |OFF }

Applies to: SQL Server (Starting with SQL Server 2014 (12.x))

ON

トランザクション分離レベルが SNAPSHOT より低い分離レベルに設定されている場合は、メモリ最適化テーブル上で解釈されたすべての Transact-SQL 操作が SNAPSHOT 分離レベルで実行されます。 SNAPSHOT よりも低い分離レベルの例として、READ COMMITTED、READ UNCOMMITTEDREAD があります。このような操作は、トランザクション分離レベルがセッションレベルで明示的に設定されているか、既定値が暗黙的に使用されるかに関係なく実行されます。
OFF

メモリ最適化テーブル上で解釈された Transact-SQL 操作のトランザクション分離レベルは引き上げられません。

データベースが OFFLINE の場合には、MEMORY_OPTIMIZED_ELEVATE_TO_SNAPSHOT の状態を変更できません。

既定のオプションは OFF です。

The current setting of this option can be determined by examining the is_memory_optimized_elevate_to_snapshot_on column in the sys.databases catalog view.

<sql_option> ::=

ANSI 準拠のオプションをデータベースレベルで制御します。

ANSI_NULL_DEFAULT { ON |OFF }

CREATE TABLE ステートメントまたは ALTER TABLE ステートメントで NULL を許可するかどうかが明示的に定義されていない場合に、列または CLR ユーザー定義型の既定値を NULL と NOT NULL のどちらにするかを指定します。制約で定義された列は、この設定が何であれ制約ルールに従います。

ON

未定義の列の既定値は NULL です。
OFF

未定義の列の既定値は NOT NULL です。

SET ステートメントを使用した接続レベルの設定は、ANSI_NULL_DEFAULT に関するデータベースレベルの既定の設定をオーバーライドします。既定では、ODBC クライアントと OLE DB クライアントは、セッションの ANSI_NULL_DEFAULT を ON に設定する接続レベルの SET ステートメントを発行します。 SQL Server のインスタンスに接続すると、クライアントはステートメントを実行します。 For more information, see SET ANSI_NULL_DFLT_ON.

ANSI 互換性を確保するために、データベースオプション ANSI_NULL_DEFAULT を ON に設定すると、データベースの既定値が NULL に変更されます。

You can determine this option's status by examining the is_ansi_null_default_on column in the sys.databases catalog view. You can also determine the status by examining the IsAnsiNullDefault property of the DATABASEPROPERTYEX function.

ANSI_NULLS { ON |OFF }

ON

NULL 値との比較結果は、すべて UNKNOWN になります。
OFF

Unicode 以外の値と null 値の比較結果は、両方の値が NULL である場合には TRUE になります。

Important

今後のバージョンの SQL Server では、ANSI_NULLS が常に ON になり、このオプションを明示的に OFF に設定するすべてのアプリケーションでエラーが発生します。新規の開発作業ではこの機能を使用しないようにし、現在この機能を使用しているアプリケーションは修正することを検討してください。

SET ステートメントを使用した接続レベルの設定は、ANSI_NULLS の既定のデータベース設定をオーバーライドします。既定では、ODBC クライアントと OLE DB クライアントは、セッションの ANSI_NULLS を ON に設定する接続レベルの SET ステートメントを発行します。 SQL Server のインスタンスに接続すると、クライアントはステートメントを実行します。 For more information, see SET ANSI_NULLS.

Important

SET ANSI_NULLS は、計算列やインデックス付きビューのインデックスを作成または変更する場合にも、ON に設定する必要があります。

You can determine this option's status by examining the is_ansi_nulls_on column in the sys.databases catalog view. You can also determine the status by examining the IsAnsiNullsEnabled property of the DATABASEPROPERTYEX function.

ANSI_PADDING { ON |OFF }

ON

比較を行う前に、文字列が同じ長さになるようにパディングされます。 Also padded to the same length before inserting to a varchar or nvarchar data type.
OFF

Inserts trailing blanks in character values into varchar or nvarchar columns. Also leaves trailing zeros in binary values that are inserted into varbinary columns. 列の長さに合わせるためにパディングされることはありません。

OFF を指定した場合、この設定は新しい列の定義にのみ影響します。

Important

今後のバージョンの SQL Server では、ANSI_PADDING が常に ON になり、このオプションを明示的に OFF に設定するすべてのアプリケーションでエラーが発生します。新規の開発作業ではこの機能を使用しないようにし、現在この機能を使用しているアプリケーションは修正することを検討してください。 ANSI_PADDING は常に ON に設定することをお勧めします。計算列やインデックス付きビューのインデックスを作成または操作するときには、ANSI_PADDING を ON に設定する必要があります。

char(n) and binary(n) columns that allow for nulls are padded to the column length when ANSI_PADDING is set to ON. ANSI_PADDING を OFF に設定すると、末尾の空白および 0 は切り捨てられます。 char(n) and binary(n) columns that don't allow nulls are always padded to the length of the column.

SET ステートメントを使用した接続レベルの設定は、ANSI_PADDING に関するデータベースレベルの既定の設定をオーバーライドします。既定では、ODBC クライアントと OLE DB クライアントは、セッションの ANSI_PADDING を ON に設定する接続レベルの SET ステートメントを発行します。 SQL Server のインスタンスに接続すると、クライアントはステートメントを実行します。 For more information, see SET ANSI_PADDING.

You can determine this option's status by examining the is_ansi_padding_on column in the sys.databases catalog view. You can also determine the status by examining the IsAnsiPaddingEnabled property of the DATABASEPROPERTYEX function.

ANSI_WARNINGS { ON |OFF }

ON

0 除算などの状態になったときに、エラーまたは警告が発行されます。集計関数に NULL 値が出現した場合にも、エラーと警告が発行されます。
OFF

0 除算などの条件が発生しても、警告は発行されず、NULL 値が返されます。

Important

SET ANSI_WARNINGS は、計算列やインデックス付きビューのインデックスを作成または変更する場合には、ON に設定する必要があります。

SET ステートメントを使用した接続レベルの設定は、ANSI_WARNINGS の既定のデータベース設定をオーバーライドします。既定では、ODBC クライアントと OLE DB クライアントは、セッションの ANSI_WARNINGS を ON に設定する接続レベルの SET ステートメントを発行します。 SQL Server のインスタンスに接続すると、クライアントはステートメントを実行します。 For more information, see SET ANSI_WARNINGS.

You can determine this option's status by examining the is_ansi_warnings_on column in the sys.databases catalog view. You can also determine the status by examining the IsAnsiWarningsEnabled property of the DATABASEPROPERTYEX function.

ARITHABORT { ON |OFF }

ON

クエリ実行中にオーバーフローエラーまたは 0 除算エラーが発生した場合に、クエリを終了します。
OFF

このようなエラーのいずれかが発生した場合に警告メッセージが表示されます。警告が表示された場合でも、クエリ、バッチ、またはトランザクションは、エラーが発生しなかったかのように処理を続行します。

Important

SET ARITHABORT は、計算列やインデックス付きビューのインデックスを作成または変更する場合には、ON に設定する必要があります。

You can determine this option's status by examining the is_arithabort_on column in the sys.databases catalog view. You can also determine the status by examining the IsArithmeticAbortEnabled property of the DATABASEPROPERTYEX function.

COMPATIBILITY_LEVEL = { 170 | 160 | 150 | 140 | 130 | 120 | 110 | 100 }

詳細については、ALTER DATABASE 互換性レベルを参照してください。

CONCAT_NULL_YIELDS_NULL { ON |OFF }

ON

オペランドのいずれかが NULL の場合、連結操作の結果は NULL になります。たとえば、文字列 "This is" と NULL を連結すると、"This is" という値ではなく NULL という値が返されます。
OFF

null 値は空の文字列として扱われます。

Important

CONCAT_NULL_YIELDS_NULL は、計算列やインデックス付きビューのインデックスを作成または変更する場合には、ON に設定する必要があります。

今後のバージョンの SQL Server では、CONCAT_NULL_YIELDS_NULL が常に ON になり、このオプションを明示的に OFF に設定するすべてのアプリケーションでエラーが発生します。新規の開発作業ではこの機能を使用しないようにし、現在この機能を使用しているアプリケーションは修正することを検討してください。

SET ステートメントを使用した接続レベルの設定は、CONCAT_NULL_YIELDS_NULL の既定のデータベース設定をオーバーライドします。既定では、ODBC クライアントと OLE DB クライアントは、SQL Server のインスタンスに接続するときに、セッションの CONCAT_NULL_YIELDS_NULL を ON に設定する接続レベルの SET ステートメントを実行します。 For more information, see SET CONCAT_NULL_YIELDS_NULL.

You can determine this option's status by examining the is_concat_null_yields_null_on column in the sys.databases catalog view. You can also determine the status by examining the IsNullConcat property of the DATABASEPROPERTYEX function.

NUMERIC_ROUNDABORT { ON |OFF }

ON

式の精度が低下した場合にエラーが生成されます。
OFF

有効桁数の損失が発生してもエラーメッセージが生成されず、結果を格納する列または変数の有効桁数に丸められます。

Important

NUMERIC_ROUNDABORT は、計算列やインデックス付きビューのインデックスを作成または変更する場合は、OFF に設定する必要があります。

You can determine the status of this option in the is_numeric_roundabort_on column in the sys.databases catalog view. You can also determine the status by examining the IsNumericRoundAbortEnabled property of the DATABASEPROPERTYEX function.

QUOTED_IDENTIFIER { ON |OFF }

ON

識別子を囲む二重引用符を使用できます。

二重引用符で囲まれた文字列はすべて、オブジェクト識別子として解釈されます。引用符で囲まれた識別子は、Transact-SQL の識別子の規則に従う必要はありません。これはキーワードにすることができます。また、Transact-SQL 識別子では許可されない文字を含めることができます。二重引用符 (") が識別子の一部である場合は、2 つの二重引用符 ("") で表すことができます。
OFF

識別子を引用符で囲むことができず、Transact-SQL の識別子に関するすべての規則に従う必要があります。リテラルは単一引用符と二重引用符のどちらで区切ることもできます。

SQL Server では識別子を角かっこ ([ と ]) で囲むこともできます。角かっこで囲まれた識別子は、QUOTED_IDENTIFIER 設定に関係なくいつでも使用できます。 For more information, see Database identifiers.

このオプションは、テーブルの作成時に、常に ON としてテーブルのメタデータに格納されます。このオプションは、テーブルの作成時にオプションが OFF に設定された場合でも格納されます。

SET ステートメントを使用した接続レベルの設定は、QUOTED_IDENTIFIER の既定のデータベース設定をオーバーライドします。既定では、ODBC クライアントと OLE DB QUOTED_IDENTIFIER を ON に設定する接続レベルの SET ステートメントを発行します。 SQL Server のインスタンスに接続すると、クライアントはステートメントを実行します。 For more information, see SET QUOTED_IDENTIFIER.

You can determine this option's status by examining the is_quoted_identifier_on column in the sys.databases catalog view. You can also determine the status by examining the IsQuotedIdentifiersEnabled property of the DATABASEPROPERTYEX function.

RECURSIVE_TRIGGERS { ON |OFF }

ON

AFTER トリガーの再帰呼び出しを実行できるようになります。
OFF

You can determine this option's status by examining the is_recursive_triggers_on column in the sys.databases catalog view. You can also determine the status by examining the IsRecursiveTriggersEnabled property of the DATABASEPROPERTYEX function.

Note

RECURSIVE_TRIGGERS に OFF に設定されている場合、直接再帰呼び出しのみが回避されます。間接再帰呼び出しを無効にするには、nested triggers サーバーオプションを 0 に設定する必要があります。

You can determine this option's status by examining the is_recursive_triggers_on column in the sys.databases catalog view or the IsRecursiveTriggersEnabled property of the DATABASEPROPERTYEX function.

<suspend_for_snapshot_backup> ::=

Applies to: SQL Server (Starting with SQL Server 2022 (16.x))

スナップショットバックアップのためにデータベースを一時停止します。 1 つ以上のデータベースのグループを定義できます。コピーのみのモードを指定できます。

SET SUSPEND_FOR_SNAPSHOT_BACKUP = { ON | OFF }

データベースを一時停止または一時停止解除します。 Default OFF.

MODE = COPY_ONLY

Optional. COPY_ONLY モードを使用します。

<target_recovery_time_option> ::=

Applies to: SQL Server (Starting with SQL Server 2012 (11.x))

間接的なチェックポイントの生成頻度をデータベースごとに指定します。 Starting with SQL Server 2016 (13.x) the default value for new databases is 1 minute, which indicates the database uses indirect checkpoints. 古いバージョンの場合、既定値は 0 です。これは、サーバーインスタンスの回復間隔の設定に依存する自動チェックポイントがデータベースで使用されることを示します。 Microsoft では、ほとんどのシステムに対して 1 分をお勧めします。

TARGET_RECOVERY_TIME = target_recovery_time { SECONDS | MINUTES }

target_recovery_time

クラッシュが発生した場合、指定したデータベースが復旧に要する時間の上限を指定します。 target_recovery_time is type int.
SECONDS

Indicates that target_recovery_time is expressed as the number of seconds.
MINUTES

Indicates that target_recovery_time is expressed as the number of minutes.

For more information about indirect checkpoints, see Database checkpoints.

OPTIMIZED_LOCKING { ON |OFF }

Applies to: SQL Server (Starting with SQL Server 2025 (17.x) Preview)

Enables optimized locking. 最適化されたロックは既定で OFF に設定されています。

OPTIMIZED_LOCKINGをオンまたはオフに設定するには、ALTER DATABASE コマンドを実行する接続を除き、データベースへのアクティブな接続が存在しない必要があります。データベースがシングルユーザーモードになっている必要はありません。データベースが ONLINE でない限り、このオプションの状態を変更することはできません。

WITH <termination> ::=

データベースの状態が変更されるときに、未完了のトランザクションをいつロールバックするかを指定します。データベースがロックされている場合に終了句を省略すると、ALTER DATABASE ステートメントが無限に待機します。指定できる終了句は 1 つのみであり、SET 句の後に指定します。

Note

すべてのデータベースオプションで WITH <termination> 句が使用できるわけではありません。 For more information, see the table under Setting options of the "Remarks" section of this article.

ROLLBACK AFTER integer [SECONDS] | ROLLBACK IMMEDIATE

指定した秒数の後、または直ちにロールバックするかどうかを指定します。
NO_WAIT

要求されたデータベースの状態またはオプションの変更をすぐに完了できない場合に要求が失敗することを指定します。すぐに完了とは、トランザクションが自身のコミットまたはロールバック処理を待機しないことを意味します。

Set options

To retrieve current settings for database options, use the sys.databases catalog view or DATABASEPROPERTYEX

データベースオプションを設定すると、新しい設定は直ちに有効になります。

新しく作成されるすべてのデータベースについて、任意のデータベースオプションの既定値を変更できます。これを実行するには、model データベース内の適切なデータベースオプションを変更します。

データベースオプションの中には、WITH <termination> 句を使用しないものや、他のオプションと組み合わせて指定できないものもあります。次の表に、このようなオプションと、それらのオプションと終了状態を示します。

Options category	他のオプションとの組み合わせの可否	WITH <termination> 句の使用の可否
<db_state_option>	Yes	Yes
<db_user_access_option>	Yes	Yes
<db_update_option>	Yes	Yes
<delayed_durability_option>	Yes	Yes
<external_access_option>	Yes	No
<cursor_option>	Yes	No
<auto_option>	Yes	No
<sql_option>	Yes	No
<recovery_option>	Yes	No
<target_recovery_time_option>	No	Yes
<database_mirroring_option>	No	No
ALLOW_SNAPSHOT_ISOLATION	No	No
READ_COMMITTED_SNAPSHOT	No	Yes
MEMORY_OPTIMIZED_ELEVATE_TO_SNAPSHOT	Yes	Yes
<service_broker_option>	Yes	No
DATE_CORRELATION_OPTIMIZATION	Yes	Yes
<parameterization_option>	Yes	Yes
<change_tracking_option>	Yes	Yes
<db_encryption_option>	Yes	No
<accelerated_database_recovery>	No	Yes
<optimized_locking>	No	Yes

SQL Server のインスタンスのプランキャッシュは、次のいずれかのオプションを設定することにより消去されます。

OFFLINE

ONLINE

MODIFY_NAME

COLLATE

READ_ONLY

READ_WRITE

FILEGROUP の既定値を変更する

FILEGROUP READ_WRITEを修正する

"FILEGROUP を READ_ONLY に変更する"

プランキャッシュは、次のシナリオでもフラッシュされます。

AUTO_CLOSE データベースオプションが ON に設定されている。データベースを参照 (または使用) するユーザー接続が 1 つも存在しない場合、バックグラウンドタスクがデータベースを自動的に閉じてシャットダウンすることを試みます。
既定のオプションが設定されているデータベースに対して複数のクエリを実行した。データベースはその後削除されます。
ソースデータベースのデータベーススナップショットが削除された。
データベースのトランザクションログを正常に再構築した。
データベースのバックアップを復元した。
データベースをデタッチした。

プランキャッシュが消去されると、後続のすべての実行プランが再コンパイルされ、場合によっては、クエリパフォーマンスが一時的に急激に低下します。プランキャッシュ内のキャッシュストアが消去されるたびに、SQL Server エラーログに SQL Server has encountered %d occurrence(s) of cachestore flush for the '%s' cachestore (part of plan cache) due to some database maintenance or reconfigure operations という通知メッセージが記録されます。このメッセージは、5 分以内にキャッシュがフラッシュされる限り、5 分間隔でログに記録されます。

Examples

A. データベースのオプションを設定する

次の例では、AdventureWorks2022 サンプルデータベースに対して、復旧モデルおよびデータページ検証のオプションを設定します。

USE master;
GO
ALTER DATABASE [database_name]
SET RECOVERY FULL PAGE_VERIFY CHECKSUM;
GO

B. データベースを READ_ONLY に設定する

データベースまたはファイルグループの状態を READ_ONLY または READ_WRITE に変更するには、データベースに対する排他的アクセスが必要です。次の例では、排他的アクセスを取得するために、データベースを SINGLE_USER モードに設定します。次に、AdventureWorks2022 データベースの状態を READ_ONLY に設定し、データベースへのアクセス権をすべてのユーザーに戻します。

Note

この例では、最初の WITH ROLLBACK IMMEDIATE ステートメントで、終了オプション ALTER DATABASE を使用しています。不完全なトランザクションはすべてロールバックされ、AdventureWorks2022 データベースへのその他の接続は直ちに切断されます。

USE master;
GO
ALTER DATABASE [database_name]
SET SINGLE_USER
WITH ROLLBACK IMMEDIATE;
GO
ALTER DATABASE [database_name]
SET READ_ONLY
GO
ALTER DATABASE [database_name]
SET MULTI_USER;
GO

C. データベースのスナップショット分離を有効にする

次の例では、AdventureWorks2022 データベースに対する SNAPSHOT 分離フレームワークオプションを有効にします。

USE [database_name];
USE master;
GO
ALTER DATABASE [database_name]
SET ALLOW_SNAPSHOT_ISOLATION ON;
GO
-- Check the state of the snapshot_isolation_framework
-- in the database.
SELECT name, snapshot_isolation_state,
    snapshot_isolation_state_desc AS description
FROM sys.databases
WHERE name = N'[database_name]';
GO

結果セットは、SNAPSHOT 分離フレームワークが有効であることを示しています。

name	snapshot_isolation_state	description
[database_name]	1	ON

D. 変更の追跡を有効化、変更、または無効化する

次の例では、AdventureWorks2022 データベースで変更の追跡を有効にし、保有期間を 2 日に設定します。

ALTER DATABASE [database_name]
SET CHANGE_TRACKING = ON
(AUTO_CLEANUP = ON, CHANGE_RETENTION = 2 DAYS);

次の例では、保有期間を 3 日に変更する方法を示します。

ALTER DATABASE [database_name]
SET CHANGE_TRACKING (CHANGE_RETENTION = 3 DAYS);

次の例では、AdventureWorks2022 データベースで変更の追跡を無効にする方法を示します。

ALTER DATABASE [database_name]
SET CHANGE_TRACKING = OFF;

E. クエリストアを有効にする

Applies to: SQL Server (Starting with SQL Server 2016 (13.x))

次の例では、クエリストアを有効にし、そのパラメーターを構成します。

ALTER DATABASE [database_name]
SET QUERY_STORE = ON
    (
      OPERATION_MODE = READ_WRITE,
      CLEANUP_POLICY = ( STALE_QUERY_THRESHOLD_DAYS = 90 ),
      DATA_FLUSH_INTERVAL_SECONDS = 900,
      QUERY_CAPTURE_MODE = AUTO,
      MAX_STORAGE_SIZE_MB = 1024,
      INTERVAL_LENGTH_MINUTES = 60
    );

F. 待機統計を使ってクエリストアを有効にする

Applies to: SQL Server (Starting with SQL Server 2017 (14.x))

次の例では、クエリストアを有効にし、そのパラメーターを構成します。

ALTER DATABASE [database_name]
SET QUERY_STORE = ON
    (
      OPERATION_MODE = READ_WRITE,
      CLEANUP_POLICY = ( STALE_QUERY_THRESHOLD_DAYS = 90 ),
      DATA_FLUSH_INTERVAL_SECONDS = 900,
      MAX_STORAGE_SIZE_MB = 1024,
      INTERVAL_LENGTH_MINUTES = 60,
      SIZE_BASED_CLEANUP_MODE = AUTO,
      MAX_PLANS_PER_QUERY = 200,
      WAIT_STATS_CAPTURE_MODE = ON,
    );

G. カスタムキャプチャポリシーオプションを使ってクエリストアを有効にする

Applies to: SQL Server (Starting with SQL Server 2019 (15.x))

次の例では、クエリストアを有効にし、そのパラメーターを構成します。

ALTER DATABASE [database_name]
SET QUERY_STORE = ON
    (
      OPERATION_MODE = READ_WRITE,
      CLEANUP_POLICY = ( STALE_QUERY_THRESHOLD_DAYS = 90 ),
      DATA_FLUSH_INTERVAL_SECONDS = 900,
      MAX_STORAGE_SIZE_MB = 1024,
      INTERVAL_LENGTH_MINUTES = 60,
      SIZE_BASED_CLEANUP_MODE = AUTO,
      MAX_PLANS_PER_QUERY = 200,
      WAIT_STATS_CAPTURE_MODE = ON,
      QUERY_CAPTURE_MODE = CUSTOM,
      QUERY_CAPTURE_POLICY = (
        STALE_CAPTURE_POLICY_THRESHOLD = 24 HOURS,
        EXECUTION_COUNT = 30,
        TOTAL_COMPILE_CPU_TIME_MS = 1000,
        TOTAL_EXECUTION_CPU_TIME_MS = 100
      )
    );

SQL Server

* SQLデータベース *

SQL Managed Instance

Azure Synapse
Analytics

Microsoft Fabric

SQL Database

互換性レベルは SET オプションですが、ALTER DATABASE 互換性レベルで説明されています。

Note

Many database set options can be configured for the current session by using SET Statements and are often configured by applications when they connect. セッションレベルの SET オプションでは ALTER DATABASE SET の値がオーバーライドされます。次のセクションで説明されているデータベースオプションは、セッション用に設定できる値であり、他の SET オプションの値は明示的に指定されていません。

Syntax

ALTER DATABASE { database_name | Current }
SET
{
    <option_spec> [ ,...n ] [ WITH <termination> ]
}
;

<option_spec> ::=
{
    <auto_option>
  | <automatic_tuning_option>
  | <change_tracking_option>
  | <cursor_option>
  | <db_encryption_option>
  | <db_update_option>
  | <db_user_access_option>
  | <delayed_durability_option>
  | <parameterization_option>
  | <query_store_options>
  | <snapshot_option>
  | <sql_option>
  | <target_recovery_time_option>
  | <termination>
  | <temporal_history_retention>
}
;

<auto_option> ::=
{
    AUTO_CREATE_STATISTICS { OFF | ON [ ( INCREMENTAL = { ON | OFF } ) ] }
  | AUTO_SHRINK { ON | OFF }
  | AUTO_UPDATE_STATISTICS { ON | OFF }
  | AUTO_UPDATE_STATISTICS_ASYNC { ON | OFF }
}

<automatic_tuning_option> ::=
{
    AUTOMATIC_TUNING = { AUTO | INHERIT | CUSTOM }
  | AUTOMATIC_TUNING ( CREATE_INDEX = { DEFAULT | ON | OFF } )
  | AUTOMATIC_TUNING ( DROP_INDEX = { DEFAULT | ON | OFF } )
  | AUTOMATIC_TUNING ( FORCE_LAST_GOOD_PLAN = { DEFAULT | ON | OFF } )
}

<change_tracking_option> ::=
{
    CHANGE_TRACKING
    {
        = OFF
      | = ON [ ( <change_tracking_option_list > [,...n] ) ]
      | ( <change_tracking_option_list> [,...n] )
    }
}

<change_tracking_option_list> ::=
   {
       AUTO_CLEANUP = { ON | OFF }
     | CHANGE_RETENTION = retention_period { DAYS | HOURS | MINUTES }
   }

<cursor_option> ::=
{
    CURSOR_CLOSE_ON_COMMIT { ON | OFF }
}

<db_encryption_option> ::=
  ENCRYPTION { ON | OFF }

<db_update_option> ::=
  { READ_ONLY | READ_WRITE }

<db_user_access_option> ::=
  { RESTRICTED_USER | MULTI_USER }

<delayed_durability_option> ::= DELAYED_DURABILITY = { DISABLED | ALLOWED | FORCED }

<parameterization_option> ::=
  PARAMETERIZATION { SIMPLE | FORCED }

<query_store_options> ::=
{
  QUERY_STORE
  {
      = OFF
    | = ON [ ( <query_store_option_list> [,... n] ) ]
    | ( < query_store_option_list> [,... n] )
    | CLEAR [ ALL ]
  }
}

<query_store_option_list> ::=
{
  OPERATION_MODE = { READ_WRITE | READ_ONLY }
  | CLEANUP_POLICY = ( STALE_QUERY_THRESHOLD_DAYS = number )
  | DATA_FLUSH_INTERVAL_SECONDS = number
  | MAX_STORAGE_SIZE_MB = number
  | INTERVAL_LENGTH_MINUTES = number
  | SIZE_BASED_CLEANUP_MODE = { AUTO | OFF }
  | QUERY_CAPTURE_MODE = { ALL | AUTO | CUSTOM | NONE }
  | MAX_PLANS_PER_QUERY = number
  | WAIT_STATS_CAPTURE_MODE = { ON | OFF }
  | QUERY_CAPTURE_POLICY = ( <query_capture_policy_option_list> [,...n] )
}

<query_capture_policy_option_list> :: =
{
    STALE_CAPTURE_POLICY_THRESHOLD = number { DAYS | HOURS }
    | EXECUTION_COUNT = number
    | TOTAL_COMPILE_CPU_TIME_MS = number
    | TOTAL_EXECUTION_CPU_TIME_MS = number
}

<snapshot_option> ::=
{
    ALLOW_SNAPSHOT_ISOLATION { ON | OFF }
  | READ_COMMITTED_SNAPSHOT { ON | OFF }
  | MEMORY_OPTIMIZED_ELEVATE_TO_SNAPSHOT { ON | OFF }
}
<sql_option> ::=
{
    ANSI_NULL_DEFAULT { ON | OFF }
  | ANSI_NULLS { ON | OFF }
  | ANSI_PADDING { ON | OFF }
  | ANSI_WARNINGS { ON | OFF }
  | ARITHABORT { ON | OFF }
  | COMPATIBILITY_LEVEL = { 160 | 150 | 140 | 130 | 120 | 110 | 100 }
  | CONCAT_NULL_YIELDS_NULL { ON | OFF }
  | NUMERIC_ROUNDABORT { ON | OFF }
  | QUOTED_IDENTIFIER { ON | OFF }
  | RECURSIVE_TRIGGERS { ON | OFF }
}

<termination>::=
{
    ROLLBACK AFTER integer [ SECONDS ]
  | ROLLBACK IMMEDIATE
  | NO_WAIT
}

<temporal_history_retention>::=TEMPORAL_HISTORY_RETENTION { ON | OFF }

Arguments

database_name

変更するデータベースの名前。

CURRENT

CURRENT を指定すると、現在のデータベースでアクションが実行されます。 CURRENT は、すべてのコンテキスト内のすべてのオプションでサポートされるわけではありません。 CURRENT でエラーが発生した場合は、データベース名を指定してください。

<auto_option> ::=

自動オプションを制御します。

AUTO_CREATE_STATISTICS { ON |OFF }

ON

クエリプランを改善してクエリのパフォーマンスを向上させるために、クエリオプティマイザーが必要に応じてクエリ述語内の列に対して 1 列ずつ統計を作成します。これらの 1 列ずつの統計は、クエリオプティマイザーがクエリをコンパイルする場合に作成されます。 1 列ずつの統計は、まだ既存の統計オブジェクトの最初の列になっていない列についてのみ作成されます。

既定値は ON です。ほとんどのデータベースで既定の設定を使用することをお勧めします。
OFF

クエリオプティマイザーがクエリをコンパイルするときにクエリ述語内の列の 1 列ずつの統計が作成されません。このオプションを OFF に設定すると、最適ではないクエリプランが作成されて、クエリのパフォーマンスが低下することがあります。

For more information, see the "Statistics options" section in Statistics.

INCREMENTAL = ON |オフ

AUTO_CREATE_STATISTICS を ON に設定し、INCREMENTAL を ON に設定します。増分統計がサポートされている場合、この設定で、自動的に作成される統計情報は、常に増分として作成されます。既定値は OFF です。 For more information, see CREATE STATISTICS.

AUTO_SHRINK { ON |OFF }

ON

データベースファイルを定期的な圧縮処理の対象とします。特定の要件がない限り、AUTO_SHRINK データベースオプションを ON に設定しないでください。詳細については、「データベースの圧縮」を参照してください。

データファイルとログファイルの両方を、自動的に圧縮できます。 AUTO_SHRINK では、データベースを単純復旧モデルに設定している場合、またはログをバックアップしている場合にのみ、トランザクションログのサイズが圧縮されます。 OFF: 未使用領域の定期チェックの際に、データベースファイルは自動的に圧縮されません。

AUTO_SHRINK オプションを使用すると、ファイル領域の 25% を超える領域が未使用の場合にファイルが圧縮されます。このオプションを指定すると、ファイルは 2 つのサイズのいずれかまで縮小されます。次のいずれか大きい方に縮小されます。

ファイルの 25% が未使用領域であるサイズ
ファイルが作成されたときのサイズ

読み取り専用データベースは圧縮できません。

OFF

データベースファイルは、未使用領域の定期的なチェック中に自動的に圧縮されることはありません。

Note

AUTO_SHRINK オプションは、包含データベースでは使用できません。

AUTO_UPDATE_STATISTICS { ON |OFF }

ON

クエリで使用される場合、および統計が古くなっている可能性がある場合に、クエリオプティマイザーによって更新されるように指定します。挿入、更新、削除、またはマージの各操作によってテーブルまたはインデックス付きビューのデータの分布が変わると、統計は古くなったと判断されます。クエリオプティマイザーでは、統計が前回更新されてから発生したデータ変更の数をカウントし、その変更の数をしきい値と比較することで、統計が古くなっている可能性がないかを判断します。このしきい値は、テーブルまたはインデックス付きビューの行数に基づいて決められます。

クエリオプティマイザーによる古い統計の確認は、クエリをコンパイルする前と、キャッシュされたクエリプランを実行する前に行われます。クエリオプティマイザーでは、古くなっている可能性がある統計を判断するため、クエリ述語内の列、テーブル、インデックス付きビューが使用されます。この情報は、クエリがコンパイルされる前にクエリオプティマイザーによって判断されます。キャッシュされたクエリプランを実行する前は、データベースエンジンで、クエリプランが最新の統計を参照しているかどうかが確認されます。

AUTO_UPDATE_STATISTICS オプションは、インデックスに対して作成された統計、クエリ述語内の列に対して 1 列ずつ作成された統計、および CREATE STATISTICS ステートメントを使用して作成された統計に適用されます。また、フィルター選択された統計情報にも適用されます。

既定値は ON です。ほとんどのデータベースで既定の設定を使用することをお勧めします。

統計を同期的に更新するか非同期的に更新するかを指定するには、AUTO_UPDATE_STATISTICS_ASYNC オプションを使用します。
OFF

統計がクエリで使用されるときに、クエリオプティマイザーによって統計が更新されないことを指定します。また、統計が古くなっている可能性がある場合は、クエリオプティマイザーによって更新されません。このオプションを OFF に設定すると、最適ではないクエリプランが作成されて、クエリのパフォーマンスが低下することがあります。

You can determine this option's status by examining the is_auto_update_stats_on column in the sys.databases catalog view. You can also determine the status by examining the IsAutoUpdateStatistics property of the DATABASEPROPERTYEX function.

For more information, see the "Statistics options" section in Statistics.

AUTO_UPDATE_STATISTICS_ASYNC { ON |OFF }

ON

AUTO_UPDATE_STATISTICS オプションの統計の更新を非同期更新にするように指定します。クエリオプティマイザーでは、統計の更新が完了するのを待たずにクエリをコンパイルします。

AUTO_UPDATE_STATISTICS が ON に設定されていなければ、このオプションを ON に設定しても、効果はありません。

既定では、AUTO_UPDATE_STATISTICS_ASYNC オプションは OFF に設定されており、クエリオプティマイザーによる統計は同期更新となります。
OFF

AUTO_UPDATE_STATISTICS オプションの統計の更新を同期更新にするように指定します。クエリオプティマイザーでは、統計の更新が完了するのを待ってからクエリをコンパイルします。

AUTO_UPDATE_STATISTICS が ON に設定されていなければ、このオプションを OFF に設定しても、効果はありません。

You can determine this option's status by examining the is_auto_update_stats_async_on column in the sys.databases catalog view.

For more information that describes when to use synchronous or asynchronous statistics updates, see the "Statistics options" section in Statistics.

<automatic_tuning_option> ::=

Controls automatic options for Automatic tuning. 次の設定のオプションは、Azure portal で、または T-SQL を介してビュー sys.database_automatic_tuning_options で確認できます。

AUTOMATIC_TUNING = { AUTO |INHERIT |CUSTOM }

AUTO

自動チューニング値を AUTO に設定すると、自動チューニングの Azure 構成の既定値が適用されます。 Azure portal では、これにより "継承元: Azure の既定値" というオプションが反映されます。
INHERIT

INHERIT 値を使用すると、親サーバーから既定の構成が継承されます。 Azure portal では、これにより "継承元: サーバー" というオプションが反映されます。親サーバー上の自動調整の構成をカスタマイズする必要があり、これらのカスタム設定を継承 (INHERIT) する、このようなサーバー上にデータベースがすべて存在する場合に特に便利です。継承を機能させるには、データベースで 3 つの個別のチューニングオプションFORCE_LAST_GOOD_PLAN、CREATE_INDEX、DROP_INDEXを DEFAULT に設定する必要があります。
CUSTOM

CUSTOM 値を使用して、データベースで使用可能な各自動チューニングオプションをカスタム構成する必要があります。 Azure portal では、これにより "継承元: 継承しない" というオプションが反映されます。

CREATE_INDEX = { DEFAULT |ON |OFF }

Enables or disables automatic index management CREATE_INDEX option of Automatic tuning. このオプションの状態は、Azure portal で、または T-SQL を介してビュー sys.database_automatic_tuning_options で確認できます。

DEFAULT

サーバーから既定の設定が継承されます。この場合、個別の自動調整を有効または無効にするオプションは、サーバーレベルで定義されます。
ON

有効にすると、不足しているインデックスがデータベース上で自動的に生成されます。インデックスの作成に従って、ワークロードのパフォーマンスの向上が確認されます。このような作成されたインデックスでこれ以上ワークロードパフォーマンスに利点が提供されなくなると、自動的に元に戻されます。自動的に作成されたインデックスは、システムで生成されたインデックスとしてフラグが設定されます。
OFF

データベース上で不足しているインデックスが自動的に生成されません。

DROP_INDEX = { DEFAULT |ON |OFF }

Enables or disables automatic index management DROP_INDEX option of Automatic tuning. このオプションの状態は、Azure portal で、または T-SQL を介してビュー sys.database_automatic_tuning_options で確認できます。

DEFAULT

サーバーから既定の設定が継承されます。この場合、個別の自動調整を有効または無効にするオプションは、サーバーレベルで定義されます。
ON

パフォーマンスワークロードに対する重複または不要になったインデックスが自動的にドロップされます。
OFF

データベース上で不足しているインデックスが自動的にドロップされません。

FORCE_LAST_GOOD_PLAN = { DEFAULT |ON |OFF }

Enables or disables automatic plan correction FORCE_LAST_GOOD_PLAN option of Automatic tuning. このオプションの状態は、Azure portal で、または T-SQL を介してビュー sys.database_automatic_tuning_options で確認できます。

DEFAULT

サーバーから既定の設定が継承されます。この場合、個別の自動調整を有効または無効にするオプションは、サーバーレベルで定義されます。これが既定値です。新しい Azure SQL サーバーの既定値は ON です。つまり、既定では、新しいデータベースは ON の設定を継承します。
ON

新しいクエリプランがパフォーマンスの低下を引き起こしている Transact-SQL クエリに対して、データベースエンジンでは最後の既知の正常なプランが自動的に強制されます。データベースエンジンでは、強制プランを使用する Transact-SQL クエリのクエリパフォーマンスが継続的に監視されます。パフォーマンスの向上がある場合、データベースエンジンでは、最新の既知の適切なプランが引き続き使用されます。パフォーマンスの向上が検出されない場合、データベースエンジンによって新しいクエリプランが生成されます。 The statement fails if the Query Store isn't enabled, or isn't in Read-Write mode.
OFF

The Database Engine reports potential query performance regressions caused by query plan changes in sys.dm_db_tuning_recommendations view. ただし、これらの推奨事項は自動的には適用されません。ユーザーは、ビューに表示される Transact-SQL スクリプトを適用することによって、アクティブな推奨事項を監視し、特定された問題を解決できます。

<change_tracking_option> ::=

ON

データベースの変更の追跡を有効にします。変更の追跡を有効にすると、AUTO CLEANUP オプションと CHANGE RETENTION オプションも設定できます。
- AUTO_CLEANUP = { ON |OFF }
  - ON
    
    指定した保有期間を過ぎると、変更追跡情報が自動的に削除されます。
  - OFF
    
    変更追跡データはデータベースから削除されません。
- CHANGE_RETENTION = retention_period { DAYS | HOURS | MINUTES }
  
  データベースに変更追跡情報を保持する最低限の期間を指定します。データは、AUTO_CLEANUP の値が ON のときにのみ削除されます。
  
  retention_period is an integer that specifies the numerical component of the retention period.
  
  The default retention period is 2 days. 最小保有期間は 1 分です。 The default retention type is DAYS.
OFF

データベースの変更の追跡を無効にします。データベースの変更の追跡を無効にする前に、すべてのテーブルで変更の追跡を無効にしてください。

<cursor_option> ::=

カーソルオプションを制御します。

CURSOR_CLOSE_ON_COMMIT { ON |OFF }

ON

トランザクションをコミットまたはロールバックしたときに開いていたカーソルはすべて閉じられます。
OFF

トランザクションがコミットされると、カーソルは開いたままです。トランザクションをロールバックすると、INSENSITIVE または STATIC として定義されているカーソル以外のすべてのカーソルが閉じます。

You can determine this option's status by examining the is_cursor_close_on_commit_on column in the sys.databases catalog view or the IsCloseCursorsOnCommitEnabled property of the DATABASEPROPERTYEX function. 接続が切断されたときだけカーソルが暗黙的に割り当てを解除されます。 For more information, see DECLARE CURSOR.

<db_encryption_option> ::=

データベース暗号化の状態を制御します。

ENCRYPTION { ON |OFF }

データベースを暗号化する (ON) か、暗号化しない (OFF) かを設定します。データベース暗号化の詳細については、「Transparent Data Encryption (TDE)」および「Azure SQL Database、Azure SQL Managed Instance、および Azure Synapse Analyticsの Transparent Data Encryption をする」を参照してください。

You can see the encryption state of the database by using the sys.dm_database_encryption_keys dynamic management view.

<db_update_option> ::=

データベースで更新を許可するかどうかを制御します。

READ_ONLY

ユーザーは、データベースのデータを読み取ることができますが、変更はできません。

Note

クエリのパフォーマンスを向上させるには、データベースを READ_ONLY に設定する前に統計を更新します。データベースをREAD_ONLYに設定した後に追加の統計が必要な場合、データベースエンジンは tempdbに統計を作成します。 For more information about statistics for a read-only database, see Statistics.
READ_WRITE

データベースに対して読み取りおよび書き込み操作を行うことができます。

この状態を変更するには、データベースに対する排他的アクセスが必要になります。詳細については、SINGLE_USER 句をご覧ください。

Note

Azure SQL データベースフェデレーションデータベースでは、SET { READ_ONLY | READ_WRITE } は無効になっています。

<db_user_access_option> ::=

データベースへのユーザーアクセスを制御します。

RESTRICTED_USER

db_owner 固定データベースロール、dbcreator 固定サーバーロール、sysadmin 固定サーバーロールのメンバーだけにデータベースへの接続を許可します。ただし、数に制限はありません。データベースに対するすべての接続は、ALTER DATABASE ステートメントの終了句で指定した時間枠内に接続解除されます。データベースが RESTRICTED_USER 状態に移行すると、資格のないユーザーによる接続の試みは拒否されます。 Azure SQL Database では、ユーザーデータベース内から実行する必要があります。 master データベースから、エラーメッセージ Msg 42008, Level 16, State 3, Line 1 ODBC error: State: 28000: Error: 18456 Message:'[Microsoft][ODBC Driver 17 for SQL Server][SQL Server]Login failed for user '##MS_InstanceCertificate##'.'.
MULTI_USER

データベースに接続するための適切な権限を持つすべてのユーザーが許可されます。 You can determine this option's status by examining the user_access column in the sys.databases catalog view or the UserAccess property of the DATABASEPROPERTYEX function. Azure SQL Database では、ユーザーデータベース内から実行する必要があります。 master データベースから、エラーメッセージ Msg 42008, Level 16, State 3, Line 1 ODBC error: State: 28000: Error: 18456 Message:'[Microsoft][ODBC Driver 17 for SQL Server][SQL Server]Login failed for user '##MS_InstanceCertificate##'.'.

<delayed_durability_option> ::=

トランザクションを完全持続性または遅延持続性のどちらとしてコミットするかどうかを制御します。

DISABLED

SET DISABLED 以後のトランザクションはすべて完全持続性になります。 ATOMIC ブロックまたは COMMIT ステートメントで設定された持続性オプションは無視されます。
ALLOWED

SET ALLOWED 以後のトランザクションはすべて、ATOMIC ブロックまたは COMMIT ステートメントで設定された持続性オプションに応じて、完全持続性または遅延持続性になります。
FORCED

SET FORCED 以後のトランザクションはすべて遅延持続性になります。 ATOMIC ブロックまたは COMMIT ステートメントで設定された持続性オプションは無視されます。

<PARAMETERIZATION_option> ::=

パラメーター化オプションを制御します。

パラメーター化 { 単純 |FORCED }

SIMPLE

クエリは、データベースの既定の動作に基づいてパラメーター化されます。
FORCED

SQL Server は、データベース内にあるすべてのクエリをパラメーター化します。

The current setting of this option can be determined by examining the is_parameterization_forced column in the sys.databases catalog view.

<query_store_options> ::=

ON |OFF |CLEAR [ すべて ]

このデータベースでクエリストアを有効にするかどうかを制御します。また、クエリストアの内容の削除も制御します。
- ON
  
  クエリのストアを有効にします。既定値は ON です。
- OFF
  
  クエリのストアを無効にします。
  
  Note
  
  Azure SQL データベース単一データベースとエラスティックプールでは、クエリストアを無効にすることはできません。 ALTER DATABASE [database] SET QUERY_STORE = OFF を実行すると、警告 'QUERY_STORE=OFF' is not supported in this version of SQL Server.が返されます。
- CLEAR
  
  クエリストアの内容を削除します。

OPERATION_MODE

クエリのストアの操作モードについて説明します。有効な値は、READ_ONLY、READ_WRITE はします。 READ_WRITE モードでは、クエリのストアでクエリプランとランタイム実行の統計情報が収集され、保持されます。 READ_ONLY モードでは、クエリストアから情報を読み取ることはできますが、新しい情報は追加されません。クエリストアの最大割り当て領域が使い果たされた場合、クエリストアは操作モードをREAD_ONLYに変更します。

CLEANUP_POLICY

クエリストアのデータ保持ポリシーを表します。 STALE_QUERY_THRESHOLD_DAYS により、クエリストアにクエリの情報が保持される日数が決定されます。 STALE_QUERY_THRESHOLD_DAYS is type bigint. 既定値は 30 です。 For SQL Database Basic edition, default is 7 days.

DATA_FLUSH_INTERVAL_SECONDS

MAX_STORAGE_SIZE_MB

クエリストアに割り当てる領域を指定します。 MAX_STORAGE_SIZE_MB is type bigint.

Note

In Azure SQL Database, the default MAX_STORAGE_SIZE_MB value differs by service tier, as follows: Premium, Business Critical, and Hyperscale: 1,024 MB; Standard and General Purpose: 100 MB; Basic: 10 MB The maximum allowed MAX_STORAGE_SIZE_MB value is 10,240 MB.

Note

MAX_STORAGE_SIZE_MB の制限は、厳密には適用されません。ストレージサイズは、クエリストアでディスクにデータが書き込まれる場合にのみ確認されます。この間隔は DATA_FLUSH_INTERVAL_SECONDS オプションか、Management Studio クエリストアのダイアログオプションである [データのフラッシュ間隔] によって設定されます。間隔の既定値は 900 秒 (15 分) です。クエリストアがストレージサイズチェック間の MAX_STORAGE_SIZE_MB 制限に違反した場合、読み取り専用モードに移行します。 SIZE_BASED_CLEANUP_MODE が有効になっている場合は、MAX_STORAGE_SIZE_MB の制限を適用するクリーンアップメカニズムもトリガーされます。十分な領域がクリアされると、クエリストアモードは自動的に読み取り/書き込みに切り替わります。

Important

INTERVAL_LENGTH_MINUTES

SIZE_BASED_CLEANUP_MODE = { AUTO |OFF }

データの総量が最大サイズに近づくとクリーンアップを自動的にアクティブ化するかどうかを制御します。

OFF

サイズベースのクリーンアップは自動的にアクティブ化されません。
AUTO

Size-based cleanup is automatically activated when size on disk reaches 90% of max_storage_size_mb. サイズのクリーンアップでは、まず最も安価で最も古いクエリを削除します。 It stops at approximately 80% of max_storage_size_mb. これは既定の構成値です。

SIZE_BASED_CLEANUP_MODE is type nvarchar.

QUERY_CAPTURE_MODE { ALL |AUTO |CUSTOM |NONE }

現在アクティブなクエリのキャプチャモードを指定します。各モードでは、特定のクエリキャプチャポリシーを定義します。

Note

ALL

すべてのクエリをキャプチャします。
AUTO

実行の数とリソースの消費量に基づいて関連するクエリがキャプチャされます。これは Azure SQL データベースの既定の構成値です。
NONE

新しいクエリのキャプチャを停止します。クエリストアは、既にキャプチャされたクエリのコンパイルとランタイムの統計を引き続き収集します。重要なクエリのキャプチャが間違う可能性があるため、この構成は慎重に使用してください。
CUSTOM

QUERY_CAPTURE_POLICY オプションを制御できます。

QUERY_CAPTURE_MODE is type nvarchar.

MAX_PLANS_PER_QUERY

各クエリに対して保持するプランの最大数を定義します。 MAX_PLANS_PER_QUERY is type int. The default value is 200.

WAIT_STATS_CAPTURE_MODE { ON |OFF }

待機統計をクエリごとにキャプチャするかどうかを制御します。

ON

クエリごとの待機統計情報がキャプチャされます。この値は既定の構成値です。
OFF

クエリごとの待機統計情報はキャプチャされません。

<query_capture_policy_option_list> :: =

クエリストアのキャプチャポリシーオプションを制御します。 STALE_CAPTURE_POLICY_THRESHOLD を除き、これらのオプションでは、定義された古いキャプチャポリシーのしきい値でクエリがキャプチャされるために必要な OR 条件が定義されます。

STALE_CAPTURE_POLICY_THRESHOLD = integer { DAYS | HOURS }

クエリをキャプチャすべきかどうかを決定する評価の間隔を定義します。既定値は 1 日で、1 時間から 7 日に設定できます。 number is type int.

EXECUTION_COUNT = integer

評価期間中、クエリを実行する回数を定義します。既定値は 30 です。これは、既定の古いキャプチャポリシーのしきい値に対して、クエリがクエリストアに保存されるためには、1 日で 30 回以上実行される必要があることを意味します。 EXECUTION_COUNT is type int.

TOTAL_COMPILE_CPU_TIME_MS = integer

評価期間中、クエリで使用されるコンパイル CPU 時間の合計経過時間を定義します。既定値は 1000 です。これは、既定の古いキャプチャポリシーのしきい値の場合、クエリがクエリストアに保存されるためには、1 日でクエリのコンパイル時に費やされる CPU 時間の合計が 1 秒以上である必要があることを意味します。 TOTAL_COMPILE_CPU_TIME_MS is type int.

TOTAL_EXECUTION_CPU_TIME_MS = integer

評価期間中、クエリによって使用される実行 CPU の合計経過時間を定義します。既定値は 100 です。これは、既定の古いキャプチャポリシーのしきい値に対して、クエリがクエリストアに保存されるためには、1 日で実行に費やされる CPU 時間の合計が 100 ミリ秒以上である必要があることを意味します。 TOTAL_EXECUTION_CPU_TIME_MS is type int.

<snapshot_option> ::=

トランザクション分離レベルを示します。

ALLOW_SNAPSHOT_ISOLATION { ON |OFF }

ON

データベースレベルでのスナップショットオプションを有効にします。有効にした場合、スナップショット分離を使用するトランザクションがなくても、DML ステートメントによって、行バージョンの生成が開始されます。このオプションを有効にすると、トランザクションで SNAPSHOT トランザクション分離レベルを指定できます。 SNAPSHOT 分離レベルでトランザクションが実行されると、すべてのステートメントはトランザクション開始時のデータのスナップショットを参照します。 SNAPSHOT 分離レベルで実行されているトランザクションが複数のデータベースのデータにアクセスする場合は、すべてのデータベースで ALLOW_SNAPSHOT_ISOLATION が ON に設定されている必要があります。ALLOW_SNAPSHOT_ISOLATION が OFF になっているデータベース内のテーブルにアクセスする場合は、トランザクション内の各ステートメントで、FROM 句内のすべての参照に対してロックヒントを使用する必要があります。
OFF

データベースレベルでのスナップショットオプションを無効にします。トランザクションでは、SNAPSHOT トランザクション分離レベルを指定できません。

ALLOW_SNAPSHOT_ISOLATION を新しい状態に (ON から OFF へ、または OFF から ON へ) 設定した場合、ALTER DATABASE は、データベース内にあるすべての既存のトランザクションがコミットされるまで、呼び出し元に制御を返しません。データベースが既に ALTER DATABASE ステートメントで指定した状態にある場合には、制御は呼び出し元に直ちに返されます。 If the ALTER DATABASE statement doesn't return quickly, use sys.dm_tran_active_snapshot_database_transactions to determine whether there are long-running transactions. ALTER DATABASE ステートメントが取り消された場合、データベースは、ALTER DATABASE が開始された時点での状態に留まります。 The sys.databases catalog view indicates the state of snapshot-isolation transactions in the database. snapshot_isolation_state_desc = IN_TRANSITION_TO_ON場合、ステートメント ALTER DATABASE .... ALLOW_SNAPSHOT_ISOLATION OFF 6 秒間一時停止し、操作を再試行します。

データベースが OFFLINE の場合には、ALLOW_SNAPSHOT_ISOLATION の状態を変更できません。

READ_ONLY データベースでALLOW_SNAPSHOT_ISOLATIONを設定した場合、データベースが後で READ_WRITE に設定されている場合、設定は保持されます。

The current setting of this option can be determined by examining the snapshot_isolation_state column in the sys.databases catalog view.

READ_COMMITTED_SNAPSHOT { ON |OFF }

ON

データベースレベルでの Read Committed スナップショットオプションを有効にします。有効にした場合、スナップショット分離を使用するトランザクションがなくても、DML ステートメントによって、行バージョンの生成が開始されます。このオプションを有効にすると、READ COMMITTED 分離レベルを指定しているトランザクションは、ロックではなく、行のバージョン管理を使用します。トランザクションが READ COMMITTED 分離レベルで実行されている場合、すべてのステートメントは、ステートメントの開始時に存在していたデータのスナップショットを参照します。
OFF

データベースレベルでの Read Committed スナップショットオプションを無効にします。 READ COMMITTED 分離レベルを指定しているトランザクションは、ロックを使用します。

READ_ONLY データベースでREAD_COMMITTED_SNAPSHOTを設定した場合、データベースが後で READ_WRITE に設定されたときに設定が保持されます。

The current setting of this option can be determined by examining the is_read_committed_snapshot_on column in the sys.databases catalog view.

Warning

When a table is created with DURABILITY = SCHEMA_ONLY, and READ_COMMITTED_SNAPSHOT is subsequently changed using ALTER DATABASE, data in the table is lost.

Tip

Azure SQL データベースでは、データベースに対して READ_COMMITTED_SNAPSHOT を ON または OFF に設定する ALTER DATABASE コマンドは、master データベースで実行する必要があります。

MEMORY_OPTIMIZED_ELEVATE_TO_SNAPSHOT { ON |OFF }

ON

トランザクション分離レベルが SNAPSHOT より低い分離レベルに設定されている場合は、メモリ最適化テーブル上で解釈されたすべての Transact-SQL 操作が SNAPSHOT 分離レベルで実行されます。 SNAPSHOT よりも低い分離レベルの例として、READ COMMITTED、READ UNCOMMITTEDREAD があります。このような操作は、トランザクション分離レベルがセッションレベルで明示的に設定されているか、既定値が暗黙的に使用されるかに関係なく実行されます。
OFF

メモリ最適化テーブル上で解釈された Transact-SQL 操作のトランザクション分離レベルは引き上げられません。

データベースが OFFLINE の場合には、MEMORY_OPTIMIZED_ELEVATE_TO_SNAPSHOT の状態を変更できません。

既定値は OFF です。

The current setting of this option can be determined by examining the is_memory_optimized_elevate_to_snapshot_on column in the sys.databases catalog view.

<sql_option> ::=

ANSI 準拠のオプションをデータベースレベルで制御します。

ANSI_NULL_DEFAULT { ON |OFF }

ON

既定値は NULL です。
OFF

既定値は NOT NULL になります。

ANSI 互換性を確保するために、データベースオプション ANSI_NULL_DEFAULT を ON に設定すると、データベースの既定値が NULL に変更されます。

ANSI_NULLS { ON |OFF }

ON

NULL 値との比較結果は、すべて UNKNOWN になります。
OFF

Unicode 以外の値と null 値の比較結果は、両方の値が NULL である場合には TRUE になります。

Important

Note

SET ANSI_NULLS は、計算列やインデックス付きビューのインデックスを作成または変更する場合にも、ON に設定する必要があります。

ANSI_PADDING { ON |OFF }

ON

比較を行う前に、文字列が同じ長さになるようにパディングされます。 Also padded to the same length before inserting to a varchar or nvarchar data type.
OFF

Inserts trailing blanks in character values into varchar or nvarchar columns. Also leaves trailing zeros in binary values that are inserted into varbinary columns. 列の長さに合わせるためにパディングされることはありません。

OFF を指定した場合、この設定は新しい列の定義にのみ影響します。

Important

ANSI_WARNINGS { ON |OFF }

ON

0 除算などの状態になったときに、エラーまたは警告が発行されます。集計関数に NULL 値が出現した場合にも、エラーと警告が発行されます。
OFF

0 除算などの条件が発生しても、警告は発行されず、NULL 値が返されます。

Note

SET ANSI_WARNINGS は、計算列やインデックス付きビューのインデックスを作成または変更する場合には、ON に設定する必要があります。

ARITHABORT { ON |OFF }

ON

クエリ実行中にオーバーフローエラーまたは 0 除算エラーが発生した場合に、クエリを終了します。
OFF

このようなエラーのいずれかが発生した場合に警告メッセージが表示されます。警告が表示された場合でも、クエリ、バッチ、またはトランザクションは、エラーが発生しなかったかのように処理を続行します。

Note

SET ARITHABORT は、計算列やインデックス付きビューのインデックスを作成または変更する場合には、ON に設定する必要があります。

COMPATIBILITY_LEVEL = { 170 | 160 | 150 | 140 | 130 | 120 | 110 | 100 }

詳細については、ALTER DATABASE 互換性レベルを参照してください。

CONCAT_NULL_YIELDS_NULL { ON |OFF }

ON

オペランドのいずれかが NULL の場合、連結操作の結果は NULL になります。たとえば、文字列 "This is" と NULL を連結すると、結果は "This is" ではなく NULL になります。
OFF

null 値は空の文字列として扱われます。

Note

CONCAT_NULL_YIELDS_NULL は、計算列やインデックス付きビューのインデックスを作成または変更する場合には、ON に設定する必要があります。

NUMERIC_ROUNDABORT { ON |OFF }

ON

式の精度が低下した場合にエラーが生成されます。
OFF

有効桁数の損失が発生してもエラーメッセージが生成されず、結果を格納する列または変数の有効桁数に丸められます。

Important

NUMERIC_ROUNDABORT は、計算列やインデックス付きビューのインデックスを作成または変更する場合は、OFF に設定する必要があります。

You can determine the status for this option in the is_numeric_roundabort_on column in the sys.databases catalog view. You can also determine the status by examining the IsNumericRoundAbortEnabled property of the DATABASEPROPERTYEX function.

QUOTED_IDENTIFIER { ON |OFF }

ON

識別子を囲む二重引用符を使用できます。

二重引用符で囲まれた文字列はすべて、オブジェクト識別子として解釈されます。引用符で囲まれた識別子は、Transact-SQL の識別子の規則に従う必要はありません。これはキーワードにすることができます。また、Transact-SQL 識別子では許可されない文字を含めることができます。二重引用符 (") が識別子の一部である場合は、2 つの二重引用符 ("") で表すことができます。
OFF

識別子を引用符で囲むことができず、Transact-SQL の識別子に関するすべての規則に従う必要があります。リテラルは単一引用符と二重引用符のどちらで区切ることもできます。

RECURSIVE_TRIGGERS { ON |OFF }

ON

AFTER トリガーの再帰呼び出しを実行できるようになります。
OFF

You can determine this option's status by examining the is_recursive_triggers_on column in the sys.databases catalog view. You can also determine the status by examining the IsRecursiveTriggersEnabled property of the DATABASEPROPERTYEX function.

Note

<target_recovery_time_option> ::=

TARGET_RECOVERY_TIME = target_recovery_time { SECONDS | MINUTES }

target_recovery_time

クラッシュが発生した場合、指定したデータベースが復旧に要する時間の上限を指定します。 target_recovery_time is type int.
SECONDS

Indicates that target_recovery_time is expressed as the number of seconds.
MINUTES

Indicates that target_recovery_time is expressed as the number of minutes.

For more information about indirect checkpoints, see Database checkpoints.

WITH <termination> ::=

Note

ROLLBACK AFTER integer [SECONDS] | ROLLBACK IMMEDIATE

指定した秒数の後、または直ちにロールバックするかどうかを指定します。
NO_WAIT

要求されたデータベースの状態またはオプションの変更をすぐに完了できない場合に要求が失敗することを指定します。すぐに完了とは、トランザクションが自身のコミットまたはロールバック処理を待機しないことを意味します。

<temporal_history_retention> ::=

TEMPORAL_HISTORY_RETENTION { ON |OFF }

ただし、既定では、ON はポイントインタイムリストア操作の後、自動的にOFF に設定されます。この設定を有効にする方法など、詳細については、「リテンションポリシーの構成方法」を参照してください。
- ON
  
  Default. テンポラルテーブルの保持ポリシーを有効にします。詳細については、「システムバージョン管理されたテンポラルテーブルの履歴データの保有期間管理」を参照してください。
- OFF
  
  一時的な履歴保持ポリシーは実行しないでください。

Set options

To retrieve current settings for database options, use the sys.databases catalog view or DATABASEPROPERTYEX

データベースオプションを設定すると、新しい設定は直ちに有効になります。

Options category	他のオプションとの組み合わせの可否	WITH <termination> 句の使用の可否
<auto_option>	Yes	No
<change_tracking_option>	Yes	Yes
<cursor_option>	Yes	No
<db_encryption_option>	Yes	No
<db_update_option>	Yes	Yes
<db_user_access_option>	Yes	Yes
<delayed_durability_option>	Yes	Yes
<parameterization_option>	Yes	Yes
ALLOW_SNAPSHOT_ISOLATION	No	No
READ_COMMITTED_SNAPSHOT	No	Yes
MEMORY_OPTIMIZED_ELEVATE_TO_SNAPSHOT	Yes	Yes
DATE_CORRELATION_OPTIMIZATION	Yes	Yes
<sql_option>	Yes	No
<target_recovery_time_option>	No	Yes

Examples

A. データベースを READ_ONLY に設定する

データベースまたはファイルグループの状態をREAD_ONLYまたはREAD_WRITEに変更するには、データベースへの排他的アクセスが必要であり、完了するまでに数秒かかる場合があります。次の例では、アクセスを制限するために、データベースを RESTRICTED_USER モードに設定します。次に、AdventureWorks2022 データベースの状態を READ_ONLY に設定し、データベースへのアクセス権をすべてのユーザーに戻します。

--Connect to [database_name];
GO
ALTER DATABASE [database_name]
SET RESTRICTED_USER;
GO
ALTER DATABASE [database_name]
SET READ_ONLY
--`SET READ_ONLY` command might take a few seconds to complete.
GO
ALTER DATABASE [database_name]
SET MULTI_USER;
GO

データベースを読み取り/書き込みモードに戻すには:

--Connect to [database_name];
GO
ALTER DATABASE [database_name]
SET READ_WRITE
GO

To verify:

SELECT [name], user_access_desc, is_read_only FROM sys.databases
WHERE [name] = 'database_name'
GO

B. データベースのスナップショット分離を有効にする

次の例では、AdventureWorks2022 データベースに対する SNAPSHOT 分離フレームワークオプションを有効にします。

--Connect to [database_name]
GO
ALTER DATABASE [database_name]
SET ALLOW_SNAPSHOT_ISOLATION ON;
GO

データベース内の snapshot_isolation_framework の状態を確認します。

--Connect to [database_name]
SELECT name, snapshot_isolation_state,
    snapshot_isolation_state_desc AS description
FROM sys.databases
WHERE name = N'database_name';
GO

結果セットは、SNAPSHOT 分離フレームワークが有効であることを示しています。

name	snapshot_isolation_state	description
[database_name]	1	ON

C. 変更の追跡を有効化、変更、または無効化する

次の例では、AdventureWorks2022 データベースで変更の追跡を有効にし、保有期間を 2 日に設定します。

--Connect to [database_name]
ALTER DATABASE [database_name]
SET CHANGE_TRACKING = ON
(AUTO_CLEANUP = ON, CHANGE_RETENTION = 2 DAYS);

次の例では、保有期間を 3 日に変更する方法を示します。

--Connect to [database_name]
ALTER DATABASE [database_name]
SET CHANGE_TRACKING (CHANGE_RETENTION = 3 DAYS);

次の例では、AdventureWorks2022 データベースで変更の追跡を無効にする方法を示します。

--Connect to [database_name]
ALTER DATABASE [database_name]
SET CHANGE_TRACKING = OFF;

D. クエリストアを有効にする

次の例では、クエリストアを有効にし、クエリストアのパラメーターを構成します。

--Connect to [database_name]
ALTER DATABASE [database_name]
SET QUERY_STORE = ON
    (
      OPERATION_MODE = READ_WRITE,
      CLEANUP_POLICY = ( STALE_QUERY_THRESHOLD_DAYS = 90 ),
      DATA_FLUSH_INTERVAL_SECONDS = 900,
      QUERY_CAPTURE_MODE = AUTO,
      MAX_STORAGE_SIZE_MB = 1024,
      INTERVAL_LENGTH_MINUTES = 60
    );

E. 待機統計を使ってクエリストアを有効にする

次の例では、クエリストアを有効にし、そのパラメーターを構成します。

--Connect to [database_name]
ALTER DATABASE [database_name]
SET QUERY_STORE = ON
    (
      OPERATION_MODE = READ_WRITE,
      CLEANUP_POLICY = ( STALE_QUERY_THRESHOLD_DAYS = 90 ),
      DATA_FLUSH_INTERVAL_SECONDS = 900,
      MAX_STORAGE_SIZE_MB = 1024,
      INTERVAL_LENGTH_MINUTES = 60,
      SIZE_BASED_CLEANUP_MODE = AUTO,
      MAX_PLANS_PER_QUERY = 200,
      WAIT_STATS_CAPTURE_MODE = ON
    );

F. カスタムキャプチャポリシーオプションを使ってクエリストアを有効にする

次の例では、クエリストアを有効にし、そのパラメーターを構成します。

--Connect to [database_name]
ALTER DATABASE [database_name]
SET QUERY_STORE = ON
    (
      OPERATION_MODE = READ_WRITE,
      CLEANUP_POLICY = ( STALE_QUERY_THRESHOLD_DAYS = 90 ),
      DATA_FLUSH_INTERVAL_SECONDS = 900,
      MAX_STORAGE_SIZE_MB = 1024,
      INTERVAL_LENGTH_MINUTES = 60,
      SIZE_BASED_CLEANUP_MODE = AUTO,
      MAX_PLANS_PER_QUERY = 200,
      WAIT_STATS_CAPTURE_MODE = ON,
      QUERY_CAPTURE_MODE = CUSTOM,
      QUERY_CAPTURE_POLICY = (
        STALE_CAPTURE_POLICY_THRESHOLD = 24 HOURS,
        EXECUTION_COUNT = 30,
        TOTAL_COMPILE_CPU_TIME_MS = 1000,
        TOTAL_EXECUTION_CPU_TIME_MS = 100
      )
    );

SQL Server

SQL Database

* SQL Managed Instance *

Azure Synapse
Analytics

Microsoft Fabric

Azure SQL Managed Instance

互換性レベルは SET オプションですが、ALTER DATABASE 互換性レベルで説明されています。

Note

Syntax

ALTER DATABASE { database_name | Current }
SET
{
    <optionspec> [ ,...n ]
}
;

<optionspec> ::=
{
    <auto_option>
  | <change_tracking_option>
  | <cursor_option>
  | <db_encryption_option>
  | <delayed_durability_option>
  | <parameterization_option>
  | <query_store_options>
  | <snapshot_option>
  | <sql_option>
  | <target_recovery_time_option>
  | <termination>
  | <temporal_history_retention>
}
;
<auto_option> ::=
{
    AUTO_CREATE_STATISTICS { OFF | ON [ ( INCREMENTAL = { ON | OFF } ) ] }
  | AUTO_SHRINK { ON | OFF }
  | AUTO_UPDATE_STATISTICS { ON | OFF }
  | AUTO_UPDATE_STATISTICS_ASYNC { ON | OFF }
}

<automatic_tuning_option> ::=
{
    AUTOMATIC_TUNING ( FORCE_LAST_GOOD_PLAN = { DEFAULT | ON | OFF } )
}

<change_tracking_option> ::=
{
    CHANGE_TRACKING
    {
       = OFF
     | = ON [ ( <change_tracking_option_list > [,...n] ) ]
     | ( <change_tracking_option_list> [,...n] )
    }
}

<change_tracking_option_list> ::=
   {
       AUTO_CLEANUP = { ON | OFF }
     | CHANGE_RETENTION = retention_period { DAYS | HOURS | MINUTES }
   }

<cursor_option> ::=
{
    CURSOR_CLOSE_ON_COMMIT { ON | OFF }
}

<db_encryption_option> ::=
  ENCRYPTION { ON | OFF }

<delayed_durability_option> ::=DELAYED_DURABILITY = { DISABLED | ALLOWED | FORCED }

<parameterization_option> ::=
  PARAMETERIZATION { SIMPLE | FORCED }

<query_store_options> ::=
{
  QUERY_STORE
  {
    = OFF
    | = ON [ ( <query_store_option_list> [,... n] ) ]
    | ( < query_store_option_list> [,... n] )
    | CLEAR [ ALL ]
  }
}

<query_store_option_list> ::=
{
  OPERATION_MODE = { READ_WRITE | READ_ONLY }
  | CLEANUP_POLICY = ( STALE_QUERY_THRESHOLD_DAYS = number )
  | DATA_FLUSH_INTERVAL_SECONDS = number
  | MAX_STORAGE_SIZE_MB = number
  | INTERVAL_LENGTH_MINUTES = number
  | SIZE_BASED_CLEANUP_MODE = { AUTO | OFF }
  | QUERY_CAPTURE_MODE = { ALL | AUTO | CUSTOM | NONE }
  | MAX_PLANS_PER_QUERY = number
  | WAIT_STATS_CAPTURE_MODE = { ON | OFF }
  | QUERY_CAPTURE_POLICY = ( <query_capture_policy_option_list> [,...n] )
}

<query_capture_policy_option_list> :: =
{
    STALE_CAPTURE_POLICY_THRESHOLD = number { DAYS | HOURS }
    | EXECUTION_COUNT = number
    | TOTAL_COMPILE_CPU_TIME_MS = number
    | TOTAL_EXECUTION_CPU_TIME_MS = number
}

<snapshot_option> ::=
{
    ALLOW_SNAPSHOT_ISOLATION { ON | OFF }
  | READ_COMMITTED_SNAPSHOT { ON | OFF }
  | MEMORY_OPTIMIZED_ELEVATE_TO_SNAPSHOT { ON | OFF }
}
<sql_option> ::=
{
    ANSI_NULL_DEFAULT { ON | OFF }
  | ANSI_NULLS { ON | OFF }
  | ANSI_PADDING { ON | OFF }
  | ANSI_WARNINGS { ON | OFF }
  | ARITHABORT { ON | OFF }
  | COMPATIBILITY_LEVEL = { 170 | 160 | 150 | 140 | 130 | 120 | 110 | 100 }
  | CONCAT_NULL_YIELDS_NULL { ON | OFF }
  | NUMERIC_ROUNDABORT { ON | OFF }
  | QUOTED_IDENTIFIER { ON | OFF }
  | RECURSIVE_TRIGGERS { ON | OFF }
}

<temporal_history_retention>::= TEMPORAL_HISTORY_RETENTION { ON | OFF }

Arguments

database_name

変更するデータベースの名前。

CURRENT

CURRENT を指定すると、現在のデータベースでアクションが実行されます。 CURRENT は、すべてのコンテキスト内のすべてのオプションでサポートされるわけではありません。 CURRENT でエラーが発生した場合は、データベース名を指定してください。

<auto_option> ::=

自動オプションを制御します。

AUTO_CREATE_STATISTICS { ON |OFF }

ON

クエリプランを改善してクエリのパフォーマンスを向上させるために、クエリオプティマイザーが必要に応じてクエリ述語内の列に対して 1 列ずつ統計を作成します。これらの 1 列ずつの統計は、クエリオプティマイザーがクエリをコンパイルする場合に作成されます。 1 列ずつの統計は、まだ既存の統計オブジェクトの最初の列になっていない列についてのみ作成されます。

既定値は ON です。ほとんどのデータベースで既定の設定を使用することをお勧めします。
OFF

クエリオプティマイザーがクエリをコンパイルするときにクエリ述語内の列の 1 列ずつの統計が作成されません。このオプションを OFF に設定すると、最適ではないクエリプランが作成されて、クエリのパフォーマンスが低下することがあります。

You can determine this option's status by examining the is_auto_create_stats_on column in the sys.databases catalog view. You can also determine the status by examining the IsAutoCreateStatistics property of the DATABASEPROPERTYEX function.

For more information, see the "Statistics options" section in Statistics.

INCREMENTAL = ON |オフ

AUTO_SHRINK { ON |OFF }

ON

データベースファイルを定期的な圧縮処理の対象とします。特定の要件がない限り、AUTO_SHRINK データベースオプションを ON に設定しないでください。詳細については、「データベースの圧縮」を参照してください。

データファイルとログファイルの両方を、自動的に圧縮できます。 AUTO_SHRINK では、データベースを単純復旧モデルに設定している場合、またはログをバックアップしている場合にのみ、トランザクションログのサイズが圧縮されます。 OFF: 未使用領域の定期チェックの際に、データベースファイルは自動的に圧縮されません。

AUTO_SHRINK オプションを使用すると、ファイル領域の 25% を超える領域が未使用の場合にファイルが圧縮されます。このオプションを指定すると、ファイルは 2 つのサイズのいずれかまで縮小されます。次のいずれか大きい方に縮小されます。
- ファイルの 25% が未使用領域であるサイズ
- ファイルが作成されたときのサイズ
読み取り専用データベースは圧縮できません。
OFF

データベースファイルは、未使用領域の定期的なチェック中に自動的に圧縮されることはありません。

Note

AUTO_SHRINK オプションは、包含データベースでは使用できません。

AUTO_UPDATE_STATISTICS { ON |OFF }

ON

クエリで使用される場合、および統計が古くなっている可能性がある場合に、クエリオプティマイザーによって更新されるように指定します。挿入、更新、削除、またはマージの各操作によってテーブルまたはインデックス付きビューのデータの分布が変わると、統計は古くなったと判断されます。クエリオプティマイザーでは、統計が前回更新されてから発生したデータ変更の数をカウントし、その変更の数をしきい値と比較することで、統計が古くなっている可能性がないかを判断します。このしきい値は、テーブルまたはインデックス付きビューの行数に基づいて決められます。

クエリオプティマイザーによる古い統計の確認は、クエリをコンパイルする前と、キャッシュされたクエリプランを実行する前に行われます。クエリオプティマイザーでは、古くなっている可能性がある統計を判断するため、クエリ述語内の列、テーブル、インデックス付きビューが使用されます。この情報は、クエリがコンパイルされる前にクエリオプティマイザーによって判断されます。キャッシュされたクエリプランを実行する前は、データベースエンジンで、クエリプランが最新の統計を参照しているかどうかが確認されます。

AUTO_UPDATE_STATISTICS オプションは、インデックスに対して作成された統計、クエリ述語内の列に対して 1 列ずつ作成された統計、および CREATE STATISTICS ステートメントを使用して作成された統計に適用されます。また、フィルター選択された統計情報にも適用されます。

既定値は ON です。ほとんどのデータベースで既定の設定を使用することをお勧めします。

統計を同期的に更新するか非同期的に更新するかを指定するには、AUTO_UPDATE_STATISTICS_ASYNC オプションを使用します。
OFF

統計がクエリで使用されるときに、クエリオプティマイザーによって統計が更新されないことを指定します。また、統計が古くなっている可能性がある場合は、クエリオプティマイザーによって更新されません。このオプションを OFF に設定すると、最適ではないクエリプランが作成されて、クエリのパフォーマンスが低下することがあります。

For more information, see the section "Using the database-wide statistics options" in Statistics.

AUTO_UPDATE_STATISTICS_ASYNC { ON |OFF }

ON

AUTO_UPDATE_STATISTICS オプションの統計の更新を非同期更新にするように指定します。クエリオプティマイザーでは、統計の更新が完了するのを待たずにクエリをコンパイルします。

AUTO_UPDATE_STATISTICS が ON に設定されていなければ、このオプションを ON に設定しても、効果はありません。

既定では、AUTO_UPDATE_STATISTICS_ASYNC オプションは OFF に設定されており、クエリオプティマイザーによる統計は同期更新となります。
OFF

AUTO_UPDATE_STATISTICS オプションの統計の更新を同期更新にするように指定します。クエリオプティマイザーでは、統計の更新が完了するのを待ってからクエリをコンパイルします。

AUTO_UPDATE_STATISTICS が ON に設定されていなければ、このオプションを OFF に設定しても、効果はありません。

You can determine this option's status by examining the is_auto_update_stats_async_on column in the sys.databases catalog view.

For more information that describes when to use synchronous or asynchronous statistics updates, see the section "Using the database-wide statistics options" in Statistics.

<automatic_tuning_option> ::=

Controls automatic options for Automatic tuning.

FORCE_LAST_GOOD_PLAN = { DEFAULT |ON |OFF }

Enables or disables FORCE_LAST_GOOD_PLANAutomatic tuning option.

DEFAULT

Azure SQL Managed Instance の既定値は ON です。
ON

新しいクエリプランがパフォーマンスの低下を引き起こしている Transact-SQL クエリに対して、データベースエンジンでは最後の既知の正常なプランが自動的に強制されます。データベースエンジンでは、強制プランを使用する Transact-SQL クエリのクエリパフォーマンスが継続的に監視されます。パフォーマンスの向上がある場合、データベースエンジンでは、最新の既知の適切なプランが引き続き使用されます。パフォーマンスの向上が検出されない場合、データベースエンジンによって新しいクエリプランが生成されます。 The statement fails if the Query Store isn't enabled, or isn't in Read-Write mode. これが既定値です。
OFF

The Database Engine reports potential query performance regressions caused by query plan changes in sys.dm_db_tuning_recommendations view. ただし、これらの推奨事項は自動的には適用されません。ユーザーは、ビューに表示される Transact-SQL スクリプトを適用することによって、アクティブな推奨事項を監視し、特定された問題を解決できます。

<change_tracking_option> ::=

ON

データベースの変更の追跡を有効にします。変更の追跡を有効にすると、AUTO CLEANUP オプションと CHANGE RETENTION オプションも設定できます。

AUTO_CLEANUP = { ON |OFF }

ON

指定した保有期間を過ぎると、変更追跡情報が自動的に削除されます。
OFF

変更追跡データはデータベースから削除されません。

CHANGE_RETENTION = retention_period { DAYS | HOURS | MINUTES }

データベースに変更追跡情報を保持する最低限の期間を指定します。データは、AUTO_CLEANUP の値が ON のときにのみ削除されます。

retention_period is an integer that specifies the numerical component of the retention period.

The default retention period is 2 days. 最小保有期間は 1 分です。 The default retention type is DAYS.

OFF

データベースの変更の追跡を無効にします。データベースの変更の追跡を無効にする前に、すべてのテーブルで変更の追跡を無効にしてください。

<cursor_option> ::=

カーソルオプションを制御します。

CURSOR_CLOSE_ON_COMMIT { ON |OFF }

ON

トランザクションをコミットまたはロールバックしたときに開いていたカーソルはすべて閉じられます。
OFF

トランザクションがコミットされても、カーソルは開いたままになります。トランザクションをロールバックすると、INSENSITIVE または STATIC として定義されているカーソルを除き、すべてのカーソルが閉じます。

You can determine this option's status by examining the is_cursor_close_on_commit_on column in the sys.databases catalog view or the IsCloseCursorsOnCommitEnabled property of the DATABASEPROPERTYEX function. 接続が切断されたときだけカーソルが暗黙的に割り当てを解除されます。 For more information, see DECLARE CURSOR.

<db_encryption_option> ::=

データベース暗号化の状態を制御します。

ENCRYPTION { ON |OFF }

You can see the encryption state of the database by using the sys.dm_database_encryption_keys dynamic management view.

<delayed_durability_option> ::=

トランザクションを完全持続性または遅延持続性のどちらとしてコミットするかどうかを制御します。

DISABLED

SET DISABLED 以後のトランザクションはすべて完全持続性になります。 ATOMIC ブロックまたは COMMIT ステートメントで設定された持続性オプションは無視されます。
ALLOWED

SET ALLOWED 以後のトランザクションはすべて、ATOMIC ブロックまたは COMMIT ステートメントで設定された持続性オプションに応じて、完全持続性または遅延持続性になります。
FORCED

SET FORCED 以後のトランザクションはすべて遅延持続性になります。 ATOMIC ブロックまたは COMMIT ステートメントで設定された持続性オプションは無視されます。

<PARAMETERIZATION_option> ::=

パラメーター化オプションを制御します。

パラメーター化 { 単純 |FORCED }

SIMPLE

クエリは、データベースの既定の動作に基づいてパラメーター化されます。
FORCED

SQL Server は、データベース内にあるすべてのクエリをパラメーター化します。

The current setting of this option can be determined by examining the is_parameterization_forced column in the sys.databases catalog view.

<query_store_options> ::=

ON |OFF |CLEAR [ すべて ]

このデータベースでクエリストアを有効にするかどうかを制御します。また、クエリストアの内容の削除も制御します。
- ON
  
  クエリのストアを有効にします。
- OFF
  
  クエリのストアを無効にします。これが既定値です。
- CLEAR
  
  クエリストアの内容を削除します。

OPERATION_MODE

CLEANUP_POLICY

DATA_FLUSH_INTERVAL_SECONDS

MAX_STORAGE_SIZE_MB

クエリストアに割り当てる領域を指定します。 MAX_STORAGE_SIZE_MB is type bigint. The default value is 100 MB.

十分な領域がクリアされると、クエリストアモードは自動的に読み取り/書き込みに切り替わります。

Important

If you think that your workload capture needs more than 10 GB of disk space, you should probably rethink and optimize your workload to reuse query plans (for example using forced parameterization, or adjust the Query Store configurations.
SQL Server 2019 (15.x) 以降および Azure SQL データベースでは、QUERY_CAPTURE_MODE を CUSTOM に設定して、クエリキャプチャポリシーをさらに制御することができます。
Azure SQL Managed Instance では、MAX_STORAGE_SIZE_MB 設定の上限は 10,240 MB です。

INTERVAL_LENGTH_MINUTES

SIZE_BASED_CLEANUP_MODE = { AUTO |OFF }

データの総量が最大サイズに近づくとクリーンアップを自動的にアクティブ化するかどうかを制御します。

OFF

サイズベースのクリーンアップは自動的にアクティブ化されません。
AUTO

Size-based cleanup is automatically activated when size on disk reaches 90% of max_storage_size_mb. サイズのクリーンアップでは、まず最も安価で最も古いクエリを削除します。 It stops at approximately 80% of max_storage_size_mb. これは既定の構成値です。

SIZE_BASED_CLEANUP_MODE is type nvarchar.

QUERY_CAPTURE_MODE { ALL |AUTO |CUSTOM |NONE }

現在アクティブなクエリのキャプチャモードを指定します。

ALL

すべてのクエリがキャプチャされます。
AUTO

実行の数とリソースの消費量に基づいて関連するクエリがキャプチャされます。これは Azure SQL データベースの既定の構成値です。
NONE

新しいクエリのキャプチャを停止します。クエリストアは、既にキャプチャされたクエリのコンパイルとランタイムの統計を引き続き収集します。重要なクエリのキャプチャが間違う可能性があるため、この構成は慎重に使用してください。

QUERY_CAPTURE_MODE is type nvarchar.

MAX_PLANS_PER_QUERY

各クエリに対して保持の計画の最大数を表す整数。 MAX_PLANS_PER_QUERY is type int. The default value is 200.

WAIT_STATS_CAPTURE_MODE { ON |OFF }

待機統計をクエリごとにキャプチャするかどうかを制御します。

ON

クエリごとの待機統計情報がキャプチャされます。この値は既定の構成値です。
OFF

クエリごとの待機統計情報はキャプチャされません。

<query_capture_policy_option_list> :: =

STALE_CAPTURE_POLICY_THRESHOLD = integer { DAYS | HOURS }

クエリをキャプチャすべきかどうかを決定する評価の間隔を定義します。既定値は 1 日で、1 時間から 7 日に設定できます。

EXECUTION_COUNT = integer

TOTAL_COMPILE_CPU_TIME_MS = integer

TOTAL_EXECUTION_CPU_TIME_MS = integer

<snapshot_option> ::=

トランザクション分離レベルを示します。

ALLOW_SNAPSHOT_ISOLATION { ON |OFF }

ON

データベースレベルでのスナップショットオプションを有効にします。有効にした場合、スナップショット分離を使用するトランザクションがなくても、DML ステートメントによって、行バージョンの生成が開始されます。このオプションを有効にすると、トランザクションで SNAPSHOT トランザクション分離レベルを指定できます。 SNAPSHOT 分離レベルでトランザクションが実行されると、すべてのステートメントはトランザクション開始時のデータのスナップショットを参照します。 SNAPSHOT 分離レベルで実行されているトランザクションが複数のデータベースのデータにアクセスする場合は、すべてのデータベースで ALLOW_SNAPSHOT_ISOLATION が ON に設定されている必要があります。ALLOW_SNAPSHOT_ISOLATION が OFF になっているデータベース内のテーブルにアクセスする場合は、トランザクション内の各ステートメントで、FROM 句内のすべての参照に対してロックヒントを使用する必要があります。
OFF

データベースレベルでのスナップショットオプションを無効にします。トランザクションでは、SNAPSHOT トランザクション分離レベルを指定できません。

ALLOW_SNAPSHOT_ISOLATION を新しい状態に (ON から OFF へ、または OFF から ON へ) 設定した場合、ALTER DATABASE は、データベース内にあるすべての既存のトランザクションがコミットされるまで、呼び出し元に制御を返しません。データベースが既に ALTER DATABASE ステートメントで指定した状態にある場合には、制御は呼び出し元に直ちに返されます。 If the ALTER DATABASE statement doesn't return quickly, use sys.dm_tran_active_snapshot_database_transactions to determine whether there are long-running transactions. ALTER DATABASE ステートメントが取り消された場合、データベースは、ALTER DATABASE が開始された時点での状態に留まります。 The sys.databases catalog view indicates the state of snapshot-isolation transactions in the database. snapshot_isolation_state_desc = IN_TRANSITION_TO_ON場合、ステートメント ALTER DATABASE ... ALLOW_SNAPSHOT_ISOLATION OFF 6 秒間一時停止し、操作を再試行します。

データベースが OFFLINE の場合には、ALLOW_SNAPSHOT_ISOLATION の状態を変更できません。

master、model、msdb、および tempdb データベースでは、ALLOW_SNAPSHOT_ISOLATION 設定を変更できます。 tempdb でこの設定を変更すると、この設定は、データベースエンジンのインスタンスが停止および再起動されるたびに保持されます。 model システムデータベースでこの設定を変更すると、この設定は、作成されたすべての新しいデータベース (tempdb を除く) の既定値となります。

master および msdb データベースでは、このオプションは既定で ON になります。

The current setting of this option can be determined by examining the snapshot_isolation_state column in the sys.databases catalog view.

READ_COMMITTED_SNAPSHOT { ON |OFF }

ON

データベースレベルで READ COMMITTED スナップショットオプションを有効にします。有効にした場合、スナップショット分離を使用するトランザクションがなくても、DML ステートメントによって、行バージョンの生成が開始されます。このオプションを有効にすると、READ COMMITTED 分離レベルを指定しているトランザクションは、ロックではなく、行のバージョン管理を使用します。トランザクションが READ COMMITTED 分離レベルで実行されている場合、すべてのステートメントは、ステートメントの開始時に存在していたデータのスナップショットを参照します。
OFF

データベースレベルでの Read Committed スナップショットオプションを無効にします。 READ COMMITTED 分離レベルを指定しているトランザクションは、ロックを使用します。

master、tempdb、または msdb システムデータベースでは、READ_COMMITTED_SNAPSHOT を ON に設定することはできません。 model システムデータベースでこの設定を変更すると、この設定は、作成されたすべての新しいデータベース (tempdb を除く) の既定値となります。

The current setting of this option can be determined by examining the is_read_committed_snapshot_on column in the sys.databases catalog view.

Warning

DURABILITY = SCHEMA_ONLYでテーブルが作成され、その後 ALTER DATABASEを使用して READ_COMMITTED_SNAPSHOT 変更されると、テーブル内のデータは失われます。

MEMORY_OPTIMIZED_ELEVATE_TO_SNAPSHOT { ON |OFF }

ON

トランザクション分離レベルが SNAPSHOT より低い分離レベルに設定されている場合は、メモリ最適化テーブル上で解釈されたすべての Transact-SQL 操作が SNAPSHOT 分離レベルで実行されます。 SNAPSHOT よりも低い分離レベルの例として、READ COMMITTED、READ UNCOMMITTEDREAD があります。このような操作は、トランザクション分離レベルがセッションレベルで明示的に設定されているか、既定値が暗黙的に使用されるかに関係なく実行されます。
OFF

メモリ最適化テーブル上で解釈された Transact-SQL 操作のトランザクション分離レベルは引き上げられません。

データベースが OFFLINE の場合には、MEMORY_OPTIMIZED_ELEVATE_TO_SNAPSHOT の状態を変更できません。

既定値は OFF です。

The current setting of this option can be determined by examining the is_memory_optimized_elevate_to_snapshot_on column in the sys.databases catalog view.

<sql_option> ::=

ANSI 準拠のオプションをデータベースレベルで制御します。

ANSI_NULL_DEFAULT { ON |OFF }

ON

既定値は NULL です。
OFF

既定値は NOT NULL になります。

ANSI 互換性を確保するために、データベースオプション ANSI_NULL_DEFAULT を ON に設定すると、データベースの既定値が NULL に変更されます。

ANSI_NULLS { ON |OFF }

ON

NULL 値との比較結果は、すべて UNKNOWN になります。
OFF

Unicode 以外の値と null 値の比較結果は、両方の値が NULL である場合には TRUE になります。

Important

SET ANSI_NULLS は、計算列やインデックス付きビューのインデックスを作成または変更する場合にも、ON に設定する必要があります。

ANSI_PADDING { ON |OFF }

ON

比較を行う前に、文字列が同じ長さになるようにパディングされます。 Also padded to the same length before inserting to a varchar or nvarchar data type.
OFF

Inserts trailing blanks in character values into varchar or nvarchar columns. Also leaves trailing zeros in binary values that are inserted into varbinary columns. 列の長さに合わせるためにパディングされることはありません。

OFF を指定した場合、この設定は新しい列の定義にのみ影響します。

Important

ANSI_WARNINGS { ON |OFF }

ON

0 除算などの状態になったときに、エラーまたは警告が発行されます。集計関数に NULL 値が出現した場合にも、エラーと警告が発行されます。
OFF

0 除算などの条件が発生しても、警告は発行されず、NULL 値が返されます。

Important

SET ANSI_WARNINGS は、計算列やインデックス付きビューのインデックスを作成または変更する場合には、ON に設定する必要があります。

ARITHABORT { ON |OFF }

ON

クエリ実行中にオーバーフローエラーまたは 0 除算エラーが発生した場合に、クエリを終了します。
OFF

このようなエラーのいずれかが発生した場合に警告メッセージが表示されます。警告が表示された場合でも、クエリ、バッチ、またはトランザクションは、エラーが発生しなかったかのように処理を続行します。

Important

SET ARITHABORT は、計算列またはインデックス付きビューのインデックスを作成または変更するときに有効 (ON) にする必要があります。

COMPATIBILITY_LEVEL = { 170 | 160 | 150 | 140 | 130 | 120 | 110 | 100 }

詳細については、ALTER DATABASE 互換性レベルを参照してください。

CONCAT_NULL_YIELDS_NULL { ON |OFF }

ON

オペランドのいずれかが NULL の場合、連結操作の結果は NULL になります。たとえば、文字列 "This is" と NULL を連結すると、結果は "This is" ではなく NULL になります。
OFF

null 値は空の文字列として扱われます。

Important

CONCAT_NULL_YIELDS_NULL は、計算列やインデックス付きビューのインデックスを作成または変更する場合には、ON に設定する必要があります。

NUMERIC_ROUNDABORT { ON |OFF }

ON

式の精度が低下した場合にエラーが生成されます。
OFF

有効桁数の損失が発生してもエラーメッセージが生成されず、結果を格納する列または変数の有効桁数に丸められます。

Important

NUMERIC_ROUNDABORT は、計算列やインデックス付きビューのインデックスを作成または変更する場合は、OFF に設定する必要があります。

QUOTED_IDENTIFIER { ON |OFF }

ON

識別子を囲む二重引用符を使用できます。

二重引用符で囲まれた文字列はすべて、オブジェクト識別子として解釈されます。引用符で囲まれた識別子は、Transact-SQL の識別子の規則に従う必要はありません。これはキーワードにすることができます。また、Transact-SQL 識別子では許可されない文字を含めることができます。二重引用符 (") が識別子の一部である場合は、2 つの二重引用符 ("") で表すことができます。
OFF

識別子を引用符で囲むことができず、Transact-SQL の識別子に関するすべての規則に従う必要があります。リテラルは単一引用符と二重引用符のどちらで区切ることもできます。

RECURSIVE_TRIGGERS { ON |OFF }

ON

AFTER トリガーの再帰呼び出しを実行できるようになります。
OFF

You can determine this option's status by examining the is_recursive_triggers_on column in the sys.databases catalog view. You can also determine the status by examining the IsRecursiveTriggersEnabled property of the DATABASEPROPERTYEX function.

Note

RECURSIVE_TRIGGERS に OFF に設定されている場合、直接再帰呼び出しのみが回避されます。間接再帰呼び出しを無効にするには、nested triggers サーバーオプションを 0 に設定する必要があります。

<target_recovery_time_option> ::=

target_recovery_time_option isn't supported on Azure SQL Managed Instance.

間接的なチェックポイントの生成頻度をデータベースごとに指定します。 Starting with SQL Server 2016 (13.x) the default value for new databases is 1 minute, which indicates database uses indirect checkpoints. 古いバージョンの場合、既定値は 0 です。これは、サーバーインスタンスの回復間隔の設定に依存する自動チェックポイントがデータベースで使用されることを示します。 Microsoft では、ほとんどのシステムに対して 1 分をお勧めします。

WITH <termination> ::=

Note

ROLLBACK AFTER integer [SECONDS] | ROLLBACK IMMEDIATE

指定した秒数の後、または直ちにロールバックするかどうかを指定します。
NO_WAIT

要求されたデータベースの状態またはオプションの変更をすぐに完了できない場合に要求が失敗することを指定します。すぐに完了とは、トランザクションが自身のコミットまたはロールバック処理を待機しないことを意味します。

<temporal_history_retention> ::=

TEMPORAL_HISTORY_RETENTION { ON |OFF }

ただし、既定では、ON はポイントインタイムリストア操作の後、自動的にOFF に設定されます。この設定を有効にする方法など、詳細については、「リテンションポリシーの構成方法」を参照してください。
- ON
  
  Default. テンポラルテーブルの保持ポリシーを有効にします。詳細については、「システムバージョン管理されたテンポラルテーブルの履歴データの保有期間管理」を参照してください。
- OFF
  
  一時的な履歴保持ポリシーは実行しないでください。

Set options

To retrieve current settings for database options, use the sys.databases catalog view or DATABASEPROPERTYEX

データベースオプションを設定すると、新しい設定は直ちに有効になります。

新しく作成されるすべてのデータベースについて、任意のデータベースオプションの既定値を変更できます。これを実行するには、model システムデータベース内の適切なデータベースオプションを変更します。

Examples

A. データベースのスナップショット分離を有効にする

次の例では、AdventureWorks2022 データベースに対する SNAPSHOT 分離フレームワークオプションを有効にします。

USE master;
GO
ALTER DATABASE [database_name]
SET ALLOW_SNAPSHOT_ISOLATION ON;
GO
-- Check the state of the snapshot_isolation_framework
-- in the database.
SELECT name, snapshot_isolation_state,
    snapshot_isolation_state_desc AS description
FROM sys.databases
WHERE name = N'[database_name]';
GO

結果セットは、SNAPSHOT 分離フレームワークが有効であることを示しています。

name	snapshot_isolation_state	description
[database_name]	1	ON

B. 変更の追跡を有効化、変更、または無効化する

次の例では、AdventureWorks2022 データベースで変更の追跡を有効にし、保有期間を 2 日に設定します。

ALTER DATABASE [database_name]
SET CHANGE_TRACKING = ON
(AUTO_CLEANUP = ON, CHANGE_RETENTION = 2 DAYS);

次の例では、保有期間を 3 日に変更する方法を示します。

ALTER DATABASE [database_name]
SET CHANGE_TRACKING (CHANGE_RETENTION = 3 DAYS);

次の例では、AdventureWorks2022 データベースで変更の追跡を無効にする方法を示します。

ALTER DATABASE [database_name]
SET CHANGE_TRACKING = OFF;

C. クエリストアを有効にする

次の例では、クエリストアを有効にし、クエリストアのパラメーターを構成します。

ALTER DATABASE [database_name]
SET QUERY_STORE = ON
    (
      OPERATION_MODE = READ_WRITE,
      CLEANUP_POLICY = ( STALE_QUERY_THRESHOLD_DAYS = 90 ),
      DATA_FLUSH_INTERVAL_SECONDS = 900,
      QUERY_CAPTURE_MODE = AUTO,
      MAX_STORAGE_SIZE_MB = 1024,
      INTERVAL_LENGTH_MINUTES = 60
    );

D. 待機統計を使ってクエリストアを有効にする

次の例では、クエリストアを有効にし、そのパラメーターを構成します。

ALTER DATABASE [database_name]
SET QUERY_STORE = ON
    (
      OPERATION_MODE = READ_WRITE,
      CLEANUP_POLICY = ( STALE_QUERY_THRESHOLD_DAYS = 90 ),
      DATA_FLUSH_INTERVAL_SECONDS = 900,
      MAX_STORAGE_SIZE_MB = 1024,
      INTERVAL_LENGTH_MINUTES = 60,
      SIZE_BASED_CLEANUP_MODE = AUTO,
      MAX_PLANS_PER_QUERY = 200,
      WAIT_STATS_CAPTURE_MODE = ON
    );

E. カスタムキャプチャポリシーオプションを使ってクエリストアを有効にする

次の例では、クエリストアを有効にし、そのパラメーターを構成します。

ALTER DATABASE [database_name]
SET QUERY_STORE = ON
    (
      OPERATION_MODE = READ_WRITE,
      CLEANUP_POLICY = ( STALE_QUERY_THRESHOLD_DAYS = 90 ),
      DATA_FLUSH_INTERVAL_SECONDS = 900,
      MAX_STORAGE_SIZE_MB = 1024,
      INTERVAL_LENGTH_MINUTES = 60,
      SIZE_BASED_CLEANUP_MODE = AUTO,
      MAX_PLANS_PER_QUERY = 200,
      WAIT_STATS_CAPTURE_MODE = ON,
      QUERY_CAPTURE_MODE = CUSTOM,
      QUERY_CAPTURE_POLICY = (
        STALE_CAPTURE_POLICY_THRESHOLD = 24 HOURS,
        EXECUTION_COUNT = 30,
        TOTAL_COMPILE_CPU_TIME_MS = 1000,
        TOTAL_EXECUTION_CPU_TIME_MS = 100
      )
    );

* Azure Synapse
分析 *

Azure Synapse Analytics

Syntax

ALTER DATABASE { database_name }
SET
{
    <optionspec> [ ,...n ]
}
;

<option_spec>::=
{
    <auto_option>
  | <db_encryption_option>
  | <query_store_options>
  | <result_set_caching>
  | <snapshot_option>
}
;

<auto_option> ::=
{
    AUTO_CREATE_STATISTICS { OFF | ON }
}

<db_encryption_option> ::=
{
    ENCRYPTION { ON | OFF }
}

<query_store_option> ::=
{
    QUERY_STORE { OFF | ON }
}

<result_set_caching_option> ::=
{
    RESULT_SET_CACHING { ON | OFF }
}

<snapshot_option> ::=
{
    READ_COMMITTED_SNAPSHOT { ON | OFF }
}

Arguments

database_name

変更するデータベースの名前。

<auto_option> ::=

自動オプションを制御します。

AUTO_CREATE_STATISTICS { ON |OFF }

ON

クエリプランを改善してクエリのパフォーマンスを向上させるために、クエリオプティマイザーが必要に応じてクエリ述語内の列に対して 1 列ずつ統計を作成します。これらの 1 列ずつの統計は、クエリオプティマイザーがクエリをコンパイルする場合に作成されます。 1 列ずつの統計は、まだ既存の統計オブジェクトの最初の列になっていない列についてのみ作成されます。

既定値は ON です。ほとんどのデータベースで既定の設定を使用することをお勧めします。
OFF

クエリオプティマイザーがクエリをコンパイルするときにクエリ述語内の列の 1 列ずつの統計が作成されません。このオプションを OFF に設定すると、最適ではないクエリプランが作成されて、クエリのパフォーマンスが低下することがあります。

このコマンドは、ユーザーデータベースに接続しているときに実行する必要があります。

For more information, see the section "Using the database-wide statistics options" in Statistics.

<db_encryption_option> ::=

データベース暗号化の状態を制御します。

ENCRYPTION { ON |OFF }

ON

暗号化するデータベースを設定します。
OFF

暗号化しないデータベースを設定します。

データベースの暗号化の状態や暗号化スキャンの状態を確認するには、sys.dm_database_encryption_keys 動的管理ビューを使用します。

<query_store_option> ::=

このデータウェアハウスでクエリストアを有効にするかどうかを制御します。

QUERY_STORE { ON |OFF }

ON

クエリのストアを有効にします。
OFF

クエリのストアを無効にします。既定値は OFF です。

Note

Azure Synapse Analytics の場合、ユーザーデータベースから ALTER DATABASE SET QUERY_STORE を実行する必要があります。別のデータウェアハウスインスタンスからのステートメントの実行は、サポートされていません。

Note

Azure Synapse Analytics の場合、クエリストアは他のプラットフォームと同様に有効にできますが、追加の構成オプションはサポートされていません。

<result_set_caching_option> ::=

Applies to: Azure Synapse Analytics

クエリ結果をデータベースにキャッシュするかどうかを制御します。

RESULT_SET_CACHING { ON |OFF }

ON

このデータベースから返されるクエリ結果セットをデータベースにキャッシュすることを指定します。
OFF

このデータベースから返されるクエリ結果セットがデータベースにキャッシュされないように指定します。

このコマンドは、master データベースに接続しているときに実行する必要があります。このデータベースの設定変更はすぐに適用されます。クエリの結果セットをキャッシュすることでストレージコストが発生します。データベースの結果キャッシュを無効にすると、以前に永続化された結果キャッシュが Azure Synapse ストレージから直ちに削除されます。

データベースの結果セットのキャッシュ構成を確認するには、次のコマンドを実行します。結果セットのキャッシュが有効になっている場合、is_result_set_caching_on は 1 を返します。

SELECT name, is_result_set_caching_on FROM sys.databases
WHERE name = <'Your_Database_Name'>

このコマンドを実行すると、キャッシュ済みの結果を利用してクエリが実行されたか確認されます。 result_cache_hit 列は、キャッシュヒットの場合は 1、キャッシュミスの場合は 0、結果セットのキャッシュが使用されなかった理由から負の値を返します。 Check sys.dm_pdw_exec_requests for details.

SELECT request_id, command, result_cache_hit FROM sys.dm_pdw_exec_requests
WHERE request_id = <'Your_Query_Request_ID'>

Note

Result set caching should not be used in conjunction with DECRYPTBYKEY. If this cryptographic function must be used, ensure you have result set caching disabled (either at session-level or database-level) at the time of execution.

Important

結果セットのキャッシュを作成し、キャッシュからデータを取得する操作は、データウェアハウスインスタンスの制御ノードで行われます。結果セットのキャッシュを有効にした場合、大きな結果セット (たとえば 100 万行超) を返すクエリを実行すると、制御ノードで CPU 使用率が高くなり、インスタンスでのクエリ応答全体が遅くなる可能性があります。これらのクエリは、通常、データの探索または ETL 操作で使用されます。制御ノードに負荷を与え、パフォーマンスの問題が発生するのを防ぐため、ユーザーは、このようなクエリを実行する前に、データベースの結果セットのキャッシュを無効にする必要があります。

結果セットのキャッシュによるパフォーマンスチューニングの詳細については、「パフォーマンスチューニングガイダンス」を確認してください。

Permissions

RESULT_SET_CACHING オプションを設定するには、ユーザーにサーバーレベルのプリンシプルログインを与えるか (プロビジョニングプロセスで作成されるもの)、ユーザーが dbmanager データベースロールのメンバーになる必要があります。

<snapshot_option> ::=

Applies to: Azure Synapse Analytics

データベースのトランザクション分離レベルを制御します。

READ_COMMITTED_SNAPSHOT { ON |OFF }

ON

データベースレベルで READ_COMMITTED_SNAPSHOT オプションを有効にします。
OFF

データベースレベルで READ_COMMITTED_SNAPSHOT オプションを無効にします。

このコマンドは、master データベースに接続しているときに実行する必要があります。ユーザーデータベースREAD_COMMITTED_SNAPSHOTオンまたはオフにすると、このデータベースに対して開いているすべての接続が強制終了されます。この変更は、データベースのメンテナンス期間中に行うか、ALTER DATABASE コマンドを実行する接続を除き、データベースへのアクティブな接続が存在しないまで待つ必要があります。データベースがシングルユーザーモードになっている必要はありません。セッションレベルで READ_COMMITTED_SNAPSHOT 設定を変更することはできません。データベースでこの設定を確認するには、is_read_committed_snapshot_on の sys.databases 列をチェックします。

READ_COMMITTED_SNAPSHOTが有効になっているデータベースでは、複数のデータバージョンが存在する場合、バージョンのスキャンによってクエリのパフォーマンスが低下する可能性があります。トランザクションが長時間になると、データベースが増大することもあります。この問題は、バージョンクリーンアップをブロックするこのようなトランザクションでデータが変更される場合に発生します。

Permissions

READ_COMMITTED_SNAPSHOT オプションを設定するには、ユーザーにデータベースの ALTER 権限を与える必要があります。

Examples

データベースの統計設定を確認する

SELECT name, is_auto_create_stats_on FROM sys.databases

データベースのクエリストアを有効にする

ALTER DATABASE [database_name]
SET QUERY_STORE = ON;

データベースに対して結果セットのキャッシュを有効にする

-- Run this command when connecting to the MASTER database

ALTER DATABASE [database_name]
SET RESULT_SET_CACHING ON;

データベースに対する結果セットのキャッシュを確認する

SELECT name, is_result_set_caching_on
FROM sys.databases;

データベースの Read_Committed_Snapshot オプションを有効にする

master データベースに接続するときに、このコマンドを実行します。

ALTER DATABASE MyDatabase
SET READ_COMMITTED_SNAPSHOT ON;

SQL Server

SQL Database

SQL Managed Instance

Azure Synapse
Analytics

Microsoft Fabric

Microsoft Fabric

ALTER DATABASE ... SETを使用して Microsoft Fabric Warehouse を管理します。

Syntax

-- Microsoft Fabric Data Warehouse

ALTER DATABASE { warehouse_name | CURRENT }
SET
{
    <option_spec> [ ,...n ] 
}

<option_spec> ::=
{
    <data_lake_log_publishing>
  | <vorder>
  | <timestamp>
  | <result_set_caching>
}
;

<data_lake_log_publishing> ::=
{
    DATA_LAKE_LOG_PUBLISHING { PAUSED | AUTO }
}

<vorder> ::=
{
    VORDER = OFF
}

<timestamp> ::=
{
    TIMESTAMP = {CURRENT_TIMESTAMP | 'YYYY-MM-DDTHH:MM:SS.SS' }  
}


<result_set_caching> ::=
{    
    RESULT_SET_CACHING { ON | OFF } 
}

Arguments

DATA_LAKE_LOG_PUBLISHING

Delta Lake ログの発行を一時停止または再開します。詳細については、 Delta Lake ログの発行に関するページを参照してください。

VORDER

V オーダー動作を無効にすることができます。詳細については、倉庫での V オーダー動作の無効化を参照してください。

TIMESTAMP

Fabric Data Warehouse の既存のウェアハウススナップショットのタイムスタンプを更新します。タイムスタンプは UTC タイムゾーンで指定する必要があります。 For more information, see Warehouse snapshots.

RESULT_SET_CACHING

現在のアイテムの結果セットキャッシュ (プレビュー) を有効または無効にします。詳細については、「結果セットのキャッシュ」を参照してください。

Permissions

ユーザーは、Fabric ワークスペースの管理者、メンバー、または共同作成者ロールのメンバーである必要があります。

Examples

A. Delta Lake ログの発行の一時停止

次の T-SQL コマンドは、現在のウェアハウスコンテキストで Delta Lake Log の発行を一時停止します。

ALTER DATABASE CURRENT SET DATA_LAKE_LOG_PUBLISHING = PAUSED;

To check the current status of Delta Lake Log publishing on all warehouses, of your workspace, use the following T-SQL code to query sys.databases in a new query window:

SELECT [name], [DATA_LAKE_LOG_PUBLISHING_DESC] FROM sys.databases;

B. 結果セットのキャッシュの設定と確認 (プレビュー)

次の T-SQL コマンドを使用すると、項目 MyDataWarehouse で、該当する SELECT クエリの作成と結果セットキャッシュ (プレビュー) の適用を開始できます。詳細については、「結果セットのキャッシュ」を参照してください。

ALTER DATABASE [MyDataWarehouse] SET RESULT_SET_CACHING ON;

The column is_result_set_caching_on from sys.databases can then be checked to confirm that result set caching (preview) has been enabled.

SELECT [name], [is_result_set_caching_on] FROM sys.databases;

Microsoft Fabric のデータウェアハウスとは
Microsoft Fabric の Warehouse で Delta Lake ログをする
Microsoft Fabric Warehouse の V オーダーについて

次の方法で共有

ALTER DATABASE の SET オプション (Transact-SQL)

製品を選択する

SQL Server

Syntax

Arguments

database_name

CURRENT

<accelerated_database_recovery> ::=

<auto_option> ::=

AUTO_CLOSE { ON |OFF }

AUTO_CREATE_STATISTICS { ON |OFF }

INCREMENTAL = ON |オフ

AUTO_SHRINK { ON |OFF }

AUTO_UPDATE_STATISTICS { ON |OFF }

AUTO_UPDATE_STATISTICS_ASYNC { ON |OFF }

<automatic_tuning_option> ::=

FORCE_LAST_GOOD_PLAN = { DEFAULT |ON |OFF }

<change_tracking_option> ::=

<containment_option> ::=

CONTAINMENT = { NONE |PARTIAL}

<cursor_option> ::=

CURSOR_CLOSE_ON_COMMIT { ON |OFF }

CURSOR_DEFAULT { LOCAL |GLOBAL }

<temporal_history_retention> ::=

TEMPORAL_HISTORY_RETENTION { ON |OFF }

<data_retention_policy> ::=

DATA_RETENTION { ON |OFF }

<database_mirroring>

<date_correlation_optimization_option> ::=

DATE_CORRELATION_OPTIMIZATION { ON |OFF }

<db_encryption_option> ::=

ENCRYPTION { ON |OFF |SUSPEND |RESUME }

<db_state_option> ::=

<db_update_option> ::=

<db_user_access_option> ::=

SINGLE_USER

RESTRICTED_USER

MULTI_USER

<delayed_durability_option> ::=

<external_access_option> ::=

DB_CHAINING { ON |OFF }

TRUSTWORTHY { ON |OFF }

DEFAULT_FULLTEXT_LANGUAGE

DEFAULT_LANGUAGE

NESTED_TRIGGERS

TRANSFORM_NOISE_WORDS

TWO_DIGIT_YEAR_CUTOFF

<FILESTREAM_option> ::=

NON_TRANSACTED_ACCESS = { オフ |READ_ONLY |フル }

DIRECTORY_NAME = <directory_name>

<HADR_options> ::=

<mixed_page_allocation_option> ::=

MIXED_PAGE_ALLOCATION { OFF |ON }

<PARAMETERIZATION_option> ::=

パラメーター化 { 単純 |FORCED }

<query_store_options> ::=

ON |OFF [ ( FORCED ) ] |CLEAR [ すべて ]

OPERATION_MODE { READ_ONLY |READ_WRITE }

READ_WRITE

READ_ONLY

CLEANUP_POLICY

DATA_FLUSH_INTERVAL_SECONDS

MAX_STORAGE_SIZE_MB

INTERVAL_LENGTH_MINUTES

SIZE_BASED_CLEANUP_MODE { AUTO |OFF }

QUERY_CAPTURE_MODE { ALL |AUTO |CUSTOM |NONE }

MAX_PLANS_PER_QUERY

WAIT_STATS_CAPTURE_MODE { ON |OFF }

<query_capture_policy_option_list> :: =

<recovery_option> ::=

TORN_PAGE_DETECTION { ON |OFF }

PAGE_VERIFY { CHECKSUM |TORN_PAGE_DETECTION |NONE }

<remote_data_archive_option> ::=

REMOTE_DATA_ARCHIVE = { ON ( SERVER = <server_name>, { CREDENTIAL = <db_scoped_credential_name> |FEDERATED_SERVICE_ACCOUNT = ON |OFF } ) |オフ

PERSISTENT_LOG_BUFFER

<service_broker_option> ::=

ENABLE_BROKER

DISABLE_BROKER

NEW_BROKER

E. クエリストアを有効にする

F. 待機統計を使ってクエリストアを有効にする

G. カスタムキャプチャポリシーオプションを使ってクエリストアを有効にする