Executando um trabalho de tradução em lote - Amazon Translate

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á.

Executando um trabalho de tradução em lote

Você pode executar um trabalho de tradução em lote usando o console do Amazon Translate AWS CLI, o ou o Amazon TranslateAPI.

nota

Os trabalhos de tradução em lote são operações de longa duração e podem levar um tempo significativo para serem concluídos. Por exemplo, a tradução em lote em um conjunto de dados pequeno pode levar alguns minutos, enquanto conjuntos de dados muito grandes podem levar até 2 dias ou mais para serem traduzidos. O tempo de conclusão também depende da disponibilidade de recursos.

Para executar um trabalho de tradução usando o console do Amazon Translate, use a página Tradução em lote para criar o trabalho:

  1. Abra o console do Amazon Translate.

  2. No menu de navegação à esquerda, escolha Tradução em lote.

  3. Na página Trabalhos de tradução, escolha Criar trabalho. O console mostra a página Criar trabalho de tradução.

  4. Em Configurações do trabalho, faça o seguinte:

    1. Em Nome, insira um nome personalizado para o trabalho de tradução em lote.

    2. Em Idioma de origem, selecione o idioma dos arquivos de origem. Se você não souber o idioma dos arquivos de origem ou se seus documentos de entrada contiverem idiomas de origem diferentes, selecione auto. O Amazon Translate detecta automaticamente o idioma de origem de cada arquivo.

    3. Em Idiomas de destino, selecione até 10 idiomas. O Amazon Translate traduz cada arquivo de origem para cada idioma de destino.

  5. Em Dados de entrada, faça o seguinte:

    1. Para a Localização do Input S3, especifique a pasta de entrada que contém os arquivos de origem da tradução no Amazon S3. Para fornecer a pasta navegando até ela no Amazon S3, escolha Selecionar pasta.

    2. Em Formato do arquivo, selecione o formato dos arquivos de origem da tradução.

  6. Em Dados de saída, faça o seguinte:

    1. Para a localização do Output S3, especifique a pasta de saída no Amazon S3 onde o Amazon Translate coloca a saída da tradução. Para fornecer a pasta navegando até ela no Amazon S3, escolha Selecionar pasta.

    2. Opcionalmente, escolha Personalizar configurações de criptografia (avançadas) se quiser criptografar sua saída com uma chave gerenciada pelo cliente que você gerencia no AWS Key Management Service ()AWS KMS.

      Por padrão, o Amazon Translate criptografa sua saída de tradução usando uma KMS chave que é criada, gerenciada e usada em seu nome pela AWS. Escolha essa opção se quiser criptografar sua saída com sua própria KMS chave.

      Se você quiser usar uma KMS chave da AWS conta atual, selecione-a em Escolher uma AWS Key Management Service chave. Ou, se você quiser usar uma KMS chave de uma AWS conta diferente, insira o Amazon Resource Name (ARN) para essa chave.

      nota

      Antes de usar sua própria KMS chave, você deve adicionar permissões à função de serviço do Amazon Translate inIAM. Se quiser usar uma KMS chave de uma conta diferente, você também deve atualizar a política de chaves em AWS KMS. Para obter mais informações, consulte Permissões de pré-requisito para personalizar a criptografia.

  7. Em Personalizações: opcional, você pode escolher personalizar a saída do trabalho de tradução com as seguintes configurações:

    Palavrões

    Mascara palavrões no resultado da tradução. Se você especificar vários idiomas de destino para o trabalho, todos os idiomas de destino devem permitir o mascaramento de palavrões. Se algum dos idiomas de destino não permitir o mascaramento de palavrões, o trabalho de tradução não mascarará o uso de palavrões em nenhum idioma de destino.

    Para obter mais informações, consulte Mascarando palavras e frases profanas no Amazon Translate.

    Brevidade

    O Amazon Translate não oferece suporte à brevidade para trabalhos de tradução em lote.

    Para obter mais informações, consulte Usando brevidade no Amazon Translate.

    Formalidade

    Para alguns idiomas de destino, você pode definir Formalidade como formal ou informal. Se você especificar vários idiomas de destino para o trabalho, o Translate ignorará a configuração de formalidade para qualquer idioma de destino incompatível.

    Para obter mais informações, consulte Definindo a formalidade no Amazon Translate.

    Terminologia personalizada

    Consiste em exemplos de termos de origem e na tradução desejada para cada termo. Se você especificar vários idiomas de destino para o trabalho, o Translate usará a terminologia designada para cada idioma de destino solicitado que tenha uma entrada para o termo de origem no arquivo de terminologia.

    Para obter mais informações, consulte Personalizando suas traduções com terminologia personalizada.

    Dados paralelos

    Consiste de exemplos que mostram como você deseja que segmentos de texto sejam traduzidos. Se você especificar vários idiomas de destino para o trabalho, o arquivo de dados paralelo deverá incluir traduções para todos os idiomas de destino.

    Ao adicionar dados paralelos a um trabalho de tradução em lote, você cria um trabalho de Tradução personalizada ativa.

    nota

    Os trabalhos de tradução personalizada ativa têm um preço mais alto do que outros trabalhos que não usam dados paralelos. Para obter mais informações, consulte Preços do Amazon Translate.

    Para obter mais informações, consulte Personalizando suas traduções com dados paralelos (Tradução personalizada ativa).

  8. Em Permissões de acesso, forneça ao Amazon Translate uma IAM função que conceda as permissões necessárias para seus arquivos de entrada e saída no Amazon S3:

    • Se você já tem essa IAM função em sua conta, escolha Usar uma IAM função existente e selecione-a em IAMFunção.

    • Se você ainda não tem essa IAM função em sua conta, escolha Criar uma IAM função. Para IAMfunção, escolha buckets S3 de entrada e saída. Em Nome do perfil, forneça um nome personalizado. Ao criar o trabalho de tradução, o Amazon Translate cria o perfil automaticamente. O nome da função em IAM é prefixado com AmazonTranslateServiceRole-.

      nota

      Se você optar por criptografar sua saída de tradução com sua própria KMS chave, não poderá escolher Criar uma IAM função. Nesse caso, você deve usar uma IAM função preexistente e sua KMS chave deve ter uma política de chaves que permita que a função use a chave.

      Para ter mais informações, consulte Permissões de pré-requisito para personalizar a criptografia

  9. Escolha Criar trabalho.

    O console retorna à página Trabalhos de tradução, onde o status da criação do trabalho é mostrado em um banner na parte superior da página. Após alguns minutos, seu trabalho é exibido na tabela.

  10. Escolha o nome do trabalho na coluna Nome para abrir a página de detalhes do trabalho.

    Enquanto o trabalho de tradução é executado, o campo Status mostra Em andamento.

  11. Quando o status for Concluído, acesse o resultado da tradução escolhendo o link em Local do arquivo de saída. O console vai até o seu bucket de saída no Amazon S3.

  12. Para baixar seus arquivos de saída, marque a caixa de seleção de cada um e escolha Download.

