DATABASEPROPERTY (Transact-SQL)

Retorna o valor de propriedade do banco de dados nomeado para o nome de propriedade e banco de dados especificados.

Observação importanteImportante

Esse recurso será removido na próxima versão do Microsoft SQL Server. Não utilize esse recurso em desenvolvimentos novos e modifique, assim que possível, os aplicativos que atualmente o utilizam. Em vez disso, use DATABASEPROPERTYEX.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

DATABASEPROPERTY ( database , property ) 

Argumentos

  • database
    É uma expressão que contém o nome do banco de dados para o qual retornará as informações da propriedade nomeada. database é nvarchar(128).

  • property
    É uma expressão que contém o nome da propriedade de banco de dados a ser retornada.property é varchar(128) e pode ser um dos valores a seguir.

    Valor

    Descrição

    Valor retornado

    IsAnsiNullDefault

    O banco de dados segue regras ISO para permitir valores nulos.

    1 = TRUE

    0 = FALSE

    NULL = Entrada inválida

    IsAnsiNullsEnabled

    Todas as comparações com um nulo são avaliadas como desconhecidas.

    1 = TRUE

    0 = FALSE

    NULL = Entrada inválida

    IsAnsiWarningsEnabled

    Quando ocorrem condições de erro padrão, são emitidas mensagens de erro ou de aviso.

    1 = TRUE

    0 = FALSE

    NULL = Entrada inválida

    IsAutoClose

    Após a saída do último usuário, o banco de dados é desligado corretamente e libera recursos.

    1 = TRUE

    0 = FALSE

    NULL = Entrada inválida

    IsAutoCreateStatistics

    Quando se tornam desatualizadas com a mudança de dados nas tabelas, as estatísticas existentes são atualizadas automaticamente.

    1 = TRUE

    0 = FALSE

    NULL = Entrada inválida

    IsAutoShrink

    Os arquivos de banco de dados são candidatos à redução automática periódica.

    1 = TRUE

    0 = FALSE

    NULL = Entrada inválida

    IsAutoUpdateStatistics

    Opção de banco de dados de atualização automática de estatística está habilitada.

    1 = TRUE

    0 = FALSE

    NULL = Entrada inválida

    IsBulkCopy

    Banco de dados permite operações não registradas no log.

    1 = TRUE

    0 = FALSE

    NULL = Entrada inválida

    IsCloseCursorsOnCommitEnabled

    Os cursores que estão abertos quando uma transação é confirmada são fechados.

    1 = TRUE

    0 = FALSE

    NULL = Entrada inválida

    IsDboOnly

    Banco de dados está em modo de acesso somente DBO.

    1 = TRUE

    0 = FALSE

    NULL = Entrada inválida

    IsDetached

    Banco de dados foi desanexado por uma operação de remoção.

    1 = TRUE

    0 = FALSE

    NULL = Entrada inválida

    IsEmergencyMode

    Modo de emergência habilitado, para permitir que um banco de dados suspeito seja utilizável.

    1 = TRUE

    0 = FALSE

    NULL = Entrada inválida

    IsFulltextEnabled

    Banco de dados com texto completo habilitado.

    1 = TRUE

    0 = FALSE

    NULL = Entrada inválida

    IsInLoad

    Banco de dados está carregando.

    1 = TRUE

    0 = FALSE

    NULL = Entrada inválida

    IsInRecovery

    Banco de dados está recuperando.

    1 = TRUE

    0 = FALSE NULL1 = Entrada inválida

    IsInStandBy

    O banco de dados está on-line como somente leitura, com log de restauração permitido.

    1 = TRUE

    0 = FALSE

    NULL = Entrada inválida

    IsLocalCursorsDefault

    As declarações de cursor assumem LOCAL como padrão.

    1 = TRUE

    0 = FALSE

    NULL = Entrada inválida

    IsNotRecovered

    Recuperação do banco de dados falhou.

    1 = TRUE

    0 = FALSE

    NULL = Entrada inválida

    IsNullConcat

    Operando de concatenação nulo resulta em NULL.

    1 = TRUE

    0 = FALSE

    NULL = Entrada inválida

    IsOffline

    Banco de dados está offline.

    1 = TRUE

    0 = FALSE

    NULL = Entrada inválida

    IsParameterizationForced

    A opção SET do banco de dados PARAMETERIZATION é FORCED.

    1 = TRUE

    0 = FALSE

    NULL = Entrada inválida

    IsQuotedIdentifiersEnabled

    Pode-se usar aspas duplas em identificadores.

    1 = TRUE

    0 = FALSE

    NULL = Entrada inválida

    IsReadOnly

    Banco de dados está em modo de acesso somente leitura.

    1 = TRUE

    0 = FALSE

    NULL = Entrada inválida

    IsRecursiveTriggersEnabled

    O acionamento recursivo dos gatilhos está habilitado.

    1 = TRUE

    0 = FALSE

    NULL = Entrada inválida

    IsShutDown

    Banco de dados encontrou um problema na inicialização.

    1 = TRUE

    0 = FALSE

    NULL1 = Entrada inválida.

    IsSingleUser

    Banco de dados está em modo de acesso de usuário único.

    1 = TRUE

    0 = FALSE

    NULL = Entrada inválida

    IsSuspect

    Banco de dados é suspeito.

    1 = TRUE

    0 = FALSE

    NULL = Entrada inválida

    IsTruncLog

    Banco de dados trunca seu log em pontos de verificação.

    1 = TRUE

    0 = FALSE

    NULL = Entrada inválida

    Version

    Número de versão interno do código do Microsoft SQL Server com o qual o banco de dados foi criado. Identificado apenas para fins informativos. Sem suporte. A compatibilidade futura não está garantida.

    Número de versão = Banco de dados está aberto.

    NULL = Banco de Dados está fechado.

1 Valor retornado também será NULL se o banco de dados nunca foi iniciado, nem fechado automaticamente.

Tipos de retorno

int

Exceções

Retorna NULL para erro ou caso um chamador não tenha permissão para exibir o objeto.

No SQL Server, um usuário só pode exibir os metadados de itens protegíveis de sua propriedade ou para os quais ele tenha permissão concedida. Isso significa que as funções internas emissoras de metadados, como OBJECT_ID, podem retornar NULL se o usuário não tiver permissão no objeto. Para obter mais informações, consulte Configuração de visibilidade de metadados e Solucionando problemas de visibilidade de metadados.

Exemplos

O exemplo a seguir retorna a configuração para a propriedade IsTruncLog para o banco de dados master.

USE master;
GO
SELECT DATABASEPROPERTY('master', 'IsTruncLog');

Aqui está o conjunto de resultados.

-------------------
1