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)