aio Paket
Sınıflar
BlobClient |
Belirli bir blobla etkileşime geçmek için bir istemci, ancak bu blob henüz mevcut olmayabilir. |
BlobLeaseClient |
Yeni bir BlobLeaseClient oluşturur. Bu istemci bir BlobClient veya ContainerClient üzerinde kiralama işlemleri sağlar. |
BlobPrefix |
Blob özelliklerinin Yinelenebilir olması. Sınırlayıcı kullanıldığında walk_blobs döndürülür. Sanal blob dizini olarak düşünülebilir. |
BlobServiceClient |
Blob Hizmeti ile hesap düzeyinde etkileşime geçmek için bir istemci. Bu istemci hesap özelliklerini alıp yapılandırmanın yanı sıra hesap içinde kapsayıcıları listeleme, oluşturma ve silme işlemlerini sağlar. Belirli bir kapsayıcı veya blobla ilgili işlemler için, bu varlıklara yönelik istemciler get_client işlevleri kullanılarak da alınabilir. |
ContainerClient |
Belirli bir kapsayıcıyla etkileşime geçmek için bir istemci, ancak bu kapsayıcı henüz mevcut olmayabilir. Bu kapsayıcıdaki belirli bir blobla ilgili işlemler için blob istemcisi işlevi kullanılarak get_blob_client alınabilir. |
ExponentialRetry |
Üstel yeniden deneme. Üstel yeniden deneme nesnesi oluşturur. initial_backoff ilk yeniden deneme için kullanılır. Sonraki yeniden denemeler initial_backoff + increment_power^retry_count saniye sonra yeniden denenir. Örneğin, varsayılan olarak ilk yeniden deneme 15 saniye sonra, saniye (15+3^1) = 18 saniye ve üçüncü sonra (15+3^2) = 24 saniye sonra gerçekleşir. |
LinearRetry |
Doğrusal yeniden deneme. Doğrusal yeniden deneme nesnesi oluşturur. |
StorageStreamDownloader |
Azure Depolama'dan indirebileceğiniz bir akış nesnesi. |
İşlevler
download_blob_from_url
Blobun içeriğini yerel bir dosyaya veya akışa indirin.
async download_blob_from_url(blob_url: str, output: str, credential: Optional[Union[str, Dict[str, str], AzureNamedKeyCredential, AzureSasCredential, "TokenCredential"]] # pylint: disable=line-too-long = None, **kwargs) -> None
Parametreler
- output
- str veya <xref:<xref:writable stream>>
Verilerin indirileceği yer. Bu, yazılacak bir dosya yolu veya yazılacak açık bir GÇ tanıtıcısı olabilir.
- credential
Kimlik doğrulaması için kullanılan kimlik bilgileri. Blob URL'sinde zaten bir SAS belirteci varsa veya blob genelse bu isteğe bağlıdır. Değer bir SAS belirteci dizesi, azure.core.credentials öğesinden azureSasCredential veya AzureNamedKeyCredential örneği, hesap paylaşılan erişim anahtarı veya azure.identity'den TokenCredentials sınıfının bir örneği olabilir. Kaynak URI'sinde zaten bir SAS belirteci varsa, bu açık bir kimlik bilgisi için yoksayılır
- ancak çakışan SAS belirteçlerinin bir ValueError oluşturacağı AzureSasCredential durumu dışında. AzureNamedKeyCredential örneği kullanılıyorsa depolama hesabı adı "name" ve depolama hesabı anahtarı "anahtar" olmalıdır.
- overwrite
- bool
Zaten varsa yerel dosyanın üzerine yazılıp yazılmayacağı. Varsayılan değer False'tur . Bu durumda, dosya zaten varsa bir ValueError oluşturulur. True olarak ayarlanırsa, var olan dosyaya yazma girişiminde bulunulacaktır. Bir akış tanıtıcısı geçirilirse, bu değer yoksayılır.
- max_concurrency
- int
İndirilmesi gereken paralel bağlantı sayısı.
- offset
- int
Blobun bir bölümünü indirmek için kullanılacak bayt aralığının başlangıcı. Uzunluk sağlanmışsa ayarlanmalıdır.
- length
- int
Akıştan okunacak bayt sayısı. Bu isteğe bağlıdır, ancak en iyi performans için sağlanmalıdır.
- validate_content
- bool
True ise, blobun her bir öbeği için bir MD5 karması hesaplar. Depolama hizmeti, gönderilen karma ile gelen içeriğin karması denetler. Https yerine http kullanıldığında (varsayılan) zaten doğrulanacaksa, bu öncelikle kablodaki bitflip'leri algılamak için değerlidir. Bu MD5 karması blob ile depolanmaz. Ayrıca etkinleştirilirse bellek açısından verimli karşıya yükleme algoritmasının kullanılmayacağını unutmayın çünkü MD5 karması hesaplaması blokların tamamını arabelleğe almayı gerektirir ve bunu yapmak bellek açısından verimli algoritmanın amacını alt eder.
Dönüş türü
upload_blob_to_url
Verileri belirli bir URL'ye yükleme
Veriler blok blobu olarak karşıya yüklenir.
param str blob_url: Blob için tam URI. Buna sas belirteci de dahil olabilir.
param data: Karşıya yüklenecek veriler. Bu bayt, metin, yinelenebilir veya dosya benzeri bir nesne olabilir.
tür verileri: bayt veya str veya Yinelenebilir
async upload_blob_to_url(blob_url: str, data: Union[Iterable[AnyStr], IO[AnyStr]], credential: Optional[Union[str, Dict[str, str], AzureNamedKeyCredential, AzureSasCredential, "TokenCredential"]] # pylint: disable=line-too-long = None, **kwargs) -> dict[str, Any]
Parametreler
- credential
Kimlik doğrulaması için kullanılan kimlik bilgileri. Blob URL'sinde zaten bir SAS belirteci varsa bu isteğe bağlıdır. Değer bir SAS belirteci dizesi, azure.core.credentials öğesinden azureSasCredential veya AzureNamedKeyCredential örneği, hesap paylaşılan erişim anahtarı veya azure.identity'den TokenCredentials sınıfının bir örneği olabilir. Kaynak URI'sinde zaten bir SAS belirteci varsa, bu açık bir kimlik bilgisi için yoksayılır
- ancak çakışan SAS belirteçlerinin bir ValueError oluşturacağı AzureSasCredential durumu dışında. AzureNamedKeyCredential örneği kullanılıyorsa depolama hesabı adı "name" ve depolama hesabı anahtarı "anahtar" olmalıdır.
paramtype kimlik bilgisi: Optional[Union[str, Dict[str, str], AzureNamedKeyCredential, AzureSasCredential, "TokenCredential"]] # pylint: disable=line-too-long
anahtar sözcük bool üzerine yazma: Karşıya yüklenecek blob'un geçerli verilerin üzerine yazıp yazmayacağı. True ise, upload_blob_to_url var olan verilerin üzerine yazar. False olarak ayarlanırsa işlem ResourceExistsError ile başarısız olur.
anahtar sözcük int max_concurrency: İndirilmesi gereken paralel bağlantı sayısı.
anahtar sözcük int uzunluğu: Akıştan okunacak bayt sayısı. Bu isteğe bağlıdır, ancak en iyi performans için sağlanmalıdır.
anahtar sözcük dict(str,str) meta verileri: Blobla meta veri olarak ilişkili ad-değer çiftleri.
anahtar sözcük bool validate_content: True ise, blobun her bir öbeği için bir MD5 karması hesaplar. Depolama hizmeti, gönderilen karma ile gelen içeriğin karması denetler. Https yerine http kullanıldığında (varsayılan) zaten doğrulanacaksa, bu öncelikle kablodaki bitflip'leri algılamak için değerlidir. Bu MD5 karması blob ile depolanmaz. Ayrıca etkinleştirilirse bellek açısından verimli karşıya yükleme algoritmasının kullanılmayacağını unutmayın çünkü MD5 karması hesaplaması blokların tamamını arabelleğe almayı gerektirir ve bunu yapmak bellek açısından verimli algoritmanın amacını alt eder.
anahtar sözcük str kodlaması: Metin giriş olarak sağlandığında kullanılacak kodlama. Varsayılan olarak UTF-8'e ayarlanır.
döndürür: Blob ile güncelleştirilmiş özellik diktesi (Etag ve son değiştirme)
rtype: dict(str, Any)
- blob_url
- data
Azure SDK for Python