Azure Yapay Zeka Arama'te Azure Depolama için dizin oluşturucuları kullanarak algılamayı değiştirme ve silme

İlk arama dizini oluşturulduktan sonra, sonraki dizin oluşturucu işlerinin yalnızca yeni ve değiştirilmiş belgeleri almasını isteyebilirsiniz. Dizin oluşturucular, Azure Depolama'daki nesneler ve dosyalar üzerindeki yerleşik zaman damgalarını kullanarak son güncelleştirmeyi takip ettiğinden, Azure Depolama'dan kaynaklanan dizinlenmiş içerik için değişiklik algılama otomatik olarak gerçekleşir.

Değişiklik algılama belirli bir değer olsa da silme algılaması değildir. Dizin oluşturucu, veri kaynaklarında nesne silme işlemini izlemez. Yalnız bırakılmış arama belgelerinin olmasını önlemek için, ikinci bir adım olarak Azure Depolama'da fiziksel silme işlemiyle önce arama belgelerinin silinmesine neden olan bir "geçici silme" stratejisi uygulayabilirsiniz.

Geçici silme stratejisini uygulamanın iki yolu vardır:

• Yerel blob geçici silme, yalnızca Blob Depolama için geçerlidir
• Özel meta verileri kullanarak yumuşak silme

Silme algılama stratejisi ilk dizin oluşturucu çalıştırmasından uygulanmalıdır. İlk çalıştırmadan önce silme ilkesini oluşturmadıysanız, ilkeyi daha sonra dizin oluşturucuya ekleyip sıfırlasanız bile, ilke uygulanmadan önce silinen tüm belgeler dizininizde kalır. Bu oluştuysa, silme ilkesinin en başından itibaren geçerli olduğundan emin olmak için yeni bir dizin oluşturucu kullanarak yeni bir dizin oluşturmanız önerilir.

Önkoşullar

• Azure Depolama dizin oluşturucusunu Blob Depolama, Tablo Depolama, Dosya Depolama veya Data Lake Storage 2. Nesil için kullanın.

• Tutarlı belge anahtarlarını ve dosya yapısını kullanın. Belge anahtarlarının veya dizin adlarının ve yollarının değiştirilmesi (ADLS 2. Nesil için geçerlidir), dizin oluşturucular tarafından hangi içeriğin dizine eklendiğini ve en son ne zaman dizinlendiğini bilmek için kullanılan iç izleme bilgilerini bozar.

Yerel blob yumuşak silme

Bu silme algılama yaklaşımı için Azure Yapay Zeka Arama, blobların geçici silme durumuna geçirilip geçirmediğini belirlemek için Azure Blob Depolama'daki yerel blob geçici silme özelliğine bağlıdır. Bloblar bu durumda algılandığında, arama dizin oluşturucu bu bilgileri kullanarak ilgili belgeyi dizinden kaldırır.

Özgün yumuşak silme gereksinimleri

• Bloblar, ADLS 2. Nesil Blob kapsayıcısı da dahil olmak üzere bir Azure Blob Depolama kapsayıcısında olmalıdır. Azure Dosyalar için Azure Yapay Zeka Arama yerel blob geçici silme ilkesi desteklenmez.

• Bloblar için geçici silmeyi etkinleştirin.

• Dizininizdeki belgelerin belge anahtarları bir blob özelliği veya "metadata_storage_path" gibi blob meta verileri olacak şekilde eşlenmelidir.

• Geçici silme desteğini yapılandırmak için Azure portalında REST API'yi veya dizin oluşturucu Veri Kaynağı yapılandırmasını kullanabilirsiniz.

• Blob sürüm oluşturma , depolama hesabında etkinleştirilmemelidir. Aksi takdirde, doğal yumuşak silme tasarım gereği desteklenmez.

Yerel geçici silme özelliğini yapılandırma

Blob Depolama'da, gereksinimlere göre geçici silmeyi etkinleştirirken bekletme ilkesini dizin oluşturucu aralığı zamanlamanızdan çok daha yüksek bir değere ayarlayın. Dizin oluşturucuyu çalıştırırken bir sorun varsa veya dizine eklemek için çok sayıda belgeniz varsa, dizin oluşturucunun geçici olarak silinen blobları işlemesi için yeterli zaman vardır. Azure Yapay Zeka Arama dizin oluşturucuları bir belgeyi dizinden yalnızca blob geçici silinme durumundayken işlerse siler.

Azure Yapay Zeka Arama'te veri kaynağında yerel blob geçici silme algılama ilkesini ayarlayın. Bunu Azure portalından veya REST API kullanarak yapabilirsiniz. Aşağıdaki yönergeler, Azure portalında veya REST API'leri aracılığıyla silme algılama ilkesinin nasıl ayarlanacağı açıklanmaktadır.

