ALTER DATABASE (Transact-SQL)

Consente di modificare alcune opzioni di configurazione di un database.

Questo articolo fornisce la sintassi, gli argomenti, la sezione Osservazioni, le autorizzazioni ed esempi per qualsiasi prodotto SQL scelto.

Per altre informazioni sulle convenzioni della sintassi, vedere Convenzioni della sintassi Transact-SQL.

Selezionare un prodotto

Nella riga seguente selezionare il nome del prodotto a cui si è interessati. Verranno visualizzate solo le informazioni per tale prodotto.

* SQL Server *  

Database SQL

Istanza gestita di SQL

Azure Synapse
Analitica

Piattaforma di strumenti
(PDW)

Microsoft Fabric

 

Panoramica: SQL Server

In SQL Server, questa istruzione consente di modificare un database oppure i file e i filegroup associati al database. ALTER DATABASE aggiunge o rimuove file e filegroup da un database, modifica gli attributi di un database o dei relativi file e filegroup, modifica le regole di confronto del database e imposta le opzioni di database. Non è possibile modificare gli snapshot del database. Per la modifica delle opzioni di database associate alla replica, usare sp_replicationdboption.

A causa della lunghezza, la sintassi di ALTER DATABASE è separata in più articoli.

Articolo	Descrizione
ALTER DATABASE	L'articolo corrente fornisce la sintassi e le informazioni correlate per la modifica del nome e delle regole di confronto di un database.
Opzioni file e filegroup ALTER DATABASE	Fornisce la sintassi e le informazioni correlate per l'aggiunta e la rimozione di file e filegroup da un database e per la modifica degli attributi di file e filegroup.
Opzioni ALTER DATABASE SET	Fornisce la sintassi e le informazioni correlate per la modifica degli attributi di un database utilizzando le opzioni SET di ALTER DATABASE.
Mirroring del database ALTER DATABASE	Include la sintassi e le informazioni correlate per le opzioni SET di ALTER DATABASE relative al mirroring del database.
ALTER DATABASE SET HADR	Fornisce la sintassi e le informazioni correlate per le opzioni dei gruppi di disponibilità Always On di ALTER DATABASE per la configurazione di un database secondario in una replica secondaria di un gruppo di disponibilità Always On.
Livello di compatibilità ALTER DATABASE	Include la sintassi e le informazioni correlate per le opzioni SET di ALTER DATABASE relative ai livelli di compatibilità del database.
ALTER DATABASE SCOPED CONFIGURATION	Fornisce la sintassi per le configurazioni con ambito database usate per impostazioni a livello di database singolo, come i comportamenti correlati all'ottimizzazione query e all'esecuzione di query.

Sintassi

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

Argomenti

database_name

Nome del database da modificare.

Nota

Questa opzione non è disponibile in un database indipendente.

CURRENT
Si applica a: SQL Server 2012 (11.x) e versioni successive.

Specifica che il database corrente in uso deve essere modificato.

MODIFY NAME = new_database_name

Rinomina il database con il nome specificato come new_database_name.

COLLATE collation_name

Specifica le regole di confronto per il database. In collation_name è possibile usare nomi di regole di confronto di Windows o SQL. Se omesso, al database vengono assegnate le regole di confronto dell'istanza di SQL Server.

Nota

Le regole di confronto non possono essere modificate dopo la creazione del database in database SQL di Azure.

Quando si creano database con regole di confronto diverse da quelle predefinite, i dati nel database rispettano sempre le regole di confronto specificate. Per SQL Server, quando si crea un database indipendente, le informazioni del catalogo interno vengono mantenute usando le regole di confronto predefinite di SQL Server, ovvero Latin1_General_100_CI_AS_WS_KS_SC.

Per altre informazioni sui nomi di regole di confronto Windows e SQL, vedere COLLATE.

<> delayed_durability_option ::=

Si applica a: SQL Server 2014 (12.x) e versioni successive.

Per altre informazioni, vedere Opzioni ALTER DATABASE SET e Controllo della durabilità delle transazioni.

<>file_and_filegroup_options::=

Per altre informazioni, vedere Opzioni per file e filegroup ALTER DATABASE.

Osservazioni:

Per rimuovere un database usare DROP DATABASE.

Per ridurre le dimensioni di un database, usare DBCC SHRINKDATABASE.

L'istruzione ALTER DATABASE deve essere eseguita in modalità commit automatico (modalità di gestione delle transazioni predefinita) e non è consentita in una transazione esplicita o implicita.

