

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Usando campos de documentos Amazon Kendra reservados ou comuns
<a name="index-reserved-fields-hiw"></a>

Com a operação [UpdateIndex](https://docs.aws.amazon.com/kendra/latest/APIReference/API_UpdateIndex.html)da API, você pode criar campos reservados ou comuns. Para fazer isso, você usa `DocumentMetadataConfigurationUpdates` e especifica o nome do campo de índice Amazon Kendra reservado para mapear para o attribute/field nome do documento equivalente. Você também pode criar campos personalizados. 

Se você usa um conector de fonte de dados, a maioria inclui mapeamentos de campo que mapeiam os campos do documento da fonte de dados para campos de Amazon Kendra índice. Se usar o console, atualize os campos selecionando a fonte de dados, a ação de edição e, em seguida, prosseguindo para a seção de mapeamentos de campo para configurar a fonte de dados.

Você pode configurar o objeto `Search` para definir um campo como exibível, facetável, pesquisável e classificável. Configure o objeto `Relevance` para definir a ordem de classificação, a duração do aumento ou o período de tempo de um campo a ser aplicado ao aumento, à atualização, ao valor de importância e aos valores de importância mapeados para valores de campo específicos. 

Se usar o console, defina as configurações de pesquisa de um campo selecionando a opção de faceta no menu de navegação. Para definir o ajuste de relevância, selecione a opção de pesquisar o índice no menu de navegação, insira uma consulta e use as opções do painel lateral para ajustar a relevância da pesquisa. Você não pode alterar o tipo de campo depois de criar o campo.

O Amazon Kendra tem os seguintes campos de documento reservados ou comuns que podem ser usados:
+ `_authors`: uma lista de um ou mais autores responsáveis pelo conteúdo do documento.
+ `_category`: uma categoria que coloca um documento em um grupo específico.
+ `_created_at`: a data e a hora no formato ISO 8601 em que o documento foi criado. Por exemplo, 2012-03-25T12:30:10\+01:00 é o formato de data e hora ISO 8601 para 25 de março de 2012 às 12h30 (mais 10 segundos) no horário da Europa Central.
+ `_data_source_id`: o identificador da fonte de dados que contém o documento.
+ `_document_body`: o conteúdo do documento.
+ `_document_id`: o identificador exclusivo do documento.
+ `_document_title`: o título do documento.
+ `_excerpt_page_number`: o número da página em um arquivo PDF em que o trecho do documento aparece. Se o índice foi criado antes de 8 de setembro de 2020, você deve reindexar os documentos antes de poder usar esse atributo.
+ `_faq_id`: se for um documento do tipo pergunta e resposta (Perguntas frequentes), um identificador exclusivo para as Perguntas frequentes.
+ `_file_type`: o tipo de arquivo do documento, como pdf ou doc.
+ `_last_updated_at`: a data e a hora no formato ISO 8601 em que o documento foi atualizado pela última vez. Por exemplo, 2012-03-25T12:30:10\+01:00 é o formato de data e hora ISO 8601 para 25 de março de 2012 às 12h30 (mais 10 segundos) no horário da Europa Central.
+ `_source_uri`: o URI em que o documento está disponível, por exemplo, o URI do documento no site da empresa.
+ `_version`: um identificador para a versão específica de um documento.
+ `_view_count`: o número de vezes que o documento foi visualizado.
+ `_language_code` (string): o código de um idioma que se aplica ao documento. Isso volta para o padrão, inglês, se você não especificar um idioma. Para obter mais informações sobre os idiomas suportados, incluindo os códigos, consulte [Adicionar documentos em outros idiomas além do inglês](https://docs.aws.amazon.com/kendra/latest/dg/in-adding-languages.html).

Você cria campos personalizados usando `DocumentMetadataConfigurationUpdates` com a operação de API `UpdateIndex`, assim como faz ao criar um campo reservado ou comum. Você deve definir o tipo de dados apropriado para o campo personalizado. 

Se usar o console, atualize os campos selecionando a fonte de dados, a ação de edição e, em seguida, prosseguindo para a seção de mapeamentos de campo para configurar a fonte de dados. Algumas fontes de dados não oferecem suporte à adição de novos campos ou campos personalizados. Você não pode alterar o tipo de campo depois de criar o campo.

Estes são os tipos que podem ser definidos para campos personalizados:
+ Data
+ Número
+ String
+ Lista de strings

Se você adicionou documentos a um índice usando a operação fields/attributes da [BatchPutDocument](https://docs.aws.amazon.com/kendra/latest/APIReference/API_BatchPutDocument.html)API, `Attributes` lista seus documentos e cria campos usando o `DocumentAttribute` objeto.

Para documentos indexados de uma fonte de Amazon S3 dados, você cria campos usando um [arquivo de metadados JSON](https://docs.aws.amazon.com/kendra/latest/dg/s3-metadata.html) que inclui as informações dos campos.

Ao usar um banco de dados compatível como fonte de dados, poderá configura os campos usando a [opção de mapeamentos de campo](https://docs.aws.amazon.com/kendra/latest/dg/data-source-database.html#data-source-procedure-database).