PUT https://[service name].search.windows.net/datasources/blob-datasource?api-version=2026-04-01
Content-Type: application/json
api-key: [admin key]
{
   "name" : "blob-datasource",
   "type" : "azureblob",
   "credentials" : { "connectionString" : "<your storage connection string>" },
   "container" : { "name" : "my-container", "query" : null },
   "dataDeletionDetectionPolicy" : {
   "@odata.type" :"#Microsoft.Azure.Search.NativeBlobSoftDeleteDeletionDetectionPolicy"
   }
}

Yerel geçici silme ilkelerini kullanarak silinmemiş blobları yeniden dizine alma

Blob Depolama'da geçici olarak silinen bir blobu geri yüklerseniz, dizin oluşturucu bunu her zaman yeniden dizine almaz. Bunun nedeni, dizin oluşturucunun dizin oluşturma gerekip gerekmediğini belirlemek için blob'un LastModified zaman damgasını kullanmasıdır. Geçici olarak silinen blob silinmediğinde, LastModified zaman damgası güncelleştirilmez, bu nedenle dizin oluşturucu daha yeni LastModified zaman damgalarına sahip blobları zaten işlediyse, silinmemiş blobu yeniden dizine almaz.

Silinmemiş bir blobu yeniden dizine almak için blob'un zaman damgasını güncelleştirin LastModified . Bunu yapmak için söz konusu blobun meta verilerini yeniden kaydetmek gerekir. Meta verileri değiştirmeniz gerekmez, ancak meta verileri yeniden kaydettiğinizde, dizin oluşturucunun bu verileri almasını bilmesi için blob'un LastModified zaman damgası güncelleştirilir.

Özel meta verileri kullanarak geçici silme stratejisi

Bu yöntem, arama belgesinin dizinden kaldırılması gerekip gerekmediğini belirtmek için özel meta veriler kullanır. İki ayrı eylem gerektirir: arama belgesini dizinden silme ve ardından Azure Depolama'da dosya silme.

Bu özellik genel olarak kullanılabilir.

Hem Azure Depolama hem de Azure Yapay Zeka Arama'te izleyebileceğiniz adımlar vardır, ancak başka özellik bağımlılıkları yoktur.

1. Azure Depolama'da, dosyaya bir özel meta veri anahtar-değer çifti ekleyerek dosyanın silinmek üzere işaretlenmiş olduğunu belirtin. Örneğin, özelliğini "IsDeleted" olarak adlandırabilir ve false olarak ayarlayabilirsiniz. Dosyayı silmek istediğinizde true olarak değiştirin.

2. Azure Yapay Zeka Arama'te veri kaynağı tanımını "dataDeletionDetectionPolicy" özelliğini içerecek şekilde düzenleyin. Örneğin, aşağıdaki ilke değeriyle IsDeletedbir meta veri özelliğine true sahipse bir dosyanın silinmesini dikkate alır:

   PUT https://[service name].search.windows.net/datasources/file-datasource?api-version=2026-04-01
   {
       "name" : "file-datasource",
       "type" : "azurefile",
       "credentials" : { "connectionString" : "<your storage connection string>" },
       "container" : { "name" : "my-share", "query" : null },
       "dataDeletionDetectionPolicy" : {
           "@odata.type" :"#Microsoft.Azure.Search.SoftDeleteColumnDeletionDetectionPolicy",
           "softDeleteColumnName" : "IsDeleted",
           "softDeleteMarkerValue" : "true"
       }
   }
   

3. Dizin oluşturucuyu çalıştırın. Dizin oluşturucu dosyayı işledikten ve belgeyi arama dizininden sildikten sonra Azure Depolama'daki fiziksel dosyayı silebilirsiniz.

Silinmemiş blobları ve dosyaları yeniden dizine alma

Özgün kaynak dosya Azure Depolama'da hala fiziksel olarak mevcutsa geçici silme işlemini tersine çevirebilirsiniz.

1. Azure Depolama'daki blob veya dosyadaki "softDeleteMarkerValue" : "false" ögesini değiştirin.

2. Blob veya dosyanın LastModified zaman damgasını denetleerek son dizin oluşturucu çalıştırmasından daha yeni olmasını sağlayın. Mevcut meta verileri yeniden kaydetmek suretiyle bir güncelleştirmeyi geçerli tarih ve saate zorlayabilirsiniz.

3. Dizin oluşturucuyu çalıştırın.

Sınırlamalar

Bire çok dizin oluşturma senaryoları kullanılırken ne yerel blob geçici silme ne de özel meta veriler aracılığıyla geçici silme geçerli değildir. Belge girdisini silmek için REST API silme işlemini kullanarak dizine bir silme isteği göndermeniz gerekir.

Sonraki Adımlar

• Azure Yapay Zeka Arama'te dizin oluşturucular
• Blob dizin oluşturucu nasıl yapılandırılır
• Blob dizine genel bakış