Java ile karşıya yüklemeler ve indirmeler için performans ayarlama

Bir uygulama Java için Azure Depolama istemci kitaplığını kullanarak veri aktardığında hızı, bellek kullanımını ve hatta isteğin başarısını veya başarısızlığını etkileyebilecek çeşitli faktörler vardır. Veri aktarımlarında performansı ve güvenilirliği en üst düzeye çıkarmak için, uygulamanızın çalıştığı ortama göre istemci kitaplığı aktarım seçeneklerini yapılandırma konusunda proaktif olmak önemlidir.

Bu makalede, veri aktarımı seçeneklerini ayarlamayla ilgili dikkat edilmesi gereken bazı noktalar açıklanır. düzgün ayarlandığında, istemci kitaplığı verileri birden çok istek arasında verimli bir şekilde dağıtabilir ve bu da gelişmiş işlem hızı, bellek kullanımı ve ağ kararlılığı ile sonuçlanabilir.

Karşıya yüklemeler için performans ayarlama

Veri aktarımı seçeneklerinin düzgün ayarlanması, karşıya yüklemeler için güvenilir performansın anahtarıdır. Depolama aktarımları, bu bağımsız değişkenlerin değerlerine göre birkaç alt iletide bölümlenir. Desteklenen maksimum aktarım boyutu işleme ve hizmet sürümüne göre değişir, bu nedenle sınırları belirlemek için belgeleri gözden geçirin. Blob depolama için aktarım boyutu sınırları hakkında daha fazla bilgi için bkz . Blob depolama için hedefleri ölçeklendirme.

Karşıya yüklemeler için aktarım seçeneklerini ayarlama

Veri aktarımı işlemlerinin performansını artırmak için ParallelTransferOptions içindeki değerleri yapılandırabilirsiniz. Aşağıdaki değerler, uygulamanızın gereksinimlerine göre karşıya yüklemeler için ayarlanabilir:

• maxSingleUploadSize: Tek bir istek karşıya yükleme için bayt cinsinden maksimum blob boyutu.
• blockSize: Her istek için aktarım için en büyük blok boyutu.
• maxConcurrency: Tek bir paralel aktarımın parçası olarak herhangi bir zamanda verilen en fazla paralel istek sayısı.

Not

İstemci kitaplıkları, sağlanmadıysa her veri aktarımı seçeneği için varsayılan değerleri kullanır. Bu varsayılanlar genellikle bir veri merkezi ortamında yüksek performanslıdır, ancak ev tüketicisi ortamları için uygun olmayabilir. Kötü ayarlanmış veri aktarımı seçenekleri aşırı uzun işlemlere ve hatta istek zaman aşımlarına neden olabilir. Bu değerleri test etmek ve uygulamanızın ve ortamınızın ihtiyaçlarına göre ayarlamak için proaktif olmak en iyisidir.

maxSingleUploadSize

Değer maxSingleUploadSize , tek bir isteğin karşıya yüklenmesi için bayt cinsinden en büyük blob boyutudur. Bu değer aşağıdaki yöntem kullanılarak ayarlanabilir:

• setMaxSingleUploadSizeLong(Long maxSingleUploadSize)

Verilerin boyutu değerinden küçük veya buna eşitse maxSingleUploadSizeblob tek bir Put Blob isteğiyle karşıya yüklenir. Blob boyutu değerinden büyükse maxSingleUploadSizeveya blob boyutu bilinmiyorsa, blob bir dizi Blok Koy çağrısı ve ardından Blok Listesi Koy kullanılarak öbekler halinde karşıya yüklenir.

Belirttiğiniz değerin için blockSize maxSingleUploadSizetanımladığınız değeri sınırlamadığını unutmayın. maxSingleUploadSize bağımsız değişkeni, bir isteğin alt iletim olmadan tüm işlemi aynı anda gerçekleştirmesi için ayrı bir boyut sınırlaması tanımlar. Genellikle, büyük değilse için tanımladığınız blockSizedeğer kadar büyük olmak istersinizmaxSingleUploadSize. Veri aktarımının boyutuna bağlı olarak, aktarım tek bir istekle tamamlandığından ve birden çok isteğin ek yükünü önlediği için bu yaklaşım daha yüksek performanslı olabilir.

