Migrar para v3.x do contêiner de leitura OCR

  • Artigo

Se você estiver usando a versão 2 do contêiner Azure AI Vision Read OCR, use este artigo para saber como atualizar seu aplicativo para usar a versão 3.x do contêiner.

Alterações da API

O contêiner Read v3.2 usa a versão 3 da API do Azure AI Vision e tem os seguintes pontos de extremidade:

  • /vision/v3.2/read/analyzeResults/{operationId}
  • /vision/v3.2/read/analyze
  • /vision/v3.2/read/syncAnalyze

Consulte o guia de migração da API REST do Azure AI Vision v3 para obter informações detalhadas sobre como atualizar seus aplicativos para usar a versão 3 da API de leitura. As operações síncronas só são suportadas em contêineres.

Alterações de configuração

  • ReadEngineConfig:ResultExpirationPeriod não é mais suportado. O contêiner Read OCR tem um trabalho Cron construído que remove os resultados e metadados associados a uma solicitação após 48 horas.
  • Cache:Redis:Configuration não é mais suportado. O cache não é usado nos contêineres v3.x, portanto, você não precisa configurá-lo.

Requisitos de memória

Os requisitos e recomendações são baseados em benchmarks com uma única solicitação por segundo, usando uma imagem de 523 KB de uma carta comercial digitalizada que contém 29 linhas e um total de 803 caracteres. A tabela a seguir descreve as alocações mínimas e recomendadas de recursos para cada contêiner de OCR de leitura.

Contentor Mínimo Recomendado
Ler 3.2 2022-04-30 4 núcleos, 8 GB de memória 8 núcleos, 16 GB de memória

Cada núcleo deve ter pelo menos 2,6 gigahertz (GHz) ou mais rápido.

O núcleo e a memória correspondem às --cpus configurações e --memory , que são usadas como parte do comando docker run.

Implementações de armazenamento

Nota

O MongoDB não é mais suportado nas versões 3.x do contêiner. Em vez disso, os contêineres dão suporte ao Armazenamento do Azure e aos sistemas de arquivos offline.

Implementação Argumento(s) de tempo de execução necessário(s)
Nível de arquivo (padrão) Não são necessários argumentos de tempo de execução. /share será usado.
Blob do Azure Storage:ObjectStore:AzureBlob:ConnectionString={AzureStorageConnectionString}

Implementações de fila

Na v3.x do contêiner, o RabbitMQ não é suportado no momento. As implementações de suporte suportadas são:

Implementação Argumento(s) de tempo de execução Utilização prevista
Na memória (padrão) Não são necessários argumentos de tempo de execução. Desenvolvimento e teste
Filas do Azure Queue:Azure:ConnectionString={AzureStorageConnectionString} Produção
RabbitMQ Indisponível Produção

Para redundância adicional, o contêiner Read v3.x usa um temporizador de visibilidade para garantir que as solicitações possam ser processadas com êxito se ocorrer uma falha durante a execução em uma configuração de vários contêineres.

Defina o temporizador com Queue:Azure:QueueVisibilityTimeoutInMilliseconds, que define o tempo para uma mensagem ficar invisível quando outro trabalhador a estiver processando. Para evitar que as páginas sejam processadas de forma redundante, recomendamos definir o período de tempo limite para 120 segundos. O valor padrão é 30 segundos.

Default value Valor recomendado
30000 120000

Próximos passos