Classe: Mongo::BulkWrite::Result

Herda:
Objeto
  • Objeto
mostrar tudo
Definido em:
lib/mongo/bulk_write/result.rb

Visão geral

Envolve uma série de operações de escrita em massa em um objeto de resultado.

Desde:

  • 2.0.6

Colapsode resumo constante

REMOVED_COUNT =

Constante para o número removido.

Desde:

  • 2.1.0

'n_removed'
INSERTED_COUNT =

Constante para o número inserido.

Desde:

  • 2.1.0

'n_inserted'
INSERTED_IDS =

Constante para IDs inseridos.

Desde:

  • 2.1.0

'insert_ids'
MATCHED_COUNT =

Constante para o número correspondido.

Desde:

  • 2.1.0

'n_matched'
ModIFIED_COUNT =

Constante para o número modificado.

Desde:

  • 2.1.0

'n_modified'
UPSERTED =

Constante para upserted.

Desde:

  • 2.1.0

'upserted'
upserted_count =

Constante para o número atualizado.

Desde:

  • 2.1.0

'n_upserted'
upserted_ids =

Constante para IDs atualizados.

Desde:

  • 2.1.0

'upserted_ids'
Campos =

Os campos contidos no documento de resultado retornaram da execução das operações.

Desde:

  • 2.1.0.

[
  INSERTED_COUNT,
  REMOVED_COUNT,
  ModIFIED_COUNT,
  upserted_count,
  MATCHED_COUNT,
  (operação)::Resultado::N
].congelar

Recolhimento do Resumo do atributo de instância

Recolhimento do Resumo do método de instância

Detalhes do construtor

#inicializar(resultados, confirmados, server_addresses = []) ⇒ Resultado

Este método faz parte de uma API privada. Evite usar esse método, se possível, pois ele pode ser removido ou alterado no futuro.

Crie o novo objeto de resultado a partir do documento de resultados.

Exemplos:

Crie o novo resultado.

Result.new({ 'n_inserted' => 10 })

Parâmetros:

  • Resultados (BSON::Document, Hash) —

    O documento de resultados .

  • Reconhecido(a) (Booleano) —

    O resultado é reconhecido?

  • server_addresses (Array<String>) (padrão para: []) —

    Endereços deduplicados de "hospedar:porta" dos servidores que produziram os resultados da operação subjacente.

Desde:

  • 2.1.0



111
112
113
114
115
 
# File 'lib/mongo/bulk_write/result.rb', linha 111

def inicializar(Resultados, Reconhecido(a), server_addresses = [])
  @results = Resultados
  @knowledged = Reconhecido(a)
  @server_addresses = Array(server_addresses).compactar.uniq
end

Detalhes do atributo da instância

#server_addresses ⇒ Array<String> (somente leitura)

Retorna a lista deduplicada de endereços "hospedar:porta" dos servidores que produziram as operações desta gravação em massa.

Retorna:

  • (Array<String>) —

    Lista deduplicada de endereços "hospedar:porta" dos servidores que produziram as operações desta gravação em massa.

Desde:

  • 2.0.6



30
31
32
 
# File 'lib/mongo/bulk_write/result.rb', linha 30

def server_addresses
  @server_addresses
end

Detalhes do método de instância

#reconhecido? ➤ Booleano

Retorna O resultado é reconhecido?.

Retorna:

  • (Booleano) —

    O resultado é reconhecido?

Desde:

  • 2.0.6



24
25
26
 
# File 'lib/mongo/bulk_write/result.rb', linha 24

def reconhecido?
  @knowledged
end

#delete_count ➤ Inteiro

Retorna o número de documentos excluídos.

Exemplos:

Obtenha o número de documentos excluídos.

result.deleted_count

Retorna:

  • (Inteiro) —

    O número excluído.

Desde:

  • 2.1.0



93
94
95
 
# File 'lib/mongo/bulk_write/result.rb', linha 93

def delete_count
  @results[REMOVED_COUNT]
end

#inserted_count ⇒ Integer

Retorna o número de documentos inseridos.

Exemplos:

Obtenha o número de documentos inseridos.

result.inserted_count

Retorna:

  • (Inteiro) —

    O número inserido.

Desde:

  • 2.1.0



125
126
127
 
# File 'lib/mongo/bulk_write/result.rb', linha 125

def insert_count
  @results[INSERTED_COUNT]
end

#inserted_ids ⇒ Array<BSON::ObjectId>

Obtenha as IDs dos documentos inseridos, se a operação tiver inserções.

Exemplos:

Obtenha os IDs inseridos.

result.inserted_ids

Retorna:

  • (Array<BSON::ObjectId>) —

    Os IDs inseridos.

Desde:

  • 2.1.0



137
138
139
 
# File 'lib/mongo/bulk_write/result.rb', linha 137

def insert_ids
  @results[INSERTED_IDS]
end

#matched_count ➤ Inteiro

Retorna o número de documentos correspondentes.

Exemplos:

Obtenha o número de documentos correspondentes.

result.matched_count

Retorna:

  • (Inteiro) —

    O número corresponde.

Desde:

  • 2.1.0



149
150
151
 
# File 'lib/mongo/bulk_write/result.rb', linha 149

def matched_count
  @results[MATCHED_COUNT]
end

#modified_count ➤ Inteiro

Retorna o número de documentos modificados.

Exemplos:

Obtenha o número de documentos modificados.

result.modified_count

Retorna:

  • (Inteiro) —

    O número modificado.

Desde:

  • 2.1.0



161
162
163
 
# File 'lib/mongo/bulk_write/result.rb', linha 161

def modified_count
  @results[ModIFIED_COUNT]
end

#upserted_count ⇒ Integer

Retorna o número de documentos atualizados.

Exemplos:

Obtenha o número de documentos atualizados.

result.upserted_count

Retorna:

  • (Inteiro) —

    O número atualizado.

Desde:

  • 2.1.0



173
174
175
 
# File 'lib/mongo/bulk_write/result.rb', linha 173

def upserted_count
  @results[upserted_count]
end

#upserted_ids ➤ Array<BSON::ObjectId>

Obtenha as IDs de documento inseridos, se a operação tiver inserções.

Exemplos:

Obtenha os IDs atualizados.

result.upserted_ids

Retorna:

  • (Array<BSON::ObjectId>) —

    Os IDs atualizados.

Desde:

  • 2.1.0



185
186
187
 
# File 'lib/mongo/bulk_write/result.rb', linha 185

def upserted_ids
  @results[upserted_ids] || []
end

#validar! ➤ Resultado

Valida o resultado da gravação em massa.

Exemplos:

Valide o resultado.

result.validate!

Retorna:

Aumenta:

Desde:

  • 2.1.0



199
200
201
202
203
 
# File 'lib/mongo/bulk_write/result.rb', linha 199

def validar!
  aumentar Erro::BulkWriteError.Novo(@results, server_addresses: @server_addresses) se @results['writeErrors'] || @results['writeConcernErrors']

  auto
end