ALTER DATABASE (Transact-SQL)

修改資料庫的特定組態選項。

本文提供適用於您所選擇之 SQL 產品的語法、引數、備註、權限和範例。

如需語法慣例的詳細資訊，請參閱 Transact-SQL 語法慣例。

選取產品

在以下資料列中，選取您感興趣的產品名稱，隨即只會顯示該產品的資訊。

* SQL Server *  

SQL Database

SQL 受控執行個體

Azure Synapse
分析

Analytics Platform
System (PDW)

Microsoft Fabric

 

概觀：SQL Server

在 SQL Server 中，此陳述式可修改資料庫或與資料庫相關聯的檔案和檔案群組。 ALTER DATABASE 會從資料庫新增或移除檔案和檔案群組、變更資料庫或其檔案群組的屬性、變更資料庫定序，以及設定資料庫選項。 無法修改資料庫快照集。 若要修改與複寫相關聯的資料庫選項，請使用 sp_replicationdboption。

由於長度的關係，ALTER DATABASE 語法會分成多篇文章。

發行項	描述
ALTER DATABASE	目前的文章會提供變更資料庫名稱和定序的語法與相關資訊。
ALTER DATABASE 檔案及檔案群組選項	提供在資料庫中新增和移除檔案及檔案群組的語法與相關資訊，以及變更檔案及檔案群組屬性的語法與相關資訊。
ALTER DATABASE SET 選項	提供使用 ALTER DATABASE 的 SET 選項來變更資料庫屬性的語法與相關資訊。
ALTER DATABASE 資料庫鏡像	可為與資料庫鏡像相關的 ALTER DATABASE SET 選項提供語法與相關資訊。
ALTER DATABASE SET HADR	針對 ALTER DATABASE 的 Always On 可用性群組選項提供語法與相關資訊，以便在 Always On 可用性群組的次要複本上設定次要資料庫。
ALTER DATABASE 相容性層級	可為與資料庫相容性層級相關的 ALTER DATABASE SET 選項提供語法與相關資訊。
ALTER DATABASE SCOPED CONFIGURATION	提供與資料庫範圍設定 (用於個別的資料庫層級設定，例如查詢最佳化及查詢執行相關行為) 相關的語法。

語法

syntaxsql

-- SQL Server Syntax
ALTER DATABASE { database_name | CURRENT }
{
    MODIFY NAME = new_database_name
  | COLLATE collation_name
  | <file_and_filegroup_options>
  | SET <option_spec> [ ,...n ] [ WITH <termination> ]
}
[;]

<file_and_filegroup_options>::=
  <add_or_modify_files>::=
  <filespec>::=
  <add_or_modify_filegroups>::=
  <filegroup_updatability_option>::=

<option_spec>::=
{
  | <auto_option>
  | <change_tracking_option>
  | <cursor_option>
  | <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_options>
  | <HADR_options>
  | <parameterization_option>
  | <query_store_options>
  | <recovery_option>
  | <service_broker_option>
  | <snapshot_option>
  | <sql_option>
  | <termination>
  | <temporal_history_retention>
  | <data_retention_policy>
  | <compatibility_level>
      { 160 | 150 | 140 | 130 | 120 | 110 | 100 | 90 }
}

引數

database_name

這是要修改之資料庫的名稱。

注意

自主資料庫無法使用此選項。

CURRENT
適用於：SQL Server 2012 (11.x) 和更新版本。

指定應該改變正在使用中的目前資料庫。

MODIFY NAME = new_database_name

使用指定為 new_database_name 的名稱來重新命名資料庫。

COLLATE collation_name

指定資料庫的定序。 collation_name 可以是 Windows 定序名稱或 SQL 定序名稱。 若未指定，就會將 SQL Server 執行個體的定序指派給資料庫。

注意

在 Azure SQL 資料庫 上建立資料庫之後，就無法變更定序。

使用預設定序除外的方式建立資料庫時，資料庫中的資料一律會接受指定的定序。 針對 SQL Server，建立自主資料庫時，會使用 SQL Server 預設定序 (Latin1_General_100_CI_AS_WS_KS_SC) 來維護內部目錄資訊。

如需有關 Windows 和 SQL 定序名稱的詳細資訊，請參閱 COLLATE。

<delayed_durability_option> ::=

適用於：SQL Server 2014 (12.x) 和更新版本。

如需詳細資訊，請參閱 ALTER DATABASE SET 選項 和控制 交易持久性。

<file_and_filegroup_options>::=

如需詳細資訊，請參閱 ALTER DATABASE 檔案及檔案群組選項。

備註

若要移除資料庫，請使用 DROP DATABASE。

若要縮小資料庫大小，請使用 DBCC SHRINKDATABASE。

ALTER DATABASE語句必須在自動認可模式中執行（預設交易管理模式），而且不允許在明確或隱含交易中執行。

