MENGUBAH DATABASE (T-SQL)

Memodifikasi opsi konfigurasi database tertentu.

Artikel ini menyediakan sintaks, argumen, keterangan, izin, dan contoh untuk produk SQL mana pun yang Anda pilih.

Untuk informasi selengkapnya tentang konvensi sintaks, lihat Konvensi sintaks transact-SQL.

Pilih produk

Di baris berikut, pilih nama produk yang Anda minati, dan hanya informasi produk yang ditampilkan.

* SQL Server *  

Microsoft Azure SQL Database

SQL Managed Instance

Azure Synapse
Analytics

Platform Analitik
Sistem (PDW)

 

Gambaran Umum: SQL Server

Di SQL Server, pernyataan ini memodifikasi database, atau file dan grup file yang terkait dengan database. ALTER DATABASE menambahkan atau menghapus file dan grup file dari database, mengubah atribut database atau file dan grup filenya, mengubah kolase database, dan mengatur opsi database. Rekam jepret database tidak dapat dimodifikasi. Untuk mengubah opsi database yang terkait dengan replikasi, gunakan sp_replicationdboption.

Karena panjangnya, ALTER DATABASE sintaksis dipisahkan ke dalam beberapa artikel.

Artikel	Deskripsi
ALTER DATABASE	Artikel saat ini menyediakan sintaksis dan informasi terkait untuk mengubah nama dan kolaborasi database.
UBAH Opsi File DATABASE dan Grup File	Menyediakan sintaksis dan informasi terkait untuk menambahkan dan menghapus file dan grup file dari database, dan untuk mengubah atribut file dan grup file.
OPSI UBAH SET DATABASE	Menyediakan sintaksis dan informasi terkait untuk mengubah atribut database dengan menggunakan opsi SET ALTER DATABASE.
MENGUBAH Pencerminan Database DATABASE	Menyediakan sintaksis dan informasi terkait untuk opsi SET ALTER DATABASE yang terkait dengan pencerminan database.
MENGUBAH HADR SET DATABASE	Menyediakan sintaksis dan informasi terkait untuk opsi grup ketersediaan AlwaysOn dari ALTER DATABASE untuk mengonfigurasi database sekunder pada replika sekunder grup ketersediaan AlwaysOn.
MENGUBAH tingkat kompatibilitas DATABASE	Menyediakan sintaksis dan informasi terkait untuk opsi SET ALTER DATABASE yang terkait dengan tingkat kompatibilitas database.
MENGUBAH KONFIGURASI CAKUPAN DATABASE	Menyediakan sintaks yang terkait dengan konfigurasi tercakup database yang digunakan untuk pengaturan tingkat database individual seperti pengoptimalan kueri dan perilaku terkait eksekusi kueri.

Sintaks

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

Argumen

database_name

Adalah nama database yang akan dimodifikasi.

Catatan

Opsi ini tidak tersedia dalam Database Termuat.

CURRENT
Berlaku untuk: SQL Server 2012 (11.x) dan yang lebih baru.

Menunjuk bahwa database saat ini yang digunakan harus diubah.

UBAH NAMA = new_database_name

Mengganti nama database dengan nama yang ditentukan sebagai new_database_name.

MENYUSUN collation_name

Menentukan kolatasi untuk database. collation_name bisa berupa nama kolase Windows atau nama kolase SQL. Jika tidak ditentukan, database diberi kolase instans SQL Server.

Catatan

Kolase tidak dapat diubah setelah database dibuat di Azure SQL Database.

Saat membuat database dengan selain kolase default, data dalam database selalu menghormati kolase yang ditentukan. Untuk SQL Server, saat membuat database mandiri, informasi katalog internal dipertahankan menggunakan kolase default SQL Server, Latin1_General_100_CI_AS_WS_KS_SC.

Untuk informasi selengkapnya tentang nama kolase Windows dan SQL, lihat COLLATE.

<> delayed_durability_option ::=

Berlaku untuk: SQL Server 2014 (12.x) dan yang lebih baru.

Untuk informasi selengkapnya, lihat OPSI ALTER DATABASE SET dan Kontrol Durabilitas Transaksi.

<>file_and_filegroup_options::=

Untuk informasi selengkapnya, lihat OPSI UBAH File DATABASE dan Grup File.

Keterangan

Untuk menghapus database, gunakan DROP DATABASE.

Untuk mengurangi ukuran database, gunakan DBCC SHRINKDATABASE.

Pernyataan ALTER DATABASE harus berjalan dalam mode penerapan otomatis (mode manajemen transaksi default) dan tidak diizinkan dalam transaksi eksplisit atau implisit.

Status file database (misalnya, online atau offline), dipertahankan secara independen dari status database. Untuk informasi selengkapnya, lihat Status File. Status file dalam grup file menentukan ketersediaan seluruh grup file. Agar grup file tersedia, semua file dalam grup file harus online. Jika grup file offline, setiap upaya untuk mengakses grup file oleh pernyataan SQL gagal dengan kesalahan. Saat Anda membuat rencana kueri untuk pernyataan SELECT, pengoptimal kueri menghindari indeks non-klusster dan tampilan terindeks yang berada di grup file offline. Ini memungkinkan pernyataan ini berhasil. Namun, jika grup file offline berisi tumpukan atau indeks terkluster dari tabel target, pernyataan SELECT gagal. Selain itu, pernyataan , UPDATE, atau DELETE apa pun INSERTyang memodifikasi tabel dengan indeks apa pun dalam grup file offline gagal.

