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. # Point-in-Time-Suche in Amazon OpenSearch Service Point in Time (PIT) ist ein Suchtyp, mit dem Sie verschiedene Abfragen für einen Datensatz ausführen können, der zeitlich festgelegt ist. Wenn Sie dieselbe Abfrage für denselben Index zu unterschiedlichen Zeitpunkten ausführen, erhalten Sie in der Regel unterschiedliche Ergebnisse, da Dokumente ständig indexiert, aktualisiert und gelöscht werden. Mit PIT können Sie Abfragen anhand eines konstanten Zustands Ihres Datensatzes durchführen. Der Hauptzweck der PIT-Suche besteht darin, sie mit `search_after` Funktionen zu verbinden. Dies ist die bevorzugte Paginierungsmethode OpenSearch, insbesondere für tiefe Paginierung, da sie mit einem Datensatz arbeitet, der zeitlich eingefroren ist, nicht an eine Abfrage gebunden ist und eine konsistente Paginierung vor- und rückwärts unterstützt. Sie können PIT mit einer Domain verwenden, auf der Version 2.5 ausgeführt wird. OpenSearch **Anmerkung** Dieses Thema bietet einen Überblick über PIT und einige Dinge, die bei der Verwendung auf einer verwalteten Amazon OpenSearch Service-Domain und nicht auf einem selbstverwalteten OpenSearch Cluster zu beachten sind. Eine vollständige Dokumentation von PIT, einschließlich einer umfassenden API-Referenz, finden Sie unter [Point in Time](https://opensearch.org/docs/latest/opensearch/point-in-time/) in der OpenSearch Open-Source-Dokumentation. ## Überlegungen Beachten Sie bei der Konfiguration Ihrer PIT-Suchen Folgendes: + Wenn Sie ein Upgrade von einer Domain mit OpenSearch Version 2.3 durchführen und eine detaillierte Zugriffskontrolle für PIT-Aktionen benötigen, müssen Sie diese Aktionen und Rollen manuell hinzufügen. + Es gibt keine Resilienz für PIT. Der Neustart von Knoten, die Kündigung des Knotens, Bereitstellungen in Blau/Grün und OpenSearch Prozessneustarts führen dazu, dass alle PIT-Daten verloren gehen. + Wenn ein Shard während der blue/green Bereitstellung verschoben wird, werden nur Live-Datensegmente auf den neuen Knoten übertragen. Shard-Segmente, die sich im Besitz von PIT befinden (sowohl exklusiv als auch diejenigen, die gemeinsam mit aktiven Daten genutzt werden), verbleiben auf dem alten Knoten. + PIT-Suchen funktionieren derzeit nicht mit asynchroner Suche. ## Erstellen Sie eine PIT Um eine PIT-Abfrage auszuführen, senden Sie HTTP-Anfragen `_search/point_in_time` unter Verwendung des folgenden Formats an: ``` POST opensearch-domain/my-index/_search/point_in_time?keep_alive=time ``` Sie können die folgenden PIT-Optionen angeben: | Optionen | Description | Standardwert | Erforderlich | | --- | --- | --- | --- | | keep\$1alive | Die Dauer der Beibehaltung der PIT. Jedes Mal, wenn Sie mit einer Suchanfrage auf eine PIT zugreifen, wird die PIT-Lebensdauer um den Zeitraum verlängert, der dem `keep_alive` Parameter entspricht. Dieser Abfrageparameter ist erforderlich, wenn Sie eine PIT erstellen, bei einer Suchanfrage jedoch optional. | | Ja | | preference | Eine Zeichenfolge, die den Knoten oder den Shard angibt, der für die Suche verwendet wurde. | Zufällig | Nein | | routing | Eine Zeichenfolge, die angibt, Suchanfragen an einen bestimmten Shard weiterzuleiten. | Das Dokument ist \$1id | Nein | | expand\$1wildcards | Eine Zeichenfolge, die den Indextyp angibt, der dem Platzhaltermuster entsprechen kann. Unterstützt kommagetrennte Werte. Gültige Werte:[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/opensearch-service/latest/developerguide/pit.html) | open | Nein | | allow\$1partial\$1pit\$1creation | Ein boolescher Wert, der angibt, ob eine PIT mit teilweisen Fehlern erstellt werden soll. | true | Nein | **Beispielantwort** ``` { "pit_id": "o463QQEPbXktaW5kZXgtMDAwMDAxFnNOWU43ckt3U3IyaFVpbGE1UWEtMncAFjFyeXBsRGJmVFM2RTB6eVg1aVVqQncAAAAAAAAAAAIWcDVrM3ZIX0pRNS1XejE5YXRPRFhzUQEWc05ZTjdyS3dTcjJoVWlsYTVRYS0ydwAA", "_shards": { "total": 1, "successful": 1, "skipped": 0, "failed": 0 }, "creation_time": 1658146050064 } ``` Wenn Sie eine PIT erstellen, erhalten Sie in der Antwort eine PIT-ID. Dies ist die ID, die Sie verwenden, um Suchen mit der PIT durchzuführen. ## Berechtigungen zu einem bestimmten Zeitpunkt PIT unterstützt eine [differenzierte Zugriffskontrolle](fgac.md). Wenn Sie ein Upgrade auf eine Domain der OpenSearch Version 2.5 durchführen und eine detaillierte Zugriffskontrolle benötigen, müssen Sie manuell Rollen mit den folgenden Berechtigungen erstellen: ``` # Allows users to use all point in time search search functionality point_in_time_full_access: reserved: true index_permissions: - index_patterns: - '*' allowed_actions: - "indices:data/read/point_in_time/create" - "indices:data/read/point_in_time/delete" - "indices:data/read/point_in_time/readall" - "indices:data/read/search" - "indices:monitor/point_in_time/segments" # Allows users to use point in time search search functionality for specific index # All type operations like list all PITs, delete all PITs are not supported in this case point_in_time_index_access: reserved: true index_permissions: - index_patterns: - 'my-index-1' allowed_actions: - "indices:data/read/point_in_time/create" - "indices:data/read/point_in_time/delete" - "indices:data/read/search" - "indices:monitor/point_in_time/segments" ``` Für Domänen mit OpenSearch Version 2.5 und höher können Sie die integrierte `point_in_time_full_access` Rolle verwenden. Weitere Informationen finden Sie in der OpenSearch Dokumentation unter [Sicherheitsmodell]( https://opensearch.org/docs/latest/search-plugins/point-in-time/#security-model). ## PIT-Einstellungen OpenSearch ermöglicht es Ihnen, alle verfügbaren [PIT-Einstellungen](https://opensearch.org/docs/latest/search-plugins/point-in-time-api/#pit-settings) mithilfe der `_cluster/settings` API zu ändern. Im OpenSearch Service können Sie derzeit keine Einstellungen ändern. ## Cluster-übergreifende Suche Sie können Cluster mit PIT erstellen PITs IDs, mit PIT suchen PITs, auflisten und PITs löschen, wobei die folgenden geringfügigen Einschränkungen gelten: + Sie können PITs nur in der Quelldomäne alle auflisten und alle löschen. + Sie können Netzwerk-Roundtrips als Teil einer clusterübergreifenden Suchabfrage nicht minimieren. Weitere Informationen finden Sie unter [Clusterübergreifende Suche in Amazon Service OpenSearch](cross-cluster-search.md). ## UltraWarm PIT-Suchen mit UltraWarm Indizes funktionieren weiterhin. Weitere Informationen finden Sie unter [UltraWarm Speicher für Amazon OpenSearch Service](ultrawarm.md). **Anmerkung** Sie können die PIT-Suchstatistiken in CloudWatch überwachen. Eine vollständige Liste der Metriken finden Sie unter [Metriken zum aktuellen Zeitpunkt](managedomains-cloudwatchmetrics.md#managedomains-cloudwatchmetrics-pit).