資料庫檔案狀態 (如線上或離線) 的維護與資料庫狀態無關。 如需詳細資訊，請參閱檔案狀態。 檔案群組內的檔案狀態決定了整個檔案群組的可用性。 若要使某個檔案群組為可用的，則在檔案群組中的所有檔案必須都在線上。 如果檔案群組離線，任何 SQL 語句存取檔案群組的嘗試都失敗，並發生錯誤。 當您建置 SELECT 陳述式的查詢計劃時，查詢最佳化工具會避開在離線檔案群組中的非叢集索引和索引檢視表。 這樣會讓這些陳述式能夠執行成功。 不過，如果離線檔案群組包含目標資料表的堆積或叢集索引，SELECT 陳述式將會失敗。 此外，任何 INSERT修改離線檔案群組中任何索引之數據表的、 UPDATE或 DELETE 語句會失敗。

當資料庫處於 RESTORING 狀態時，大部分 ALTER DATABASE 語句都會失敗。 設定資料庫鏡像選項例外。 資料庫可能會在作用中還原作業期間處於 RESTOREING 狀態，或資料庫或記錄檔的還原作業因為備份檔損毀而失敗時。

設定下列其中一個選項，可清除 SQL Server 執行個體的計畫快取。

• COLLATE
• MODIFY FILEGROUP DEFAULT
• MODIFY FILEGROUP READ_ONLY
• MODIFY FILEGROUP READ_WRITE
• MODIFY_NAME
• OFFLINE
• ONLINE
• PAGE_VERIFY
• READ_ONLY
• READ_WRITE

清除計畫快取會導致重新編譯所有後續執行計畫，而且可能會導致查詢效能突然暫時下降。 針對計畫快取中每個已清除的快取存放區，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。 只要在該時間間隔內快取發生排清，這個訊息就會每五分鐘記錄一次。

在下列情況下也會排清計畫快取：

• 資料庫將 AUTO_CLOSE 資料庫選項設定為 ON。 當沒有任何使用者連接參考或使用資料庫時，背景工作嘗試關閉並自動關閉資料庫。
• 您針對有預設選項的資料庫執行幾個查詢。 然後卸除資料庫。
• 卸除來源資料庫的資料庫快照集。
• 您已成功重建資料庫的交易記錄。
• 您還原資料庫備份。
• 您卸離資料庫。

變更資料庫定序

將不同定序套用至資料庫之前，請確定已符合下列條件：

• 您是資料庫目前唯一的使用者。
• 沒有結構描述繫結的物件相依於資料庫的定序。

如果下列相依於資料庫定序的物件存在於資料庫中，語句就會 ALTER DATABASE database_name COLLATE 失敗。 SQL Server 會針對封鎖 ALTER 動作的每個物件傳回錯誤訊息：

• 使用 SCHEMABINDING 建立的使用者定義函式和檢視
• 計算資料行
• CHECK 條件約束
• 傳回包含字元資料行資料表的資料表值函式，其定序繼承自預設資料庫定序

變更資料庫定序時，就會自動更新非結構描述繫結實體的相依性資訊。

變更資料庫定序並不會在資料庫物件的任何系統名稱之間建立複本。 如果重複的名稱產生於變更的定序，下列命名空間可能會導致資料庫定序變更失敗：

• 物件名稱，例如程序、資料表、觸發程序或檢視
• 結構描述名稱
• 主體，例如群組、角色或使用者
• 純量類型名稱，例如系統和使用者定義型別
• 全文檢索目錄名稱
• 物件內的資料行或參數名稱
• 資料表內的索引名稱

新定序所產生的重複名稱會導致變更動作失敗，而 SQL Server 會傳回錯誤訊息，指定找到重複專案的命名空間。

檢視資料庫資訊

您可以利用目錄檢視、系統函數和系統預存程序，以傳回資料庫、檔案和檔案群組的相關資訊。

權限

需要資料庫的 ALTER 權限。

範例

A. 變更資料庫名稱

下列範例會將 AdventureWorks2022 資料庫的名稱變更為 Northwind。

SQL

USE master;
GO
ALTER DATABASE AdventureWorks2022
Modify Name = Northwind ;
GO

B. 變更資料庫定序

下列範例會使用 testdb 定序來建立名為 SQL_Latin1_General_CP1_CI_AS 的資料庫，然後將 testdb 資料庫的定序變更為 COLLATE French_CI_AI。

適用於：SQL Server 2008 (10.0.x) 和更新版本。

SQL

USE master;
GO

CREATE DATABASE testdb
COLLATE SQL_Latin1_General_CP1_CI_AS ;
GO

ALTER DATABASE testDB
COLLATE French_CI_AI ;
GO

相關內容

• CREATE DATABASE
• DATABASEPROPERTYEX
• DROP DATABASE
• SET TRANSACTION ISOLATION LEVEL
• EVENTDATA
• sp_configure
• sp_spaceused
• sys.databases
• sys.database_files
• sys.data_spaces
• sys.filegroups
• sys.master_files
• 系統資料庫