

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.

# Verwaltung der Dokumentenkomprimierung auf Sammlungsebene
<a name="doc-compression"></a>

Mit der Dokumentenkomprimierung auf Sammlungsebene von Amazon DocumentDB 5.0 können Sie die Speicher- und I/O-Kosten senken, indem Sie die Dokumente in Ihren Sammlungen komprimieren. Sie können die Dokumentenkomprimierung auf Sammlungsebene aktivieren und bei Bedarf Komprimierungsmetriken anzeigen, indem Sie den Speicherzuwachs anhand von Komprimierungsmetriken wie der Speichergröße komprimierter Dokumente und dem Komprimierungsstatus messen. Amazon DocumentDB 5.0 verwendet den LZ4 Komprimierungsalgorithmus, um Dokumente zu komprimieren.

Amazon DocumentDB unterstützt die Dokumentenkomprimierung ab Version 5.0. Im Folgenden finden Sie Funktionen zur Komprimierung von Dokumenten auf Sammlungsebene:
+ **Standardverhalten** — Die Standardkomprimierungseinstellung für neue Sammlungen auf einem 5.0-Cluster wird durch den Cluster-Parameter bestimmt. `default_collection_compression` Dieser Parameter ist standardmäßig auf „deaktiviert“ gesetzt. 
+ **Komprimieren vorhandener Sammlungen** — Die Komprimierungseinstellungen für bestehende Sammlungen können mit dem `collMod` Befehl geändert werden.
+ **Ändern des Komprimierungsschwellenwerts** — Der Standardschwellenwert für die Komprimierung beträgt 2 KB. Dieser Wert kann für neue Sammlungen mit dem `createCollection` Befehl angegeben und für bestehende Sammlungen mit dem `collMod` Befehl geändert werden.

**Anmerkung**  
Die Amazon DocumentDB DocumentDB-Dokumentenkomprimierung wird in den Amazon DocumentDB DocumentDB-Versionen 3.6 und 4.0 nicht unterstützt.

**Topics**
+ [Verwaltung der Dokumentenkomprimierung](#manage-compression)
+ [Überwachung der Dokumentenkomprimierung](#monitoring-compression)

## Verwaltung der Dokumentenkomprimierung
<a name="manage-compression"></a>

### Aktivieren der Dokumentenkomprimierung in einer Sammlung
<a name="enabling-collection-compression"></a>

Aktivieren Sie die Dokumentenkomprimierung beim Erstellen einer Sammlung in Amazon DocumentDB 5.0 mithilfe der folgenden `db.createCollection()` Methode:

```
db.createCollection( sample_collection,{
    storageEngine : {
        documentDB: {
            compression:{enable: <true | false>}
        }
    }
})
```

### Aktivieren der Dokumentenkomprimierung in einem Cluster
<a name="enabling-cluster-compression"></a>

Die Dokumentenkomprimierung kann standardmäßig für alle neuen Sammlungen auf Clusterebene aktiviert werden, indem der Cluster-Parameter `default_collection_compression` auf „enabled“ gesetzt wird. Wenn dieser Parameter auf „aktiviert“ gesetzt ist, ist für neu erstellte Sammlungen auf dem Cluster die Komprimierung standardmäßig aktiviert, wobei der Komprimierungsschwellenwert 2 KB beträgt.

### Komprimieren vorhandener Sammlungen
<a name="compress-existing-collections"></a>

Sie können auch die Komprimierungseinstellungen für eine vorhandene Sammlung ändern, indem Sie den `collMod` Vorgang verwenden und die folgende `storageEngine` Konfiguration angeben. Bitte beachten Sie, dass die mit diesem Befehl vorgenommene Änderung nur für neue inserted/updated Dokumente gilt und dass sich die Komprimierung zuvor eingefügter Dokumente nicht ändert.

```
db.runCommand({ 
    collMod: "orders", 
    storageEngine: { 
        documentDB: {compression: {enable: <true | false>} }
    }
})
```

### Einstellung der Schwellenwerte für die Komprimierung
<a name="set-compression-threshold"></a>

Standardmäßig liegt der Komprimierungsschwellenwert für komprimierte Sammlungen bei 2032 Byte. Dieser Schwellenwert kann im `createCollection` Befehl festgelegt werden, wenn eine neue Sammlung mit aktivierter Komprimierung erstellt wird: 

```
db.createCollection( sample_collection, {
    storageEngine : {
        documentDB: {
            compression: {
                enable: true,
                threshold: <128 - 8000>
            }
        }
    }
})
```

Sie können den Komprimierungsschwellenwert für eine vorhandene komprimierte Sammlung auch ändern, indem Sie den `collMod` Vorgang verwenden und die folgende `storageEngine` Konfiguration angeben:

```
db.runCommand({ 
    collMod: "orders", 
    storageEngine: { 
        documentDB: {
            compression: {
                enable: true,
                threshold: <128 - 8000>
            }
        }
    }
})
```

Bitte beachten Sie, dass der Komprimierungsschwellenwert nur auf einen Wert zwischen 128 und 8000 Byte festgelegt werden kann. Außerdem muss die `enable` Option bei der Angabe des Komprimierungsschwellenwerts auf „true“ gesetzt werden.

## Überwachung der Dokumentenkomprimierung
<a name="monitoring-compression"></a>

Sie können überprüfen, ob eine Sammlung komprimiert ist, und ihr Komprimierungsverhältnis wie folgt berechnen.

Zeigen Sie die Komprimierungsstatistiken an, indem Sie den `db.collection.stats()` Befehl `db.printCollectionStats()` oder in der Mongo-Shell ausführen. Die Ausgabe zeigt Ihnen die Originalgröße und die komprimierte Größe, die Sie vergleichen können, um die Speichergewinne durch die Dokumentenkomprimierung zu analysieren. In diesem Beispiel werden die Statistiken für eine Sammlung mit dem Namen „sample\$1collection“ unten angezeigt. Im Folgenden wird ein Skalierungsfaktor von 1024\$11024 verwendet, um die Werte und in MB auszugeben. `size` `storageSize`

```
db.sample_collection.stats(1024*1024)
```

Das Folgende ist ein Beispiel für die Ausgabe für den obigen Befehl:

```
{
    "ns" : "test.sample_collection",
    "count" : 1000000,
    "size" : 3906.3,
    "avgObjSize" : 4096,
    "storageSize" : 1953.1, 
    compression:{"enabled" : true,"threshold" : 2032},
    ...
}
```
+ **Größe** — Die Originalgröße der Dokumentensammlung.
+ **avgObjSize**- Die durchschnittliche Dokumentgröße vor der Komprimierung, abgerundet auf die erste Dezimalzahl. Die Maßeinheit ist Byte.
+ **StorageSize** — Die Speichergröße der Sammlung nach der Komprimierung. Die Maßeinheit ist Byte.
+ **aktiviert** — Zeigt an, ob die Komprimierung aktiviert oder deaktiviert ist.

Um das tatsächliche Komprimierungsverhältnis zu berechnen, dividieren Sie die Sammlungsgröße durch die Speichergröße (Size/StorageSize). Für das obige Beispiel lautet die Berechnung 3906,3/1953,1, was einem Kompressionsverhältnis von 2:1 entspricht.