Funções de metadados (Transact-SQL)

Aplica-se a:SQL ServerInstância Gerenciada de SQL do Azure

Este artigo descreve funções escalares que retornam informações sobre os objetos de banco de dados e de banco de dados.

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

Metadados de contexto de servidor, banco de dados, sessão e entidade de segurança

Descubra onde você está executando (instância e banco de dados) e quem você está executando como ou por meio (aplicativo cliente, entidade de banco de dados). Use essas informações para scripts e diagnósticos com reconhecimento de ambiente.

Função	Description
SERVERPROPERTY	Retorna propriedades da instância do SQL Server, como edição, ordenação ou nível de produto.
DB_ID	Retorna a ID de um banco de dados.
DB_NAME	Retorna o nome de um banco de dados dado a ID.
DATABASEPROPERTYEX	Retorna valores de propriedade no nível do banco de dados, como ordenação e status.
ORIGINAL_DB_NAME	Retorna o nome do banco de dados original antes de uma sequência de restauração.
APP_NAME	Retorna o nome do aplicativo para a sessão atual.
DATABASE_PRINCIPAL_ID	Retorna a ID principal de uma entidade de segurança de banco de dados.
VERSION	Retorna a cadeia de caracteres de versão do Azure Synapse Analytics and Analytics Platform System (PDW).

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

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

Resolva IDs para nomes entre objetos e esquemas e analise identificadores de várias partes. Essas funções fornecem suporte principal para introspecção e SQL dinâmico.

Função	Description
OBJECT_ID	Retorna a ID de um objeto com escopo de esquema.
OBJECT_NAME	Retorna o nome do objeto para uma ID de objeto.
OBJECT_SCHEMA_NAME	Retorna o nome do esquema de um objeto.
SCHEMA_ID	Retorna a ID de um esquema.
SCHEMA_NAME	Retorna o nome de um esquema por ID.
PARSENAME	Retorna uma parte de um nome de objeto multipart (servidor, banco de dados, esquema, objeto).
@@PROCID	Retorna a ID do procedimento armazenado em execução no momento.

Recursos de objeto e metadados de programação

Inspecione o que é um objeto, como ele se comporta e como ele é implementado. Essa inspeção inclui a definição e as propriedades e os metadados do assembly CLR.

Função	Description
OBJECT_DEFINITION	Retorna a definição (texto de origem) de objetos programáveis.
OBJECTPROPERTY	Retorna uma propriedade para um objeto (por exemplo, seja uma exibição, uma tabela e assim por diante).
OBJECTPROPERTYEX	Retorna informações de propriedade de objeto estendido.
ASSEMBLYPROPERTY	Retorna um valor de propriedade especificado de um assembly CLR do SQL.

Metadados do modelo de dados (tipos e colunas)

Entenda as propriedades e a identidade do tipo e a identidade e as propriedades da coluna. Use esses metadados para validação de esquema, geração de código, ETL e verificações de compatibilidade.

Função	Description
TYPE_ID	Retorna a ID de um tipo de dados.
TYPE_NAME	Retorna um nome de tipo de dados por ID.
TYPEPROPERTY	Retorna uma propriedade de um tipo de dados, como precisão ou anulável.
COL_NAME	Retorna o nome da coluna para uma determinada ID de coluna.
COL_LENGTH	Retorna o comprimento de uma coluna em bytes.
COLUMNPROPERTY	Retorna uma propriedade de uma coluna, como se ela é uma identidade ou uma coluna computada.

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

Inspecione as estruturas de indexação e a atualização das estatísticas. Use esses metadados para ajustar fluxos de trabalho e manutenção controlada por metadados.

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

Armazenamento físico e metadados de texto completo

Inspecione o layout físico (arquivos e grupos de arquivos) e os componentes de texto completo. Use essas informações para gerenciamento de armazenamento, solução de problemas e auditoria de configuração.

Função	Description
FILE_ID	Retorna a ID do arquivo.
FILE_IDEX	Retorna a ID do arquivo com base no nome do arquivo.
FILE_NAME	Retorna o nome do arquivo para uma ID de arquivo.
FILEGROUP_ID	Retorna a ID de um grupo de arquivos.
FILEGROUP_NAME	Retorna o nome de um grupo de arquivos.
FILEGROUPPROPERTY	Retorna uma propriedade de um grupo de arquivos.
FILEPROPERTY	Retorna uma propriedade de arquivo, como tamanho ou status.
FULLTEXTCATALOGPROPERTY	Retorna uma propriedade de um catálogo de texto completo.
FULLTEXTSERVICEPROPERTY	Retorna propriedades de serviço de texto completo, como o status de carga.

Coordenação de runtime e metadados de valor gerados

Coordene o trabalho entre sessões usando bloqueios de aplicativo. Recupere valores numéricos gerados para objetos de identidade e sequência.

Função	Description
APPLOCK_MODE	Retorna o modo de bloqueio mantido pela sessão atual.
APPLOCK_TEST	Testa se um bloqueio pode ser adquirido sem realmente adquiri-lo.
SCOPE_IDENTITY	Retorna o último valor de identidade gerado no escopo atual.
PRÓXIMO VALOR PARA	Retorna o próximo valor em um objeto de sequência.