Création d'une source Amazon S3 de données

Les exemples suivants illustrent la création d'une source de Amazon S3 données. Les exemples supposent que vous avez déjà créé un index et un IAM rôle autorisés à lire les données de l'index. Pour plus d'informations sur le IAM rôle, consultez la section Rôles IAM d'accès. Pour plus d'informations sur la création d'un index, consultez la section Création d'un index.

CLI

aws kendra create-data-source \
 --index-id index ID \
 --name example-data-source \
 --type S3 \
 --configuration '{"S3Configuration":{"BucketName":"bucket name"}}' 
 --role-arn 'arn:aws:iam::account id:role:/role name

Python

L'extrait de code Python suivant crée une source de Amazon S3 données. Pour un exemple complet, voirDémarrer (AWS SDK for Python (Boto3)).

print("Create an Amazon S3 data source.")
    
    # Provide a name for the data source
    name = "getting-started-data-source"
    # Provide an optional description for the data source
    description = "Getting started data source."
    # Provide the IAM role ARN required for data sources
    role_arn = "arn:aws:iam::${accountID}:role/${roleName}"
    # Provide the data soource connection information
    s3_bucket_name = "S3-bucket-name"
    type = "S3"
    # Configure the data source
    configuration = {"S3DataSourceConfiguration":
        {
            "BucketName": s3_bucket_name
        }
    }

    data_source_response = kendra.create_data_source(
        Configuration = configuration,
        Name = name,
        Description = description,
        RoleArn = role_arn,
        Type = type,
        IndexId = index_id
    )

La création de votre source de données peut prendre un certain temps. Vous pouvez suivre la progression à l'aide de l'DescribeDataSourceAPI. Lorsque le statut de la source de données est ACTIVE défini, la source de données est prête à être utilisée.

Les exemples suivants montrent comment obtenir le statut d'une source de données.

CLI

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

Python

L'extrait de code Python suivant fournit des informations sur une source de données S3. Pour un exemple complet, voirDémarrer (AWS SDK for Python (Boto3)).

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

    while True:
        data_source_description = kendra.describe_data_source(
            Id = "data-source-id",
            IndexId = "index-id"
        )
        status = data_source_description["Status"]
        print(" Creating data source. Status: "+status)
        time.sleep(60)
        if status != "CREATING":
            break

Cette source de données n'a pas de calendrier, elle ne s'exécute donc pas automatiquement. Pour indexer la source de données, vous appelez StartDataSourceSyncJobpour synchroniser l'index avec la source de données.

Les exemples suivants illustrent la synchronisation d'une source de données.

CLI

aws kendra start-data-source-sync-job \
 --index-id index ID \
 --id data source ID

Python

L'extrait de code Python suivant synchronise une Amazon S3 source de données. Pour un exemple complet, voirDémarrer (AWS SDK for Python (Boto3)).

print("Synchronize the data source.")

    sync_response = kendra.start_data_source_sync_job(
        Id = "data-source-id",
        IndexId = "index-id"
    )