Funções de metadados (Transact-SQL)

Aplica-se a:SQL ServerAzure SQL Managed Instance

Este artigo descreve funções escalares que retornam informação sobre a base de dados e os objetos da base de dados.

Todas as funções de metadados são não determinísticas. Nem sempre devolvem os mesmos resultados sempre que são chamados, mesmo com o mesmo conjunto de valores de entrada.

Metadados de servidor, base de dados, sessão e contexto principal

Descobre onde estás a correr (instância e base de dados) e com quem estás a correr (aplicação cliente, principal da base de dados). Use esta informação para scripts e diagnósticos conscientes do ambiente.

Função	Description
SERVERPROPERTY	Devolve propriedades da instância do SQL Server, como edição, colação ou nível de produto.
DB_ID	Devolve o ID de uma base de dados.
DB_NAME	Devolve o nome de uma base de dados com o ID.
DATABASEPROPERTYEX	Devolve valores de propriedades ao nível da base de dados, como a colação e o estado.
ORIGINAL_DB_NAME	Devolve o nome original da base de dados antes de uma sequência de restauro.
APP_NAME	Devolve o nome da aplicação para a sessão atual.
DATABASE_PRINCIPAL_ID	Devolve o ID principal de um principal de segurança de base de dados.
VERSÃO	Retorna a string de versão para Azure Synapse Analytics and Analytics Platform System (PDW).

¹Aplica-se apenas a: Azure Synapse Analytics and Analytics Platform System (PDW)

Identificação de objetos e resolução de nomes

Resolver IDs em nomes entre objetos e esquemas, e analisar identificadores multipartes. Estas funções fornecem suporte central para introspeção e SQL dinâmico.

Função	Description
OBJECT_ID	Devolve o ID de um objeto com âmbito de esquema.
OBJECT_NAME	Devolve o nome do objeto para um ID de objeto.
OBJECT_SCHEMA_NAME	Devolve o nome do esquema de um objeto.
SCHEMA_ID	Devolve o ID de um esquema.
SCHEMA_NAME	Devolve o nome de um esquema por ID.
PARSENAME	Devolve uma parte do nome de um objeto multiparte (servidor, base de dados, esquema, objeto).
@@PROCID	Devolve o ID do procedimento armazenado atualmente em execução.

Metadados de capacidades de objetos e programabilidade

Inspeciona o que é um objeto, como se comporta e como é implementado. Esta inspeção inclui a definição e propriedades, bem como os metadados de montagem CLR.

Função	Description
OBJECT_DEFINITION	Devolve a definição (texto fonte) de objetos programáveis.
OBJECTPROPERTY	Devolve uma propriedade para um objeto (por exemplo, seja uma vista, tabela, etc.).
OBJECTPROPERTYEX	Devolve informação estendida sobre propriedades do objeto.
ASSEMBLY PROPERTY	Devolve um valor de propriedade especificado de uma assembly SQL CLR.

Metadados do modelo de dados (tipos e colunas)

Compreenda a identidade e propriedades do tipo, e a identidade e propriedades das colunas. Use estes metadados para validação de esquemas, geração de código, ETL e verificações de compatibilidade.

Função	Description
TYPE_ID	Devolve o ID de um tipo de dado.
TYPE_NAME	Devolve um nome de tipo de dado por ID.
TIPO DE PROPRIEDADE	Devolve uma propriedade de um tipo de dado, como precisão ou anulável.
COL_NAME	Devolve o nome da coluna para um determinado ID de coluna.
COL_LENGTH	Devolve o comprimento de uma coluna em bytes.
COLUMNPROPERTY	Devolve uma propriedade de uma coluna, como se é uma coluna identidade ou calculada.

Metadados do caminho de acesso (índices e estatísticas)

Verifique as estruturas de indexação e a atualização das estatísticas. Utilize estes metadados na otimização de fluxos de trabalho e na manutenção orientada por metadados.

Função	Description
INDEX_COL	Devolve o nome de uma coluna indexada.
INDEXKEY_PROPERTY	Devolve uma propriedade de uma chave de índice.
INDEXPROPERTY	Devolve uma propriedade de um índice, como clustered ou disabled.
STATS_DATE	Devolve as estatísticas da data que foram atualizadas pela última vez para uma tabela ou índice.

Armazenamento físico e metadados em texto completo

Inspecionar o layout físico (ficheiros e grupos de ficheiros) e os componentes em texto completo. Use esta informação para gestão de armazenamento, resolução de problemas e auditoria de configuração.

Função	Description
FILE_ID	Devolve o ID do ficheiro.
FILE_IDEX	Devolve o ID do ficheiro com base no nome do ficheiro.
FILE_NAME	Devolve o nome do ficheiro como ID de ficheiro.
FILEGROUP_ID	Devolve o ID de um grupo de ficheiros.
FILEGROUP_NAME	Devolve o nome de um grupo de ficheiros.
FILEGROUPPROPERTY	Devolve uma propriedade de um grupo de ficheiros.
FILEPROPERTY	Devolve uma propriedade do ficheiro, como tamanho ou estado.
FULLTEXTCATALOGPROPERTY	Devolve uma propriedade de um catálogo de texto completo.
PROPRIEDADEDOSERVIÇODETEXTOINTEGRAL	Devolve propriedades do serviço de texto completo, como o estado de carregamento.

Coordenação em tempo de execução e metadados de valor gerados

Coordenar o trabalho entre sessões usando bloqueios de aplicação. Recuperar valores numéricos gerados para objetos de identidade e sequência.

Função	Description
APPLOCK_MODE	Devolve o modo de bloqueio mantido pela sessão atual.
APPLOCK_TEST	Testa se uma fechadura pode ser obtida sem realmente a adquirir.
SCOPE_IDENTITY	Devolve o último valor de identidade gerado no âmbito atual.
PRÓXIMO VALOR PARA	Devolve o valor seguinte num objeto de sequência.