

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.

# Verwalten von Statistiken, die die Neptune-DFE-Engine verwenden soll
<a name="neptune-dfe-statistics"></a>

**Anmerkung**  
Die Unterstützung von openCypher ist von der DFE-Abfrage-Engine in Neptune abhängig.  
Die DFE-Engine wird mithilfe des [neptune\_dfe\_query\_engine](parameters.md#parameters-instance-parameters-neptune_dfe_query_engine) Instance-Parameters in der DB-Parametergruppe einer Instanz gesteuert.

Die DFE-Engine verwendet Informationen zu den Daten in Ihrem Neptune-Diagramm, um bei der Planung der Abfrageausführung effektive Kompromisse einzugehen. Bei diesen Informationen handelt es sich um Statistiken, die sogenannte Merkmalssätze und Prädikatstatistiken umfassen, die als Anleitung für die Abfrageplanung dienen können.

Ab [Engine-Version 1.2.1.0](engine-releases-1.2.1.0.md) können Sie mithilfe der [GetGraphSummary](iam-dp-actions.md#getgraphsummary)API oder des Endpunkts [zusammenfassende Informationen](neptune-graph-summary.md) zu Ihrem Diagramm aus diesen Statistiken abrufen. `summary`

Diese DFE-Statistiken werden derzeit neu generiert, wenn entweder mehr als 10 % der Daten in Ihrem Diagramm geändert wurden oder wenn die neuesten Statistiken älter als 10 Tage sind. Diese Auslöser können sich in der Zukunft jedoch ändern.

**Anmerkung**  
Die Statistikgenerierung ist für `T3`- und `T4g`-Instances deaktiviert, da sie die Arbeitsspeicherkapazität dieser Instance-Typen überschreiten kann.

Sie können die Generierung von DFE-Statistiken über einen der folgenden Endpunkte verwalten:
+ `https://{{your-neptune-host}}:{{port}}/rdf/statistics `    (für SPARQL).
+ `https://{{your-neptune-host}}:{{port}}/propertygraph/statistics`    (für Gremlin und openCypher) und die alternative Version: `https://{{your-neptune-host}}:{{port}}/pg/statistics`.

**Anmerkung**  
Ab [Engine-Version 1.1.1.0](engine-releases-1.1.1.0.md) wird der Gremlin-Statistik-Endpunkt (`https://{{your-neptune-host}}:{{port}}/gremlin/statistics`) zugunsten des `propertygraph`- oder `pg`-Endpunkts außer Betrieb genommen. Aus Gründen der Abwärtskompatibilität wird er weiter unterstützt, wird jedoch in zukünftigen Versionen möglicherweise entfernt.  
Ab [Engine-Version 1.2.1.0](engine-releases-1.2.1.0.md) wird der SPARQL-Statistik-Endpunkt (`https://{{your-neptune-host}}:{{port}}/sparql/statistics`) zugunsten des `rdf`-Endpunkts außer Betrieb genommen. Aus Gründen der Abwärtskompatibilität wird er weiter unterstützt, wird jedoch in zukünftigen Versionen möglicherweise entfernt.

**Anmerkung**  
Wenn sich ein DFE-Statistikendpunkt auf einer Reader-Instance befindet, kann er nur [Statusanfragen](#neptune-dfe-statistics-status) verarbeiten. Andere Anfragen schlagen mit einer `ReadOnlyViolationException` fehl.

## Größenbeschränkungen für die DFE-Statistikgenerierung
<a name="neptune-dfe-statistics-limits"></a>

Derzeit wird die Generierung von DFE-Statistiken angehalten, wenn eine der folgenden Größenbeschränkungen erreicht wird:
+ Die Anzahl der generierten Merkmalsätze darf 50 000 nicht überschreiten.
+ Die Anzahl der generierten Prädikatstatistiken darf eine Million nicht überschreiten.

Diese Grenzwerte unterliegen Änderungen.

## Aktueller Status der DFE-Statistiken
<a name="neptune-dfe-statistics-status"></a>

Sie können den aktuellen Status der DFE-Statistiken wie folgt überprüfen:

**Anmerkung**  
In den folgenden Beispielen werden der Endpunkt und die Befehle der Eigenschaft graph verwendet. Verwenden Sie für RDF-Daten `get-sparql-statistics` für die AWS CLI und `/rdf/statistics` für REST-Endpunkte.

------
#### [ AWS CLI ]

```
aws neptunedata get-propertygraph-statistics \
  --endpoint-url https://{{your-neptune-endpoint}}:{{port}} \
  --region {{us-east-1}}
```

**Anmerkung**  
Ersetze es {{us-east-1}} durch die Region deines Neptun-Clusters. Sie können weglassen, `--region` wenn Sie eine Standardregion konfiguriert haben.

Weitere Informationen finden Sie unter [get-propertygraph-statistics](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/get-propertygraph-statistics.html) in der Befehlsreferenz. AWS CLI 

------
#### [ SDK ]

```
import boto3
import json
from botocore.config import Config

client = boto3.client(
    'neptunedata',
    endpoint_url='https://{{your-neptune-endpoint}}:{{port}}',
    config=Config(read_timeout=None, retries={'total_max_attempts': 1})
)

response = client.get_propertygraph_statistics()

print(json.dumps(response['payload'], indent=2, default=str))
```

------
#### [ awscurl ]

```
awscurl https://{{your-neptune-endpoint}}:{{port}}/propertygraph/statistics \
  --region {{us-east-1}} \
  --service neptune-db
```

**Anmerkung**  
In diesem Beispiel wird davon ausgegangen, dass Ihre AWS Anmeldeinformationen in Ihrer Umgebung konfiguriert sind. Ersetze es {{us-east-1}} durch die Region deines Neptun-Clusters.

Weitere Informationen zur Verwendung **awscurl** mit der IAM-Authentifizierung finden Sie unter. [Verwenden von `awscurl` mit temporären Anmeldeinformationen, um eine sichere Verbindung zu einem DB-Cluster mit aktivierter IAM-Authentifizierung herzustellen](iam-auth-connect-command-line.md#iam-auth-connect-awscurl)

------
#### [ curl ]

```
curl -G https://{{your-neptune-endpoint}}:{{port}}/propertygraph/statistics
```

------

Die Antwort auf eine Statusanforderung enthält die folgenden Felder:
+ `status`  –   HTTP-Rückgabecode der Anforderung. Wenn die Anforderung erfolgreich ist, lautet der Code `200`. Eine Liste mit häufigen Fehlern finden Sie unter [Häufige Fehler](#neptune-dfe-statistics-errors).
+ `payload`:
  + `autoCompute`  –   (Boolean) Gibt an, ob die automatische Generierung von Statistiken aktiviert ist oder nicht.
  + `active`  –   (Boolean) Gibt an, ob die automatische Generierung von DFE-Statistiken aktiviert ist oder nicht.
  + `statisticsId `  –   Meldet die ID der aktuellen Statistikgenerierungsausführung. Der Wert ` -1 ` gibt an, dass keine Statistiken generiert wurden.
  + `date`  –   Die UTC-Zeit, zu der die DFE-Statistiken zuletzt generiert wurden (im Format ISO 8601).
**Anmerkung**  
Vor [Engine-Version 1.2.1.0](engine-releases-1.2.1.0.md) wurde dies mit Minutengenauigkeit dargestellt. Ab Engine-Version 1.2.1.0 wird dies mit Millisekundengenauigkeit dargestellt (zum Beispiel `2023-01-24T00:47:43.319Z`).
  + `note`  –   Ein Hinweis zu Problemen in dem Fall, dass Statistiken ungültig sind.
  + `signatureInfo`  –   Enthält Informationen zu den in der Statistik generierten Merkmalsätzen (vor [Engine-Version 1.2.1.0](engine-releases-1.2.1.0.md) hatte dieses Feld den Namen `summary`). Dies ist im Allgemeinen nicht direkt umsetzbar:
    + `signatureCount`  –   Gesamtzahl der Signaturen für alle Merkmalsätze.
    + `instanceCount`  –   Gesamtzahl der Merkmalsatz-Instances.
    + `predicateCount`  –   Gesamtzahl der eindeutigen Prädikate.

Die Antwort auf eine Statusanforderung, wenn keine Statistiken generiert wurden, sieht wie folgt aus:

```
{
  "status" : "200 OK",
  "payload" : {
    "autoCompute" : true,
    "active" : false,
    "statisticsId" : -1
   }
}
```

Wenn DFE-Statistiken verfügbar sind, sieht die Antwort wie folgt aus:

```
{
  "status" : "200 OK",
  "payload" : {
    "autoCompute" : true,
    "active" : true,
    "statisticsId" : 1588893232718,
    "date" : "2020-05-07T23:13Z",
    "summary" : {
      "signatureCount" : 5,
      "instanceCount" : 1000,
      "predicateCount" : 20
    }
  }
}
```

Wenn die Generierung von DFE-Statistiken fehlgeschlagen ist, weil beispielsweise die [Größenbeschränkung für Statistiken](#neptune-dfe-statistics-limits) überschritten wurde, sieht die Antwort wie folgt aus:

```
{
  "status" : "200 OK",
  "payload" : {
    "autoCompute" : true,
    "active" : false,
    "statisticsId" : 1588713528304,
    "date" : "2020-05-05T21:18Z",
    "note" : "Limit reached: Statistics are not available"
  }
}
```

## Deaktivieren der automatischen Generierung von DFE-Statistiken
<a name="neptune-dfe-statistics-auto-disable"></a>

Standardmäßig ist die automatische Generierung von DFE-Statistiken aktiviert, wenn Sie DFE aktivieren.

Sie können die automatische Generierung wie folgt deaktivieren:

**Anmerkung**  
In den folgenden Beispielen werden der Endpunkt und die Befehle der Eigenschaft Graph verwendet. Verwenden Sie für RDF-Daten `manage-sparql-statistics` für die AWS CLI und `/rdf/statistics` für REST-Endpunkte.

------
#### [ AWS CLI ]

```
aws neptunedata manage-propertygraph-statistics \
  --endpoint-url https://{{your-neptune-endpoint}}:{{port}} \
  --mode disableAutoCompute
```

Weitere Informationen finden Sie unter [manage-propertygraph-statistics](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/manage-propertygraph-statistics.html) in der Befehlsreferenz. AWS CLI 

------
#### [ SDK ]

```
import boto3
from botocore.config import Config

client = boto3.client(
    'neptunedata',
    endpoint_url='https://{{your-neptune-endpoint}}:{{port}}',
    config=Config(read_timeout=None, retries={'total_max_attempts': 1})
)

response = client.manage_propertygraph_statistics(mode='disableAutoCompute')

print(response['status'])
```

------
#### [ awscurl ]

```
awscurl https://{{your-neptune-endpoint}}:{{port}}/propertygraph/statistics \
  --region {{us-east-1}} \
  --service neptune-db \
  -X POST \
  -H 'Content-Type: application/json' \
  -d '{"mode":"disableAutoCompute"}'
```

**Anmerkung**  
In diesem Beispiel wird davon ausgegangen, dass Ihre AWS Anmeldeinformationen in Ihrer Umgebung konfiguriert sind. Ersetze es {{us-east-1}} durch die Region deines Neptun-Clusters.

Weitere Informationen zur Verwendung **awscurl** mit der IAM-Authentifizierung finden Sie unter. [Verwenden von `awscurl` mit temporären Anmeldeinformationen, um eine sichere Verbindung zu einem DB-Cluster mit aktivierter IAM-Authentifizierung herzustellen](iam-auth-connect-command-line.md#iam-auth-connect-awscurl)

------
#### [ curl ]

```
curl -X POST -d '{ "mode" : "disableAutoCompute" }' https://{{your-neptune-endpoint}}:{{port}}/propertygraph/statistics
```

------

Wenn die Anforderung erfolgreich ist, lautet der HTTP-Antwortcode `200` und die Antwort ist:

```
{
  "status" : "200 OK"
}
```

Sie können überprüfen, ob die automatische Generierung deaktiviert ist, indem Sie eine [Statusanforderung](#neptune-dfe-statistics-status) ausgeben und überprüfen, ob das Feld `autoCompute` in der Antwort auf `false` festgelegt ist.

Durch das Deaktivieren der automatischen Generierung von Statistiken wird eine laufende Statistikberechnung nicht beendet.

Wenn Sie eine Anforderung zur Deaktivierung der automatischen Generierung an eine Reader-Instance Ihres DB-Clusters statt an die Writer-Instance senden, schlägt die Anforderung mit dem HTTP-Rückgabecode 400 und einer Ausgabe wie der folgenden fehl:

```
{
  "detailedMessage" : "Writes are not permitted on a read replica instance",
  "code" : "ReadOnlyViolationException",
  "requestId":"8eb8d3e5-0996-4a1b-616a-74e0ec32d5f7"
}
```

Eine Liste mit weiteren häufigen Fehlern finden Sie unter [Häufige Fehler](#neptune-dfe-statistics-errors).

## Re-enabling automatische Generierung von DFE-Statistiken
<a name="neptune-dfe-statistics-auto-re-enable"></a>

Standardmäßig ist die automatische Generierung von DFE-Statistiken bereits aktiviert, wenn Sie DFE aktivieren. Wenn Sie die automatische Generierung deaktivieren, können Sie diese später wie folgt erneut aktivieren:

**Anmerkung**  
In den folgenden Beispielen werden der Endpunkt und die Befehle der Eigenschaft graph verwendet. Verwenden Sie für RDF-Daten `manage-sparql-statistics` für die AWS CLI und `/rdf/statistics` für REST-Endpunkte.

------
#### [ AWS CLI ]

```
aws neptunedata manage-propertygraph-statistics \
  --endpoint-url https://{{your-neptune-endpoint}}:{{port}} \
  --mode enableAutoCompute
```

Weitere Informationen finden Sie unter [manage-propertygraph-statistics](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/manage-propertygraph-statistics.html) in der Befehlsreferenz. AWS CLI 

------
#### [ SDK ]

```
import boto3
from botocore.config import Config

client = boto3.client(
    'neptunedata',
    endpoint_url='https://{{your-neptune-endpoint}}:{{port}}',
    config=Config(read_timeout=None, retries={'total_max_attempts': 1})
)

response = client.manage_propertygraph_statistics(mode='enableAutoCompute')

print(response['status'])
```

------
#### [ awscurl ]

```
awscurl https://{{your-neptune-endpoint}}:{{port}}/propertygraph/statistics \
  --region {{us-east-1}} \
  --service neptune-db \
  -X POST \
  -H 'Content-Type: application/json' \
  -d '{"mode":"enableAutoCompute"}'
```

**Anmerkung**  
In diesem Beispiel wird davon ausgegangen, dass Ihre AWS Anmeldeinformationen in Ihrer Umgebung konfiguriert sind. Ersetze es {{us-east-1}} durch die Region deines Neptun-Clusters.

Weitere Informationen zur Verwendung **awscurl** mit der IAM-Authentifizierung finden Sie unter. [Verwenden von `awscurl` mit temporären Anmeldeinformationen, um eine sichere Verbindung zu einem DB-Cluster mit aktivierter IAM-Authentifizierung herzustellen](iam-auth-connect-command-line.md#iam-auth-connect-awscurl)

------
#### [ curl ]

```
curl -X POST -d '{ "mode" : "enableAutoCompute" }' https://{{your-neptune-endpoint}}:{{port}}/propertygraph/statistics
```

------

Wenn die Anforderung erfolgreich ist, lautet der HTTP-Antwortcode `200` und die Antwort ist:

```
{
  "status" : "200 OK"
}
```

Sie können überprüfen, ob die automatische Generierung aktiviert ist, indem Sie eine [Statusanforderung](#neptune-dfe-statistics-status) ausgeben und prüfen, ob das Feld `autoCompute` in der Antwort auf `true` festgelegt ist.

## Manuelles Auslösen der Generierung von DFE-Statistiken
<a name="neptune-dfe-statistics-manual"></a>

Sie können die Generierung von DFE-Statistiken wie folgt manuell starten:

**Anmerkung**  
In den folgenden Beispielen werden der Endpunkt und die Befehle der Eigenschaft Graph verwendet. Verwenden Sie für RDF-Daten `manage-sparql-statistics` für die AWS CLI und `/rdf/statistics` für REST-Endpunkte.

------
#### [ AWS CLI ]

```
aws neptunedata manage-propertygraph-statistics \
  --endpoint-url https://{{your-neptune-endpoint}}:{{port}} \
  --mode refresh
```

Weitere Informationen finden Sie unter [manage-propertygraph-statistics](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/manage-propertygraph-statistics.html) in der Befehlsreferenz. AWS CLI 

------
#### [ SDK ]

```
import boto3
import json
from botocore.config import Config

client = boto3.client(
    'neptunedata',
    endpoint_url='https://{{your-neptune-endpoint}}:{{port}}',
    config=Config(read_timeout=None, retries={'total_max_attempts': 1})
)

response = client.manage_propertygraph_statistics(mode='refresh')

print(json.dumps(response['payload'], indent=2, default=str))
```

------
#### [ awscurl ]

```
awscurl https://{{your-neptune-endpoint}}:{{port}}/propertygraph/statistics \
  --region {{us-east-1}} \
  --service neptune-db \
  -X POST \
  -H 'Content-Type: application/json' \
  -d '{"mode":"refresh"}'
```

**Anmerkung**  
In diesem Beispiel wird davon ausgegangen, dass Ihre AWS Anmeldeinformationen in Ihrer Umgebung konfiguriert sind. Ersetze es {{us-east-1}} durch die Region deines Neptun-Clusters.

Weitere Informationen zur Verwendung **awscurl** mit der IAM-Authentifizierung finden Sie unter. [Verwenden von `awscurl` mit temporären Anmeldeinformationen, um eine sichere Verbindung zu einem DB-Cluster mit aktivierter IAM-Authentifizierung herzustellen](iam-auth-connect-command-line.md#iam-auth-connect-awscurl)

------
#### [ curl ]

```
curl -X POST -d '{ "mode" : "refresh" }' https://{{your-neptune-endpoint}}:{{port}}/propertygraph/statistics
```

------

Wenn die Anforderung erfolgreich ist, sieht die Ausgabe wie folgt aus und der HTTP-Rückgabecode ist 200:

```
{
  "status" : "200 OK",
  "payload" : {
    "statisticsId" : 1588893232718
  }
}
```

Die `statisticsId` in der Ausgabe ist die ID der Statistikgenerierung, die zurzeit ausgeführt wird. Wenn zum Zeitpunkt der Anforderung bereits eine Ausführung bearbeitet wird, gibt die Anforderung die ID dieser Ausführung zurück, statt eine neue zu initiieren. Sie können jeweils nur eine Statistikgenerierung gleichzeitig ausführen.

Wenn während der Generierung der DFE-Statistiken ein Failover auftritt, nimmt der neue Writer-Knoten den zuletzt verarbeiteten Prüfpunkt auf und setzt die Statistikausführung ab dort fort.

## Verwendung der `StatsNumStatementsScanned` CloudWatch Metrik zur Überwachung der Statistikberechnung
<a name="neptune-dfe-statistics-monitoring"></a>

Die `StatsNumStatementsScanned` CloudWatch Metrik gibt die Gesamtzahl der Anweisungen zurück, die seit dem Start des Servers für statistische Berechnungen gescannt wurden. Sie wird bei jedem Slice der Statistikberechnung aktualisiert.

Bei jeder Auslösung einer Statistikberechnung nimmt diese Zahl zu. Wenn keine Berechnung stattfindet, bleibt sie konstant. Wenn Sie ein Diagramm mit `StatsNumStatementsScanned`-Werten über die Zeit betrachten, erhalten Sie daher ein ziemlich klares Bild davon, wann und wie schnell Statistikberechnungen ausgeführt wurden:

![Diagramm der StatsNumStatementsScanned Metrikwerte](http://docs.aws.amazon.com/de_de/neptune/latest/userguide/images/StatsNumStatementsScanned-graph.png)


Während der Berechnung zeigt Ihnen die Steigung im Diagramm, wie schnell diese ausgeführt wird. (Je steiler die Steigung, desto schneller werden Statistiken berechnet.)

Wenn das Diagramm einfach eine flache Linie bei 0 ist, wurde das Statistik-Feature aktiviert, es wurden jedoch keine Statistiken berechnet. Wenn das Statistik-Feature deaktiviert wurde oder wenn Sie eine Engine-Version verwenden, die keine Statistikberechnung unterstützt, ist `StatsNumStatementsScanned` nicht vorhanden.

Wie bereits erwähnt, können Sie die Statistikberechnung über die Statistik-API deaktivieren. Wenn Sie diese jedoch deaktiviert lassen, sind Statistiken möglicherweise nicht aktuell, was zu einer mangelhaften Abfrageplangenerierung für die DFE-Engine führen kann.

Informationen [Überwachung von Neptune mit Amazon CloudWatch](cloudwatch.md) zur Verwendung finden Sie unter CloudWatch.

## Verwenden AWS Identity and Access Management (IAM-) Authentifizierung mit DFE-Statistikendpunkten
<a name="neptune-dfe-statistics-iam-auth"></a>

Sie können mit der IAM-Authentifizierung sicher auf DFE-Statistikendpunkte zugreifen, indem Sie [awscurl](https://github.com/okigan/awscurl) oder ein anderes Tool verwenden AWS CLI, das mit HTTPS und IAM funktioniert. Informationen zum Einrichten der richtigen Anmeldeinformationen finden Sie unter. [Verwenden von `awscurl` mit temporären Anmeldeinformationen, um eine sichere Verbindung zu einem DB-Cluster mit aktivierter IAM-Authentifizierung herzustellen](iam-auth-connect-command-line.md#iam-auth-connect-awscurl)

Die folgenden Beispiele zeigen, wie eine authentifizierte Statusanfrage gestellt wird:

**Anmerkung**  
In den folgenden Beispielen werden der Endpunkt und die Befehle des Eigenschaftsdiagramms verwendet. Verwenden Sie für RDF-Daten die entsprechenden SPARQL-Befehle (`get-sparql-statistics`,`manage-sparql-statistics`) für die AWS CLI und `/rdf/statistics` für REST-Endpunkte.

------
#### [ AWS CLI ]

```
aws neptunedata get-propertygraph-statistics \
  --endpoint-url https://{{your-neptune-endpoint}}:{{port}}
```

Der AWS CLI verarbeitet die IAM-Authentifizierung automatisch anhand Ihrer konfigurierten Anmeldeinformationen.

------
#### [ SDK ]

```
import boto3
import json
from botocore.config import Config

client = boto3.client(
    'neptunedata',
    endpoint_url='https://{{your-neptune-endpoint}}:{{port}}',
    config=Config(read_timeout=None, retries={'total_max_attempts': 1})
)

response = client.get_propertygraph_statistics()

print(json.dumps(response['payload'], indent=2, default=str))
```

Das SDK verarbeitet die IAM-Authentifizierung automatisch mithilfe Ihrer konfigurierten Anmeldeinformationen.

------
#### [ awscurl ]

```
awscurl https://{{your-neptune-endpoint}}:{{port}}/propertygraph/statistics \
  --region {{us-east-1}} \
  --service neptune-db
```

**Anmerkung**  
Ersetze es {{us-east-1}} durch die Region deines Neptun-Clusters.

------
#### [ curl ]

```
curl -G https://{{your-neptune-endpoint}}:{{port}}/propertygraph/statistics
```

**Anmerkung**  
Dieses Beispiel beinhaltet keine IAM-Authentifizierung. Um die IAM-Authentifizierung mit zu verwenden**curl**, müssen Sie die Anfrage manuell signieren. Erwägen Sie AWS CLI, **awscurl** stattdessen das SDK oder zu verwenden.

------

In den folgenden Beispielen wird die Statistikgenerierung manuell mit Authentifizierung initiiert:

------
#### [ AWS CLI ]

```
aws neptunedata manage-propertygraph-statistics \
  --endpoint-url https://{{your-neptune-endpoint}}:{{port}} \
  --mode refresh
```

------
#### [ SDK ]

```
import boto3
import json
from botocore.config import Config

client = boto3.client(
    'neptunedata',
    endpoint_url='https://{{your-neptune-endpoint}}:{{port}}',
    config=Config(read_timeout=None, retries={'total_max_attempts': 1})
)

response = client.manage_propertygraph_statistics(mode='refresh')

print(json.dumps(response['payload'], indent=2, default=str))
```

------
#### [ awscurl ]

Erstellen Sie eine JSON-Datei mit dem Namen`request.json`, die Folgendes enthält:

```
{ "mode" : "refresh" }
```

Dann führe Folgendes aus:

```
awscurl https://{{your-neptune-endpoint}}:{{port}}/propertygraph/statistics \
  --region {{us-east-1}} \
  --service neptune-db \
  -X POST \
  -H 'Content-Type: application/json' \
  -d @request.json
```

------
#### [ curl ]

```
curl -X POST https://{{your-neptune-endpoint}}:{{port}}/propertygraph/statistics \
  -H 'Content-Type: application/json' \
  -d '{ "mode" : "refresh" }'
```

**Anmerkung**  
Dieses Beispiel beinhaltet keine IAM-Authentifizierung. Um die IAM-Authentifizierung mit zu verwenden**curl**, müssen Sie die Anfrage manuell signieren. Erwägen Sie AWS CLI, **awscurl** stattdessen das SDK oder zu verwenden.

------

## Löschen von DFE-Statistiken
<a name="neptune-dfe-statistics-delete"></a>

Sie können alle Statistiken in der Datenbank wie folgt löschen:

**Anmerkung**  
In den folgenden Beispielen werden der Endpunkt und die Befehle der Eigenschaft graph verwendet. Verwenden Sie für RDF-Daten `delete-sparql-statistics` für die AWS CLI und `/rdf/statistics` für REST-Endpunkte.

------
#### [ AWS CLI ]

```
aws neptunedata delete-propertygraph-statistics \
  --endpoint-url https://{{your-neptune-endpoint}}:{{port}}
```

Weitere Informationen finden Sie unter [delete-propertygraph-statistics](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/delete-propertygraph-statistics.html) in der Befehlsreferenz. AWS CLI 

------
#### [ SDK ]

```
import boto3
import json
from botocore.config import Config

client = boto3.client(
    'neptunedata',
    endpoint_url='https://{{your-neptune-endpoint}}:{{port}}',
    config=Config(read_timeout=None, retries={'total_max_attempts': 1})
)

response = client.delete_propertygraph_statistics()

print(json.dumps(response['payload'], indent=2, default=str))
```

------
#### [ awscurl ]

```
awscurl https://{{your-neptune-endpoint}}:{{port}}/propertygraph/statistics \
  --region {{us-east-1}} \
  --service neptune-db \
  -X DELETE
```

**Anmerkung**  
In diesem Beispiel wird davon ausgegangen, dass Ihre AWS Anmeldeinformationen in Ihrer Umgebung konfiguriert sind. Ersetze es {{us-east-1}} durch die Region deines Neptun-Clusters.

Weitere Informationen zur Verwendung **awscurl** mit der IAM-Authentifizierung finden Sie unter. [Verwenden von `awscurl` mit temporären Anmeldeinformationen, um eine sichere Verbindung zu einem DB-Cluster mit aktivierter IAM-Authentifizierung herzustellen](iam-auth-connect-command-line.md#iam-auth-connect-awscurl)

------
#### [ curl ]

```
curl -X DELETE https://{{your-neptune-endpoint}}:{{port}}/propertygraph/statistics
```

------

Gültige HTTP-Rückgabecodes sind:
+ `200`   –   Die Statistiken wurden erfolgreich gelöscht.

  In diesem Fall würde eine typische Antwort wie folgt aussehen:

  ```
  {
    "status" : "200 OK",
    "payload" : {
        "active" : false,
        "statisticsId" : -1
    }
  }
  ```
+ `204`   –   Es gab keine Statistiken, die gelöscht werden konnten.

  In diesem Fall ist die Antwort leer (keine Antwort).

Wenn Sie eine Löschanforderung an einen Statistikendpunkt auf einem Reader-Knoten senden, wird eine `ReadOnlyViolationException` ausgelöst.

## Häufige Fehlercodes für DFE-Statistikanforderungen
<a name="neptune-dfe-statistics-errors"></a>

Im Folgenden finden Sie eine Liste häufiger Fehler, die auftreten können, wenn Sie eine Anforderung an einen Statistikendpunkt senden:
+ `AccessDeniedException`   –   *Rückgabecode:* `400`. *Meldung:* `Missing Authentication Token`.
+ `BadRequestException` (für Gremlin und openCypher)   –   *Rückgabecode:* `400`. *Meldung:* `Bad route: /pg/statistics`.
+ `BadRequestException` (für RDF-Daten)   –   *Rückgabecode:* `400`. *Meldung:* `Bad route: /rdf/statistics`.
+ `InvalidParameterException`   –   *Rückgabecode:* `400`. *Meldung:* `Statistics command parameter 'mode' has unsupported value '{{the invalid value}}'`.
+ `MissingParameterException`   –   *Rückgabecode:* `400`. *Meldung:* `Content-type header not specified.`.
+ `ReadOnlyViolationException`   –   *Rückgabecode:* `400`. *Meldung:* `Writes are not permitted on a read replica instance`.

Wenn Sie beispielsweise eine Anforderung senden, wenn DFE und Statistiken nicht aktiviert sind, erhalten Sie eine Antwort wie die folgende:

```
{
  "code" : "BadRequestException",
  "requestId" : "b2b8f8ee-18f1-e164-49ea-836381a3e174",
  "detailedMessage" : "Bad route: /sparql/statistics"
}
```