本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 對應資料來源欄位
<a name="field-mapping"></a>

Amazon Kendra 資料來源連接器可以將文件或內容欄位從資料來源映射到 Amazon Kendra 索引中的欄位。根據預設，每個連接器都是設計用來編目特定資料來源欄位。預設資料來源欄位及其屬性無法變更或自訂。在 Amazon Kendra 主控台上，無法編輯的預設欄位和預設欄位屬性會顯示為灰色。

Amazon Kendra 連接器也可讓您將自訂文件或內容欄位從資料來源映射至索引中的自訂欄位。例如，如果您的資料來源中有名為 "dept" 的欄位，其中包含文件的部門資訊，您可以將其對應至名為 "Department" 的索引欄位。如此一來，您可以在查詢文件時使用 欄位。

您也可以映射 Amazon Kendra 預留或常見欄位，例如 `_created_at`。如果您的資料來源有名為 "creation\$1date" 的欄位，您可以將其對應至名為 的同等 Amazon Kendra 預留欄位`_created_at`。如需 Amazon Kendra 預留欄位的詳細資訊，請參閱[文件屬性或欄位](https://docs.aws.amazon.com/kendra/latest/dg/hiw-document-attributes.html)。

您可以映射大多數資料來源的欄位。您可以為下列資料來源建立欄位映射：
+ Adobe Experience Manager
+ Alfresco
+ Aurora (MySQL)
+ Aurora (PostgreSQL)
+ Amazon FSx (Windows)
+ Amazon FSx (NetApp ONTAP)
+ Amazon RDS/Aurora
+ Amazon RDS (Microsoft SQL Server)
+ Amazon RDS (MySQL)
+ Amazon RDS ( Oracle)
+ Amazon RDS (PostgreSQL)
+ Amazon Kendra Web 爬蟲程式
+ WorkDocs
+ Box (立方體)
+ Confluence
+ Dropbox
+ Drupal
+ GitHub
+ Google 工作區硬碟
+ Gmail
+ IBM DB2
+ Jira
+ Microsoft Exchange
+ Microsoft OneDrive
+ Microsoft SharePoint
+ Microsoft Teams
+ Microsoft SQL Server
+ Microsoft Yammer
+ MySQL
+ Oracle Database
+ PostgreSQL
+ Quip
+ Salesforce
+ ServiceNow
+ Slack
+ Zendesk

如果您將文件存放在 S3 儲存貯體或 S3 資料來源中，您可以使用 JSON 中繼資料檔案指定欄位。如需詳細資訊，請參閱 [S3 資料來源連接器](https://docs.aws.amazon.com/kendra/latest/dg/data-source-s3.html)。

將資料來源欄位映射至索引欄位是一個三步驟的程序：

1. 建立索引。如需詳細資訊，請參閱[建立索引](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html)。

1. 更新索引以新增欄位。

1. 建立資料來源，並包含欄位映射以對應預留欄位，以及任何自訂欄位以編製欄位 Amazon Kendra 索引。

若要更新索引以新增自訂欄位，請使用 主控台編輯資料來源欄位映射，並新增自訂欄位或使用 [UpdateIndex](https://docs.aws.amazon.com/kendra/latest/APIReference/API_UpdateIndex.html) API。您總共可以將 500 個自訂欄位新增至您的索引。

對於資料庫資料來源，如果資料庫資料欄的名稱符合預留欄位的名稱，則欄位和資料欄會自動映射。

使用 [UpdateIndex](https://docs.aws.amazon.com/kendra/latest/APIReference/API_UpdateIndex.html) API，您可以使用 新增預留和自訂欄位`DocumentMetadataConfigurationUpdates`。

下列 JSON 範例示範如何使用 `DocumentMetadataConfigurationUpdates` 將名為「部門」的欄位新增至索引。

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

當您建立 欄位時，您可以選擇設定 欄位用於搜尋的方式。您可以選擇下列項目：
+ **可顯示** - 決定是否在查詢回應中傳回 欄位。預設值為 `true`。
+ **Facetable** - 表示 欄位可用於建立面向。預設值為 `false`。
+ **可搜尋** - 決定是否在搜尋中使用 欄位。字串欄位的預設值是 `true`，以及數字和日期欄位的預設值是 `false`。
+ **可排序** - 表示 欄位可用來排序查詢的回應。只能設定日期、數字和字串欄位。無法為字串清單欄位設定 。

下列 JSON 範例使用 `DocumentMetadataConfigurationUpdates`將名為 "Department" 的欄位新增至索引，並將其標記為面向。

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

## 使用 Amazon Kendra 預留或通用文件欄位
<a name="index-reserved-fields"></a>

使用 [UpdateIndex API](https://docs.aws.amazon.com/kendra/latest/APIReference/API_UpdateIndex.html)，您可以使用 建立預留或通用欄位，`DocumentMetadataConfigurationUpdates` Amazon Kendra 並指定預留索引欄位名稱以對應至同等文件屬性/欄位名稱。您也可以建立自訂欄位。如果您使用資料來源連接器，大多數包含將資料來源文件欄位映射至 Amazon Kendra 索引欄位的欄位映射。如果您使用 主控台，您可以透過選取資料來源、選取編輯動作，然後在欄位映射區段旁繼續設定資料來源，來更新欄位。

您可以設定 `Search` 物件，將欄位設定為可顯示、可面向、可搜尋和可排序。您可以設定 `Relevance` 物件來設定欄位的排名順序、提升持續時間或時段，以套用至映射至特定欄位值的提升、新鮮度、重要性值和重要性值。如果您使用 主控台，您可以在導覽功能表中選取面向選項來設定欄位的搜尋設定。若要設定相關性調校，請選取導覽選單中搜尋索引的選項，輸入查詢，然後使用側邊面板選項調校搜尋相關性。建立欄位後，就無法變更欄位類型。

Amazon Kendra 具有下列預留或常用文件欄位，您可以使用：
+ `_authors`- 負責文件內容的一或多個作者清單。
+ `_category`- 在特定群組中放置文件的類別。
+ `_created_at`- 建立文件的日期和時間，採用 ISO 8601 格式。例如，2012-03-25T12:30:10\$101:00 是以 ISO 8601 日期時間格式表示的歐洲中部時間 2012 年 3 月 25 日中午 12:30 (加上 10 秒)。
+ `_data_source_id`- 包含文件之資料來源的識別符。
+ `_document_body`- 文件的內容。
+ `_document_id`- 文件的唯一識別符。
+ `_document_title`- 文件的標題。
+ `_excerpt_page_number`- 出現文件摘錄的 PDF 檔案中的頁碼。如果您的索引是在 2020 年 9 月 8 日之前建立的，您必須先重新索引文件，才能使用此屬性。
+ `_faq_id`—如果這是問答類型文件 (FAQ)，則為常見問答集的唯一識別符。
+ `_file_type`— 文件的檔案類型，例如 pdf 或 doc。
+ `_last_updated_at`- 上次更新文件的 ISO 8601 格式日期和時間。例如，2012-03-25T12:30:10\$101:00 是以 ISO 8601 日期時間格式表示的歐洲中部時間 2012 年 3 月 25 日中午 12:30 (加上 10 秒)。
+ `_source_uri`- 文件可用的 URI。例如，公司網站上的文件 URI。
+ `_version`- 文件特定版本的識別符。
+ `_view_count`— 文件已檢視的次數。
+ `_language_code` （字串） — 適用於文件的語言程式碼。如果您未指定語言，則預設為英文。如需支援語言的詳細資訊，包括其代碼，請參閱[新增英文以外語言的文件](https://docs.aws.amazon.com/kendra/latest/dg/in-adding-languages.html)。

對於自訂欄位，您可以使用 `DocumentMetadataConfigurationUpdates`搭配 `UpdateIndex` API 來建立這些欄位，就像您在建立預留或通用欄位時一樣。您必須為自訂欄位設定適當的資料類型。如果您使用 主控台，您可以透過選取資料來源、選取編輯動作，然後在欄位映射區段旁繼續設定資料來源，來更新欄位。有些資料來源不支援新增欄位或自訂欄位。建立欄位後，就無法變更欄位類型。

以下是您可以為自訂欄位設定的類型：
+ Date
+ Number
+ String
+ 字串清單

如果您使用 [BatchPutDocument](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BatchPutDocument.html) API 將文件新增至索引， 會`Attributes`列出文件的欄位/屬性，並使用 `DocumentAttribute` 物件建立欄位。

對於從 Amazon S3 資料來源編製索引的文件，您可以使用包含欄位資訊的 [JSON 中繼資料檔案](https://docs.aws.amazon.com/kendra/latest/dg/s3-metadata.html)建立欄位。

如果您使用支援的資料庫做為資料來源，您可以使用欄位[映射選項來設定欄位](https://docs.aws.amazon.com/kendra/latest/dg/data-source-database.html#data-source-procedure-database)。