sp_configure (Transact-SQL)
適用対象:
SQL Server Azure SQL Managed Instance 
Azure Synapse Analytics Analytics Platform System (PDW)
現在のサーバーのグローバル構成設定を表示または変更します。
Note
データベース レベルの構成オプションについては、「ALTER DATABA Standard Edition SCOPED CONFIGURATION (Transact-SQL)」を参照してください。 ソフト NUMA を構成するには、ソフト NUMA (SQL Server) を参照してください。
構文
-- Syntax for SQL Server
sp_configure [ [ @configname = ] 'option_name'
[ , [ @configvalue = ] 'value' ] ]
-- Syntax for Parallel Data Warehouse
-- List all of the configuration options
sp_configure
[;]
-- Configure Hadoop connectivity
sp_configure [ @configname= ] 'hadoop connectivity',
[ @configvalue = ] { 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 }
[;]
RECONFIGURE
[;]
引数
[ @configname = ] 'option_name' 構成オプションの名前を指定します。 option_name は varchar(35)、既定値は NULL です。 SQL Server データベース エンジンは、構成名の一部である一意の文字列を認識します。 指定しない場合、オプションの完全な一覧が返されます。
使用可能な構成オプションとその設定については、「サーバー構成オプション (SQL Server)」を参照してください。
[ @configvalue = ] 'value' 新しい構成設定です。 value のデータ型は intで、既定値は NULL です。 最大値はオプションごとに異なります。
各オプションの最大値を確認するには、sys.configurations カタログ ビューの最大列を参照してください。
リターン コードの値
0 (成功) または 1 (失敗)
結果セット
パラメーターなしで実行すると、 sp_configure は 5 列の結果セットを返し、次の表に示すように、オプションをアルファベット順に昇順に並べ替えます。
config_valueとrun_valueの値は自動的には同じではありません。 sp_configureを使用して構成設定を更新した後、システム管理者は RECONFIGURE または RECONFIGURE WITH OVERRIDE を使用して、実行中の構成値を更新する必要があります。 詳細については、「解説」を参照してください。
| 列名 | データ型 | 説明 |
|---|---|---|
| name | nvarchar(35) | 構成オプションの名前。 |
| minimum | int | 構成オプションの最小値。 |
| maximum | int | 構成オプションの最大値。 |
| config_value | int | sp_configure (sys.configurations.value の値) を使用して構成オプションが設定された値。 これらのオプションの詳細については、「 サーバー構成オプション (SQL Server) と sys.configurations (Transact-SQL)」を参照してください。 |
| run_value | int | 現在、構成オプションの値 (sys.configurations.value_in_useの値) が実行されています。 詳しくは、「sys.configurations (Transact-SQL)」を参照してください。 |
解説
sp_configureを使用して、サーバー レベルの設定を表示または変更します。 データベース レベルの設定を変更するには、ALTER DATABASE 現在のユーザー セッションにのみ影響する設定を変更するには、ステートメントを SET 使用します。
一部のサーバー構成オプションは、ALTER Standard Edition RVER CONFIGURATION (Transact-SQL) でのみ使用できます。
SQL Server ビッグ データ クラスター
サーバー設定のインスタンス レベルでの構成、またはデータベースの可用性グループへの手動での追加などの一部の操作は、SQL Server インスタンスへの接続が必要です。 可用性グループに属するデータベース内での sp_configure、RESTORE DATABASE、または DDL コマンドのような操作は、SQL Server インスタンスへの接続が必要です。 既定では、ビッグ データ クラスターには、インスタンスへの接続を有効にするエンドポイントが含まれません。 このエンドポイントは、手動で公開する必要があります。
手順については、プライマリ レプリカのデータベースへの接続に関するページを参照してください。
実行中の構成値の更新
オプションに新しい値を指定すると、結果セットはこの値を config_value 列に表示します。 この値は、最初は、現在実行中の構成値を 示す run_value 列の値とは異なります。 run_value列の実行中の構成値を更新するには、システム管理者が RECONFIGURE または RECONFIGURE WITH OVERRIDE を実行する必要があります。
RECONFIGURE と RECONFIGURE WITH OVERRIDE の両方が、すべての構成オプションで機能します。 ただし、基本的な RECONFIGURE ステートメントは、妥当な範囲外のオプション値、またはオプション間の競合を引き起こす可能性のあるオプション値を拒否します。 たとえば、回復間隔の値が 60 分を超える場合、またはアフィニティ マスク値がアフィニティ I/O マスク値と重複している場合、RECONFIGURE はエラーを生成します。 一方、RECONFIGURE WITH OVERRIDE では、正しいデータ型のオプション値を受け取り、指定した値で強制的に再構成します。
注意
オプション値が適切でない場合、サーバー インスタンスの構成に悪影響を及ぼす可能性があります。 RECONFIGURE WITH OVERRIDE は慎重に使用してください。
一部のオプションは、RECONFIGURE ステートメントにより動的に更新されます。その他のオプションを使用する場合は、サーバーの停止と再起動が必要になります。 たとえば、最小サーバー メモリオプションと最大サーバー メモリ サーバー メモリ オプションは、データベース エンジンで動的に更新されるため、サーバーを再起動せずに変更できます。 これに対し、fill factor オプションの実行値を再構成するには、データベース エンジンを再起動する必要があります。
構成オプションで RECONFIGURE を実行した後、sp_configure'option_name' を実行して、オプションが動的に更新されたかどうかを確認できます。 run_value列とconfig_value列の値は、動的に更新されたオプションと一致する必要があります。 sys.configurations カタログ ビューのis_dynamic列を調べることで、動的なオプションを確認チェックすることもできます。
変更は、SQL Server エラー ログにも書き込まれます。
Note
指定した値がオプションに対して大きすぎる場合、run_value列には、無効な設定を使用するのではなく、データベース エンジンが既定で動的メモリに設定されているという事実が反映されます。
詳細については、「RECONFIGURE (Transact-SQL)」を参照してください。
詳細オプション
アフィニティ マスクや回復間隔などの一部の構成オプションは、詳細オプションとして指定されます。 既定では、これらのオプションは表示および変更できません。 それらを使用できるようにするには、[詳細オプションの表示] 構成オプションを 1 に設定します。
注意
[詳細オプションの表示] オプションが 1 に設定されている場合、この設定はすべてのユーザーに適用されます。 この状態は一時的にのみ使用し、詳細オプションの表示が必要なタスクが完了したら 0 に戻することをお勧めします。
構成オプションとその設定の詳細については、「サーバー構成オプション (SQL Server)」を参照してください。
アクセス許可
パラメーターなしで、または最初のパラメーターだけを指定して sp_configure を実行する権限は、既定ですべてのユーザーに付与されます。 両方のパラメーターでsp_configureを実行して構成オプションを変更したり、RECONFIGURE ステートメントを実行したりするには、ALTER Standard Edition TTINGS サーバー レベルのアクセス許可が付与されている必要があります。 ALTER SETTINGS 権限は、 sysadmin 固定サーバー ロールと serveradmin 固定サーバー ロールでは暗黙のうちに付与されています。
例
A. 詳細な構成オプションの一覧表示
次の例は、すべての構成オプションを設定および一覧表示する方法を示しています。 高度な構成オプションは、最初の設定show advanced options1で表示されます。 このオプションを変更すると、パラメーターなしで実行 sp_configure すると、すべての構成オプションが表示されます。
USE master;
GO
EXEC sp_configure 'show advanced options', '1';
"構成オプション 'show advanced options' が 0 から 1 に変更されました。 RECONFIGURE ステートメントを実行してインストールします。
RECONFIGURE を実行し、すべての構成オプションを表示します。
RECONFIGURE;
EXEC sp_configure;
B. 構成オプションの変更
次の例では、システムの recovery interval を 3 分に設定します。
USE master;
GO
EXEC sp_configure 'recovery interval', '3';
RECONFIGURE WITH OVERRIDE;
例: Analytics Platform System (PDW)
C: すべての使用可能な構成設定を一覧表示する
次の例では、すべての構成オプションを一覧表示する方法を示します。
EXEC sp_configure;
結果は、オプションの最小値と最大値が続くオプション名を返します。 config_valueは、再構成が完了したときに Azure Synapse Analytics が使用する値です。 run_value は、現在使用されている値です。 値が変更中のプロセスではない限り、 config_value と run_value は、通常は同じ値です。
D. 1 つの構成名の構成設定を一覧表示する
EXEC sp_configure @configname='hadoop connectivity';
E. Hadoop 接続を設定する
Hadoop 接続を設定するには、sp_configureの実行に加えて、さらにいくつかの手順が必要です。 完全な手順については、CREATE EXTERNAL DATA SOURCE (Transact-SQL) に関するページを参照してください。
参照
ALTER SERVER CONFIGURATION (Transact-SQL)
RECONFIGURE (Transact-SQL)
SET ステートメント (Transact-SQL)
サーバー構成オプション (SQL Server)
ALTER DATABASE (Transact-SQL)
システム ストアド プロシージャ (Transact-SQL)
sys.configurations (Transact-SQL)
ALTER DATABASE SCOPED CONFIGURATION (Transact-SQL)
ソフト NUMA (SQL Server)
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示