Lo stato di un file di database, ad esempio online o offline, viene mantenuto indipendentemente dallo stato del database. Per altre informazioni, vedere Stati del file. Lo stato dei file all'interno di un filegroup determina la disponibilità dell'intero filegroup. Un filegroup è disponibile se tutti i file in esso inclusi sono online. Se un filegroup è offline, qualsiasi tentativo di accesso al filegroup da un'istruzione SQL ha esito negativo e viene generato un errore. Per la compilazione di piani delle query per istruzioni SELECT, Query Optimizer evita gli indici non cluster e le viste indicizzate presenti in filegroup offline. Ciò consente la corretta esecuzione di tali istruzioni. Se tuttavia il filegroup offline contiene l'indice cluster o heap della tabella di destinazione, l'istruzione SELECT avrà esito negativo, Inoltre, qualsiasi INSERTistruzione , UPDATEo DELETE che modifica una tabella con qualsiasi indice in un filegroup offline ha esito negativo.

Quando un database si trova nello stato RESTORE, la maggior parte ALTER DATABASE delle istruzioni ha esito negativo. Un'alternativa consiste nell'impostare le opzioni di mirroring del database. Un database potrebbe trovarsi nello stato RESTORE durante un'operazione di ripristino attiva o quando un'operazione di ripristino di un database o di un file di log non riesce a causa di un file di backup danneggiato.

La cache dei piani per l'istanza di SQL Server viene cancellata quando si imposta una delle opzioni seguenti.

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

La cancellazione della cache dei piani comporta la ricompilazione di tutti i piani di esecuzione successivi e può causare un peggioramento improvviso e temporaneo delle prestazioni di esecuzione delle query. Per ogni archivio cache cancellato nella cache dei piani, il log degli errori di SQL Server contiene il messaggio informativo seguente: 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. Questo messaggio viene registrato ogni cinque minuti per tutta la durata dello scaricamento della cache.

La cache dei piani viene inoltre scaricata negli scenari seguenti:

• L'opzione AUTO_CLOSE di un database è impostata su ON. Se il database non viene utilizzato da alcuna connessione utente, neanche come riferimento, tramite l'attività in background viene effettuato il tentativo di chiusura e di arresto automatici del database.
• Vengono eseguite diverse query su un database contenente opzioni predefinite. Successivamente, il database viene eliminato.
• Viene eliminato uno snapshot del database per un database di origine.
• Viene ricompilato correttamente il log delle transazioni per un database.
• Viene ripristinato un backup del database.
• Viene scollegato un database.

Modificare le regole di confronto del database

Prima di applicare regole di confronto diverse a un database, verificare che siano soddisfatte le condizioni seguenti:

• Nessun altro utente sta utilizzando il database.
• Nessun oggetto associato a schema dipende dalle regole di confronto del database.

Se gli oggetti seguenti, che dipendono dalle regole di confronto del database, esistono nel database, l'istruzione ALTER DATABASE database_name COLLATE ha esito negativo. SQL Server restituisce un messaggio di errore per ogni oggetto che blocca l'azione ALTER :

• Funzioni definite dall'utente e viste create con SCHEMABINDING
• Colonne calcolate
• Vincoli CHECK
• Funzioni con valori di tabella che restituiscono tabelle contenenti colonne di tipo carattere con regole di confronto ereditate dalle regole di confronto predefinite del database

Le informazioni sulle dipendenze per le entità non associate a schemi vengono aggiornate automaticamente quando vengono modificate le regole di confronto del database.

La modifica delle regole di confronto del database non comporta la creazione di duplicati per i nomi di sistema degli oggetti di database. Se i nomi duplicati derivano dalle regole di confronto modificate, gli spazi dei nomi seguenti possono causare l'errore di una modifica delle regole di confronto del database:

• Nomi di oggetti, come stored procedure, tabelle, trigger o viste
• Nomi schema
• Entità, come gruppi, ruoli o utenti
• Nomi di tipi di dati scalari, come i tipi di dati di sistema e definiti dall'utente
• Nomi di cataloghi full-text
• Nomi di colonne o parametri in un oggetto
• Nomi di indici in una tabella

I nomi duplicati risultanti dalle nuove regole di confronto causano l'esito negativo dell'azione di modifica e SQL Server restituisce un messaggio di errore che specifica lo spazio dei nomi in cui è stato trovato il duplicato.

Visualizzare le informazioni sul database

Per restituire informazioni su database, file e filegroup, è possibile usare viste del catalogo, funzioni di sistema e stored procedure di sistema.

Autorizzazioni

È richiesta l'autorizzazione ALTER per il database.

Esempi

R. Modificare il nome di un database

Nell'esempio seguente il nome del database AdventureWorks2022 viene modificato in Northwind.

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

B. Modificare le regole di confronto di un database

L'esempio seguente crea un database denominato testdb con le SQL_Latin1_General_CP1_CI_AS regole di confronto e quindi modifica le regole di confronto del testdb database in COLLATE French_CI_AI.

Si applica a: SQL Server 2008 (10.0.x) e versioni successive.

USE master;
GO

CREATE DATABASE testdb
COLLATE SQL_Latin1_General_CP1_CI_AS ;
GO

ALTER DATABASE testDB
COLLATE French_CI_AI ;
GO

Contenuto correlato

• 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
• Database di sistema