ALTER DATABASE (Transact-SQL)

Modifica determinadas opções de configuração de um banco de dados.

Este artigo fornece a sintaxe, os argumentos, os comentários, as permissões e os exemplos de qualquer produto SQL que você escolher.

Para obter mais informações sobre as convenções de sintaxe, confira Convenções de sintaxe Transact-SQL.

Selecionar um produto

Na linha a seguir, selecione o nome do produto em que você tem interesse e somente as informações do produto serão exibidas.

* SQL Server *  

Banco de Dados SQL

Instância Gerenciada de SQL

Azure Synapse
Análise

Analytics Platform
System (PDW)

 

Visão geral: SQL Server

No SQL Server, essa instrução modifica um banco de dados ou os arquivos e grupos de arquivos associados ao banco de dados. ALTER DATABASE adiciona ou remove arquivos e grupos de arquivos de um banco de dados, altera os atributos de um banco de dados ou seus arquivos e grupos de arquivos, altera a ordenação de banco de dados e define opções de banco de dados. Os instantâneos do banco de dados não podem ser modificados. Para modificar opções de banco de dados associadas à replicação, use sp_replicationdboption.

Devido à extensão da sintaxe ALTER DATABASE, ela foi dividida em vários artigos.

Artigo	Descrição
ALTER DATABASE	O artigo atual fornece a sintaxe e as informações relacionadas para alterar o nome e a ordenação de um banco de dados.
Opções de arquivo e grupo de arquivos de ALTER DATABASE	Fornece a sintaxe e informações relacionadas para adicionar e remover arquivos e grupos de arquivos de um banco de dados e para alterar os atributos dos arquivos e grupos de arquivos.
Opções do ALTER DATABASE SET	Fornece a sintaxe para alterar os atributos de um banco de dados usando as opções SET de ALTER DATABASE.
Espelhamento de banco de dados de ALTER DATABASE	Fornece a sintaxe e informações relacionadas para as opções SET de ALTER DATABASE relacionadas ao espelhamento de banco de dados.
ALTER DATABASE SET HADR	Fornece a sintaxe e informações relacionadas para as opções Grupos de disponibilidade AlwaysOn de ALTER DATABASE para configurar um banco de dados secundário em uma réplica secundária de um Grupo de Disponibilidade AlwaysOn.
Nível de compatibilidade ALTER DATABASE	Fornece a sintaxe e informações relacionadas para as opções SET de ALTER DATABASE relacionadas aos níveis de compatibilidade do banco de dados.
ALTER DATABASE SCOPED CONFIGURATION	Fornece a sintaxe relacionada às configurações no escopo do banco de dados usadas para configurações de nível de banco de dados individuais, como comportamentos relacionados a otimização de consulta e execução de consulta.

Sintaxe

-- 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 }
}

Argumentos

database_name

É o nome do banco de dados a ser modificado.

Observação

Essa opção não está disponível em um Banco de Dados Contencionado.

CURRENT
Aplica-se a: SQL Server 2012 (11.x) e posterior.

Designa que o banco de dados em uso deve ser alterado.

MODIFY NAME = new_database_name

Renomeia o banco de dados com o nome especificado como novo_nome_do_banco_de_dados.

COLLATE collation_name

Especifica a ordenação do banco de dados. collation_name pode ser um nome de ordenação do Windows ou um nome de ordenação SQL. Se não especificado, ao banco de dados será atribuída a ordenação da instância do SQL Server.

Observação

O agrupamento não pode ser alterado após a criação do banco de dados no Banco de Dados SQL do Azure.

Durante a criação de bancos de dados com itens diferentes da ordenação padrão, os dados no banco de dados sempre respeitam a ordenação especificada. Para SQL Server, ao criar um banco de dados independente, as informações do catálogo interno serão mantidas por meio da ordenação padrão de SQL Server, Latin1_General_100_CI_AS_WS_KS_SC.

Para saber mais sobre nomes de ordenações Windows e SQL, confira COLLATE.

<delayed_durability_option> ::=

Aplica-se a: SQL Server 2014 (12.x) e posterior.

Para obter mais informações, consulte Opções de ALTER DATABASE SET e Controlar durabilidade da transação.

<file_and_filegroup_options>::=

Para saber mais, confira Opções de arquivo e grupo de arquivos de ALTER DATABASE.

Comentários

Para remover um banco de dados, use DROP DATABASE.

Para diminuir o tamanho de um banco de dados, use DBCC SHRINKDATABASE.

A ALTER DATABASE instrução deve ser executada no modo de confirmação automática (o modo de gerenciamento de transações padrão) e não é permitida em uma transação explícita ou implícita.

