BASE DE DADOS ALTER (Transact-SQL)

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

Este artigo fornece a sintaxe, argumentos, observações, permissões e exemplos para qualquer produto SQL escolhido.

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

Selecione um produto

Na linha seguinte, selecione o nome do produto em que está interessado e apenas as informações desse produto são apresentadas.

* SQL Server *  

Banco de Dados SQL

de instância gerenciada SQL

Azure Synapse
Análise

Plataforma de análise
Sistema (PDW)

Microsoft Fabric

 

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 o agrupamento do banco de dados e define as opções do banco de dados. Os instantâneos do banco de dados não podem ser modificados. Para modificar as opções de banco de dados associadas à replicação, use sp_replicationdboption.

Devido ao seu comprimento, a sintaxe ALTER DATABASE é separada em vários artigos.

Artigo	Descrição
ALTER DATABASE	O artigo atual fornece a sintaxe e informações relacionadas para alterar o nome e o agrupamento de um banco de dados.
Opções de arquivo e grupo de arquivos ALTER DATABASE	Fornece a sintaxe e as 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 ALTER DATABASE SET	Fornece a sintaxe e informações relacionadas para alterar os atributos de um banco de dados usando as opções SET de ALTER DATABASE.
de espelhamento de banco de dados ALTER DATABASE	Fornece a sintaxe e as 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 as informações relacionadas para as opções de grupos de disponibilidade Always On de ALTER DATABASE para configurar um banco de dados secundário em uma réplica secundária de um grupo de disponibilidade Always On.
Nível de compatibilidade ALTER DATABASE	Fornece a sintaxe e as informações relacionadas para as opções SET do ALTER DATABASE relacionadas aos níveis de compatibilidade do banco de dados.
ALTERAR DE CONFIGURAÇÃO COM ESCOPO DO BANCO DE DADOS	Fornece a sintaxe relacionada às configurações de escopo do banco de dados usadas para configurações individuais no nível do banco de dados, como otimização de consultas e comportamentos relacionados à execução de consultas.

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

Esta opção não está disponível em um banco de dados contido.

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

Designa que a base de dados atual em uso deve ser alterada.

MODIFICAR NOME = new_database_name

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

COLLATE collation_name

Especifica o agrupamento para o banco de dados. collation_name pode ser um nome de agrupamento do Windows ou um nome de agrupamento SQL. Se não for especificado, o banco de dados receberá o agrupamento 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.

Ao criar bancos de dados com agrupamento diferente do padrão, os dados no banco de dados sempre respeitam o agrupamento especificado. Para o SQL Server, ao criar um banco de dados contido, as informações do catálogo interno são mantidas usando o agrupamento padrão do SQL Server, Latin1_General_100_CI_AS_WS_KS_SC.

Para obter mais informações sobre os nomes de agrupamento Windows e SQL, consulte COLLATE.

<delayed_durability_option> ::=

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

Para obter mais informações, consulte opções do ALTER DATABASE SET e Control Transaction Durability.

<file_and_filegroup_options>::=

Para obter mais informações, consulte ALTER DATABASE File and Filegroup Options.

Comentários

Para remover um banco de dados, use DROP DATABASE.

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

A instrução ALTER DATABASE 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 do arquivo. O estado dos arquivos dentro de um grupo de arquivos determina a disponibilidade de todo o grupo de arquivos. Para que um grupo de arquivos esteja disponível, todos os arquivos dentro do grupo de 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 consulta evita índices não clusterizados e exibições indexadas que residem em grupos de arquivos offline. Isso permite que essas declarações sejam bem-sucedidas. No entanto, se o grupo de arquivos offline contiver o heap ou o índice clusterizado da tabela de destino, as instruções SELECT falharão. Além disso, qualquer instrução INSERT, UPDATEou DELETE que modifique uma tabela com qualquer índice em um grupo de arquivos offline falhará.

Quando um banco de dados está no estado RESTORE, a maioria das instruções ALTER DATABASE falha. A exceção é definir opções de espelhamento de banco de dados. Um banco de dados pode estar no estado RESTAURANDO 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 de plano para a instância do SQL Server é limpo definindo uma das seguintes opções.

• COLISÃO
• MODIFICAR O PADRÃO DO GRUPO DE ARQUIVOS
• MODIFICAR READ_ONLY GRUPO DE ARQUIVOS
• MODIFICAR READ_WRITE GRUPO DE ARQUIVOS
• MODIFY_NAME
• OFFLINE
• ONLINE
• PAGE_VERIFY
• READ_ONLY
• READ_WRITE

Limpar o cache do plano causa uma recompilação de todos os planos de execução subsequentes e pode causar uma diminuição súbita e temporária no desempenho da consulta. Para cada cachestore limpo no cache de plano, 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, desde que o cache seja liberado dentro desse intervalo de tempo.

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

• Um banco de dados tem a opção AUTO_CLOSE banco de dados definida como ON. Quando nenhuma conexão de usuário faz referência ou usa o banco de dados, a tarefa em segundo plano tenta fechar e desligar o banco de dados automaticamente.
• Você executa várias consultas em um banco de dados que tem opções padrão. Em seguida, o banco de dados é descartado.
• Um instantâneo de banco de dados para um banco de dados de origem é descartado.
• Você recria com êxito o log de transações de um banco de dados.
• Você restaura um backup de banco de dados.
• Desanexar um banco de dados.

Alterar o agrupamento do banco de dados

Antes de aplicar um agrupamento diferente a um banco de dados, verifique se as seguintes condições estão em vigor:

• Você é o único que atualmente usa o banco de dados.
• Nenhum objeto vinculado ao esquema depende do agrupamento do banco de dados.

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

• 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 agrupamentos herdados do agrupamento de banco de dados padrão

As informações de dependência para entidades não vinculadas ao esquema são atualizadas automaticamente quando o agrupamento do banco de dados é alterado.

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

• Nomes de objetos, como um procedimento, tabela, gatilho ou exibição
• Nomes de esquema
• Entidades como um grupo, função ou usuário
• Nomes de tipo escalar, como sistemas e tipos definidos pelo usuário
• Nomes de catálogo de texto completo
• Nomes de colunas ou parâmetros 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.

Ver informações da base de dados

Você pode usar exibições de 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 permissão ALTER no banco de dados.

Exemplos

Um. 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 o agrupamento de um banco de dados

O exemplo a seguir cria um banco de dados chamado testdb com o agrupamento SQL_Latin1_General_CP1_CI_AS e, em seguida, altera o agrupamento 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

• CRIAR BANCO DE DADOS
• DATABASEPROPERTYEX
• DROP DATABASE
• DEFINIR O NÍVEL DE ISOLAMENTO DE TRANSAÇÃO
• EVENTDATA
• sp_configure
• sp_spaceused
• sys.databases
• sys.database_files
• sys.data_spaces
• sys.filegroups
• sys.master_files
• de bancos de dados do sistema