managed_backup.sp_backup_config_basic (Transact-SQL)

  • Статья

Область применения: SQL Server 2016 (13.x) и более поздних версий

Настраивает управляемое резервное копирование SQL Server в базовые параметры Microsoft Azure для определенной базы данных или экземпляра SQL Server.

Примечание.

Эту процедуру можно вызвать самостоятельно для создания базовой конфигурации управляемого резервного копирования. Однако если вы планируете добавлять расширенные функции или пользовательское расписание, настройте эти параметры с помощью managed_backup.sp_backup_config_advanced и managed_backup.sp_backup_config_schedule, прежде чем включить управляемое резервное копирование с помощью этой процедуры.

Соглашения о синтаксисе Transact-SQL

Синтаксис

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'
[ ; ]

Аргументы

[ @enable_backup = ] { 0 | 1 }

Включите или отключите управляемое резервное копирование SQL Server в Microsoft Azure для указанной базы данных. @enable_backup бит.

Обязательный параметр при настройке управляемого резервного копирования SQL Server в Microsoft Azure для первого экземпляра SQL Server. Если вы изменяете существующую управляемую резервную копию SQL Server на конфигурацию Microsoft Azure, этот параметр является необязательным. В этом случае все значения конфигурации, не указанные, сохраняют существующие значения.

Дополнительные сведения см. в статье "Включение управляемых резервных копий SQL Server в Azure".

[ @database_name = ] 'database_name'

Имя базы данных для включения управляемого резервного копирования в определенной базе данных.

Если @database_name имеет значение NULL, параметры находятся на уровне экземпляра (применяется ко всем новым базам данных, созданным на экземпляре).

[ @container_url = ] 'Azure_служба хранилища_blob_container'

URL-адрес, указывающий расположение резервной копии. Если @credential_name имеет значение NULL, этот URL-адрес является URL-адресом подписанного URL-адреса (SAS) контейнера BLOB-объектов в служба хранилища Azure, а резервные копии используют новую резервную копию для блокировки функциональных возможностей BLOB-объектов. Дополнительные сведения см. в разделе "Общие сведения о SAS". При указании @credential_name это URL-адрес учетной записи хранения, а резервные копии используют устаревшую резервную копию для функциональных возможностей страничных BLOB-объектов.

Если URL-адрес SAS содержит маркер SAS, необходимо отделить его от маркера SAS на вопросительный знак и не включать вопросительный знак.

Например, 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 приводит к следующим двум значениям:

Тип Выходные данные
URL-адрес контейнера https://managedbackupstorage.blob.core.windows.net/backupcontainer
Маркер SAS sv=2014-02-14&sr=c&sig=xM2LXVo1Erqp7LxQ%9BxqK9QC6%5Qabcd%9LKjHGnnmQWEsDf%5Q%se=2015-05-14T14%3B93%4V20X&sp=rwdl

Примечание.

В настоящее время для этого параметра поддерживается только URL-адрес SAS.

[ @retention_days = ] retention_period_in_days

Срок хранения файлов резервной копии в днях. @retention_days является int. Это обязательный параметр при настройке управляемого резервного копирования SQL Server в Microsoft Azure впервые на экземпляре SQL Server. При изменении управляемого резервного копирования SQL Server на конфигурацию Microsoft Azure этот параметр является необязательным. Если аргумент не указан, сохраняются существующие значения конфигурации.

[ @credential_name = ] 'sql_credential_name'

Имя учетных данных SQL, используемых для проверки подлинности в учетной записи хранения Azure. @credential_name — sysname. При указании резервная копия хранится в страничном BLOB-объекте. Если этот параметр имеет значение NULL, резервная копия хранится в виде блочного BLOB-объекта. Резервное копирование на страницу большого двоичного объекта устарело, поэтому рекомендуется использовать новую функцию резервного копирования BLOB-объектов блока. При использовании для изменения управляемого резервного копирования SQL Server на конфигурацию Microsoft Azure этот параметр является необязательным. Если не указано, сохраняются существующие значения конфигурации.

Предупреждение

В настоящее время параметр @credential_name не поддерживается. Поддерживается только резервное копирование для блочного большого двоичного объекта, которое требует, чтобы этот параметр был NULL.

Значения кода возврата

0 (успешно) или 1 (сбой).

Разрешения

Требуется членство в роли базы данных db_backupoperator с разрешениями ALTER ANY CREDENTIAL и РАЗРЕШЕНИЯ EXECUTE для хранимой sp_delete_backuphistory процедуры.

Примеры

А. Создание контейнера учетной записи хранения и URL-адреса SAS

Вы можете создать контейнер учетной записи хранения и URL-адрес подписанного URL-адреса URL-адреса с подписанным URL-адресом url-адреса с помощью последних команд Azure PowerShell. В следующем примере создается новый контейнер myContainer в mystorageaccount учетной записи хранения, а затем получает URL-адрес SAS для него с полными разрешениями.

Дополнительные сведения о подписанных URL-адресах см. в статье об использование подписанных URL-адресов SAS в службе хранилища Azure. Пример сценария PowerShell см. в статье "Создание подписанного URL-адреса".

$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. Включение управляемого резервного копирования SQL Server в Azure

В следующем примере выполняется управляемое резервное копирование SQL Server в Microsoft Azure для экземпляра SQL Server, в котором он выполняется, устанавливает политику хранения в течение 30 дней и задает целевой контейнер, именованный myContainermystorageaccountв учетной записи хранения.

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. Отключение управляемого резервного копирования SQL Server в Azure

В следующем примере отключается управляемое резервное копирование SQL Server в Microsoft Azure для экземпляра SQL Server, на который он выполняется.

USE msdb;
GO

EXEC managed_backup.sp_backup_config_basic @enable_backup = 0;
GO

Связанный контент