O estado de um arquivo de banco de dados (por exemplo, online ou offline) é mantido independentemente do estado do banco de dados. Para obter mais informações, consulte Estados de arquivo. O estado dos arquivos dentro de um grupo de arquivos determina a disponibilidade de todo o grupo. Para que um grupo de arquivos fique disponível, todos os seus arquivos devem estar online. Se um grupo de arquivos estiver offline, qualquer tentativa de acessar o grupo de arquivos por uma instrução SQL falhará com um erro. Quando você cria planos de consulta para instruções SELECT, o otimizador de consultas evita índices não clusterizados e exibições indexadas que residam em grupos de arquivos offline. Isso permite que essas instruções tenham êxito. Porém, se o grupo de arquivos offline contiver o heap ou índice clusterizado da tabela de destino, as instruções SELECT falharão. Além disso, qualquer INSERTinstrução , UPDATEou DELETE que modifique uma tabela com qualquer índice em um grupo de arquivos offline falhará.

Quando um banco de dados está no estado RESTOREING, a maioria das ALTER DATABASE instruções falha. A exceção está definindo opções de espelhamento de banco de dados. Um banco de dados pode estar no estado RESTORING durante uma operação de restauração ativa ou quando uma operação de restauração de um banco de dados ou arquivo de log falha devido a um arquivo de backup corrompido.

O cache do plano para a instância do SQL Server é limpo pela configuração de uma das seguintes opções.

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

A limpeza do cache de planos gera uma recompilação de todos os planos de execução subsequentes e pode provocar uma redução repentina e temporária do desempenho de consultas. Para cada armazenamento em cache limpo no cache de planos, o log de erros do SQL Server contém a seguinte mensagem informativa: 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. Essa mensagem é registrada a cada cinco minutos, contanto que o cache seja liberado dentro desse intervalo de tempo.

O cache de planos também é liberado nos seguintes cenários:

• Um banco de dados tem a opção de banco de dados AUTO_CLOSE definida como ON. Quando nenhuma conexão de usuário fizer referência ou usar o banco de dados, a tarefa de banco de dados tentará fechar e encerrar o banco de dados automaticamente.
• Execute diversas consultas em um banco de dados que tem opções padrão. O banco de dados é removido.
• Um instantâneo de banco de dados para um banco de dados de origem é removido.
• Você recria com sucesso o log de transação para um banco de dados.
• Você restaura um backup de banco de dados.
• Você desanexa um banco de dados.

Alterar o agrupamento do banco de dados

Antes de aplicar uma ordenação diferente a um banco de dados, certifique-se de que existam as seguintes condições:

• Você é o único usuário que está utilizando o banco de dados no momento.
• Nenhum objeto associado ao esquema depende da ordenação do banco de dados.

Se os objetos a seguir, que dependem do agrupamento do banco de dados, existirem no banco de dados, a ALTER DATABASE database_name COLLATE instrução falhará. O SQL Server retorna uma mensagem de erro para cada objeto que bloqueia a ALTER ação:

• Funções definidas pelo usuário e exibições criadas com SCHEMABINDING
• Colunas computadas
• Restrições CHECK
• Funções com valor de tabela que retornam tabelas com colunas de caracteres com ordenações herdadas da ordenação de banco de dados padrão

Informações de dependência de entidades não associadas a esquema são automaticamente atualizadas quando a ordenação de banco de dados é alterada.

Alterar a ordenação de banco de dados não cria duplicatas entre nenhum nome de sistema para os objetos de banco de dados. Se nomes duplicados resultarem do agrupamento alterado, os seguintes namespaces podem causar a falha de uma alteração de agrupamento de banco de dados:

• Nomes de objeto, como procedimentos, tabelas, gatilhos ou exibições
• Nomes de esquema
• Entidades, como grupos, funções ou usuários
• Nomes escalares, como tipos de sistema e tipos definidos pelo usuário
• Nomes de catálogo de texto completo
• Nomes de coluna ou parâmetro dentro de um objeto
• Nomes de índice dentro de uma tabela

Nomes duplicados resultantes do novo agrupamento fazem com que a ação de alteração falhe, e o SQL Server retorna uma mensagem de erro especificando o namespace onde a duplicata foi encontrada.

Exibir informações do banco de dados

É possível usar exibições do catálogo, funções do sistema e procedimentos armazenados do sistema para retornar informações sobre bancos de dados, arquivos e grupos de arquivos.

Permissões

Requer a permissão ALTER no banco de dados.

Exemplos

a. Alterar o nome de um banco de dados

O exemplo a seguir altera o nome do banco de dados AdventureWorks2022 para Northwind.

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

B. Alterar a ordenação de um banco de dados

O exemplo a seguir cria um banco de dados chamado testdb com a ordenação SQL_Latin1_General_CP1_CI_AS e, em seguida, altera a ordenação do banco de dados testdb para COLLATE French_CI_AI.

Aplica-se a: SQL Server 2008 (10.0.x) e posterior.

USE master;
GO

CREATE DATABASE testdb
COLLATE SQL_Latin1_General_CP1_CI_AS ;
GO

ALTER DATABASE testDB
COLLATE French_CI_AI ;
GO

Conteúdo relacionado

• 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
• Bancos de dados do sistema