Blob dizini etiketleriyle Azure Blob verilerini yönetme ve bulma

Veri kümeleri büyüdükçe, veri denizinde belirli bir nesneyi bulmak zor olabilir. Blob dizin etiketleri, anahtar-değer dizin etiketi özniteliklerini kullanarak veri yönetimi ve bulma özellikleri sağlar. Nesneleri tek bir kapsayıcı içinde veya depolama hesabınızdaki tüm kapsayıcılarda kategorilere ayırabilir ve bulabilirsiniz. Veri gereksinimleri değiştikçe, nesneler dizin etiketleri güncelleştirilerek dinamik olarak kategorilere ayırılabilir. Nesneler, geçerli kapsayıcı kuruluşlarında yerinde kalabilir.

Blob dizin etiketleri şu olanaklara olanak sağlar:

• Anahtar-değer dizin etiketlerini kullanarak bloblarınızı dinamik olarak kategorilere ayırma

• Depolama hesabının tamamında belirli etiketli blobları hızla bulma

• Dizin etiketlerinin değerlendirilmesi temelinde blob API'leri için koşullu davranışlar belirtme

• Blob yaşam döngüsü yönetimi gibi özellikler üzerinde gelişmiş denetimler için dizin etiketlerini kullanma

Depolama hesabınızda birçok farklı uygulama tarafından erişilen milyonlarca blobun bulunduğu bir senaryo düşünün. Tek bir projeden tüm ilgili verileri bulmak istiyorsunuz. Veriler farklı adlandırma kurallarına sahip birden çok kapsayıcıya yayılabildiği için kapsamın ne olduğundan emin değilsiniz. Ancak, uygulamalarınız projelerine göre tüm verileri etiketlerle karşıya yükler. Milyonlarca blobda arama yapıp adları ve özellikleri karşılaştırmak yerine bulma ölçütleriniz olarak kullanabilirsiniz Project = Contoso . Blob dizini, 50 blob kümesini hızlı bir şekilde bulup döndürmek için depolama hesabınızın tamamında tüm kapsayıcıları Project = Contosofiltreler.

Blob dizinini kullanma örnekleriyle başlamak için bkz . Verileri yönetmek ve bulmak için blob dizini etiketlerini kullanma.

Blob dizin etiketleri ve veri yönetimi

Kapsayıcı ve blob adı ön ekleri tek boyutlu kategorilerdir. Blob dizin etiketleri blob veri türleri (Blok, Ekleme veya Sayfa) için çok boyutlu kategorilere ayırmaya olanak sağlar. Çok boyutlu kategorilere ayırma, verilerinizi hızla bulabilmeniz için Azure Blob Depolama tarafından yerel olarak dizine eklenir.

Depolama hesabınızda aşağıdaki beş blobu göz önünde bulundurun:

• container1/transaction.csv

• container2/campaign.docx

• fotoğraflar/bannerphoto.png

• arşivler/tamamlandı/2019review.pdf

• günlükler/2020/01/01/logfile.txt

Bu bloblar kapsayıcı/sanal klasör/blob adı ön eki kullanılarak ayrılır. Geçerli ön ek kuruluşlarını korurken bunları birlikte kategorilere ayırmak için bu beş blobun dizin etiketi özniteliğini Project = Contoso ayarlayabilirsiniz. Dizin etiketleri eklemek, dizini kullanarak verileri filtreleme ve bulma özelliğini ortaya çıkartarak verileri taşıma gereksinimini ortadan kaldırır.

Blob dizini etiketlerini ayarlama

Blob dizin etiketleri, depolama hesabınızdaki yeni veya mevcut nesnelere uygulanabilen anahtar-değer öznitelikleridir. Blobu Koy, Blok Listesini Koy veya Blobu Kopyala işlemlerini ve isteğe bağlı x-ms-tags üst bilgiyi kullanarak karşıya yükleme işlemi sırasında dizin etiketleri belirtebilirsiniz. Depolama hesabınızda bloblar zaten varsa, isteğin gövdesinde dizin etiketleriyle biçimlendirilmiş bir XML belgesi geçirerek Blob Etiketlerini Ayarla'yı çağırın.

Verilerinizin işlenmesinin ne zaman bittiğini açıklamak için blobunuza tek bir etiket uygulayabilirsiniz.

"processedDate" = '2020-01-01'

Verileri daha açıklayıcı hale getirmek için blobunuza birden çok etiket uygulayabilirsiniz.

"Project" = 'Contoso' "Classified" = 'True' "Status" = 'Unprocessed' "Priority" = '01'