Para executar um trabalho de tradução usando o AWS CLI, use o start-text-translation-jobcomando e especifique o nome do seu recurso de dados paralelo para o parallel-data-names parâmetro.

exemplo tart-text-translation-job Comando S

O exemplo a seguir executa um trabalho de tradução enviando um arquivo do Excel que é armazenado em um bucket de entrada no Amazon S3. Esse trabalho é personalizado pelos dados paralelos incluídos na solicitação.

$ aws translate start-text-translation-job \
> --input-data-config ContentType=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet,S3Uri=s3://amzn-s3-demo-bucket/input/ \
> --output-data-config S3Uri=s3://amzn-s3-demo-bucket/output/ \
> --data-access-role-arn arn:aws:iam::111122223333:role/my-iam-role \
> --source-language-code en \
> --target-language-codes es it \
> --job-name my-translation-job

Se o comando for bem-sucedido, o Amazon Translate responderá com o ID e status de trabalho:

{
    "JobId": "4446f95f20c88a4b347449d3671fbe3d",
    "JobStatus": "SUBMITTED"
}

Se quiser personalizar a saída do seu trabalho de tradução, é possível usar os seguintes parâmetros:

--settings

Configurações para configurar sua saída de tradução, incluindo as seguintes opções:

Ative a brevidade na saída da tradução. O Amazon Translate não oferece suporte à brevidade para trabalhos de tradução em lote. Para obter mais informações, consulte Usando brevidade no Amazon Translate.

