Partilhar via

Ajuste de desempenho para uploads e downloads com JavaScript

  • Artigo

Quando um aplicativo transfere dados usando a biblioteca de cliente do Armazenamento do Azure para JavaScript, há vários fatores que podem afetar a velocidade, o uso de memória e até mesmo o sucesso ou falha da solicitação. Para maximizar o desempenho e a confiabilidade das transferências de dados, é importante ser proativo na configuração das opções de transferência da biblioteca do cliente com base no ambiente em que seu aplicativo é executado.

Este artigo apresenta várias considerações para ajustar as opções de transferência de dados. Quando ajustada corretamente, a biblioteca do cliente pode distribuir dados de forma eficiente entre várias solicitações, o que pode resultar em maior velocidade de operação, uso de memória e estabilidade de rede.

Ajuste de desempenho para uploads

Ajustar corretamente as opções de transferência de dados é a chave para um desempenho confiável para uploads. As transferências de armazenamento são particionadas em várias subtransferências com base nos valores desses argumentos. O tamanho máximo de transferência suportado varia de acordo com a operação e a versão do serviço, portanto, certifique-se de verificar a documentação para determinar os limites. Para obter mais informações sobre limites de tamanho de transferência para armazenamento de Blob, consulte Dimensionar destinos para armazenamento de Blob.

Definir opções de transferência para carregamentos

Você pode configurar propriedades em BlockBlobParallelUploadOptions para melhorar o desempenho das operações de transferência de dados. A tabela a seguir lista as propriedades que você pode configurar, juntamente com uma descrição:

Property Description
blockSize O tamanho máximo do bloco a ser transferido para cada solicitação como parte de uma operação de carregamento. Para saber mais, consulte blockSize.
maxSingleShotSize Se o tamanho dos dados for menor ou igual a esse valor, eles serão carregados em uma única colocação, em vez de divididos em partes. Se os dados forem carregados em uma única captura, o tamanho do bloco será ignorado. O valor padrão é 256 MB. Se você personalizar essa propriedade, deverá usar um valor menor ou igual a 256 MB. Para saber mais, consulte maxSingleShotSize.
concurrency O número máximo de solicitações paralelas que são emitidas a qualquer momento como parte de uma única transferência paralela.

Nota

As bibliotecas de cliente usarão padrões para cada opção de transferência de dados, se não forem fornecidas. Esses padrões geralmente têm desempenho em um ambiente de data center, mas provavelmente não são adequados para ambientes de consumidores domésticos. Opções de transferência de dados mal ajustadas podem resultar em operações excessivamente longas e até mesmo tempos limite de solicitação. É melhor ser proativo ao testar esses valores e ajustá-los com base nas necessidades do seu aplicativo e ambiente.

maxSingleShotSize

O maxSingleShotSize valor é o tamanho máximo de blob em bytes para um único carregamento de solicitação.

Se o tamanho dos dados for menor ou igual a maxSingleShotSize, o blob será carregado com uma única solicitação Put Blob . Se o tamanho do blob for maior que maxSingleShotSize, ou se o tamanho do blob for desconhecido, o blob será carregado em partes usando uma série de chamadas Put Block seguidas por Put Block List.

É importante observar que o valor especificado para blockSize não limita o valor definido para maxSingleShotSize. O maxSingleShotSize argumento define uma limitação de tamanho separada para uma solicitação para executar toda a operação de uma só vez, sem subtransferências. Muitas vezes, você quer maxSingleShotSize ser pelo menos tão grande quanto o valor definido para blockSize, se não maior. Dependendo do tamanho da transferência de dados, essa abordagem pode ser mais eficiente, pois a transferência é concluída com uma única solicitação e evita a sobrecarga de várias solicitações.

Se você não tiver certeza de qual valor é melhor para sua situação, uma opção segura é definir maxSingleShotSize para o mesmo valor usado para blockSize.

tamanho do bloco

O blockSize valor é o comprimento máximo de uma transferência em bytes ao carregar um blob de bloco em partes.

Como mencionado anteriormente, este valor não limita maxSingleShotSize, que pode ser maior do que blockSize.

Para manter os dados em movimento de forma eficiente, as bibliotecas de cliente nem sempre atingem o blockSize valor de cada transferência. Dependendo da operação, o valor máximo suportado para o tamanho da transferência pode variar. Para obter mais informações sobre limites de tamanho de transferência para armazenamento de Blob, consulte o gráfico em Dimensionar destinos para armazenamento de Blob.

Exemplo de código