Mevcut dizin etiketi özniteliklerini değiştirmek için, var olan etiket özniteliklerini alın, etiket özniteliklerini değiştirin ve yerine Blob Etiketlerini Ayarla işlemini kullanın. Blobdan tüm dizin etiketlerini kaldırmak için etiket özniteliği belirtilmemiş işlemi çağırın Set Blob Tags . Blob dizini etiketleri blob veri içeriklerinin alt kaynağı olduğundan, Set Blob Tags temel alınan içeriği değiştirmez ve blobun son değiştirme zamanını veya eTag'ini değiştirmez. Tüm geçerli temel bloblar için dizin etiketleri oluşturabilir veya değiştirebilirsiniz. Dizin etiketleri de önceki sürümler için korunur, ancak blob dizin altyapısına geçirilemez, bu nedenle önceki sürümleri almak için dizin etiketlerini sorgulayamazsınız. Geçici olarak silinen bloblardaki etiketler değiştirilemez.

Blob dizini etiketleri için aşağıdaki sınırlar geçerlidir:

• Her blob en fazla 10 blob dizin etiketine sahip olabilir

• Etiket anahtarları bir ile 128 karakter arasında olmalıdır.

• Etiket değerleri sıfır ile 256 karakter arasında olmalıdır.

• Etiket anahtarları ve değerleri büyük/küçük harfe duyarlıdır.

• Etiket anahtarları ve değerleri yalnızca dize veri türlerini destekler. Tüm sayılar, tarihler, saatler veya özel karakterler dize olarak kaydedilir.

• Sürüm oluşturma etkinse, dizin etiketleri blobun belirli bir sürümüne uygulanır. Dizin etiketlerini geçerli sürümde ayarlarsanız ve yeni bir sürüm oluşturulursa, etiket yeni sürümle ilişkilendirilmeyecektir. Etiket yalnızca önceki sürümle ilişkilendirilecektir.

• Etiket anahtarları ve değerleri aşağıdaki adlandırma kurallarına uymalıdır:

  • Alfasayısal karakterler:

    • a - z (küçük harfler)

    • A-Z (büyük harfler)

    • 0 ile 9 arasında (sayılar)

  • Geçerli özel karakterler: boşluk, artı, eksi, nokta, iki nokta üst üste, eşittir, alt çizgi, eğik çizgi ( +-.:=_/)

Blob dizini etiketlerini alma ve listeleme

Blob dizin etiketleri blob verilerinin yanı sıra bir alt kaynak olarak depolanır ve temel alınan blob veri içeriğinden bağımsız olarak alınabilir. Tek bir blob için blob dizin etiketleri, Blob Etiketlerini Al işlemiyle alınabilir. Parametresiyle Blobları Listele işlemi, blob dizin etiketleriyle include:tags birlikte bir kapsayıcı içindeki tüm blobları da döndürür.

En az bir blob dizin etiketine sahip tüm bloblar için, x-ms-tag-count blob üzerindeki dizin etiketlerinin sayısını gösteren BlobLarı Listele, Blob Al ve Blob Özelliklerini Al işlemlerinde döndürülür.

Blob dizini etiketlerini kullanarak veri bulma

Dizin oluşturma altyapısı, anahtar-değer özniteliklerinizi çok boyutlu bir dizinde kullanıma sunar. Dizin etiketlerinizi ayarladıktan sonra bunlar blobda bulunur ve hemen alınabilir.

Blob dizininin güncelleştirilebilmesi biraz zaman alabilir. Bu, hem etiket ekleme hem de mevcut etiketleri düzenleme için geçerlidir. Gereken süre iş yüküne bağlıdır. Örneğin, Blob Etiketlerini Ayarla işleminin saniyede 15000 ila 20000 işlem hızında tamamlanması 30 dakika sürerse, bu blobların tümünü dizine eklemek 10 dakika kadar sürebilir. Daha düşük bir hızda dizin oluşturma gecikmesi bir saniyenin altında olabilir. Trafiğin dağılımı dizin oluşturma gecikmelerini de etkiler. Örneğin, bir istemci uygulaması bloblardaki etiketleri aynı kapsayıcı altında sıralı olarak ayarlarsa, etiketlerin birlikte konumlandırılmayan bloblara uygulanması durumunda gecikme daha yüksek olabilir.

Blob dizini güncelleştirildikten sonra Blob Depolama tarafından sunulan yerel sorgu ve bulma özelliklerini kullanabilirsiniz.

