Erstellen eines Index

Um einen Index zu erstellen

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

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

3. Geben Sie im Feld Indexdetails angeben Ihrem Index einen Namen und eine Beschreibung.

4. Geben Sie im Feld IAM Rolle eine IAM Rolle an. Um eine Rolle zu finden, wählen Sie eine der Rollen in Ihrem Konto aus, die das Wort „Kendra“ enthalten, oder geben Sie den Namen einer anderen Rolle ein. Weitere Informationen zu den Berechtigungen, die für die Rolle erforderlich sind, finden Sie unter IAM Rollen für Indizes.

5. Wählen Sie Weiter.

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. Sehen Sie sich die Liste der Indizes an, um den Fortschritt der Indexerstellung zu verfolgen. Wenn der Status des Indexes lautetACTIVE, ist Ihr Index einsatzbereit.

Um einen Index zu erstellen

1. Verwenden Sie den folgenden Befehl, um einen Index zu erstellen. Das 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 Indexes zu überprüfen, verwenden Sie die Index-ID, die create-index mit dem folgenden Befehl zurückgegeben wurde. Wenn der Status des Indexes lautetACTIVE, ist Ihr Index einsatzbereit.

   aws kendra describe-index \
    --index-id index ID
   

Um einen Index zu erstellen

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

  • description—Eine Beschreibung des Indexes, den Sie erstellen. Dieser Schritt ist optional.

  • index_name— Der Name des Indexes, den Sie erstellen.

  • role_arn— Der Amazon-Ressourcenname (ARN) einer Rolle, die ausgeführt werden kann Amazon Kendra APIs. 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.")

Um einen Index zu erstellen

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

  • description—Eine Beschreibung des Indexes, den Sie erstellen. Dieser Schritt ist optional.

  • index_name— Der Name des Indexes, den Sie erstellen.

  • role_arn— Der Amazon-Ressourcenname (ARN) einer Rolle, die ausgeführt werden kann Amazon Kendra APIs. 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.");
      }
  }