Função COUNT no Amazon QLDB - Amazon Quantum Ledger Database (Amazon QLDB)

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á.

Função COUNT no Amazon QLDB

Importante

Aviso de fim do suporte: os clientes existentes poderão usar o 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 PostgreSQL.

No Amazon QLDB, use a função COUNT para retornar o número de documentos que são definidos pela expressão dada. 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 no 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 obter 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