managed_backup.sp_backup_config_basic (Transact-SQL)
Gilt für: SQL Server 2016 (13.x) und höhere Versionen
Konfiguriert die verwaltete SQL Server-Sicherung für microsoft Azure-Basiseinstellungen für eine bestimmte Datenbank oder für eine Instanz von SQL Server.
Hinweis
Dieses Verfahren kann eigenständig aufgerufen werden, um eine einfache verwaltete Sicherungskonfiguration zu erstellen. Wenn Sie jedoch beabsichtigen, erweiterte Features oder einen benutzerdefinierten Zeitplan hinzuzufügen, konfigurieren Sie diese Einstellungen mithilfe von managed_backup.sp_backup_config_advanced und managed_backup.sp_backup_config_schedule, bevor Sie verwaltete Sicherung mit diesem Verfahren aktivieren.
Transact-SQL-Syntaxkonventionen
Syntax
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'
[ ; ]
Argumente
[ @enable_backup = ] { 0 | 1 }
Aktivieren oder Deaktivieren der verwalteten SQL Server-Sicherung in Microsoft Azure für die angegebene Datenbank. @enable_backup ist bit.
Erforderlicher Parameter beim Konfigurieren der verwalteten SQL Server-Sicherung für die erste Instanz von SQL Server in Microsoft Azure. Wenn Sie eine vorhandene verwaltete SQL Server-Sicherung in die Microsoft Azure-Konfiguration ändern, ist dieser Parameter optional. In diesem Fall behalten alle konfigurationswerte, die nicht angegeben wurden, ihre vorhandenen Werte.
Weitere Informationen finden Sie unter Aktivieren der verwalteten SQL Server-Sicherung in Azure.
[ @database_name = ] 'database_name'
Der Datenbankname zum Aktivieren der verwalteten Sicherung für eine bestimmte Datenbank.
Wenn @database_name festgelegt NULL
ist, befinden sich die Einstellungen auf Instanzebene (gilt für alle neuen Datenbanken, die auf der Instanz erstellt wurden).
[ @container_url = ] 'Azure_Storage_blob_container'
Eine URL, die den Speicherort der Sicherung angibt. Wenn @credential_name ist, ist NULL
diese URL eine SAS-URL (Shared Access Signature) zu einem BLOB-Container in Azure Storage, und die Sicherungen verwenden die neue Sicherung, um blob-Funktionalität zu blockieren. Weitere Informationen erhalten Sie unter "Gewähren des eingeschränkten Zugriffs auf Azure Storage-Ressourcen mit freigegebenen Zugriffssignaturen (SAS)". Wenn @credential_name angegeben wird, handelt es sich hierbei um eine Speicherkonto-URL, und die Sicherungen verwenden die veraltete Sicherung zur Seiten-BLOB-Funktionalität.
Wenn die SAS-URL das SAS-Token enthält, müssen Sie es vom SAS-Token am Fragezeichen trennen und das Fragezeichen nicht einschließen.
Führt beispielsweise 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
zu den folgenden beiden Werten:
type | Output |
---|---|
Container-URL | https://managedbackupstorage.blob.core.windows.net/backupcontainer |
SAS-Token | sv=2014-02-14&sr=c&sig=xM2LXVo1Erqp7LxQ%9BxqK9QC6%5Qabcd%9LKjHGnnmQWEsDf%5Q%se=2015-05-14T14%3B93%4V20X&sp=rwdl |
Hinweis
Derzeit wird nur eine SAS-URL für diesen Parameter unterstützt.
[ @retention_days = ] retention_period_in_days
Die Beibehaltungsdauer für die Sicherungsdateien in Tagen. @retention_days ist int. Dies ist ein erforderlicher Parameter beim erstmaligen Konfigurieren der verwalteten SQL Server-Sicherung in Microsoft Azure in der Sql Server-Instanz. Wenn Sie die verwaltete SQL Server-Sicherung in die Microsoft Azure-Konfiguration ändern, ist dieser Parameter optional. Wenn der Parameter nicht angegeben ist, werden die vorhandenen Konfigurationswerte beibehalten.
[ @credential_name = ] 'sql_credential_name'
Der Name der SQL-Anmeldeinformationen, die für die Authentifizierung beim Azure-Speicherkonto verwendet werden. @credential_name ist "sysname". Wenn angegeben, wird die Sicherung in einem Seiten-BLOB gespeichert. Wenn dieser Parameter lautet NULL
, wird die Sicherung als Block-BLOB gespeichert. Das Sichern des Seitenblobs ist veraltet, daher empfiehlt es sich, die neue Block-BLOB-Sicherungsfunktionalität zu verwenden. Wenn sie zum Ändern der verwalteten SQL Server-Sicherung in die Microsoft Azure-Konfiguration verwendet wird, ist dieser Parameter optional. Wenn nicht angegeben, werden die vorhandenen Konfigurationswerte beibehalten.
Warnung
Der parameter @credential_name wird zurzeit nicht unterstützt. Nur Sicherung zum Blockieren von BLOB wird unterstützt, was erfordert, dass dieser Parameter sein muss NULL
.
Rückgabecodewerte
0
(erfolgreich) oder 1
Fehler.
Berechtigungen
Erfordert die Mitgliedschaft in der db_backupoperator-Datenbankrolle mit ALTER ANY CREDENTIAL-Berechtigungen und EXECUTE-Berechtigungen für die sp_delete_backuphistory
gespeicherte Prozedur.
Beispiele
A. Erstellen des Speicherkontocontainers und der SAS-URL
Sie können sowohl den Speicherkontocontainer als auch die SAS-URL (Shared Access Signature) mithilfe der neuesten Azure PowerShell-Befehle erstellen. Im folgenden Beispiel wird ein neuer Container myContainer
im mystorageaccount
Speicherkonto erstellt und anschließend eine SAS-URL für ihn mit vollständigen Berechtigungen erhalten.
Weitere Informationen zu SAS (Shared Access Signatures) finden Sie unter Gewähren von eingeschränktem Zugriff auf Azure Storage-Ressourcen mithilfe von SAS (Shared Access Signature). Ein Beispiel für ein PowerShell-Skript finden Sie unter Erstellen einer Freigegebenen Zugriffssignatur.
$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. Aktivieren von SQL Server Managed Backup in Azure
Im folgenden Beispiel wird sql Server managed backup to Microsoft Azure für die Instanz von SQL Server aktiviert, für die sie ausgeführt wird, die Aufbewahrungsrichtlinie auf 30 Tage festgelegt und das Ziel auf einen Container festgelegt, der in einem Speicherkonto mit dem Namen benannt myContainer
mystorageaccount
ist.
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. Deaktivieren der verwalteten SQL Server-Sicherung in Azure
Im folgenden Beispiel wird die verwaltete SQL Server-Sicherung in Microsoft Azure für die Instanz von SQL Server deaktiviert, auf der sie ausgeführt wird.
USE msdb;
GO
EXEC managed_backup.sp_backup_config_basic @enable_backup = 0;
GO