managed_backup.fn_backup_db_config (Transact-SQL)

适用于:SQL Server 2016 (13.x) 及更高版本

返回包含 SQL Server 托管备份到 Microsoft Azure 配置设置的 0、1 行或更多行。 返回指定数据库的 1 行,或返回实例上配置了 SQL Server 托管备份到 Microsoft Azure 的所有数据库的信息。

使用此存储过程可以查看或确定 SQL Server 实例上数据库或所有数据库的当前 SQL Server 托管备份到 Microsoft Azure 配置设置。

Transact-SQL 语法约定

语法

managed_backup.fn_backup_db_config ('database_name' | '' | NULL)  

参数

@db_name
数据库的名称。 参数 @db_name 为 SYSNAME。 如果传递给此参数的是空字符串或 Null 值,则将返回 SQL Server 实例上所有数据库的有关信息。

返回的表

列名称 数据类型 描述
db_name SYSNAME 数据库名称。
db_guid UNIQUEIDENTIFIER 唯一标识数据库的标识符。
is_availability_database BIT 此数据库是否参与可用性组。 值 1 指示数据库是可用性数据库,0 指示不是。
is_dropped BIT 值 1 指示此数据库为已删除数据库。
credential_name SYSNAME 用于对存储帐户进行身份验证的 SQL 凭据的名称。 NULL 值指示未设置 SQL 凭据。
retention_days INT 当前的保留期(以天为单位)。 NULL 值表示从未为此数据库配置 SQL Server 托管备份到 Microsoft Azure。
is_managed_backup_enabled INT 指示当前是否为此数据库启用了到 Microsoft Azure 的 SQL Server 托管备份。 值为 1 表示当前已启用到 Microsoft Azure 的 SQL Server 托管备份,值为 0 表示已为此数据库禁用到 Microsoft Azure 的 SQL Server 托管备份。
storage_url NVARCHAR(1024) 存储帐户的 URL。
Encryption_algorithm NCHAR(20) 返回当前要在加密备份时使用的加密算法。
Encryptor_type NCHAR(15) 返回加密程序设置:证书或非对称密钥。
Encryptor_name NCHAR(max_length_of_cert/asymm_key_name) 证书或非对称密钥的名称。

安全性

权限

要求具有 ALTER ANY CREDENTIAL 权限的db_backupoperator数据库角色的成员身份。 不应拒绝 用户 VIEW ANY DEFINITION 权限。

示例

以下示例将 SQL Server 托管备份返回到“TestDB”的 Microsoft Azure 配置

对于每个代码段,请在语言属性字段中选择“tsql”。

Use msdb  
GO  
SELECT * FROM managed_backup.fn_backup_db_config('TestDB')  

以下示例将 SQL Server 托管备份返回到它所执行 SQL Server 实例上所有数据库的 Microsoft Azure 配置。

Use msdb  
GO  
SELECT * FROM managed_backup.fn_backup_db_config (NULL)