Durumunuz için en uygun değerin hangisi olduğundan emin değilseniz, güvenli bir seçenek için blockSizekullanılan değere ayarlamaktırmaxSingleUploadSize.

blockSize

Değer blockSize , blok blobunu öbekler halinde karşıya yüklerken bayt cinsinden aktarımın uzunluk üst sınırıdır. Bu değer aşağıdaki yöntem kullanılarak ayarlanabilir:

• setBlockSizeLong(Long blockSize)

Değer blockSize , blok blobunu öbekler halinde karşıya yüklerken bayt cinsinden aktarımın uzunluk üst sınırıdır. Daha önce belirtildiği gibi, bu değer değerinden büyük blockSizeolabilecek değerini sınırlamazmaxSingleUploadSize.

Verilerin verimli bir şekilde ilerlemesini sağlamak için istemci kitaplıkları her aktarım için her zaman değere blockSize ulaşamayabilir. İşleme bağlı olarak aktarım boyutu için desteklenen maksimum değer farklılık gösterebilir. Blob depolama için aktarım boyutu sınırları hakkında daha fazla bilgi için Bkz . Blob depolama için hedefleri ölçeklendirme.

maxConcurrency

Değer maxConcurrency , tek bir paralel aktarımın parçası olarak herhangi bir zamanda verilen en fazla paralel istek sayısıdır. Bu değer aşağıdaki yöntem kullanılarak ayarlanabilir:

• setMaxConcurrency(Integer maxConcurrency)

Kod örneği

Karşıya yükleme için kullanılacak ParallelTransferOptions aşağıdaki import yönergeye sahip olduğunuzdan emin olun:

import com.azure.storage.blob.models.*;

Aşağıdaki kod örneğinde ParallelTransferOptions değerlerinin nasıl ayarlanacağı ve blobUploadFromFileOptions örneğinin parçası olarak seçeneklerin nasıl eklanacağı gösterilmektedir . Bir dosyadan karşıya yüklemiyorsanız BlobParallelUploadOptions kullanarak benzer seçenekleri ayarlayabilirsiniz. Bu örnekte sağlanan değerler bir öneri olarak tasarlanmamıştır. Bu değerleri düzgün ayarlamak için uygulamanızın belirli gereksinimlerini dikkate almanız gerekir.

ParallelTransferOptions parallelTransferOptions = new ParallelTransferOptions()
        .setBlockSizeLong((long) (4 * 1024 * 1024)) // 4 MiB block size
        .setMaxConcurrency(2)
        .setMaxSingleUploadSizeLong((long) 8 * 1024 * 1024); // 8 MiB max size for single request upload

BlobUploadFromFileOptions options = new BlobUploadFromFileOptions("<localFilePath>");
options.setParallelTransferOptions(parallelTransferOptions);

Response<BlockBlobItem> blockBlob = blobClient.uploadFromFileWithResponse(options, null, null);

Bu örnekte yöntemini kullanarak paralel aktarım çalışanlarının maksimum sayısını 2 olarak setMaxConcurrency ayarlayacağız. Ayrıca yöntemini kullanarak 8 MiB olarak ayarladık maxSingleUploadSize setMaxSingleUploadSizeLong . Blob boyutu 8 MiB'den küçükse, karşıya yükleme işlemini tamamlamak için yalnızca tek bir istek gerekir. Blob boyutu 8 MiB'den büyükse blob, yöntemini kullanarak ayarladığımız en büyük öbek boyutu 4 MiB olan öbekler halinde setBlockSizeLong karşıya yüklenir.

Karşıya yüklemeler için performansla ilgili dikkat edilmesi gerekenler

Karşıya yükleme sırasında Depolama istemci kitaplıkları, tarafından ParallelTransferOptionstanımlanan yapılandırma seçeneklerine göre belirli bir karşıya yükleme akışını birden çok alt yüke böler. Her alt yükün REST işlemine kendi ayrılmış çağrısı vardır. Bir BlobClient nesne için bu işlem Put Block işlemidir. Depolama istemci kitaplığı, yüklemenin tamamını tamamlamak için bu REST işlemlerini paralel olarak yönetir (aktarım seçeneklerine bağlı olarak).

