managed_backup.fn_backup_db_config (Transact-SQL)

Aplica-se a: SQL Server 2016 (13.x) e versões posteriores

Retorna 0, 1 ou mais linhas com as definições de configuração do backup gerenciado do SQL Server no Microsoft Azure. Retorna 1 linha para o banco de dados especificado ou retorna as informações de todos os bancos de dados configurados com o backup gerenciado do SQL Server no Microsoft Azure na instância.

Use este procedimento armazenado para revisar ou determinar as definições de configuração atuais do backup gerenciado do SQL Server no Microsoft Azure para um banco de dados ou todos os bancos de dados em uma instância do SQL Server.

Convenções de sintaxe de Transact-SQL

Sintaxe

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

Argumentos

@db_name
O nome do banco de dados. O @db_name parâmetro é SYSNAME. Se uma cadeia de caracteres vazia ou um valor NULO for passado para esse parâmetro, as informações sobre todos os bancos de dados na instância do SQL Server serão retornadas.

Tabela retornada

Nome da Coluna Tipo de Dados Descrição
db_name SYSNAME nome do banco de dados.
db_guid UNIQUEIDENTIFIER Identificador que identifica exclusivamente o banco de dados.
is_availability_database BIT Se o banco de dados estiver participando de um grupo de disponibilidade. Um valor 1 indica que é um banco de dados de disponibilidade e o valor 0 indica que não é.
is_dropped BIT Um valor 1 indica que esse é um banco de dados ignorado.
credential_name SYSNAME O nome da credencial de SQL usado para realizar a autenticação na conta de armazenamento. O valor NULL indica que nenhuma credencial do SQL foi definida.
retention_days INT O período de retenção atual em dias. NULL indica que o backup gerenciado do SQL Server no Microsoft Azure nunca foi configurado para esse banco de dados.
is_managed_backup_enabled INT Indica se o backup gerenciado do SQL Server no Microsoft Azure está habilitado no momento para esse banco de dados. Um valor de 1 indica que o backup gerenciado do SQL Server no Microsoft Azure está habilitado no momento e um valor de 0 indica que o backup gerenciado do SQL Server no Microsoft Azure está desabilitado para esse banco de dados.
storage_url NVARCHAR(1024) A URL da conta de armazenamento.
Encryption_algorithm NCHAR(20) Retorna o algoritmo de criptografia atual a ser usado na criptografia do backup.
Encryptor_type NCHAR(15) Retorna a configuração do criptografador: certificado ou chave assimétrica.
Encryptor_name NCHAR(max_length_of_cert/asymm_key_name) O nome do certificado ou da chave assimétrica.

Segurança

Permissões

Requer associação na função de banco de dados db_backupoperator com permissões ALTER ANY CREDENTIAL . O usuário não deve ter permissões VIEW ANY DEFINITION negadas.

Exemplos

O exemplo a seguir retorna a configuração do backup gerenciado do SQL Server para o Microsoft Azure para 'TestDB'

Para cada snippet de código, selecione 'tsql' no campo do atributo de idioma.

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

O exemplo a seguir retorna a configuração do backup gerenciado do SQL Server no Microsoft Azure para todos os bancos de dados na instância do SQL Server em que ele é executado.

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