managed_backup.fn_backup_db_config (Transact-SQL)

  • Artigo

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

Retorna 0, 1 ou mais linhas com backup gerenciado do SQL Server para definições de configuração do 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 para o Microsoft Azure na instância.

Use este procedimento armazenado para revisar ou determinar o backup gerenciado atual do SQL Server para definições de configuração do 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. O valor 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 1 indica que o backup gerenciado do SQL Server para o Microsoft Azure está habilitado no momento e um valor 0 indica que o backup gerenciado do SQL Server para o Microsoft Azure está desabilitado para esse banco de dados.
storage_url NVARCHAR(1024) A URL da conta de armazenamento.
Encryption_algorithm NCAR(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 à função de banco de dados db_backupoperator com permissões ALTER ANY CREDENTIAL. O usuário não deve ter suas permissões de definição negadas.

Exemplos

O exemplo a seguir retorna o backup gerenciado do SQL Server para a configuração do 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 o backup gerenciado do SQL Server para a configuração do 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)