managed_backup.sp_backup_config_basic (Transact-SQL)

Berlaku untuk: SQL Server 2016 (13.x) dan yang lebih baru

Mengonfigurasi SQL Server Managed Backup ke pengaturan dasar Microsoft Azure untuk database tertentu atau untuk instans SQL Server.

Catatan

Prosedur ini dapat dipanggil sendiri untuk membuat konfigurasi cadangan terkelola dasar. Namun, jika Anda berencana untuk menambahkan fitur tingkat lanjut atau jadwal kustom, pertama-tama konfigurasikan pengaturan tersebut menggunakan managed_backup.sp_backup_config_advanced (Transact-SQL) dan managed_backup.sp_backup_config_schedule (Transact-SQL) sebelum mengaktifkan pencadangan terkelola dengan prosedur ini.

tautan topikIkon Konvensi Sintaks Transact-SQL

Sintaks

EXEC managed_backup.sp_backup_config_basic  
    [@enable_backup = ] { 0 | 1}    ,[@database_name = ] 'database_name'    ,[@container_url = ] 'Azure_Storage_blob_container  
    ,[@retention_days = ] 'retention_period_in_days'    ,[@credential_name = ] 'sql_credential_name'  

Argumen

@enable_backup
Aktifkan atau nonaktifkan SQL Server Managed Backup ke Microsoft Azure untuk database yang ditentukan. adalah @enable_backupBIT. Parameter yang diperlukan saat mengonfigurasi SQL Server Managed Backup ke Microsoft Azure untuk instans pertama SQL Server. Jika Anda mengubah SQL Server Managed Backup yang sudah ada ke konfigurasi Microsoft Azure, parameter ini bersifat opsional. Dalam hal ini, nilai konfigurasi apa pun yang tidak ditentukan mempertahankan nilai yang ada.

@database_name
Nama database untuk mengaktifkan pencadangan terkelola pada database tertentu.

@container_url
URL yang menunjukkan lokasi cadangan. Ketika @credential_name NULL, URL ini adalah URL tanda tangan akses bersama (SAS) ke kontainer blob di Azure Storage, dan cadangan menggunakan cadangan baru untuk memblokir fungsionalitas blob. Untuk informasi selengkapnya, silakan tinjau Memahami SAS. Ketika @credential_name ditentukan, maka ini adalah URL akun penyimpanan, dan cadangan menggunakan fungsionalitas pencadangan yang tidak digunakan lagi ke blob halaman.

Catatan

Hanya URL SAS yang didukung untuk parameter ini saat ini.

@retention_days
Periode retensi untuk file cadangan dalam beberapa hari. adalah @storage_url INT. Ini adalah parameter yang diperlukan saat mengonfigurasi SQL Server Managed Backup ke Microsoft Azure untuk pertama kalinya pada instans SQL Server. Saat mengubah konfigurasi SQL Server Managed Backup ke Microsoft Azure, parameter ini bersifat opsional. Jika tidak ditentukan, nilai konfigurasi yang ada akan dipertahankan.

@credential_name
Nama Kredensial SQL yang digunakan untuk mengautentikasi ke akun penyimpanan Azure. @credentail_name adalah SYSNAME. Ketika ditentukan, cadangan disimpan ke blob halaman. Jika parameter ini NULL, cadangan akan disimpan sebagai blob blok. Pencadangan ke blob halaman tidak digunakan lagi, jadi lebih disukai untuk menggunakan fungsionalitas cadangan blob blok baru. Ketika digunakan untuk mengubah konfigurasi SQL Server Managed Backup ke Microsoft Azure, parameter ini bersifat opsional. Jika tidak ditentukan, maka nilai konfigurasi yang ada akan dipertahankan.

Peringatan

Parameter @credential_name saat ini tidak didukung. Hanya cadangan untuk memblokir blob yang didukung, yang mengharuskan parameter ini menjadi NULL.

Mengembalikan Nilai Kode

0 (keberhasilan) atau 1 (kegagalan)

Keamanan

Izin

Memerlukan keanggotaan dalam peran database db_backupoperator , dengan izin ALTER ANY CREDENTIAL , dan izin EXECUTE pada prosedur tersimpan sp_delete_backuphistory .

Contoh

Anda dapat membuat kontainer akun penyimpanan dan URL SAS dengan menggunakan perintah Azure PowerShell terbaru. Contoh berikut membuat kontainer baru, mycontainer, di akun penyimpanan mystorageaccount lalu mendapatkan URL SAS untuk kontainer tersebut dengan izin penuh.

$context = New-AzureStorageContext -StorageAccountName mystorageaccount -StorageAccountKey (Get-AzureStorageKey -StorageAccountName mystorageaccount).Primary  
New-AzureStorageContainer -Name mycontainer -Context $context  
New-AzureStorageContainerSASToken -Name mycontainer -Permission rwdl -FullUri -Context $context  

Contoh berikut memungkinkan SQL Server Managed Backup ke Microsoft Azure untuk instans SQL Server dijalankannya, menetapkan kebijakan penyimpanan menjadi 30 hari, mengatur tujuan ke kontainer bernama 'mycontainer' di akun penyimpanan bernama 'mystorageaccount'.

Use msdb;  
Go  
   EXEC managed_backup.sp_backup_config_basic  
                @enable_backup=1  
                ,@container_url = 'https://mystorageaccount.blob.core.windows.net/mycontainer'  
                ,@retention_days=30;   
GO  
  

Contoh berikut menonaktifkan SQL Server Managed Backup ke Microsoft Azure untuk instans SQL Server dieksekusi.

Use msdb;  
Go  
EXEC managed_backup.sp_backup_config_basic  
                @enable_backup=0;  
GO  
  

Lihat juga

managed_backup.sp_backup_config_advanced (Transact-SQL)
managed_backup.sp_backup_config_schedule (Transact-SQL)