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. # Schritt 4: Einen Amazon Kendra Kendra-Index erstellen und die Metadaten aufnehmen Um Ihre intelligente Suchlösung zu implementieren, erstellen Sie einen Amazon Kendra Kendra-Index und nehmen darin Ihre S3-Daten und Metadaten auf. Bevor Sie Ihrem Amazon Kendra Kendra-Index Metadaten hinzufügen, erstellen Sie benutzerdefinierte Indexfelder, die benutzerdefinierten Dokumentattributen entsprechen, die wiederum den Amazon Comprehend Comprehend-Entitätstypen entsprechen. Amazon Kendra verwendet die Indexfelder und benutzerdefinierten Dokumentattribute, die Sie erstellen, um Ihre Dokumente zu suchen und zu filtern. Weitere Informationen finden Sie unter [Index](https://docs.aws.amazon.com/kendra/latest/dg/hiw-index.html) und [Erstellen von benutzerdefinierten Dokumentattributen](https://docs.aws.amazon.com/kendra/latest/dg/custom-attributes.html). **Topics** + [Einen Amazon Kendra Kendra-Index erstellen](#tutorial-search-metadata-create-index) + [Aktualisierung der IAM-Rolle für den Amazon S3 S3-Zugriff](#tutorial-search-metadata-create-index-update-IAM) + [Benutzerdefinierte Suchindexfelder für Amazon Kendra erstellen](#tutorial-search-metadata-create-index-custom-fields) + [Hinzufügen des Amazon S3 S3-Buckets als Datenquelle für den Index](#tutorial-search-metadata-create-index-connect-data) + [Synchronisieren des Amazon Kendra Kendra-Index](#tutorial-search-metadata-create-index-sync) ## Einen Amazon Kendra Kendra-Index erstellen Um Ihre Quelldokumente abzufragen, erstellen Sie einen Amazon Kendra Kendra-Index. Wenn Sie das AWS CLI in diesem Schritt verwenden, erstellen und fügen Sie eine AWS IAM-Rolle und -Richtlinie hinzu, die es Amazon Kendra ermöglichen, auf Ihre CloudWatch Protokolle zuzugreifen, bevor Sie einen Index erstellen. Weitere Informationen finden Sie unter [Voraussetzungen](https://docs.aws.amazon.com/kendra/latest/dg/gs-prerequisites.html). ### So erstellen Sie einen Amazon Kendra Kendra-Index (Konsole) 1. Öffnen Sie die Amazon Kendra Kendra-Konsole unter [https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/). **Wichtig** Stellen Sie sicher, dass Sie sich in derselben Region befinden, in der Sie Ihren Amazon Comprehend Comprehend-Entitätsanalysejob und Ihren Amazon S3 S3-Bucket erstellt haben. Wenn Sie sich in einer anderen Region befinden, wählen Sie in der AWS **Regionsauswahl in der oberen Navigationsleiste die Region** aus, in der Sie Ihren Amazon S3 S3-Bucket erstellt haben. 1. Wählen Sie **Index erstellen**. 1. Gehen Sie für **Indexdetails** auf der Seite „**Indexdetails angeben**“ wie folgt vor: 1. Geben Sie für **Indexname** **kendra-index** ein. 1. Lassen Sie das Feld **Beschreibung** leer. 1. Wählen Sie für **IAM Role (IAM-Rolle)** die Option **Create a New Role (Neue Rolle erstellen)** aus. Diese Rolle bietet Zugriff auf Ihren Amazon S3 S3-Bucket. 1. Geben Sie für **Rollenname** den Namen **kendra-role** ein. Die IAM-Rolle wird das Präfix `AmazonKendra-` haben. 1. Behalten Sie die Standardeinstellungen für **Verschlüsselung** und **Tags** bei und wählen Sie **Weiter**. 1. Wählen Sie für **Einstellungen zur Zugriffssteuerung** auf der Seite **Benutzerzugriffskontrolle konfigurieren** die Option **Nein** und dann **Weiter** aus. 1. **Wählen Sie für **Provisioning-Editionen** auf der Seite mit den **Provisioning-Details** die Option **Developer Edition und anschließend Create** aus.** ### So erstellen Sie einen Amazon Kendra Kendra-Index ()AWS CLI 1. Gehen Sie wie folgt vor, um eine IAM-Rolle für Amazon Kendra zu erstellen und anzuhängen, die diese Rolle als vertrauenswürdige Entität erkennt: 1. Speichern Sie die folgende Vertrauensrichtlinie als JSON-Datei, die `kendra-trust-policy.json` in einem Texteditor auf Ihrem lokalen Gerät aufgerufen wird. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": { "Effect": "Allow", "Principal": { "Service": "kendra.amazonaws.com" }, "Action": "sts:AssumeRole" } } ``` ------ 1. Verwenden Sie den Befehl [create-role](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/create-role.html), um eine IAM-Rolle namens zu erstellen `kendra-role` und Ihre gespeicherte `kendra-trust-policy.json` Datei an diese anzuhängen: ------ #### [ Linux ] ``` aws iam create-role \ --role-name kendra-role \ --assume-role-policy-document file://path/kendra-trust-policy.json ``` Wobei Folgendes gilt: + *path/*ist der Dateipfad zu `kendra-trust-policy.json` Ihrem lokalen Gerät. ------ #### [ macOS ] ``` aws iam create-role \ --role-name kendra-role \ --assume-role-policy-document file://path/kendra-trust-policy.json ``` Wobei Folgendes gilt: + *path/*ist der Dateipfad zu `kendra-trust-policy.json` Ihrem lokalen Gerät. ------ #### [ Windows ] ``` aws iam create-role ^ --role-name kendra-role ^ --assume-role-policy-document file://path/kendra-trust-policy.json ``` Wobei Folgendes gilt: + *path/*ist der Dateipfad zu `kendra-trust-policy.json` Ihrem lokalen Gerät. ------ 1. Kopieren Sie den Amazon-Ressourcennamen (ARN) in Ihren Texteditor und speichern Sie ihn lokal unter`kendra-role-arn`. **Anmerkung** Der ARN hat ein ähnliches Format wie*arn:aws:iam::123456789012:role/kendra-role*. Sie benötigen den ARN, unter dem Sie gespeichert haben`kendra-role-arn`, um Amazon Kendra Kendra-Jobs auszuführen. 1. Bevor Sie einen Index erstellen, müssen Sie Ihre Erlaubnis `kendra-role` zum Schreiben in CloudWatch Logs erteilen. Führen Sie dazu die folgenden Schritte aus: 1. Speichern Sie die folgende Vertrauensrichtlinie als JSON-Datei, die `kendra-cloudwatch-policy.json` in einem Texteditor auf Ihrem lokalen Gerät aufgerufen wird. *aws-region*Ersetzen Sie es durch Ihre AWS Region und *aws-account-id* durch Ihre 12-stellige AWS Konto-ID. 1. Verwenden Sie den Befehl create-policy, um eine IAM-Richtlinie für den Zugriff auf CloudWatch Logs zu [erstellen](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/create-policy.html): ------ #### [ Linux ] ``` aws iam create-policy \ --policy-name kendra-cloudwatch-policy \ --policy-document file://path/kendra-cloudwatch-policy.json ``` Wobei Folgendes gilt: + *path/*ist der Dateipfad zu `kendra-cloudwatch-policy.json` Ihrem lokalen Gerät. ------ #### [ macOS ] ``` aws iam create-policy \ --policy-name kendra-cloudwatch-policy \ --policy-document file://path/kendra-cloudwatch-policy.json ``` Wobei Folgendes gilt: + *path/*ist der Dateipfad zu `kendra-cloudwatch-policy.json` Ihrem lokalen Gerät. ------ #### [ Windows ] ``` aws iam create-policy ^ --policy-name kendra-cloudwatch-policy ^ --policy-document file://path/kendra-cloudwatch-policy.json ``` Wobei Folgendes gilt: + *path/*ist der Dateipfad zu `kendra-cloudwatch-policy.json` Ihrem lokalen Gerät. ------ 1. Kopieren Sie den Amazon-Ressourcennamen (ARN) in Ihren Texteditor und speichern Sie ihn lokal unter`kendra-cloudwatch-arn`. **Anmerkung** Der ARN hat ein ähnliches Format wie*arn:aws:iam::123456789012:role/kendra-cloudwatch-policy*. Sie benötigen den ARN, unter dem Sie gespeichert haben`kendra-cloudwatch-arn`, um ihn an `kendra-cloudwatch-policy` Ihre IAM-Rolle anzuhängen. 1. Verwenden Sie den folgenden Befehl`kendra-cloudwatch-policy`, um das an Ihre IAM-Rolle anzuhängen: [attach-role-policy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/attach-role-policy.html) ------ #### [ Linux ] ``` aws iam attach-role-policy \ --policy-arn policy-arn \ --role-name kendra-role ``` Wobei Folgendes gilt: + *policy-arn*ist dein gespeicherter. `kendra-cloudwatch-arn` ------ #### [ macOS ] ``` aws iam attach-role-policy \ --policy-arn policy-arn \ --role-name kendra-role ``` Wobei Folgendes gilt: + *policy-arn*ist dein Erretter`kendra-cloudwatch-arn`. ------ #### [ Windows ] ``` aws iam attach-role-policy ^ --policy-arn policy-arn ^ --role-name kendra-role ``` Wobei Folgendes gilt: + *policy-arn*ist dein Erretter`kendra-cloudwatch-arn`. ------ 1. Verwenden Sie den Befehl [create-index, um einen Index](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/create-index.html) zu erstellen: ------ #### [ Linux ] ``` aws kendra create-index \ --name kendra-index \ --edition DEVELOPER_EDITION \ --role-arn role-arn \ --region aws-region ``` Wobei Folgendes gilt: + *role-arn*ist dein gespeichert, `kendra-role-arn` + *aws-region*ist deine AWS Region. ------ #### [ macOS ] ``` aws kendra create-index \ --name kendra-index \ --edition DEVELOPER_EDITION \ --role-arn role-arn \ --region aws-region ``` Wobei Folgendes gilt: + *role-arn*ist deine Rettung`kendra-role-arn`, + *aws-region*ist deine AWS Region. ------ #### [ Windows ] ``` aws kendra create-index ^ --name kendra-index ^ --edition DEVELOPER_EDITION ^ --role-arn role-arn ^ --region aws-region ``` Wobei Folgendes gilt: + *role-arn*ist deine Rettung`kendra-role-arn`, + *aws-region*ist deine AWS Region. ------ 1. Kopieren Sie den Index `Id` und speichern Sie ihn in einem Texteditor als`kendra-index-id`. Das `Id` hilft Ihnen, den Status Ihrer Indexerstellung zu verfolgen. 1. Verwenden Sie den Befehl [describe-index](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/describe-index.html), um den Fortschritt Ihrer Indexerstellung zu verfolgen: ------ #### [ Linux ] ``` aws kendra describe-index \ --id kendra-index-id \ --region aws-region ``` Wobei Folgendes gilt: + *kendra-index-id*ist dein gespeichert, `kendra-index-id` + *aws-region*ist deine AWS Region. ------ #### [ macOS ] ``` aws kendra describe-index \ --id kendra-index-id \ --region aws-region ``` Wobei Folgendes gilt: + *kendra-index-id*ist deine Rettung`kendra-index-id`, + *aws-region*ist deine AWS Region. ------ #### [ Windows ] ``` aws kendra describe-index ^ --id kendra-index-id ^ --region aws-region ``` Wobei Folgendes gilt: + *kendra-index-id*ist deine Rettung`kendra-index-id`, + *aws-region*ist deine AWS Region. ------ Die Indexerstellung dauert im Durchschnitt 15 Minuten, kann aber auch länger dauern. Wenn der Status des Indexes aktiv ist, ist Ihr Index einsatzbereit. Während Ihr Index erstellt wird, können Sie mit dem nächsten Schritt beginnen. Wenn Sie das AWS CLI in diesem Schritt verwenden, erstellen Sie eine IAM-Richtlinie und fügen sie Ihrer Amazon Kendra IAM-Rolle hinzu, die Ihrem Index Berechtigungen für den Zugriff auf Ihren S3-Bucket gewährt. ## Aktualisierung der IAM-Rolle für den Amazon S3 S3-Zugriff Während der Indexerstellung aktualisieren Sie Ihre Amazon Kendra IAM-Rolle, sodass der von Ihnen erstellte Index Daten aus Ihrem Amazon S3 S3-Bucket lesen kann. Weitere Informationen finden Sie unter [IAM-Zugriffsrollen für Amazon Kendra](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html). ### So aktualisieren Sie Ihre IAM-Rolle (Konsole) 1. Öffnen Sie unter [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) die IAM-Konsole. 1. Wählen Sie im linken Navigationsbereich **Rollen** aus und geben Sie den Namen der Rolle **kendra-role** in das **Suchfeld** über dem **Namen der Rolle** ein. 1. Klicken Sie in den vorgeschlagenen Optionen auf`kendra-role`. 1. Wählen Sie unter **Zusammenfassung** die Option **Richtlinien anhängen** aus. 1. Geben **Sie unter Berechtigungen anhängen** in das **Suchfeld** das Kontrollkästchen neben der **ReadOnlyAccessAmazonS3-Richtlinie** ein **S3** und aktivieren Sie es aus den vorgeschlagenen Optionen. 1. Wählen Sie **Richtlinie anfügen** aus. Auf der **Übersichtsseite** sehen Sie nun zwei Richtlinien, die mit der IAM-Rolle verknüpft sind. 1. Kehren Sie zur Amazon Kendra Kendra-Konsole unter zurück [https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/)und warten Sie, bis sich der Status Ihres Indexes von **Creating** auf **Active** ändert, bevor Sie mit dem nächsten Schritt fortfahren. ### Um Ihre IAM-Rolle zu aktualisieren ()AWS CLI 1. Speichern Sie den folgenden Text in einer JSON-Datei, die `kendra-S3-access-policy.json` in einem Texteditor auf Ihrem lokalen Gerät aufgerufen wird. Ersetzen Sie amzn-s3-demo-bucket durch Ihren S3-Bucket-Namen, durch Ihre AWS Region, *aws-region* durch Ihre 12-stellige Konto-ID und *aws-account-id* durch Ihre gespeicherte AWS . *kendra-index-id* `kendra-index-id` 1. [Verwenden Sie den Befehl create-policy, um eine IAM-Richtlinie für den Zugriff auf Ihren S3-Bucket zu erstellen:](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/create-policy.html) ------ #### [ Linux ] ``` aws iam create-policy \ --policy-name kendra-S3-access-policy \ --policy-document file://path/kendra-S3-access-policy.json ``` Wobei Folgendes gilt: + *path/*ist der Dateipfad zu `kendra-S3-access-policy.json` Ihrem lokalen Gerät. ------ #### [ macOS ] ``` aws iam create-policy \ --policy-name kendra-S3-access-policy \ --policy-document file://path/kendra-S3-access-policy.json ``` Wobei Folgendes gilt: + *path/*ist der Dateipfad zu `kendra-S3-access-policy.json` Ihrem lokalen Gerät. ------ #### [ Windows ] ``` aws iam create-policy ^ --policy-name kendra-S3-access-policy ^ --policy-document file://path/kendra-S3-access-policy.json ``` Wobei Folgendes gilt: + *path/*ist der Dateipfad zu `kendra-S3-access-policy.json` Ihrem lokalen Gerät. ------ 1. Kopieren Sie den Amazon-Ressourcennamen (ARN) in Ihren Texteditor und speichern Sie ihn lokal unter`kendra-S3-access-arn`. **Anmerkung** Der ARN hat ein ähnliches Format wie*arn:aws:iam::123456789012:role/kendra-S3-access-policy*. Sie benötigen den ARN, unter dem Sie gespeichert haben`kendra-S3-access-arn`, um ihn an `kendra-S3-access-policy` Ihre IAM-Rolle anzuhängen. 1. Um die IAM-Rolle `kendra-S3-access-policy` an Ihre Amazon Kendra IAM-Rolle anzuhängen, verwenden Sie den [attach-role-policy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/attach-role-policy.html)folgenden Befehl: ------ #### [ Linux ] ``` aws iam attach-role-policy \ --policy-arn policy-arn \ --role-name kendra-role ``` Wobei Folgendes gilt: + *policy-arn*ist Ihr gespeicherter. `kendra-S3-access-arn` ------ #### [ macOS ] ``` aws iam attach-role-policy \ --policy-arn policy-arn \ --role-name kendra-role ``` Wobei Folgendes gilt: + *policy-arn*ist dein Erretter`kendra-S3-access-arn`. ------ #### [ Windows ] ``` aws iam attach-role-policy ^ --policy-arn policy-arn ^ --role-name kendra-role ``` Wobei Folgendes gilt: + *policy-arn*ist dein Erretter`kendra-S3-access-arn`. ------ ## Benutzerdefinierte Suchindexfelder für Amazon Kendra erstellen Um Amazon Kendra darauf vorzubereiten, Ihre Metadaten als benutzerdefinierte Dokumentattribute zu erkennen, erstellen Sie benutzerdefinierte Felder, die den Entitätstypen von Amazon Comprehend entsprechen. Sie geben die folgenden neun Amazon Comprehend Comprehend-Entitätstypen als benutzerdefinierte Felder ein: + COMMERCIAL\$1ITEM + DATE + EREIGNIS + LOCATION + ORGANISATION + OTHER + PERSON + MENGE + TITLE **Wichtig** Falsch geschriebene Entitätstypen werden vom Index nicht erkannt. ### Um benutzerdefinierte Felder für Ihren Amazon Kendra Kendra-Index zu erstellen (Konsole) 1. Öffnen Sie die Amazon Kendra Kendra-Konsole unter [https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/). 1. Klicken Sie in der Liste der **Indizes** auf. `kendra-index` 1. Wählen Sie im linken Navigationsbereich unter **Datenverwaltung** die Option **Facettendefinition** aus. 1. Wählen Sie im Menü **Indexfelder** die Option **Feld hinzufügen** aus. 1. Gehen **Sie im Dialogfeld Indexfeld hinzufügen** wie folgt vor: 1. Geben Sie im **Feld Feldname** den Wert ein**COMMERCIAL\$1ITEM**. 1. Wählen Sie im **Feld Datentyp** die Option **Zeichenkettenliste** aus. 1. **Wählen Sie unter **Verwendungstypen** die Optionen **Facetable**, **Durchsuchbar und **Displayable**** aus und wählen Sie dann Hinzufügen aus.** 1. Wiederholen Sie die Schritte a bis c für jeden Amazon Comprehend Comprehend-Entitätstyp: COMMERCIAL\$1ITEM, DATE, EVENT, LOCATION, ORGANIZATION, OTHER, PERSON, QUANTITY, TITLE. Die Konsole zeigt Meldungen über das erfolgreiche Hinzufügen von Feldern an. Sie können sich dafür entscheiden, sie zu schließen, bevor Sie mit dem nächsten Schritt fortfahren. ### Um benutzerdefinierte Felder für Ihren Amazon Kendra Kendra-Index zu erstellen ()AWS CLI 1. Speichern Sie den folgenden Text als JSON-Datei, die `custom-attributes.json` in einem Texteditor auf Ihrem lokalen Gerät aufgerufen wird. ``` [ { "Name": "COMMERCIAL_ITEM", "Type": "STRING_LIST_VALUE", "Search": { "Facetable": true, "Searchable": true, "Displayable": true } }, { "Name": "DATE", "Type": "STRING_LIST_VALUE", "Search": { "Facetable": true, "Searchable": true, "Displayable": true } }, { "Name": "EVENT", "Type": "STRING_LIST_VALUE", "Search": { "Facetable": true, "Searchable": true, "Displayable": true } }, { "Name": "LOCATION", "Type": "STRING_LIST_VALUE", "Search": { "Facetable": true, "Searchable": true, "Displayable": true } }, { "Name": "ORGANIZATION", "Type": "STRING_LIST_VALUE", "Search": { "Facetable": true, "Searchable": true, "Displayable": true } }, { "Name": "OTHER", "Type": "STRING_LIST_VALUE", "Search": { "Facetable": true, "Searchable": true, "Displayable": true } }, { "Name": "PERSON", "Type": "STRING_LIST_VALUE", "Search": { "Facetable": true, "Searchable": true, "Displayable": true } }, { "Name": "QUANTITY", "Type": "STRING_LIST_VALUE", "Search": { "Facetable": true, "Searchable": true, "Displayable": true } }, { "Name": "TITLE", "Type": "STRING_LIST_VALUE", "Search": { "Facetable": true, "Searchable": true, "Displayable": true } } ] ``` 1. Verwenden Sie den Befehl [update-index, um benutzerdefinierte Felder in Ihrem Index](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/update-index.html) zu erstellen: ------ #### [ Linux ] ``` aws kendra update-index \ --id kendra-index-id \ --document-metadata-configuration-updates file://path/custom-attributes.json \ --region aws-region ``` Wobei Folgendes gilt: + *kendra-index-id*ist dein gespeichert, `kendra-index-id` + *path/*ist der Dateipfad zu `custom-attributes.json` Ihrem lokalen Gerät, + *aws-region*ist deine AWS Region. ------ #### [ macOS ] ``` aws kendra update-index \ --id kendra-index-id \ --document-metadata-configuration-updates file://path/custom-attributes.json \ --region aws-region ``` Wobei Folgendes gilt: + *kendra-index-id*ist deine Rettung`kendra-index-id`, + *path/*ist der Dateipfad zu `custom-attributes.json` Ihrem lokalen Gerät, + *aws-region*ist deine AWS Region. ------ #### [ Windows ] ``` aws kendra update-index ^ --id kendra-index-id ^ --document-metadata-configuration-updates file://path/custom-attributes.json ^ --region aws-region ``` Wobei Folgendes gilt: + *kendra-index-id*ist deine Rettung`kendra-index-id`, + *path/*ist der Dateipfad zu `custom-attributes.json` Ihrem lokalen Gerät, + *aws-region*ist deine AWS Region. ------ 1. Verwenden Sie den Befehl [describe-index, um zu überprüfen, ob die benutzerdefinierten Attribute zu Ihrem Index](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/describe-index.html) hinzugefügt wurden: ------ #### [ Linux ] ``` aws kendra describe-index \ --id kendra-index-id \ --region aws-region ``` Wobei Folgendes gilt: + *kendra-index-id*ist dein gespeichert, `kendra-index-id` + *aws-region*ist deine AWS Region. ------ #### [ macOS ] ``` aws kendra describe-index \ --id kendra-index-id \ --region aws-region ``` Wobei Folgendes gilt: + *kendra-index-id*ist deine Rettung`kendra-index-id`, + *aws-region*ist deine AWS Region. ------ #### [ Windows ] ``` aws kendra describe-index ^ --id kendra-index-id ^ --region aws-region ``` Wobei Folgendes gilt: + *kendra-index-id*ist deine Rettung`kendra-index-id`, + *aws-region*ist deine AWS Region. ------ ## Hinzufügen des Amazon S3 S3-Buckets als Datenquelle für den Index Bevor Sie Ihren Index synchronisieren können, müssen Sie Ihre S3-Datenquelle damit verbinden. ### So verbinden Sie einen S3-Bucket mit Ihrem Amazon Kendra Kendra-Index (Konsole) 1. Öffnen Sie die Amazon Kendra Kendra-Konsole unter [https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/). 1. Klicken Sie in der Liste der **Indizes** auf. `kendra-index` 1. Wählen Sie im linken Navigationsmenü unter **Datenverwaltung** die Option **Datenquellen** aus. 1. Navigieren **Sie im Abschnitt Datenquellen-Connectortyp** auswählen zu **Amazon S3** und wählen Sie **Connector hinzufügen** aus. 1. Gehen Sie auf der Seite „**Datenquellendetails angeben**“ wie folgt vor: 1. Geben Sie unter **Name und Beschreibung** für **Datenquellenname** den Wert ein**S3-data-source**. 1. Lassen Sie den Abschnitt **Beschreibung** leer. 1. Behalten Sie die Standardeinstellungen für **Tags** bei. 1. Wählen Sie **Weiter** aus. 1. Gehen Sie auf der Seite **Synchronisierungseinstellungen konfigurieren** im Abschnitt **Synchronisierungsbereich** wie folgt vor: 1. Wählen **Sie unter Geben Sie den Speicherort der Datenquelle** ein die Option **S3 durchsuchen** aus. 1. **Wählen Sie unter Ressourcen** auswählen Ihren S3-Bucket aus und wählen Sie dann **Wählen aus**. 1. Wählen Sie unter **Speicherort des Präfixordners für Metadatendateien** die Option **S3 durchsuchen** aus. 1. Klicken Sie unter **Ressourcen auswählen** in der Liste der Buckets auf den Namen Ihres Buckets. 1. Wählen Sie für **Objekte** das Optionsfeld für `metadata` und wählen Sie **Wählen** aus. Das Ortsfeld sollte jetzt lauten`metadata/`. 1. Behalten Sie die Standardeinstellungen für den **Speicherort der Konfigurationsdatei für die Zugriffskontrollliste**, den **Entschlüsselungsschlüssel auswählen** und die Option **Zusätzliche Konfiguration** bei. 1. Wählen Sie für die **IAM-Rolle** auf der Seite **Synchronisierungseinstellungen konfigurieren** die Option. `kendra-role` 1. Wählen Sie auf der Seite **Synchronisierungseinstellungen konfigurieren** unter **Zeitplan für die Synchronisierungsausführung** für **Häufigkeit** die Option Bei **Bedarf ausführen** und dann **Weiter** aus. 1. **Überprüfen Sie auf der Seite Überprüfen und erstellen** Ihre Auswahl für die Datenquellendetails und wählen Sie **Datenquelle hinzufügen** aus. ### Um einen S3-Bucket mit Ihrem Amazon Kendra Kendra-Index zu verbinden ()AWS CLI 1. Speichern Sie den folgenden Text als JSON-Datei, die `S3-data-connector.json` in einem Texteditor auf Ihrem lokalen Gerät aufgerufen wird. ``` { "S3Configuration":{ "BucketName":"amzn-s3-demo-bucket", "DocumentsMetadataConfiguration":{ "S3Prefix":"metadata" } } } ``` Ersetzen Sie amzn-s3-demo-bucket durch den Namen Ihres S3-Buckets. 1. Verwenden Sie den folgenden Befehl, um Ihren S3-Bucket mit Ihrem Index zu verbinden: [create-data-source](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/create-data-source.html) ------ #### [ Linux ] ``` aws kendra create-data-source \ --index-id kendra-index-id \ --name S3-data-source \ --type S3 \ --configuration file://path/S3-data-connector.json \ --role-arn role-arn \ --region aws-region ``` Wobei Folgendes gilt: + *kendra-index-id*ist dein gespeichert`kendra-index-id`, + *path/*ist der Dateipfad zu `S3-data-connector.json` Ihrem lokalen Gerät, + *role-arn*ist dein gespeichert, `kendra-role-arn` + *aws-region*ist deine AWS Region. ------ #### [ macOS ] ``` aws kendra create-data-source \ --index-id kendra-index-id \ --name S3-data-source \ --type S3 \ --configuration file://path/S3-data-connector.json \ --role-arn role-arn \ --region aws-region ``` Wobei Folgendes gilt: + *kendra-index-id*ist deine Rettung`kendra-index-id`, + *path/*ist der Dateipfad zu `S3-data-connector.json` Ihrem lokalen Gerät, + *role-arn*ist dein gespeichert, `kendra-role-arn` + *aws-region*ist deine AWS Region. ------ #### [ Windows ] ``` aws kendra create-data-source ^ --index-id kendra-index-id ^ --name S3-data-source ^ --type S3 ^ --configuration file://path/S3-data-connector.json ^ --role-arn role-arn ^ --region aws-region ``` Wobei Folgendes gilt: + *kendra-index-id*ist deine Rettung`kendra-index-id`, + *path/*ist der Dateipfad zu `S3-data-connector.json` Ihrem lokalen Gerät, + *role-arn*ist dein gespeichert, `kendra-role-arn` + *aws-region*ist deine AWS Region. ------ 1. Kopieren Sie den Connector `Id` und speichern Sie ihn in einem Texteditor als`S3-connector-id`. Das `Id` hilft Ihnen, den Status des Datenverbindungsprozesses zu verfolgen. 1. Verwenden Sie den [describe-data-source](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/describe-data-source.html)folgenden Befehl, um sicherzustellen, dass Ihre S3-Datenquelle erfolgreich verbunden wurde: ------ #### [ Linux ] ``` aws kendra describe-data-source \ --id S3-connector-id \ --index-id kendra-index-id \ --region aws-region ``` Wobei Folgendes gilt: + *S3-connector-id*ist dein gespeichert`S3-connector-id`, + *kendra-index-id*ist dein Erretter`kendra-index-id`, + *aws-region*ist deine AWS Region. ------ #### [ macOS ] ``` aws kendra describe-data-source \ --id S3-connector-id \ --index-id kendra-index-id \ --region aws-region ``` Wobei Folgendes gilt: + *S3-connector-id*ist deine Rettung`S3-connector-id`, + *kendra-index-id*ist dein Erretter`kendra-index-id`, + *aws-region*ist deine AWS Region. ------ #### [ Windows ] ``` aws kendra describe-data-source ^ --id S3-connector-id ^ --index-id kendra-index-id ^ --region aws-region ``` Wobei Folgendes gilt: + *S3-connector-id*ist deine Rettung`S3-connector-id`, + *kendra-index-id*ist dein Erretter`kendra-index-id`, + *aws-region*ist deine AWS Region. ------ Am Ende dieses Schritts ist Ihre Amazon S3 S3-Datenquelle mit dem Index verbunden. ## Synchronisieren des Amazon Kendra Kendra-Index Nachdem die Amazon S3 S3-Datenquelle hinzugefügt wurde, synchronisieren Sie jetzt Ihren Amazon Kendra Kendra-Index damit. ### So synchronisieren Sie Ihren Amazon Kendra Kendra-Index (Konsole) 1. Öffnen Sie die Amazon Kendra Kendra-Konsole unter [https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/). 1. Klicken Sie in der Liste der **Indizes** auf. `kendra-index` 1. Klicken Sie im linken Navigationsmenü auf **Datenquellen**. 1. Wählen Sie **unter Datenquellen** die Option aus`S3-data-source`. 1. Wählen Sie in der oberen Navigationsleiste die Option **Jetzt synchronisieren** aus. ### So synchronisieren Sie Ihren Amazon Kendra Kendra-Index ()AWS CLI 1. Verwenden Sie den Befehl [start-data-source-sync-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/start-data-source-sync-job.html), um Ihren Index zu synchronisieren: ------ #### [ Linux ] ``` aws kendra start-data-source-sync-job \ --id S3-connector-id \ --index-id kendra-index-id \ --region aws-region ``` Wobei Folgendes gilt: + *S3-connector-id*ist dein gespeichert`S3-connector-id`, + *kendra-index-id*ist dein Erretter`kendra-index-id`, + *aws-region*ist deine AWS Region. ------ #### [ macOS ] ``` aws kendra start-data-source-sync-job \ --id S3-connector-id \ --index-id kendra-index-id \ --region aws-region ``` Wobei Folgendes gilt: + *S3-connector-id*ist deine Rettung`S3-connector-id`, + *kendra-index-id*ist dein Erretter`kendra-index-id`, + *aws-region*ist deine AWS Region. ------ #### [ Windows ] ``` aws kendra start-data-source-sync-job ^ --id S3-connector-id ^ --index-id kendra-index-id ^ --region aws-region ``` Wobei Folgendes gilt: + *S3-connector-id*ist deine Rettung`S3-connector-id`, + *kendra-index-id*ist dein Erretter`kendra-index-id`, + *aws-region*ist deine AWS Region. ------ 1. Verwenden Sie den Befehl [list-data-source-sync-jobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/list-data-source-sync-jobs.html), um den Status der Indexsynchronisierung zu überprüfen: ------ #### [ Linux ] ``` aws kendra list-data-source-sync-jobs \ --id S3-connector-id \ --index-id kendra-index-id \ --region aws-region ``` Wobei Folgendes gilt: + *S3-connector-id*ist dein gespeichert`S3-connector-id`, + *kendra-index-id*ist dein Erretter`kendra-index-id`, + *aws-region*ist deine AWS Region. ------ #### [ macOS ] ``` aws kendra list-data-source-sync-jobs \ --id S3-connector-id \ --index-id kendra-index-id \ --region aws-region ``` Wobei Folgendes gilt: + *S3-connector-id*ist deine Rettung`S3-connector-id`, + *kendra-index-id*ist dein Erretter`kendra-index-id`, + *aws-region*ist deine AWS Region. ------ #### [ Windows ] ``` aws kendra list-data-source-sync-jobs ^ --id S3-connector-id ^ --index-id kendra-index-id ^ --region aws-region ``` Wobei Folgendes gilt: + *S3-connector-id*ist deine Rettung`S3-connector-id`, + *kendra-index-id*ist dein Erretter`kendra-index-id`, + *aws-region*ist deine AWS Region. ------ Am Ende dieses Schritts haben Sie einen durchsuchbaren und filterbaren Amazon Kendra Kendra-Index für Ihren Datensatz erstellt.