데이터 소스 필드 매핑

Amazon Kendra 데이터 소스 커넥터는 데이터 소스의 문서 또는 콘텐츠 필드를 Amazon Kendra 인덱스의 필드에 매핑할 수 있습니다. 기본적으로 각 커넥터는 특정 데이터 소스 필드를 크롤링하도록 설계되었습니다. 기본 데이터 소스 필드와 해당 속성은 변경하거나 사용자 지정할 수 없습니다. Amazon Kendra 콘솔에서 편집할 수 없는 기본 필드와 기본 필드 속성은 회색으로 표시됩니다.

Amazon Kendra 또한 커넥터를 사용하면 데이터 소스의 사용자 지정 문서 또는 콘텐츠 필드를 인덱스의 사용자 지정 필드에 매핑할 수 있습니다. 예를 들어, 데이터 소스에 문서의 부서 정보가 포함된 “dept”라는 필드가 있는 경우, “Department”라는 인덱스 필드에 매핑할 수 있습니다. 이렇게 하면 문서를 쿼리할 때 필드를 사용할 수 있습니다.

와 같은 Amazon Kendra 예약 필드 또는 일반 필드를 매핑할 수도 있습니다_created_at. 데이터 소스에 "creation_date"라는 필드가 있는 경우 이를 라는 동등한 Amazon Kendra 예약 필드에 매핑할 수 있습니다_created_at. Amazon Kendra 예약 필드에 대한 자세한 내용은 문서 속성 또는 필드를 참조하세요.

대부분의 데이터 소스에 대해 필드를 매핑할 수 있습니다. 다음 데이터 소스에 대한 필드 매핑을 만들 수 있습니다.

문서를 S3 버킷 또는 S3 데이터 소스에 저장하는 경우 JSON 메타데이터 파일을 사용하여 필드를 지정합니다. 자세한 내용은 S3 데이터 소스 커넥터를 참고하세요.

데이터 소스 필드를 인덱스 필드에 매핑하는 과정은 다음과 같이 3단계입니다.

인덱스를 업데이트하여 사용자 지정 필드를 추가하려면 콘솔을 사용하여 데이터 소스 필드 매핑을 편집하고 사용자 지정 필드를 추가하거나 UpdateIndex API를 사용합니다. 인덱스에 총 500개의 사용자 지정 필드를 추가할 수 있습니다.

데이터베이스 데이터 소스의 경우 데이터베이스 열의 이름이 예약된 필드의 이름과 일치하면 필드와 열이 자동으로 매핑됩니다.

UpdateIndex API를 사용하면 DocumentMetadataConfigurationUpdates를 사용하여 예약 및 사용자 지정 필드를 추가할 수 있습니다.

다음 JSON 예제는 DocumentMetadataConfigurationUpdates를 사용하여 “Department”라는 필드를 인덱스에 추가합니다.

"DocumentmetadataConfigurationUpdates": [
   {
       "Name": "Department",
       "Type": "STRING_VALUE"
   }
]

필드를 생성할 때 해당 필드가 검색에 사용되는 방식을 설정할 수 있습니다. 사용자는 다음 중에서 선택할 수 있습니다.

다음 JSON 예제는 DocumentMetadataConfigurationUpdates를 사용하여 “Department”라는 필드를 인덱스에 추가하고 facetable로 표시합니다.

"DocumentMetadataConfigurationUpdates": [
   {
       "Name": "Department",
       "Type": "STRING_VALUE",
       "Search": {
           "Facetable": true
       }
   }
]

Amazon Kendra 예약 또는 일반 문서 필드 사용

UpdateIndex API를 사용하면 DocumentMetadataConfigurationUpdates를 사용하고 Amazon Kendra 예약 인덱스 필드 이름을 지정하여 예약된 필드 또는 공통 필드를 생성하여 동등한 문서 속성/필드 이름에 매핑할 수 있습니다. 사용자 지정 필드도 생성할 수 있습니다. 데이터 소스 커넥터를 사용하는 경우 데이터 소스 문서 필드를 Amazon Kendra 인덱스 필드에 매핑하는 필드 매핑을 대부분 포함합니다. 콘솔을 사용하는 경우 데이터 소스를 선택하고 편집 작업을 선택한 다음 데이터 소스 구성을 위한 필드 매핑 섹션 옆으로 이동하여 필드를 업데이트합니다.

필드를 displayable, facetable, searchable, sortable로 설정하도록 Search 객체를 구성할 수 있습니다. 필드의 순위 순서, 부스트 기간 또는 부스팅에 적용할 기간, 최신성, 중요도 값 및 특정 필드 값에 매핑된 중요도 값을 설정하도록 Relevance 객체를 구성할 수 있습니다. 콘솔을 사용하는 경우 탐색 메뉴에서 패싯 옵션을 선택하여 필드에 대한 검색 설정을 지정할 수 있습니다. 관련성 조정을 설정하려면 탐색 메뉴에서 인덱스를 검색하는 옵션을 선택하고 쿼리를 입력한 다음 사이드 패널 옵션을 사용하여 검색 관련성을 조정합니다. 필드를 생성한 후에는 필드 유형을 변경할 수 없습니다.

Amazon Kendra 에는 사용할 수 있는 다음과 같은 예약 또는 공통 문서 필드가 있습니다.

사용자 지정 필드의 경우 예약된 필드 또는 공통 필드를 만들 때와 마찬가지로 UpdateIndex API와 DocumentMetadataConfigurationUpdates를 사용하여 이러한 필드를 만듭니다. 사용자 지정 필드에 적절한 데이터 유형을 설정해야 합니다. 콘솔을 사용하는 경우 데이터 소스를 선택하고 편집 작업을 선택한 다음 데이터 소스 구성을 위한 필드 매핑 섹션 옆으로 이동하여 필드를 업데이트합니다. 일부 데이터 소스는 새 필드 또는 사용자 지정 필드 추가를 지원하지 않습니다. 필드를 생성한 후에는 필드 유형을 변경할 수 없습니다.

사용자 지정 필드에 설정할 수 있는 유형은 다음과 같습니다.

BatchPutDocument API를 사용하여 인덱스에 문서를 추가한 경우, Attributes는 문서의 필드/속성을 나열하고 DocumentAttribute 객체를 사용하여 필드를 생성합니다.

Amazon S3 데이터 소스에서 인덱싱된 문서의 경우 필드 정보가 포함된 JSON 메타데이터 파일을 사용하여 필드를 생성합니다.

지원되는 데이터베이스를 데이터 소스로 사용하는 경우 필드 매핑 옵션을 사용하여 필드를 구성할 수 있습니다.