COUNTfunção na Amazon QLDB - Banco de dados Amazon Quantum Ledger (AmazonQLDB)

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

COUNTfunção na Amazon QLDB

Importante

Aviso de fim do suporte: os clientes existentes poderão usar a Amazon QLDB até o final do suporte em 31/07/2025. Para obter mais detalhes, consulte Migrar um Amazon QLDB Ledger para o Amazon Aurora Postgre. SQL

Na AmazonQLDB, use a COUNT função para retornar o número de documentos definidos pela expressão especificada. A função tem duas variações:

  • COUNT(*): conta todos os documentos na tabela de destino, independentemente de incluírem ou não valores nulos ou ausentes.

  • COUNT(expression): calcula o número de documentos com valores não nulos em um campo ou expressão específica existente.

Atenção

A função COUNT não está otimizada, portanto, não recomendamos usá-la sem uma pesquisa indexada. Quando você executa uma consulta QLDB sem uma pesquisa indexada, ela invoca uma verificação completa da tabela. Isso pode causar problemas de desempenho em tabelas grandes, incluindo conflitos de simultaneidade e tempos limite de transação.

Para evitar verificações de tabelas, você deve executar instruções com uma cláusula de predicado WHERE usando um operador de igualdade (= ou IN) em um campo indexado ou em um ID de documento. Para ter mais informações, consulte Otimizar a performance da consulta.

Sintaxe

COUNT ( * | expression )

Argumentos

expression

O nome do campo ou expressão na qual a função opera. Esse parâmetro pode ser qualquer um dos Tipos de dados com suporte.

Tipo de retorno

int

Exemplos

SELECT COUNT(*) FROM VehicleRegistration r WHERE r.LicensePlateNumber = 'CA762X' -- 1 SELECT COUNT(r.VIN) FROM Vehicle r WHERE r.VIN = '1N4AL11D75C109151' -- 1 SELECT COUNT(a) FROM << { 'a' : 1 }, { 'a': 2 }, { 'a': 3 } >> -- 3

Funções relacionadas