managed_backup.sp_backup_config_basic (Transact-SQL)

  • Artikel

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 Enable SQL Server Managed Backups to Azure.

[ @database_name = ] 'database_name'

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

Wenn @database_name auf NULL festgelegt 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 NULL ist, handelt es sich bei dieser URL um eine SAS-URL (Shared Access Signature) zu einem Blobcontainer in Azure Storage, und die Sicherungen verwenden die neue Sicherung, um blob-Funktionen zu blockieren. Weitere Informationen finden Sie unter Understanding 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 NULL ist, 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. Es wird nur sicherung zum Blockieren des Blobs unterstützt, was erfordert, dass dieser Parameter NULL ist.

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 myContainermystorageaccountist.

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

Zugehöriger Inhalt