Habilite palavrões para mascarar palavras e frases profanas. Para habilitar, defina o parâmetro de palavrões para Profanity=MASK. Para obter mais informações, consulte Mascarando palavras e frases profanas no Amazon Translate. Se algum dos idiomas de destino não permitir o mascaramento de palavrões, o trabalho de tradução não mascarará o uso de palavrões em nenhum idioma de destino.

Defina o nível de formalidade na saída da tradução. Defina o parâmetro Formality como FORMAL ouINFORMAL. Se você especificar vários idiomas de destino para o trabalho, o Translate ignorará a configuração de formalidade para qualquer idioma de destino incompatível. Para obter mais informações, consulte Definindo a formalidade no Amazon Translate.

--terminology-names

O nome de um recurso de terminologia personalizada a ser adicionado ao trabalho de tradução. Este recurso lista exemplos de termos de origem e a tradução desejada para cada termo. Se você especificar vários idiomas de destino para o trabalho, o Translate usará a terminologia designada para cada idioma de destino solicitado que tenha uma entrada para o termo de origem no arquivo de terminologia.

Esse parâmetro aceita somente um recurso de terminologia personalizada.

Para obter uma lista dos recursos de terminologia personalizada disponíveis, use o comando list-terminologies.

Para obter mais informações, consulte Personalizando suas traduções com terminologia personalizada.

--parallel-data-names

O nome de um recurso de dados paralelo a ser adicionado ao trabalho de tradução. Esse recurso consiste em exemplos que mostram como você deseja que segmentos de texto sejam traduzidos. Se você especificar vários idiomas de destino para o trabalho, o arquivo de dados paralelo deverá incluir traduções para todos os idiomas de destino.

Ao adicionar dados paralelos a um trabalho de tradução, você cria um trabalho de Tradução personalizada ativa.

Esse parâmetro aceita somente um recurso de dados paralelos.

nota

Os trabalhos de tradução personalizada ativa têm um preço mais alto do que outros trabalhos que não usam dados paralelos. Para obter mais informações, consulte Preços do Amazon Translate.

Para obter uma lista dos recursos de dados paralelos disponíveis, use o comando list-parallel-data.

Para obter mais informações, consulte Personalizando suas traduções com dados paralelos (Tradução personalizada ativa).

Para verificar o status do seu trabalho de tradução, use o comando describe-text-translation-job.

exemplo escribe-text-translation-job Comando D

O exemplo a seguir verifica o status do trabalho fornecendo o ID do trabalho. Essa ID foi fornecida pelo Amazon Translate quando o trabalho foi iniciado pelo comando start-text-translation-job.

$ aws translate describe-text-translation-job \
> --job-id 4446f95f20c88a4b347449d3671fbe3d

O Amazon Translate responde com as propriedades do trabalho, que incluem seu status:

{
    "TextTranslationJobProperties": {
        "JobId": "4446f95f20c88a4b347449d3671fbe3d",
        "JobName": "my-translation-job",
        "JobStatus": "COMPLETED",
        "JobDetails": {
            "TranslatedDocumentsCount": 0,
            "DocumentsWithErrorsCount": 0,
            "InputDocumentsCount": 1
        },
        "SourceLanguageCode": "en",
        "TargetLanguageCodes": [
            "es", 
            "it" 
        ],
        "SubmittedTime": 1598661012.468,
        "InputDataConfig": {
            "S3Uri": "s3://amzn-s3-demo-bucket/input/",
            "ContentType": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
        },
        "OutputDataConfig": {
            "S3Uri": "s3://amzn-s3-demo-bucket/output/111122223333-TranslateText-4446f95f20c88a4b347449d3671fbe3d/"
        },
        "DataAccessRoleArn": "arn:aws:iam::111122223333:role/my-iam-role"
    }
}

Se o valor JobStatus for IN_PROGRESS, aguarde alguns minutos e execute describe-text-translation-job novamente até que o status seja COMPLETED. Quando o trabalho for concluído, você poderá baixar os resultados da tradução no local fornecido pelo campo S3Uri abaixoOutputDataConfig.

Para enviar um trabalho de tradução em lote usando o Amazon TranslateAPI, use a StartTextTranslationJoboperação.