Etiketlere Göre BlobLarı Bul işlemi, dizin etiketleri belirli bir sorgu ifadesiyle eşleşen filtrelenmiş bir blob kümesi almanıza olanak tanır. Find Blobs by Tags depolama hesabınızdaki tüm kapsayıcılarda filtrelemeyi destekler veya filtrelemenin kapsamını yalnızca tek bir kapsayıcı olarak ayarlayabilirsiniz. Tüm dizin etiketi anahtarları ve değerleri dize olduğundan ilişkisel işleçler sözcüksel sıralama kullanır.

Blob dizini filtreleme için aşağıdaki ölçütler geçerlidir:

• Etiket anahtarları çift tırnak içine alınmalıdır (")

• Etiket değerleri ve kapsayıcı adları tek tırnak içine alınmalıdır (')

• @ karakterine yalnızca belirli bir kapsayıcı adına filtre uygulama izni verilir (örneğin, @container = 'ContainerName')

• Filtreler, dizelerde sözcük temelli sıralama ile uygulanır

• Aynı anahtardaki aynı taraflı aralık işlemleri geçersizdir (örneğin, "Rank" > '10' AND "Rank" >= '15')

• Filtre ifadesi oluşturmak için REST kullanılırken, karakterler URI ile kodlanmalıdır

• Etiket sorguları, tek bir etiket kullanılarak eşitlik eşleşmesi için iyileştirilmiştir (ör. StoreID = "100"). , =, <, ><= içeren >tek bir etiket kullanan aralık sorguları da verimlidir. Birden fazla etikete sahip VE kullanan sorgular o kadar verimli olmayacaktır. Örneğin, Maliyet > "01" AND Maliyet <= "100" verimlidir. Maliyet > "01 AND StoreID = "2" o kadar verimli değildir.

Aşağıdaki tabloda için Find Blobs by Tagstüm geçerli işleçler gösterilmektedir:

Blob dizini etiketleriyle koşullu blob işlemleri

REST 2019-10-10 ve üzeri sürümlerde blob hizmeti API'lerinin çoğu artık koşullu üst bilgiyi x-ms-if-tagsdestekler. Böylece işlem yalnızca belirtilen blob dizini koşulu karşılandığında başarılı olur. Koşul karşılanmazsa alırsınız error 412: The condition specified using HTTP conditional header(s) is not met.

Üst x-ms-if-tags bilgi, diğer mevcut HTTP koşullu üst bilgileriyle (If-Match, If-None-Match vb.) birleştirilebilir. bir istekte birden çok koşullu üst bilgi sağlanıyorsa, işlemin başarılı olması için tümünün true değerini değerlendirmesi gerekir. Tüm koşullu üst bilgiler mantıksal AND ile etkili bir şekilde birleştirilir.

Aşağıdaki tabloda koşullu işlemler için geçerli işleçler gösterilmektedir:

Blob dizini etiketleriyle platform tümleştirmeleri

Blob dizini etiketleri yalnızca blob verilerinizi kategorilere ayırmanıza, yönetmenize ve aramanıza yardımcı olmakla kalmaz, aynı zamanda yaşam döngüsü yönetimi gibi diğer Blob Depolama özellikleriyle tümleştirme sağlar.

Yaşam Döngüsü yönetimi

blobIndexMatch Yaşam döngüsü yönetiminde kural filtresi olarak kullanarak verileri daha serin katmanlara taşıyabilir veya bloblarınıza uygulanan dizin etiketlerine göre verileri silebilirsiniz. Kurallarınızda daha ayrıntılı olabilir ve blobları yalnızca belirtilen etiket ölçütleriyle eşleşiyorsa taşıyabilir veya silebilirsiniz.

Etiketlenmiş verilere eylemler uygulamak için yaşam döngüsü kuralında tek başına bir filtre kümesi olarak blob dizini eşlemesi ayarlayabilirsiniz. İsterseniz daha belirli veri kümelerini eşleştirmek için ön ek ile blob dizinini de birleştirebilirsiniz. Yaşam döngüsü kuralında birden fazla filtre belirtildiğinde mantıksal AND işlemi uygulanır. Eylem yalnızca tüm filtre ölçütleri eşleşiyorsa uygulanır.

Aşağıdaki örnek yaşam döngüsü yönetim kuralı adlı videofileskapsayıcıdaki blok blobları için geçerlidir. Kural blobları arşiv depolamaya katmanlar ancak veriler blob dizin etiketi ölçütleriyle "Status" == 'Processed' AND "Source" == 'RAW'eşleşiyorsa.

{
    "rules": [
        {
            "enabled": true,
            "name": "ArchiveProcessedSourceVideos",
            "type": "Lifecycle",
            "definition": {
                "actions": {
                    "baseBlob": {
                        "tierToArchive": {
                            "daysAfterModificationGreaterThan": 0
                        }
                    }
                },
                "filters": {
                    "blobIndexMatch": [
                        {
                            "name": "Status",
                            "op": "==",
                            "value": "Processed"
                        },
                        {
                            "name": "Source",
                            "op": "==",
                            "value": "RAW"
                        }
                    ],
                    "blobTypes": [
                        "blockBlob"
                    ],
                    "prefixMatch": [
                        "videofiles/"
                    ]
                }
            }
        }
    ]
}

İzinler ve yetkilendirme

Aşağıdaki yaklaşımlardan birini kullanarak blob dizin etiketlerine erişim yetkisi vekleyebilirsiniz:

• Microsoft Entra güvenlik sorumlusuna izin vermek için Azure rol tabanlı erişim denetimini (Azure RBAC) kullanma. Üstün güvenlik ve kullanım kolaylığı için Microsoft Entra Id kullanın. Blob işlemleriyle Microsoft Entra Id kullanma hakkında daha fazla bilgi için bkz . Azure Depolama'da verilere erişimi yetkilendirme.

• Blob dizinine erişim yetkisi vermek için paylaşılan erişim imzası (SAS) kullanma. Paylaşılan erişim imzaları hakkında daha fazla bilgi için bkz . Paylaşılan erişim imzalarını (SAS) kullanarak Azure Depolama kaynaklarına sınırlı erişim verme.

• Paylaşılan Anahtar ile işlemleri yetkilendirmek için hesap erişim anahtarlarını kullanma. Daha fazla bilgi için bkz . Paylaşılan Anahtarla Yetkilendirme.

Blob dizin etiketleri, blob verilerinin alt kaynağıdır. Blobları okuma veya yazma izinleri veya SAS belirteci olan bir kullanıcının blob dizin etiketlerine erişimi olmayabilir.

Rol tabanlı erişim denetimi

Microsoft Entra kimliği kullanan arayanlara blob dizin etiketleri üzerinde çalışmak için aşağıdaki izinler verilebilir.

Dizin etiketi işlemleri için temel alınan blob verilerinden ayrı ek izinler gereklidir. Depolama Blobu Veri Sahibi rolüne üç blob dizin etiketi işleminin tümü için izinler verilir.

SAS izinleri

Paylaşılan erişim imzası (SAS) kullanan arayanlara blob dizini etiketleri üzerinde çalışmak için kapsamlı izinler verilebilir.

Blob için hizmet SAS'i

Blob dizin etiketlerine erişime izin vermek için bir blob için hizmet SAS'sinde aşağıdaki izinler verilebilir. Yalnızca blob okuma (r) ve yazma (w) izinleri, dizin etiketlerini okumak veya yazmak için yeterli değildir.

Kapsayıcı için hizmet SAS'i

Blob etiketlerinde filtrelemeye izin vermek için bir kapsayıcı için hizmet SAS'sinde aşağıdaki izinler verilebilir. Blob listesi (i) izni, blobların dizin etiketlerine göre filtrelenmesine izin vermek için yeterli değildir.

Hesap SAS'i

Blob dizin etiketlerine erişime ve blob etiketleri üzerinde filtrelemeye izin vermek için hesap SAS'sinde aşağıdaki izinler verilebilir.

Yalnızca blob okuma (r) ve yazma (w) izinleri dizin etiketlerini okumak veya yazmak için yeterli değildir ve liste (i) izni blobların dizin etiketlerine göre filtrelenmesine izin vermek için yeterli değildir.

Meta veri ve blob dizin etiketleri arasında seçim

Hem blob dizini etiketleri hem de meta veriler, blob kaynağıyla birlikte rastgele kullanıcı tanımlı anahtar-değer özelliklerini depolama olanağı sağlar. Her ikisi de blobun içeriğini döndürmeden veya değiştirmeden doğrudan alınabilir ve ayarlanabilir. Hem meta veriler hem de dizin etiketleri kullanılabilir.

Yalnızca dizin etiketleri otomatik olarak dizinlenir ve yerel Blob Depolama hizmeti tarafından aranabilir hale gelir. Meta veriler yerel olarak dizine alınamaz veya aranamaz. Azure Search gibi ayrı bir hizmet kullanmanız gerekir. Blob dizini etiketleri, temel alınan blob verilerinden ayrı okuma, filtreleme ve yazma için ek izinlere sahiptir. Meta veriler blobla aynı izinleri kullanır ve Blob Al ve Blob Özelliklerini Al işlemleri tarafından HTTP üst bilgileri olarak döndürülür. Blob dizin etiketleri, Microsoft tarafından yönetilen bir anahtar kullanılarak bekleme sırasında şifrelenir. Bekleyen meta veriler, blob verileri için belirtilen şifreleme anahtarı kullanılarak şifrelenir.

Aşağıdaki tabloda meta veriler ile blob dizini etiketleri arasındaki farklar özetlemektedir:

Fiyatlandırma

Depolama hesabındaki dizin etiketlerinin aylık ortalama sayısı için ücretlendirilirsiniz. Dizin oluşturma altyapısının maliyeti yoktur. Blob Etiketlerini Ayarlama, Blob Etiketlerini Alma ve Blob Etiketlerini Bulma istekleri geçerli ilgili işlem fiyatlarına göre ücretlendirilir. Etikete Göre Blob Bul işlemi yapılırken kullanılan liste işlemlerinin sayısının istekteki yan tümce sayısına eşit olduğunu unutmayın. Örneğin, sorgu (StoreID = 100) bir liste işlemidir. Sorgu (StoreID = 100 AND SKU = 10010) iki liste işlemidir. Daha fazla bilgi edinmek için bkz. Blob fiyatlandırmasını engelleme.

Özellik desteği

Bu özellik için destek, Data Lake Storage 2. Nesil, Ağ Dosya Sistemi (NFS) 3.0 protokolü veya SSH Dosya Aktarım Protokolü (SFTP) etkinleştirilerek etkilenebilir. Bu özelliklerden herhangi birini etkinleştirdiyseniz bu özelliğin desteğini değerlendirmek için bkz . Azure Depolama hesaplarında Blob Depolama özelliği desteği.

Koşullar ve bilinen sorunlar

Bu bölümde bilinen sorunlar ve koşullar açıklanmaktadır.

• Yalnızca genel amaçlı v2 hesapları ve premium blok blob hesapları desteklenir. Premium sayfa blobu, eski blob ve hiyerarşik ad alanı etkinleştirilmiş hesaplar desteklenmez. Genel amaçlı v1 hesapları desteklenmez.

• Sayfa bloblarını dizin etiketleriyle karşıya yüklemek, etiketleri kalıcı yapmaz. Sayfa blobunu karşıya yükledikten sonra etiketleri ayarlayın.

• Blob depolama sürümü oluşturma etkinse, geçerli sürümde dizin etiketlerini kullanmaya devam edebilirsiniz. Dizin etiketleri önceki sürümler için korunur, ancak bu etiketler blob dizin altyapısına geçirilmiyor, bu nedenle bunları önceki sürümleri almak için kullanamazsınız. Önceki bir sürümü geçerli sürüme yükseltirseniz, önceki sürümün etiketleri geçerli sürümün etiketleri olur. Bu etiketler geçerli sürümle ilişkilendirildiğinden blob dizin altyapısına geçirilir ve bunları sorgulayabilirsiniz.

• Benzer şekilde, Dizin etiketleri geçici olarak silinen bloblar ve anlık görüntüler için korunur, ancak bu etiketler blob dizin altyapısına geçirilemez, bu nedenle bunları geçici olarak silinen blobları ve anlık görüntüleri almak için kullanamazsınız. Geçici olarak silinen blobları ve anlık görüntüleri geri yüklerseniz, etiketleri blob dizin altyapısına geçirilir ve bunları sorgulayabilirsiniz.

• Dizin etiketlerinin dizine eklenip dizinlenmediğini belirlemek için api yoktur.

• Yaşam döngüsü yönetimi yalnızca blob dizini eşleşmesiyle eşitlik denetimlerini destekler.

• Copy Blob blob dizin etiketlerini kaynak blobdan yeni hedef bloba kopyalamaz. Kopyalama işlemi sırasında hedef bloba uygulanmasını istediğiniz etiketleri belirtebilirsiniz.

Sık sorulan sorular (SSS)

Bkz. Blob dizini etiketleri hakkında SSS.

Sonraki adımlar

Blob dizininin nasıl kullanılacağına ilişkin bir örnek için bkz . Verileri yönetmek ve bulmak için blob dizinini kullanma.

Yaşam döngüsü yönetimi hakkında bilgi edinin ve blob dizini eşleştirmesi ile bir kural ayarlayın.