Azure Blob Depolama verileri yönetmek ve bulmak için blob dizini etiketlerini kullanma

Blob dizin etiketleri, anahtar-değer etiketi özniteliklerini kullanarak depolama hesabınızdaki verileri kategorilere ayırır. Bu etiketler otomatik olarak dizinlenir ve verileri kolayca bulmak için aranabilir çok boyutlu bir dizin olarak kullanıma sunulur. Bu makalede blob dizin etiketlerini kullanarak verileri ayarlama, alma ve bulma adımları gösterilmektedir.

Bu özellik hakkında bilinen sorunlar ve sınırlamalarla birlikte daha fazla bilgi edinmek için bkz . Blob dizini etiketleriyle Azure Blob verilerini yönetme ve bulma.

Dizin etiketleriyle yeni blobu karşıya yükleme

Bu görev, Depolama Blob Veri Sahibi veya özel bir Azure rolü aracılığıyla Azure kaynak sağlayıcısı işlemine Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write izin verilmiş bir güvenlik sorumlusu tarafından gerçekleştirilebilir.

Portal

1. Azure portalında depolama hesabınızı seçin.

2. Veri depolama altında Kapsayıcılar seçeneğine gidin ve kapsayıcınızı seçin.

3. Karşıya Yükle düğmesini seçin ve yerel dosya sisteminize göz atarak blok blobu olarak karşıya yüklenecek dosyayı bulun.

4. Gelişmiş açılan listesini genişletin ve Blob Dizini Etiketleri bölümüne gidin.

5. Verilerinize uygulanmasını istediğiniz anahtar/değer blob dizini etiketlerini girin.

6. Blobu karşıya yüklemek için Karşıya Yükle düğmesini seçin.

   

PowerShell

1. Connect-AzAccount komutuyla Azure aboneliğinizde oturum açın ve ekrandaki yönergeleri izleyin.

   Connect-AzAccount
   

2. Kimliğiniz birden fazla abonelikle ilişkiliyse etkin aboneliğinizi ayarlayın. Ardından depolama hesabı bağlamını alın.

   $context = Get-AzSubscription -SubscriptionId <subscription-id>
   Set-AzContext $context
   $storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -AccountName "<storage-account-name>"
   $ctx = $storageAccount.Context   
   

3. komutunu kullanarak blobu Set-AzStorageBlobContent karşıya yükleyin. parametresini -Tag kullanarak etiketleri ayarlayın.

   $containerName = "myContainer"
   $file = "C:\demo-file.txt"
   
   Set-AzStorageBlobContent -File $file -Container $containerName -Context $ctx -Tag @{"tag1" = "value1"; "tag2" = "value2" }
   

Azure CLI

1. Azure Cloud Shell'i açın veya Azure CLI'yi yerel olarak yüklediyseniz Windows PowerShell gibi bir komut konsolu uygulaması açın.

2. storage-preview uzantısını yükleyin.

   az extension add -n storage-preview
   

3. Azure CLI'yı yerel olarak kullanıyorsanız oturum açma komutunu çalıştırın.

   az login
   

4. Kimliğiniz birden fazla abonelikle ilişkiliyse, etkin aboneliğinizi depolama hesabının aboneliği olarak ayarlayın.

   az account set --subscription <subscription-id>
   

   <subscription-id> Yer tutucu değerini aboneliğinizin kimliğiyle değiştirin.

5. komutunu kullanarak blobu az storage blob upload karşıya yükleyin. parametresini --tags kullanarak etiketleri ayarlayın.

   az storage blob upload --account-name mystorageaccount --container-name myContainer --name demo-file.txt --file C:\demo-file.txt --tags tag1=value1 tag2=value2 --auth-mode login
   

AzCopy

Bkz. Dizin etiketleriyle karşıya yükleme.

Blob dizini etiketlerini alma, ayarlama ve güncelleştirme

Blob dizini etiketlerini alma işlemi, Depolama Blob Veri Sahibi veya özel bir Azure rolü aracılığıyla Azure kaynak sağlayıcısı işlemine Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/read izin verilmiş bir güvenlik sorumlusu tarafından gerçekleştirilebilir.

