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. # Exportieren Sie Parameterfelder im `params`-JSON-Objekt der obersten Ebene Mit dem `params`-Neptune-Export-JSON-Objekt können Sie den Export steuern, einschließlich des Typs und des Formats der exportierten Daten. ## Liste der möglichen Felder im `params`-Exportparameterobjekt Im Folgenden sind alle möglichen Felder der obersten Ebene aufgeführt, die in einem `params`-Objekt vorkommen können. Nur eine Teilmenge dieser Felder kommt in einem Objekt vor. ### Liste der Felder, die allen Exporttypen gemeinsam sind + [`cloneCluster`](#export-params-cloneCluster) + [`cloneClusterInstanceType`](#export-params-cloneClusterInstanceType) + [`cloneClusterReplicaCount`](#export-params-cloneClusterReplicaCount) + [`cloneClusterEnableAuditLogs`](#export-params-cloneClusterEnableAuditLogs) + [`clusterId`](#export-params-clusterId) + [`endpoint`](#export-params-endpoint) + [`endpoints`](#export-params-endpoints) + [`profile`](#export-params-profile) + [`useIamAuth`](#export-params-useIamAuth) + [`includeLastEventId`](#export-params-includeLastEventId) ### Liste der Felder für den Export von Eigenschaftsgraphen + [`concurrency`](#export-params-concurrency) + [`edgeLabels`](#export-params-edgeLabels) + [`filter`](#export-params-filter) + [`filterConfigFile`](#export-params-filterConfigFile) + [`gremlinFilter`](#export-params-gremlinFilter) + [`gremlinNodeFilter`](#export-params-gremlinFilter) + [`gremlinEdgeFilter`](#export-params-gremlinFilter) + [`format`](#export-params-format-pg) + [`nodeLabels`](#export-params-nodeLabels) + [`scope`](#export-params-scope) ### Liste der Felder für RDF-Exporte + [`format`](#export-params-format-rdf) + [`rdfExportScope`](#export-params-rdfExportScope) + [`sparql`](#export-params-sparql) + [`namedGraph`](#namedgraph-params-sparql) ## Felder, die allen Exporttypen gemeinsam sind ### `cloneCluster`-Feld in `params` *(Optional)*. Standard: `false`. Wenn der `cloneCluster`-Parameter auf `true` gesetzt ist, verwendet der Exportvorgang einen schnellen Klon Ihres DB-Clusters: ``` "cloneCluster" : true ``` Standardmäßig exportiert der Exportvorgang Daten aus dem DB-Cluster, den Sie mit den Parametern `endpoint`, `endpoints` oder `clusterId` angeben. Wenn Ihr DB-Cluster jedoch während des Exports verwendet wird und sich Daten ändern, kann der Exportvorgang die Konsistenz der exportierten Daten nicht garantieren. Um sicherzustellen, dass die exportierten Daten konsistent sind, verwenden Sie stattdessen den `cloneCluster`-Parameter, um aus einem statischen Klon Ihres DB-Clusters zu exportieren. Der geklonte DB-Cluster wird in derselben VPC wie der Quell-DB-Cluster erstellt und übernimmt die Sicherheitsgruppe, die Subnetzgruppe und die IAM-Datenbankauthentifizierungse instellungen der Quelle. Wenn der Export abgeschlossen ist, löscht Neptune den geklonten DB-Cluster. Standardmäßig besteht ein geklonter DB-Cluster aus einer einzigen Instance desselben Instance-Typs wie die primäre Instance im Quell-DB-Cluster. Sie können den Instance-Typ ändern, der für den geklonten DB-Cluster verwendet wird, indem Sie mit `cloneClusterInstanceType` einen anderen Instance-Typ angeben. **Anmerkung** Wenn Sie die `cloneCluster`-Option nicht verwenden und direkt aus Ihrem Haupt-DB-Cluster exportieren, müssen Sie möglicherweise das Timeout für die Instances erhöhen, aus denen Daten exportiert werden. Bei großen Datensätzen sollte das Timeout auf mehrere Stunden festgelegt werden. ### `cloneClusterInstanceType`-Feld in `params` *(Optional)*. Wenn der `cloneCluster`-Parameter vorhanden und auf `true` gesetzt ist, können Sie den `cloneClusterInstanceType`-Parameter verwenden, um den Instance-Typ anzugeben, der für den geklonten DB-Cluster verwendet wird: Standardmäßig besteht ein geklonter DB-Cluster aus einer einzigen Instance desselben Instance-Typs wie die primäre Instance im Quell-DB-Cluster. ``` "cloneClusterInstanceType" : "(for example, r5.12xlarge)" ``` ### `cloneClusterReplicaCount`-Feld in `params` *(Optional)*. Wenn der `cloneCluster`-Parameter vorhanden und auf `true` gesetzt ist, können Sie den `cloneClusterReplicaCount`-Parameter verwenden, um die Anzahl der Lesereplikat-Instances anzugeben, die im geklonten DB-Cluster erstellt wurden: ``` "cloneClusterReplicaCount" : (for example, 3) ``` Standardmäßig besteht ein geklonter DB-Cluster aus einer einzigen primären Instance. Mit dem `cloneClusterReplicaCount`-Parameter können Sie angeben, wie viele zusätzliche Lesereplikat-Instances erstellt werden sollen. ### `cloneClusterEnableAuditLogs`-Feld in `params` *(Optional)*. Standard: falsch. Wenn der `cloneCluster` Parameter vorhanden und auf true gesetzt ist, können Sie den `cloneClusterEnableAuditLogs` Parameter verwenden, um Audit-Logs im geklonten Cluster zu aktivieren oder zu deaktivieren. Standardmäßig ist die Auditprotokollierung deaktiviert. ``` "cloneClusterEnableAuditLogs" : true ``` ### `clusterId`-Feld in `params` *(Optional)*. Der `clusterId`-Parameter gibt die ID eines zu verwendenden DB-Clusters an: ``` "clusterId" : "(the ID of your DB cluster)" ``` Wenn Sie den `clusterId`-Parameter verwenden, verwendet der Exportvorgang alle verfügbaren Instances in diesem DB-Cluster, um Daten zu extrahieren. **Anmerkung** Die Parameter `endpoint`, `endpoints` und `clusterId` schließen sich gegenseitig aus. Verwenden Sie stets nur einen davon. ### `endpoint`-Feld in `params` *(Optional)*. Verwenden Sie `endpoint`, um einen Endpunkt einer Neptune-Instance in Ihrem DB-Cluster anzugeben, den der Exportprozess abfragen kann, um Daten zu extrahieren (siehe [Endpunktverbindungen](feature-overview-endpoints.md)). Dies ist nur der DNS-Name und beinhaltet nicht das Protokoll oder den Port: ``` "endpoint" : "(a DNS endpoint of your DB cluster)" ``` Verwenden Sie einen Cluster oder Instance-Endpunkt, aber nicht den Haupt-Leser-Endpunkt. **Anmerkung** Die Parameter `endpoint`, `endpoints` und `clusterId` schließen sich gegenseitig aus. Verwenden Sie stets nur einen davon. ### `endpoints`-Feld in `params` *(Optional)*. Verwenden Sie `endpoints`, um ein JSON-Array von Endpunkten in Ihrem DB-Cluster anzugeben, das der Exportprozess abfragen kann, um Daten zu extrahieren (siehe [Endpunktverbindungen](feature-overview-endpoints.md)). Dies sind nur DNS-Namen ohne Protokoll oder Port: ``` "endpoints": [ "(one endpoint in your DB cluster)", "(another endpoint in your DB cluster)", "(a third endpoint in your DB cluster)" ] ``` Wenn Sie mehrere Instances in Ihrem Cluster haben (eine primäre und ein oder mehrere Lesereplikate), können Sie die Exportleistung verbessern, indem Sie den `endpoints`-Parameter verwenden, um Abfragen auf eine Liste dieser Endpunkte zu verteilen. **Anmerkung** Die Parameter `endpoint`, `endpoints` und `clusterId` schließen sich gegenseitig aus. Verwenden Sie stets nur einen davon. ### `profile`-Feld in `params` *(Erforderlich, um Trainingsdaten für Neptune ML zu exportieren, sofern das `neptune_ml`-Feld nicht im `additionalParams`-Feld vorhanden ist*). Der `profile`-Parameter stellt Sätze vorkonfigurierter Parameter für bestimmte Workloads bereit. Derzeit unterstützt der Exportvorgang nur das Profil `neptune_ml` Wenn Sie Trainingsdaten für Neptune ML exportieren, fügen Sie dem `params`-Objekt den folgenden Parameter hinzu: ``` "profile" : "neptune_ml" ``` ### `useIamAuth`-Feld in `params` *(Optional)*. Standard: `false`. Wenn für die Datenbank, aus der Sie Daten exportieren, die [IAM-Authentifizierung aktiviert](iam-auth-enable.md) ist, müssen Sie den Parameter `useIamAuth` mit der Einstellung auf `true` einschließen: ``` "useIamAuth" : true ``` ### `includeLastEventId`-Feld in `params` Wenn Sie den Wert `includeLastEventId` auf „true“ setzen und in der Datenbank, aus der Sie Daten exportieren, [Neptune Streams](streams-using.md) aktiviert ist, schreibt der Exportvorgang eine `lastEventId.json`-Datei an den angegebenen Exportspeicherort. Diese Datei enthält das `commitNum` und das `opNum` des letzten Ereignisses im Stream. ``` "includeLastEventId" : true ``` Eine durch den Exportvorgang erstellte geklonte Datenbank übernimmt die Streams-Einstellung der übergeordneten Datenbank. Wenn für das übergeordnete Objekt Streams aktiviert sind, sind auch Streams für den Klon aktiviert. Der Inhalt des Streams auf dem Clone entspricht dem Inhalt des übergeordneten Streams (einschließlich desselben Ereignisses IDs) zu dem Zeitpunkt, zu dem der Clone erstellt wurde. ## Felder für den Export von Eigenschaftsgraphen ### `concurrency`-Feld in `params` *(Optional)*. Standard: `4`. Der `concurrency`-Parameter gibt die Anzahl der parallelen Abfragen an, die der Exportvorgang verwenden soll: ``` "concurrency" : (for example, 24) ``` Eine gute Richtlinie besteht darin, die Parallelitätsstufe für alle Instances, aus denen Sie Daten exportieren, CPUs auf die doppelte Anzahl von v festzulegen. Eine r5.xlarge-Instance hat beispielsweise 4 v. CPUs Wenn Sie aus einem Cluster von 3 r5.xlarge-Instances exportieren, können Sie die Parallelitätsebene auf 24 (= 3 x 2 x 4) festlegen. Wenn Sie den Neptune-Export-Service verwenden, ist die Parallelitätsebene durch die [JobSize](export-parameters.md#export-parameters-jobSize)-Einstellung begrenzt. Ein kleiner Auftrag unterstützt beispielsweise eine Parallelitätsebene von 8. Wenn Sie versuchen, mithilfe des `concurrency`-Parameters eine Parallelitätsebene von 24 für einen kleinen Auftrag anzugeben, bleibt die effektive Ebene bei 8. Wenn Sie aus einem geklonten Cluster exportieren, berechnet der Exportprozess auf der Grundlage der Größe der geklonten Instances und der Auftragsgröße eine angemessene Parallelitätsebene. ### `edgeLabels`-Feld in `params` *(Optional)*. Verwenden Sie `edgeLabels`, um nur die Edges zu exportieren, deren Etiketten Sie angeben: ``` "edgeLabels" : ["(a label)", "(another label"] ``` Jedes Etikett im JSON-Array muss ein einzelnes, einfaches Etikett sein. Der `scope`-Parameter hat Vorrang vor dem `edgeLabels`-Parameter. Wenn der `scope`-Wert also keine Edges enthält, hat der `edgeLabels`-Parameter keine Wirkung. ### `filter`-Feld in `params` *(Optional)*. Verwenden Sie diese Option, `filter` um anzugeben, dass nur Knoten, and/or Kanten mit bestimmten Beschriftungen exportiert werden sollen, und um die Eigenschaften zu filtern, die für jeden Knoten oder jede Kante exportiert werden. Die allgemeine Struktur eines `filter`-Objekts, entweder direkt oder in einer Filterkonfigurationsdatei, sieht wie folgt aus: ``` "filter" : { "nodes": [ (array of node label and properties objects) ], "edges": [ (array of edge definition an properties objects) ] } ``` + **`nodes`** – Enthält ein JSON-Array von Knoten und Knoteneigenschaften in der folgenden Form: ``` "nodes : [ { "label": "(node label)", "properties": [ "(a property name)", "(another property name)", ( ... ) ] } ] ``` + `label` – Etikett(en) des Eigenschaftsgraphen des Knotens. Akzeptiert einen einzelnen Wert oder, wenn der Knoten mehrere Etiketten hat, ein Array von Werten. + `properties` – Enthält ein Array mit den Namen der Eigenschaften des Knotens, die Sie exportieren möchten. + **`edges`** – Enthält ein JSON-Array mit Edge-Definitionen in der folgenden Form: ``` "edges" : [ { "label": "(edge label)", "properties": [ "(a property name)", "(another property name)", ( ... ) ] } ] ``` + `label` – Etikett des Edge-Eigenschaftsgraphen. Nimmt einen einzelnen Wert an. + `properties` – Enthält ein Array mit den Namen der Eigenschaften des Edges, die Sie exportieren möchten. ### `filterConfigFile`-Feld in `params` *(Optional)*. Verwenden Sie `filterConfigFile`, um eine JSON-Datei anzugeben, die eine Filterkonfiguration in derselben Form enthält, die der `filter`-Parameter annimmt: ``` "filterConfigFile" : "s3://(your Amazon S3 bucket)/neptune-export/(the name of the JSON file)" ``` Informationen zum Format der `filterConfigFile`-Datei finden Sie unter [Filter](#export-params-filter). ### `format`-Feld, das für Eigenschaftsgraphdaten in `params` verwendet wird *(Optional)*. *Standart*: `csv` (CSV) Der `format`-Parameter gibt das Ausgabeformat der exportierten Eigenschaftsgraphdaten an: ``` "format" : (one of: csv, csvNoHeaders, json, neptuneStreamsJson) ``` + **`csv`** – Ausgabe im CSV-Format mit Spaltenüberschriften, die gemäß dem [Gremlin-Ladedatenformat](bulk-load-tutorial-format-gremlin.md) formatiert sind. + **`csvNoHeaders`** – CSV-formatierte Daten ohne Spaltenüberschriften. + **`json`** – JSON-formatierte Daten. + **`neptuneStreamsJson`** – JSON-formatierte Daten, die das [GREMLIN\$1JSON-Änderungsserialisierungsformat](streams-change-formats.md) verwenden. ### `gremlinFilter`-Feld in `params` *(Optional)*. Mit dem `gremlinFilter`-Parameter können Sie ein Gremlin-Snippet angeben, z. B. einen `has()`-Schritt, mit dem sowohl Knoten als auch Edges gefiltert werden: ``` "gremlinFilter" : (a Gremlin snippet) ``` Feldnamen und Zeichenfolgenwerte sollten von doppelten Escape-Anführungszeichen umgeben sein. Für Datums- und Uhrzeitangaben können Sie die [Datetime](best-practices-gremlin-datetime.md)-Methode verwenden. Im folgenden Beispiel werden nur die Knoten und Edges exportiert, deren Erstellungsdatum nach dem 10.10.2021 liegt: ``` "gremlinFilter" : "has(\"created\", gt(datetime(\"2021-10-10\")))" ``` ### `gremlinNodeFilter`-Feld in `params` *(Optional)*. Mit dem `gremlinNodeFilter`-Parameter können Sie ein Gremlin-Snippet angeben, z. B. einen `has()`-Schritt, mit dem Knoten gefiltert werden: ``` "gremlinNodeFilter" : (a Gremlin snippet) ``` Feldnamen und Zeichenfolgenwerte sollten von doppelten Escape-Anführungszeichen umgeben sein. Für Datums- und Uhrzeitangaben können Sie die [Datetime](best-practices-gremlin-datetime.md)-Methode verwenden. Das folgende Beispiel exportiert nur die Knoten mit einer booleschen `deleted` Eigenschaft, deren Wert `true` ist: ``` "gremlinNodeFilter" : "has(\"deleted\", true)" ``` ### `gremlinEdgeFilter`-Feld in `params` *(Optional)*. Mit dem `gremlinEdgeFilter`-Parameter können Sie ein Gremlin-Snippet angeben, z. B. einen `has()`-Schritt, mit dem Edges gefiltert werden: ``` "gremlinEdgeFilter" : (a Gremlin snippet) ``` Feldnamen und Zeichenfolgenwerte sollten von doppelten Escape-Anführungszeichen umgeben sein. Für Datums- und Uhrzeitangaben können Sie die [Datetime](best-practices-gremlin-datetime.md)-Methode verwenden. Das folgende Beispiel exportiert nur die Edges mit einer numerischen `strength`-Eigenschaft, deren Wert 5 ist: ``` "gremlinEdgeFilter" : "has(\"strength\", 5)" ``` ### `nodeLabels`-Feld in `params` *(Optional)*. Verwenden Sie `nodeLabels`, um nur die Knoten zu exportieren, deren Etiketten Sie angeben: ``` "nodeLabels" : ["(a label)", "(another label"] ``` Jedes Etikett im JSON-Array muss ein einzelnes, einfaches Etikett sein. Der `scope`-Parameter hat Vorrang vor dem `nodeLabels`-Parameter. Wenn der `scope`-Wert keine Knoten enthält, hat der `nodeLabels`-Parameter daher keine Wirkung. ### `scope`-Feld in `params` *(Optional)*. Standard: `all`. Der `scope`-Parameter gibt an, ob nur Knoten, nur Edges oder Knoten und Edges exportiert werden sollen: ``` "scope" : (one of: nodes, edges, or all) ``` + `nodes` – Exportiert nur Knoten und ihre Eigenschaften. + `edges` – Exportiert nur Edges und ihre Eigenschaften. + `all` – Exportiert sowohl Knoten als auch Edges und ihre Eigenschaften (Standard). ## Felder für den RDF-Export ### `format`-Feld, das für RDF-Daten in `params` verwendet wird *(Optional)*. *Standardwert*: `turtle` Der `format`-Parameter gibt das Ausgabeformat der exportierten RDF-Daten an: ``` "format" : (one of: turtle, nquads, ntriples, neptuneStreamsJson) ``` + **`turtle`** – Ausgabe im Turtle-Format. + **`nquads`** – N-Quads-formatierte Daten ohne Spaltenüberschriften. + **`ntriples`** – N-Triples-formatierte Daten. + **`neptuneStreamsJson`** – JSON-formatierte Daten, die das [SPARQL NQUADS-Änderungsserialisierungsformat](streams-change-formats.md) verwenden. ### `rdfExportScope`-Feld in `params` *(Optional)*. Standard: `graph`. Der `rdfExportScope`-Parameter gibt den Umfang des RDF-Exports an: ``` "rdfExportScope" : (one of: graph, edges, or query) ``` + `graph` – Exportiert alle RDF-Daten. + `edges` – Exportiert nur die Triples, die Edges repräsentieren. + `query` – Exportiert Daten, die durch eine SPARQL-Abfrage abgerufen wurden, die mithilfe des Felds `sparql` bereitgestellt wird. ### `sparql`-Feld in `params` *(Optional)*. Mit dem `sparql`-Parameter können Sie eine SPARQL-Abfrage angeben, um die zu exportierenden Daten abzurufen: ``` "sparql" : (a SPARQL query) ``` Wenn Sie eine Abfrage mithilfe des `sparql`-Felds angeben, müssen Sie das `rdfExportScope`-Feld auch auf `query` setzen. ### `namedGraph`-Feld in `params` *(Optional)*. Mit dem `namedGraph` Parameter können Sie einen IRI angeben, um den Export auf ein einzelnes benanntes Diagramm zu beschränken: ``` "namedGraph" : (Named graph IRI) ``` Der `namedGraph` Parameter kann nur verwendet werden, wenn das `rdfExportScope` Feld auf gesetzt ist`graph`.