ALTER DATABASE (Transact-SQL)

Изменяет определенные параметры конфигурации базы данных.

Эта статья приводит синтаксис, аргументы, комментарии, разрешения и примеры для любых выбранных продуктов SQL.

Дополнительные сведения о соглашениях о синтаксисе см. в статье Соглашения о синтаксисе в Transact-SQL.

Выбор продукта

В следующей строке выберите название нужного продукта, и отобразится информация только об этом продукте.

* SQL Server *  

База данных SQL

Управляемый экземпляр SQL

Azure Synapse
Аналитики

Analytics Platform
System (PDW)

 

Обзор: SQL Server

В SQL Server эта инструкция изменяет базу данных или файлы и файловые группы, связанные с базой данных. ALTER DATABASE добавляет или удаляет файлы и файловые группы из базы данных, изменяет атрибуты базы данных или его файлов и файловых групп, изменяет параметры сортировки базы данных и задает параметры базы данных. Моментальные снимки базы данных изменить нельзя. Чтобы изменить параметры базы данных, связанные с репликацией, используйте процедуру sp_replicationdboption.

Так как синтаксис ALTER DATABASE имеет значительную длину, мы разделили его описание на несколько статей.

Статья	Description
ALTER DATABASE	В этой статье приведен синтаксис и сопутствующие сведения по изменению имени и параметров сортировки базы данных.
Параметры инструкции ALTER DATABASE для файлов и файловых групп	Синтаксис для добавления или удаления файлов и файловых групп в базе данных, для изменения атрибутов файлов и файловых групп, а также дополнительная информация об этом.
Параметры ALTER DATABASE SET	Синтаксис для изменения атрибутов базы данных с помощью параметров SET команды ALTER DATABASE, а также дополнительная информация об этом.
Зеркальное отображение базы данных ALTER DATABASE	Синтаксис параметров SET команды ALTER DATABASE, используемых в процессе зеркального отображения базы данных, а также дополнительная информация об этом.
ALTER DATABASE SET HADR	Предоставляет синтаксис и связанные сведения о параметрах групп доступности AlwaysOn alter DATABASE для настройки базы данных-получателя на вторичной реплике группы доступности AlwaysOn.
Уровень совместимости ALTER DATABASE	Синтаксис параметров SET инструкции ALTER DATABASE, имеющих отношение к уровням совместимости базы данных, и дополнительная информация об этом.
ALTER DATABASE SCOPED CONFIGURATION	Обеспечивает синтаксис для конфигурации для с областью базы данных, используемый для параметров уровня отдельной базы данных, таких как выполнение запроса и оптимизация запросов.

Синтаксис

-- 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>
      { 150 | 140 | 130 | 120 | 110 | 100 | 90 }
}

Аргументы

database_name

Имя изменяемой базы данных.

Заметка

Этот параметр недоступен в автономной базе данных.

ТЕКУЩИЙ
Область применения: SQL Server 2012 (11.x) и более поздних версий.

Определяет, что должна быть изменена текущая используемая база данных.

MODIFY NAME = new_database_name

Присваивает базе данных имя, указанное в аргументе новое_имя_базы_данных.

COLLATE collation_name

Задает параметры сортировки для базы данных. Аргументом collation_name может быть либо имя параметров сортировки Windows, либо имя параметров сортировки SQL. Если это не указано, база данных назначает параметры сортировки экземпляра SQL Server.

Заметка

Параметры сортировки нельзя изменить после создания базы данных в базе данных SQL Azure.

При создании баз данных с параметрами сортировки, отличными от параметров сортировки по умолчанию, данные в базе данных всегда учитывают указанные параметры сортировки. Для SQL Server при создании автономной базы данных данные внутреннего каталога сохраняются с помощью параметров сортировки по умолчанию SQL Server, Latin1_General_100_CI_AS_WS_KS_SC.

Список имен параметров сортировки Windows и SQL см. в статье Параметры сортировки.

<> delayed_durability_option ::=

Область применения: SQL Server 2014 (12.x) и более поздних версий.

Дополнительные сведения см. в статьях Параметры ALTER DATABASE SET и Управление устойчивостью транзакций.

<>file_and_filegroup_options::=

Дополнительные сведения см. в статье Параметры инструкции ALTER DATABASE для файлов и файловых групп (Transact-SQL).

Замечания

Чтобы удалить базу данных, используйте инструкцию DROP DATABASE.