Saat database berada dalam status PEMULIHAN, sebagian besar ALTER DATABASE pernyataan gagal. Pengecualian mengatur opsi pencerminan database. Database mungkin dalam status PEMULIHAN selama operasi pemulihan aktif atau ketika operasi pemulihan database atau file log gagal karena file cadangan yang rusak.

Cache paket untuk instans SQL Server dibersihkan dengan mengatur salah satu opsi berikut.

• COLLATE
• UBAH FILEGROUP DEFAULT
• UBAH fileGROUP READ_ONLY
• UBAH fileGROUP READ_WRITE
• MODIFY_NAME
• OFFLINE
• ONLINE
• PAGE_VERIFY
• READ_ONLY
• BACA_TULIS

Menghapus cache rencana menyebabkan kompilasi ulang semua rencana eksekusi berikutnya dan dapat menyebabkan penurunan performa kueri secara tiba-tiba dan sementara. Untuk setiap cachestore yang dihapus dalam cache paket, log kesalahan SQL Server berisi pesan informasi berikut: 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. Pesan ini dicatat setiap lima menit selama cache dihapus dalam interval waktu tersebut.

Cache paket juga dihapus dalam skenario berikut:

• Database memiliki opsi database yang AUTO_CLOSE diatur ke AKTIF. Ketika tidak ada referensi koneksi pengguna atau menggunakan database, tugas latar belakang mencoba menutup dan mematikan database secara otomatis.
• Anda menjalankan beberapa kueri terhadap database yang memiliki opsi default. Kemudian, database dihilangkan.
• Rekam jepret database untuk database sumber dihilangkan.
• Anda berhasil membangun kembali log transaksi untuk database.
• Anda memulihkan cadangan database.
• Anda melepas database.

Mengubah kolacek database

Sebelum Anda menerapkan kolatasi yang berbeda ke database, pastikan bahwa kondisi berikut ini ada di tempat:

• Anda adalah satu-satunya yang saat ini menggunakan database.
• Tidak ada objek yang terikat skema tergantung pada kolate database.

Jika objek berikut, yang bergantung pada kolate database, ada di database, ALTER DATABASE database_name COLLATE pernyataan gagal. SQL Server mengembalikan pesan kesalahan untuk setiap objek yang ALTER memblokir tindakan:

• Fungsi dan tampilan yang ditentukan pengguna yang dibuat dengan SCHEMABINDING
• Kolom komputasi
• Batasan CHECK
• Fungsi bernilai tabel yang mengembalikan tabel dengan kolom karakter dengan kolase yang diwarisi dari kolase database default

Informasi dependensi untuk entitas yang tidak terikat skema secara otomatis diperbarui saat kolate database diubah.

Mengubah kolatasi database tidak membuat duplikat di antara nama sistem apa pun untuk objek database. Jika nama duplikat dihasilkan dari kolamen yang diubah, namespace berikut dapat menyebabkan kegagalan perubahan kolamen database:

• Nama objek seperti prosedur, tabel, pemicu, atau tampilan
• Nama skema
• Prinsipal seperti grup, peran, atau pengguna
• Nama jenis skalar seperti jenis sistem dan yang ditentukan pengguna
• Nama katalog teks lengkap
• Nama kolom atau parameter dalam objek
• Nama indeks dalam tabel

Nama duplikat yang dihasilkan dari kolase baru menyebabkan tindakan perubahan gagal, dan SQL Server mengembalikan pesan kesalahan yang menentukan namespace tempat duplikat ditemukan.

Menampilkan informasi database

Anda dapat menggunakan tampilan katalog, fungsi sistem, dan prosedur tersimpan sistem untuk mengembalikan informasi tentang database, file, dan grup file.

Izin

ALTER Memerlukan izin pada database.

Contoh

J. Mengubah nama database

Contoh berikut mengubah nama database menjadi AdventureWorks2022Northwind.

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

B. Mengubah kolatasi database

Contoh berikut membuat database bernama testdb dengan SQL_Latin1_General_CP1_CI_AS kolas, lalu mengubah kolatasi testdb database menjadi COLLATE French_CI_AI.

Berlaku untuk: SQL Server 2008 (10.0.x) dan yang lebih baru.

USE master;
GO

CREATE DATABASE testdb
COLLATE SQL_Latin1_General_CP1_CI_AS ;
GO

ALTER DATABASE testDB
COLLATE French_CI_AI ;
GO

Konten terkait

• MEMBUAT DATABASE
• DATABASEPROPERTYEX
• JATUHKAN DATABASE
• ATUR TINGKAT ISOLASI TRANSAKSI
• EVENTDATA
• sp_configure
• sp_spaceused
• sys.databases
• sys.database_files
• sys.data_spaces
• sys.filegroups
• sys.master_files
• Database Sistem