Erstellen eines Index - Amazon Kendra

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.

Erstellen eines Index

Sie können einen Index über die -Konsole oder durch Aufrufen der CreateIndex-API erstellen. Sie können die AWS Command Line Interface (AWS CLI) oder das SDK mit der API verwenden. Nachdem Sie Ihren Index erstellt haben, können Sie Dokumente direkt zu ihm oder aus einer Datenquelle hinzufügen.

Um einen Index zu erstellen, müssen Sie den Amazon-Ressourcennamen (ARN) einer AWS Identity and Access Management (IAM)-Rolle angeben, damit Indizes auf zugreifen können CloudWatch. Weitere Informationen finden Sie unter IAM Rollen für Indizes.

Die folgenden Registerkarten stellen ein Verfahren zum Erstellen eines Index mithilfe der AWS Management Consoleund Codebeispiele für die Verwendung der AWS CLIsowie Python- und Java-SDKs bereit.

Console
So erstellen Sie einen Index

  1. Melden Sie sich bei der - AWS Managementkonsole an und öffnen Sie die - Amazon Kendra Konsole unter https://console.aws.amazon.com/kendra/.

  2. Wählen Sie im Abschnitt Indizes die Option Index erstellen aus.

  3. Geben Sie unter Indexdetails angeben einen Namen und eine Beschreibung für Ihren Index an.

  4. Geben Sie IAM in Rolle eine - IAM Rolle an. Um eine Rolle zu finden, wählen Sie aus Rollen in Ihrem Konto, die das Wort „kendra“ enthalten, oder geben Sie den Namen einer anderen Rolle ein. Weitere Informationen zu den Berechtigungen, die die Rolle benötigt, finden Sie unter IAM Rollen für Indizes.

  5. Wählen Sie Weiter aus.

  6. Wählen Sie auf der Seite Benutzerzugriffskontrolle konfigurieren die Option Weiter aus. Sie können Ihren Index aktualisieren, um Token für die Zugriffskontrolle zu verwenden, nachdem Sie einen Index erstellt haben. Weitere Informationen finden Sie unter Steuern des Zugriffs auf Dokumente.

  7. Wählen Sie auf der Seite mit den Bereitstellungsdetails die Option Erstellen aus.

  8. Es kann einige Zeit dauern, bis der Index erstellt ist. Überprüfen Sie die Liste der Indizes, um den Fortschritt der Indexerstellung zu überwachen. Wenn der Status des Index lautetACTIVE, ist Ihr Index einsatzbereit.

AWS CLI
So erstellen Sie einen Index

  1. Verwenden Sie den folgenden Befehl, um einen Index zu erstellen. Der role-arn muss der Amazon-Ressourcenname (ARN) einer - IAM Rolle sein, die Amazon Kendra Aktionen ausführen kann. Weitere Informationen finden Sie unter IAM Rollen .

    Der Befehl ist für Linux und macOS formatiert. Wenn Sie Windows verwenden, ersetzen Sie das Unix-Zeilenfortsetzungszeichen (\) durch ein caret (^).

    aws kendra create-index \
 --name index name \
 --description "index description" \
 --role-arn arn:aws:iam::account ID:role/role name

  2. Es kann einige Zeit dauern, bis der Index erstellt ist. Um den Status Ihres Index zu überprüfen, verwenden Sie die von zurückgegebene Index-ID create-index mit dem folgenden Befehl. Wenn der Status des Index lautetACTIVE, ist Ihr Index einsatzbereit.

    aws kendra describe-index \
 --index-id index ID
Python
So erstellen Sie einen Index

  • Geben Sie Werte für die folgenden Variablen im folgenden Codebeispiel an:

    • description– Eine Beschreibung des Index, den Sie erstellen. Dieser Schritt ist optional.

    • index_name– Der Name des Index, den Sie erstellen.

    • role_arn– Der Amazon-Ressourcenname (ARN) einer Rolle, die Amazon Kendra APIs ausführen kann. Weitere Informationen finden Sie unter IAM Rollen .

    import boto3
from botocore.exceptions import ClientError
import pprint
import time

kendra = boto3.client("kendra")

print("Create an index.")

# Provide a name for the index
index_name = "index-name"
# Provide an optional description for the index
description = "index description"
# Provide the IAM role ARN required for indexes
role_arn = "arn:aws:iam::${account id}:role/${role name}"

try:
    index_response = kendra.create_index(
        Name = index_name,
        Description = description,
        RoleArn = role_arn
    )

    pprint.pprint(index_response)

    index_id = index_response["Id"]

    print("Wait for Amazon Kendra to create the index.")

    while True:
        # Get the details of the index, such as the status
        index_description = kendra.describe_index(
            Id = index_id
        )
        # If status is not CREATING, then quit
        status = index_description["Status"]
        print(" Creating index. Status: "+status)
        if status != "CREATING":
            break
        time.sleep(60)

except  ClientError as e:
        print("%s" % e)

print("Program ends.")
Java
So erstellen Sie einen Index

  • Geben Sie Werte für die folgenden Variablen im folgenden Codebeispiel an:

    • description– Eine Beschreibung des Index, den Sie erstellen. Dieser Schritt ist optional.

    • index_name– Der Name des Index, den Sie erstellen.

    • role_arn– Der Amazon-Ressourcenname (ARN) einer Rolle, die Amazon Kendra APIs ausführen kann. Weitere Informationen finden Sie unter IAM Rollen .

    package com.amazonaws.kendra;

import java.util.concurrent.TimeUnit;
import software.amazon.awssdk.services.kendra.KendraClient;
import software.amazon.awssdk.services.kendra.model.CreateIndexRequest;
import software.amazon.awssdk.services.kendra.model.CreateIndexResponse;
import software.amazon.awssdk.services.kendra.model.DescribeIndexRequest;
import software.amazon.awssdk.services.kendra.model.DescribeIndexResponse;
import software.amazon.awssdk.services.kendra.model.IndexStatus;


public class CreateIndexExample {

    public static void main(String[] args) throws InterruptedException {

        String indexDescription = "Getting started index for Kendra";
        String indexName = "java-getting-started-index";
        String indexRoleArn = "arn:aws:iam::<your AWS account ID>:role/KendraRoleForGettingStartedIndex";

        System.out.println(String.format("Creating an index named %s", indexName));
        CreateIndexRequest createIndexRequest = CreateIndexRequest
            .builder()
            .description(indexDescription)
            .name(indexName)
            .roleArn(indexRoleArn)
            .build();
        KendraClient kendra = KendraClient.builder().build();
        CreateIndexResponse createIndexResponse = kendra.createIndex(createIndexRequest);
        System.out.println(String.format("Index response %s", createIndexResponse));

        String indexId = createIndexResponse.id();

        System.out.println(String.format("Waiting until the index with ID %s is created.", indexId));
        while (true) {
            DescribeIndexRequest describeIndexRequest = DescribeIndexRequest.builder().id(indexId).build();
            DescribeIndexResponse describeIndexResponse = kendra.describeIndex(describeIndexRequest);
            IndexStatus status = describeIndexResponse.status();
            if (status != IndexStatus.CREATING) {
                break;
            }

            TimeUnit.SECONDS.sleep(60);
        }

        System.out.println("Index creation is complete.");
    }
}

Nachdem Sie Ihren Index erstellt haben, fügen Sie ihm Dokumente hinzu. Sie können sie direkt hinzufügen oder eine Datenquelle erstellen, die Ihren Index regelmäßig aktualisiert.

Themen