Not

Blok blobları en fazla 50.000 blok blok sayısına sahiptir. Blok blobunuzun boyutu üst sınırı 50.000 kezdir block_size.

Karşıya yüklemeler sırasında arabelleğe alma

Depolama REST katmanı, kaldığınız yerden REST karşıya yükleme işleminin algılanmasını desteklemez; tek tek aktarımlar tamamlanır veya kaybolur. Akış karşıya yüklemelerinde dayanıklılık sağlamak için Depolama istemci kitaplıkları, karşıya yüklemeyi başlatmadan önce her rest çağrısı için verileri arabelleğe alır. Ağ hızı sınırlamalarına ek olarak, bu arabelleğe alma davranışı sırayla karşıya yüklerken bile için blockSizedaha küçük bir değeri göz önünde bulundurmanın bir nedenidir. değerinin blockSize azaltılması, her istekte arabelleğe alınan maksimum veri miktarını ve başarısız bir isteğin her yeniden denemesini azaltır. Belirli bir boyuttaki veri aktarımları sırasında sık sık zaman aşımlarıyla karşılaşıyorsanız değerini blockSize azaltmak arabelleğe alma süresini azaltır ve daha iyi performansa neden olabilir.

İndirmeler için performans ayarlama

Veri aktarımı seçeneklerinin düzgün ayarlanması, indirmeler için güvenilir performansın anahtarıdır. Depolama aktarımları, içinde ParallelTransferOptionstanımlanan değerlere göre birkaç alt iletide bölümlenir.

İndirmeler için aktarım seçeneklerini ayarlama

İndirmeler için aşağıdaki değerler uygulamanızın gereksinimlerine göre ayarlanabilir:

• blockSize: Her istek için aktarım için en büyük blok boyutu. setBlockSizeLong yöntemini kullanarak bu değeri ayarlayabilirsiniz.
• maxConcurrency: Tek bir paralel aktarımın parçası olarak herhangi bir zamanda verilen en fazla paralel istek sayısı. setMaxConcurrency yöntemini kullanarak bu değeri ayarlayabilirsiniz.

Kod örneği

İndirme için kullanılacak ParallelTransferOptions aşağıdaki import yönergeye sahip olduğunuzdan emin olun:

import com.azure.storage.common.*;

Aşağıdaki kod örneğinde ParallelTransferOptions değerlerinin nasıl ayarlanacağı ve blobDownloadToFileOptions örneğinin parçası olarak seçeneklerin nasıl eklanacağı gösterilmektedir .

ParallelTransferOptions parallelTransferOptions = new ParallelTransferOptions()
        .setBlockSizeLong((long) (4 * 1024 * 1024)) // 4 MiB block size
        .setMaxConcurrency(2);

BlobDownloadToFileOptions options = new BlobDownloadToFileOptions("<localFilePath>");
options.setParallelTransferOptions(parallelTransferOptions);

blobClient.downloadToFileWithResponse(options, null, null);

İndirmeler için performansla ilgili dikkat edilmesi gerekenler

İndirme sırasında Depolama istemci kitaplıkları, tarafından ParallelTransferOptionstanımlanan yapılandırma seçeneklerine göre belirli bir indirme isteğini birden çok alt yüke böler. Her alt indirmenin REST işlemine kendi ayrılmış çağrısı vardır. Aktarım seçeneklerine bağlı olarak, istemci kitaplıkları tam indirmeyi tamamlamak için bu REST işlemlerini paralel olarak yönetir.

Sonraki adımlar

• Bu makale, Java için Blob Depolama geliştirici kılavuzunun bir parçasıdır. Uygulamanızı derleme bölümünde geliştirici kılavuzu makalelerinin tam listesine bakın.
• Azure Depolama işlemlerinin performansını etkileyebilecek faktörler hakkında daha fazla bilgi edinmek için bkz . Blob depolamada gecikme süresi.
• Blob depolama kullanarak uygulamaların performansını iyileştirmeye yönelik tasarım konuları listesini görmek için bkz . Blob depolama için performans ve ölçeklenebilirlik denetim listesi.