O exemplo de código a seguir mostra como definir valores para BlockBlobParallelUploadOptions e incluir as opções como parte de uma chamada de método de upload. Os valores fornecidos nas amostras não pretendem ser uma recomendação. Para ajustar corretamente esses valores, você precisa considerar as necessidades específicas do seu aplicativo.

// Specify data transfer options
const uploadOptions = {
  blockSize: 4 * 1024 * 1024, // 4 MiB max block size
  concurrency: 2, // maximum number of parallel transfer workers
  maxSingleShotSize: 8 * 1024 * 1024, // 8 MiB initial transfer size
} 

// Create blob client from container client
const blockBlobClient = containerClient.getBlockBlobClient(blobName);

// Upload blob with transfer options
await blockBlobClient.uploadFile(localFilePath, uploadOptions);

Neste exemplo, definimos o número máximo de trabalhadores de transferência paralela como 2 usando a concurrency propriedade. Também definimos maxSingleShotSize para 8 MiB. Se o tamanho do blob for menor que 8 MiB, apenas uma única solicitação será necessária para concluir a operação de upload. Se o tamanho do blob for maior que 8 MiB, o blob será carregado em pedaços com um tamanho máximo de bloco de 4 MiB, que definimos na blockSize propriedade.

Considerações de desempenho para uploads

Durante um upload, as bibliotecas de cliente de armazenamento dividem um determinado fluxo de upload em vários subcarregamentos com base nas opções de configuração definidas pelo BlockBlobParallelUploadOptions. Cada subupload tem sua própria chamada dedicada para a operação REST. Neste exemplo, a operação é Put Block. A biblioteca do cliente de armazenamento gerencia essas operações REST em paralelo (dependendo das opções de transferência) para concluir o carregamento completo.

Nota

Os blobs de bloco têm uma contagem máxima de blocos de 50.000 blocos. O tamanho máximo do blob de bloco, então, é de 50.000 vezes block_size.

Armazenamento em buffer durante carregamentos

A camada REST de armazenamento não suporta pegar uma operação de upload REST de onde você parou; As transferências individuais são concluídas ou perdidas. Para garantir a resiliência para uploads de fluxo, as bibliotecas do cliente de armazenamento armazenam em buffer dados para cada chamada REST individual antes de iniciar o carregamento. Além das limitações de velocidade da rede, esse comportamento de buffer é um motivo para considerar um valor menor para blockSize, mesmo ao carregar em sequência. Diminuir o valor de blockSize diminui a quantidade máxima de dados armazenados em buffer em cada solicitação e cada nova tentativa de uma solicitação com falha. Se você estiver enfrentando tempos limite frequentes durante transferências de dados de um determinado tamanho, reduzir o valor de reduz o tempo de blockSize buffer e pode resultar em melhor desempenho.

Ajuste de desempenho para downloads

O ajuste das opções de transferência de dados para downloads está disponível somente ao usar o método downloadToBuffer . Esse método baixa um blob em paralelo a um buffer com base nos valores definidos em BlobDownloadToBufferOptions. Outros métodos de download não suportam ajustar as opções de transferência de dados.

Definir opções de transferência para downloads

Os seguintes valores podem ser ajustados para downloads ao usar o downloadToBuffer método:

  • blockSize: O tamanho máximo do bloco a ser transferido para cada solicitação.
  • simultaneidade: o número máximo de solicitações paralelas emitidas a qualquer momento como parte de uma única transferência paralela.

Considerações de desempenho para downloads

Durante um download usando downloadToBuffero , as bibliotecas de cliente de armazenamento dividem uma determinada solicitação de download em vários subdownloads com base nas opções de configuração definidas pelo BlobDownloadToBufferOptions. Cada subdownload tem sua própria chamada dedicada para a operação REST. Dependendo das opções de transferência, as bibliotecas de cliente gerenciam essas operações REST em paralelo para concluir o download completo.

Exemplo de código

O exemplo de código a seguir mostra como definir valores para BlobDownloadToBufferOptions e incluir as opções como parte de uma chamada de método downloadToBuffer. Os valores fornecidos nas amostras não pretendem ser uma recomendação. Para ajustar corretamente esses valores, você precisa considerar as necessidades específicas do seu aplicativo.

// Specify data transfer options
const downloadToBufferOptions = {
    blockSize: 4 * 1024 * 1024, // 4 MiB max block size
    concurrency: 2, // maximum number of parallel transfer workers
}

// Download data to buffer
const result = await client.downloadToBuffer(offset, count, downloadToBufferOptions);

Conteúdos relacionados