Blob dizini etiketlerini ayarlama ve güncelleştirme, Depolama Blob Veri Sahibi veya özel bir Azure rolü aracılığıyla Azure kaynak sağlayıcısı işlemine Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write izin verilmiş bir güvenlik sorumlusu tarafından gerçekleştirilebilir.

Portal

1. Azure portalında depolama hesabınızı seçin.

2. Veri depolama altında Kapsayıcılar seçeneğine gidin ve kapsayıcınızı seçin.

3. Seçili kapsayıcı içindeki bloblar listesinden blobunuzu seçin.

4. Bloba genel bakış sekmesi, blobunuzun tüm Blob Dizin Etiketleri de dahil olmak üzere özelliklerini görüntüler.

5. Blobunuz için anahtar/değer dizini etiketlerinden herhangi birini alabilir, ayarlayabilir, değiştirebilir veya silebilirsiniz.

6. Blobunuzda yapılan güncelleştirmeleri onaylamak için Kaydet düğmesini seçin.

   

PowerShell

1. Connect-AzAccount komutuyla Azure aboneliğinizde oturum açın ve ekrandaki yönergeleri izleyin.

   Connect-AzAccount
   

2. Kimliğiniz birden fazla abonelikle ilişkiliyse etkin aboneliğinizi ayarlayın. Ardından depolama hesabı bağlamını alın.

   $context = Get-AzSubscription -SubscriptionId <subscription-id>
   Set-AzContext $context
   $storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -AccountName "<storage-account-name>"
   $ctx = $storageAccount.Context   
   

3. Blobun etiketlerini almak için komutunu kullanın Get-AzStorageBlobTag ve parametresini -Blob blobun adına ayarlayın.

   $containerName = "myContainer"
   $blobName = "myBlob" 
   Get-AzStorageBlobTag -Context $ctx -Container $containerName -Blob $blobName
   

4. Blobun etiketlerini ayarlamak için komutunu kullanın Set-AzStorageBlobTag . parametresini -Blob blobun adına, parametresini -Tag ise ad ve değer çiftleri koleksiyonuna ayarlayın.

   $containerName = "myContainer"
   $blobName = "myBlob" 
   $tags = @{"tag1" = "value1"; "tag2" = "value2" }
   Set-AzStorageBlobTag -Context $ctx -Container $containerName -Blob $blobName -Tag $tags
   

Azure CLI

1. Azure Cloud Shell'i açın veya Azure CLI'yi yerel olarak yüklediyseniz Windows PowerShell gibi bir komut konsolu uygulaması açın.

2. storage-preview uzantısını yükleyin.

   az extension add -n storage-preview
   

3. Azure CLI'yı yerel olarak kullanıyorsanız oturum açma komutunu çalıştırın.

   az login
   

4. Kimliğiniz birden fazla abonelikle ilişkiliyse, etkin aboneliğinizi depolama hesabının aboneliği olarak ayarlayın.

   az account set --subscription <subscription-id>
   

   <subscription-id> Yer tutucu değerini aboneliğinizin kimliğiyle değiştirin.

5. Blobun etiketlerini almak için komutunu kullanın az storage blob tag list ve parametresini --name blobun adına ayarlayın.

   az storage blob tag list --account-name mystorageaccount --container-name myContainer --name demo-file.txt --auth-mode login
   

6. Blobun etiketlerini ayarlamak için komutunu kullanın az storage blob tag set . parametresini --name blobun adına, parametresini --tags ise ad ve değer çiftleri koleksiyonuna ayarlayın.

   az storage blob tag set --account-name mystorageaccount --container-name myContainer --name demo-file.txt --tags tag1=value1 tag2=value2 --auth-mode login
   

AzCopy

Bkz. Dizin etiketlerini değiştirme

Blob dizini etiketleriyle verileri filtreleme ve bulma

Bu görev, Depolama Blob Veri Sahibi veya özel bir Azure rolü aracılığıyla Azure kaynak sağlayıcısı işlemine Microsoft.Storage/storageAccounts/blobServices/containers/blobs/filter/action izin verilmiş bir güvenlik sorumlusu tarafından gerçekleştirilebilir.

