Bagikan melalui

managed_backup.sp_backup_config_basic (Transact-SQL)

  • Artikel

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

Mengonfigurasi cadangan terkelola SQL Server 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 lanjutan atau jadwal kustom, konfigurasikan pengaturan tersebut menggunakan managed_backup.sp_backup_config_advanced dan managed_backup.sp_backup_config_schedule, sebelum mengaktifkan pencadangan terkelola dengan prosedur ini.

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 = ] { 0 | 1 }

Aktifkan atau nonaktifkan cadangan terkelola SQL Server ke Microsoft Azure untuk database yang ditentukan. @enable_backup sedikit.

Parameter yang diperlukan saat mengonfigurasi cadangan terkelola SQL Server ke Microsoft Azure untuk instans pertama SQL Server. Jika Anda mengubah cadangan terkelola SQL Server 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.

Untuk informasi selengkapnya, lihat Mengaktifkan pencadangan terkelola SQL Server ke Azure.

[ @database_name = ] 'database_name'

Nama database untuk mengaktifkan cadangan terkelola pada database tertentu.

Jika @database_name diatur ke NULL, pengaturan berada pada tingkat instans (berlaku untuk semua database baru yang dibuat pada instans).

[ @container_url = ] 'Azure_Storage_blob_container'

URL yang menunjukkan lokasi cadangan. Saat @credential_name adalah 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, tinjau Memberikan akses terbatas ke sumber daya Azure Storage menggunakan tanda tangan akses bersama (SAS). Ketika @credential_name ditentukan, maka ini adalah URL akun penyimpanan, dan cadangan menggunakan cadangan yang tidak digunakan lagi untuk fungsionalitas blob halaman.

Jika URL SAS menyertakan token SAS, Anda harus memisahkannya dari token SAS pada tanda tanya, dan tidak menyertakan tanda tanya.

Misalnya, https://managedbackupstorage.blob.core.windows.net/backupcontainer?sv=2014-02-14&sr=c&sig=xM2LXVo1Erqp7LxQ%9BxqK9QC6%5Qabcd%9LKjHGnnmQWEsDf%5Q%se=2015-05-14T14%3B93%4V20X&sp=rwdl menghasilkan dua nilai berikut:

Jenis Output
URL Kontainer https://managedbackupstorage.blob.core.windows.net/backupcontainer
Token SAS sv=2014-02-14&sr=c&sig=xM2LXVo1Erqp7LxQ%9BxqK9QC6%5Qabcd%9LKjHGnnmQWEsDf%5Q%se=2015-05-14T14%3B93%4V20X&sp=rwdl

Catatan

Hanya URL SAS yang didukung untuk parameter ini saat ini.

[ @retention_days = ] retention_period_in_days

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

[ @credential_name = ] 'sql_credential_name'

Nama kredensial SQL yang digunakan untuk mengautentikasi ke akun penyimpanan Azure. @credential_name adalah sysname. Ketika ditentukan, cadangan disimpan ke blob halaman. Jika parameter ini adalah NULL, cadangan disimpan sebagai blob blok. Mencadangkan ke blob halaman tidak digunakan lagi, jadi lebih disukai untuk menggunakan fungsionalitas pencadangan blob blok baru. Ketika digunakan untuk mengubah cadangan terkelola SQL Server ke konfigurasi Microsoft Azure, parameter ini bersifat opsional. Jika tidak ditentukan, maka nilai konfigurasi yang ada 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 (berhasil) atau 1 (kegagalan).

Izin

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

Contoh

J. Membuat kontainer akun penyimpanan dan URL SAS

Anda dapat membuat kontainer akun penyimpanan dan URL tanda tangan akses bersama (SAS) dengan menggunakan perintah Azure PowerShell terbaru. Contoh berikut membuat kontainer baru di mystorageaccount akun penyimpanan, lalu mendapatkan URL SAS untuk kontainer myContainer tersebut dengan izin penuh.

Untuk informasi selengkapnya tentang tanda tangan akses bersama, lihat Berikan akses terbatas ke sumber daya Azure Storage dengan menggunakan tanda tangan akses berbagi (SAS). Untuk contoh skrip PowerShell, lihat Membuat Tanda Tangan Akses Bersama.

$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

B. Mengaktifkan Pencadangan Terkelola SQL Server ke Azure

Contoh berikut memungkinkan pencadangan terkelola SQL Server ke Microsoft Azure untuk instans SQL Server tempatnya dijalankan, mengatur kebijakan penyimpanan menjadi 30 hari, dan 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

C. Menonaktifkan Pencadangan Terkelola SQL Server ke Azure

Contoh berikut menonaktifkan pencadangan terkelola SQL Server ke Microsoft Azure untuk instans SQL Server tempatnya dijalankan.

USE msdb;
GO

EXEC managed_backup.sp_backup_config_basic @enable_backup = 0;
GO

Konten terkait