managed_backup.sp_backup_config_basic (Transact-SQL)

Gilt für:yes SQL Server 2016 (13.x) und höher

Konfiguriert die SQL Server Managed Backup, um grundlegende Einstellungen für eine bestimmte Datenbank oder eine Instanz von SQL Server zu Microsoft Azure.

Hinweis

Dieses Verfahren kann eigenständig aufgerufen werden, um eine grundlegende verwaltete Sicherungskonfiguration zu erstellen. Wenn Sie jedoch erweiterte Features oder einen benutzerdefinierten Zeitplan hinzufügen möchten, konfigurieren Sie diese Einstellungen zunächst mit managed_backup.sp_backup_config_advanced (Transact-SQL) und managed_backup.sp_backup_config_schedule (Transact-SQL), bevor Sie die verwaltete Sicherung mit diesem Verfahren aktivieren.

Topic link iconTransact-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
Aktivieren oder deaktivieren Sie SQL Server verwaltete Sicherung für Microsoft Azure für die angegebene Datenbank. ist @enable_backup@enable_backup. Erforderlicher Parameter beim Konfigurieren von SQL Server Managed Backup für Microsoft Azure für die erste Instanz von SQL Server. Wenn Sie eine vorhandene SQL Server Managed Backup in Microsoft Azure Konfiguration ändern, ist dieser Parameter optional. In diesem Fall behalten alle nicht angegebenen Konfigurationswerte ihre vorhandenen Werte bei.

@database_name
Der Datenbankname zum Aktivieren der verwalteten Sicherung für eine bestimmte Datenbank.

@container_url
Eine URL, die den Speicherort der Sicherung angibt. Wenn @credential_name NULL ist, ist diese URL eine SAS-URL (Shared Access Signature) für einen Blobcontainer in Azure Storage, und die Sicherungen verwenden die neue Sicherung, um blob-Funktionen zu blockieren. Weitere Informationen finden Sie unter Grundlegendes zu SAS. Wenn @credential_name angegeben ist, ist dies eine Speicherkonto-URL, und die Sicherungen verwenden die veraltete Funktion "Sicherung auf Seitenblob".

Hinweis

Derzeit wird nur eine SAS-URL für diesen Parameter unterstützt.

@retention_days
Die Beibehaltungsdauer für die Sicherungsdateien in Tagen. ist @storage_url INT. Dies ist ein erforderlicher Parameter, wenn SQL Server Managed Backup so konfiguriert wird, dass Microsoft Azure zum ersten Mal auf der Instanz von SQL Server. Beim Ändern des SQL Server Managed Backup in Microsoft Azure Konfiguration ist dieser Parameter optional. Wenn der Parameter nicht angegeben ist, werden die vorhandenen Konfigurationswerte beibehalten.

@credential_name
Der Name der SQL Anmeldeinformationen, die für die Authentifizierung beim Azure-Speicherkonto verwendet werden. @credentail_name ist @credentail_name. Wenn angegeben, wird die Sicherung in einem Seitenblob gespeichert. Wenn dieser Parameter NULL ist, wird die Sicherung als Blockblob gespeichert. Die Sicherung in Seitenblobs ist veraltet, daher wird die Verwendung der neuen Blockblob-Sicherungsfunktionalität bevorzugt. Wenn dieser Parameter verwendet wird, um die SQL Server Managed Backup in Microsoft Azure Konfiguration zu ändern, ist dieser Parameter optional. Wenn keine Angabe erfolgt, werden die vorhandenen Konfigurationswerte beibehalten.

Warnung

Der @credential_name Parameter wird derzeit nicht unterstützt. Es wird nur die Sicherung im Blockblob unterstützt, was erfordert, dass dieser Parameter NULL ist.

Rückgabecodewert

„0“ (erfolgreich) oder „1“ (fehlerhaft)

Sicherheit

Berechtigungen

Erfordert die Mitgliedschaft in db_backupoperator Datenbankrolle mit ALTER ANY CREDENTIAL-Berechtigungen und EXECUTE-Berechtigungen für sp_delete_backuphistory gespeicherte Prozedur.

Beispiele

Sie können sowohl den Speicherkontocontainer als auch die SAS-URL mithilfe der neuesten Azure PowerShell Befehle erstellen. Im folgenden Beispiel wird ein neuer Container mycontainer im Speicherkonto mystorageaccount erstellt und dann eine SAS-URL für diesen Container mit vollständigen Berechtigungen erhalten.

$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  

Im folgenden Beispiel wird SQL Server verwaltete Sicherung aktiviert, um Microsoft Azure für die Instanz von SQL Server sie ausgeführt wird, legt die Aufbewahrungsrichtlinie auf 30 Tage fest, legt das Ziel auf einen Container mit dem Namen "mycontainer" in einem Speicherkonto mit dem Namen "mystorageaccount" fest.

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  
  

Im folgenden Beispiel wird SQL Server verwaltete Sicherung deaktiviert, um Microsoft Azure für die Instanz von SQL Server sie ausgeführt wird.

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

Weitere Informationen

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