Not

Önceki sürümleri almak için dizin etiketlerini kullanamazsınız. Önceki sürümlerin etiketleri blob dizin altyapısına geçirilmiyor. Daha fazla bilgi için bkz . Koşullar ve bilinen sorunlar.

Portal

Azure portalında blob dizin etiketleri filtresi, seçili kapsayıcınızın kapsamını daraltmak için parametreyi @container otomatik olarak uygular. Etiketli verileri depolama hesabınızın tamamında filtrelemek ve bulmak istiyorsanız REST API'mizi, SDK'larımızı veya araçlarımızı kullanın.

1. Azure portalında depolama hesabınızı seçin.

2. Veri depolama altında Kapsayıcılar seçeneğine gidin ve kapsayıcınızı seçin.

3. Seçili kapsayıcı içinde filtrelemek için Blob Dizini etiketleri filtre düğmesini seçin.

4. Bir blob dizin etiketi anahtarı ve etiket değeri girin.

5. Ek etiket filtreleri (en fazla 10) eklemek için Blob Dizini etiketleri filtre düğmesini seçin.

   

PowerShell

1. Connect-AzAccount komutuyla Azure aboneliğinizde oturum açın ve ekrandaki yönergeleri izleyin.

   Connect-AzAccount
   

2. Kimliğiniz birden fazla abonelikle ilişkiliyse etkin aboneliğinizi ayarlayın. Ardından depolama hesabı bağlamını alın.

   $context = Get-AzSubscription -SubscriptionId <subscription-id>
   Set-AzContext $context
   $storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -AccountName "<storage-account-name>"
   $ctx = $storageAccount.Context   
   

3. Belirli bir blob etiketiyle eşleşen tüm blobları bulmak için komutunu kullanın Get-AzStorageBlobByTag .

   $filterExpression = """tag1""='value1'"
   Get-AzStorageBlobByTag -TagFilterSqlExpression $filterExpression -Context $ctx
   

4. Blobları yalnızca belirli bir kapsayıcıda bulmak için kapsayıcı adını öğesine -TagFilterSqlExpressionekleyin.

   $filterExpression = "@container='myContainer' AND ""tag1""='value1'"
   Get-AzStorageBlobByTag -TagFilterSqlExpression $filterExpression -Context $ctx
   

Azure CLI

1. Azure Cloud Shell'i açın veya Azure CLI'yi yerel olarak yüklediyseniz Windows PowerShell gibi bir komut konsolu uygulaması açın.

2. storage-preview uzantısını yükleyin.

   az extension add -n storage-preview
   

3. Azure CLI'yı yerel olarak kullanıyorsanız oturum açma komutunu çalıştırın.

   az login
   

4. Kimliğiniz birden fazla abonelikle ilişkiliyse, etkin aboneliğinizi depolama hesabının aboneliği olarak ayarlayın.

   az account set --subscription <subscription-id>
   

   <subscription-id> Yer tutucu değerini aboneliğinizin kimliğiyle değiştirin.

5. Belirli bir blob etiketiyle eşleşen tüm blobları bulmak için komutunu kullanın az storage blob filter .

   az storage blob filter --account-name mystorageaccount --tag-filter """tag1""='value1' and ""tag2""='value2'" --auth-mode login
   

6. Blobları yalnızca belirli bir kapsayıcıda bulmak için kapsayıcı adını parametresine --tag-filter ekleyin.

   az storage blob filter --account-name mystorageaccount --tag-filter """@container""='myContainer' and ""tag1""='value1' and ""tag2""='value2'" --auth-mode login
   

AzCopy

Yok

Sonraki adımlar

• Blob dizini etiketleri hakkında daha fazla bilgi edinin, bkz. Blob dizini etiketleriyle Azure Blob verilerini yönetme ve bulma
• Yaşam döngüsü yönetimi hakkında daha fazla bilgi edinin, bkz. Azure Blob Depolama yaşam döngüsünü yönetme
• Birden çok depolama hesabında nesneler üzerinde büyük ölçekte dizin etiketleri ayarlama hakkında daha fazla bilgi edinin. Bkz. Azure Depolama Eylemleri nedir?