View a markdown version of this page

$ Beispielrate - Amazon DocumentDB
Beispiel (MongoDB Shell)Codebeispiele

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

$ Beispielrate

Neu ab Version 8.0.1.

Wird von Elastic Cluster nicht unterstützt.

Der $sampleRate Operator in Amazon DocumentDB vergleicht eine Zufallsstichprobe der Eingabedokumente auf der Grundlage der angegebenen Rate. Sie können ihn in einem find() Abfragefilter oder in einer $match Aggregationsphase verwenden. Da die Auswahl probabilistisch ist, handelt es sich bei der Anzahl der zurückgegebenen Dokumente um einen Näherungswert, der je nach Durchlauf variieren kann.

Parameter

  • value: Eine Zahl im Bereich [0, 1] (einschließlich), die direkt an den Operator übergeben wird (z. B.{ $sampleRate: 0.3 }), die die Wahrscheinlichkeit festlegt, mit der jedes Dokument eingeschlossen wird. Ein Wert von 0 gibt keine Dokumente zurück; ein Wert von 1 gibt alle Dokumente zurück.

Beispiel (MongoDB Shell)

Das folgende Beispiel verwendet$sampleRate, um ungefähr 30 Prozent der Dokumente in einer Sammlung zurückzugeben.

Erstellen Sie Beispieldokumente 

db.events.insertMany([
  { _id: 1, type: "click" },
  { _id: 2, type: "view" },
  { _id: 3, type: "click" },
  { _id: 4, type: "view" },
  { _id: 5, type: "purchase" }
]);

Beispiel für eine Abfrage 

db.events.aggregate([
  { $match: { $sampleRate: 0.3 } }
]);

Ausgabe

Die Operation gibt eine zufällige Teilmenge der Dokumente zurück. Da $sampleRate es probabilistisch ist, variieren die spezifischen zurückgegebenen Dokumente und ihre Anzahl bei jeder Ausführung der Abfrage.

Codebeispiele

Um ein Codebeispiel für die Verwendung des $sampleRate Befehls anzuzeigen, wählen Sie die Registerkarte für die Sprache, die Sie verwenden möchten:

Node.js
const { MongoClient } = require('mongodb');

async function example() {
  const uri = 'mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false';
  const client = new MongoClient(uri);

  try {
    await client.connect();
    const db = client.db('test');
    const collection = db.collection('events');

    // Return approximately 30% of the documents
    const result = await collection.aggregate([
      { $match: { $sampleRate: 0.3 } }
    ]).toArray();

    console.log(result);
  } finally {
    await client.close();
  }
}

example();
Python
from pymongo import MongoClient

def example():
    client = MongoClient('mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')

    try:
        db = client['test']
        collection = db['events']

        # Return approximately 30% of the documents
        result = list(collection.aggregate([
            { '$match': { '$sampleRate': 0.3 } }
        ]))

        print(result)
    finally:
        client.close()

example()