Чтобы уменьшить размер базы данных, используйте предложение DBCC SHRINKDATABASE.

Инструкция ALTER DATABASE должна выполняться в режиме автоматической фиксации (режим управления транзакциями по умолчанию). Инструкция не разрешена в явной или неявной транзакции.

Состояние файла базы данных (например "в сети" или "вне сети") поддерживается независимо от состояния базы данных. Дополнительные сведения см. в разделе Состояния файлов. Состояние файлов в пределах файловой группы определяет доступность файловой группы в целом. Чтобы файловая группа была доступна, необходимо, чтобы все файлы в файловой группе находились в режиме в сети. Если файловая группа вне сети, то любая попытка обращения к файловой группе с помощью инструкции SQL закончится ошибкой. При создании планов запросов для инструкций SELECT оптимизатор запросов избегает некластеризованных индексов и индексированных представлений, которые находятся в файловых группах вне сети. Это позволяет успешно выполнить эти инструкции. Однако если файловая группа, находящаяся в режиме вне сети, содержит кучу или кластеризованный индекс целевой таблицы, инструкция SELECT не будет выполнена. Кроме того, любая инструкция INSERT, UPDATE или DELETE, изменяющая таблицу с любым индексом в файловой группе, находящихся в режиме вне сети, также не будет выполнена.

Если база данных находится в состоянии RESTORING, выполнение большинства инструкций ALTER DATABASE завершится сбоем. Исключением является настройка параметров зеркального отображения базы данных. База данных может находиться в состоянии RESTORING во время выполнения операции восстановления или тогда, когда при операции восстановления базы данных или файла журнала происходит сбой из-за поврежденного файла резервной копии.

Кэш планов для экземпляра 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. Если отсутствуют ссылки соединений пользователя или базы данных, фоновая задача предпримет попытку закрыть и отключить базу данных автоматически.
• Выполняется несколько запросов в базе данных с параметрами по умолчанию. Затем база данных уничтожается.
• Моментальный снимок базы данных для базы данных-источника удален.
• Успешное перестроение журнала транзакций базы данных.
• Восстановление резервной копии базы данных.
• Отсоединение базы данных.

Изменение сортировки базы данных

Прежде чем применить другие параметры сортировки к базе данных, убедитесь, что соблюдены следующие условия.

• Вы являетесь единственным пользователем базы данных в настоящее время.
• Ни один объект, привязанный к схеме, не зависит от параметров сортировки базы данных.

Если в базе данных существуют следующие объекты, которые зависят от сортировки базы данных, инструкция ALTER DATABASE database_name COLLATE завершится ошибкой. SQL Server возвращает сообщение об ошибке для каждого объекта, блокирующего ALTER действие:

• определяемые пользователем функции и представления, созданные с помощью параметра SCHEMABINDING;
• Вычисляемые столбцы
• CHECK, ограничение
• функции, которые возвращают таблицы с символьными столбцами, имеющими параметры сортировки, унаследованные из параметров сортировки базы данных по умолчанию.

Информация о зависимостях не привязанных к схеме сущностей обновляется автоматически при изменении параметров сортировки базы данных.

При изменении параметров сортировки базы данных дубликаты любых системных имен для объектов базы данных не создаются. Если новые параметры сортировки вызывают повторяющиеся имена, следующие пространства имен могут вызвать сбой при изменении параметров сортировки базы данных:

• имена объектов, такие как процедуры, таблицы, триггеры или представления;
• Имена схем
• участники, такие как группы, роли или пользователи;
• имена скалярных типов, таких как системные и определяемые пользователем типы;
• имена полнотекстовых каталогов;
• имена столбцов или параметров в пределах объекта;
• имена индексов в пределах таблицы.

Повторяющиеся имена, полученные из-за новой сортировки, приведет к сбою действия изменения, и SQL Server вернет сообщение об ошибке, указывающее пространство имен, в котором найдена повторяющаяся копия.

Просмотр сведений о базе данных

Для возврата сведений о базах данных, файлах и файловых группах можно использовать представления каталогов, системные функции и системные хранимые процедуры.

Разрешения

Необходимо разрешение ALTER на базу данных.

Примеры

О. Изменение имени базы данных

В следующем примере имя базы данных AdventureWorks2022 изменяется на Northwind.

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) и более поздних версий.

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
• Системные базы данных