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
<a name="sampleRate"></a>

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)
<a name="sampleRate-examples"></a>

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
<a name="sampleRate-code"></a>

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()
```

------