Azure Yapay Zeka Arama sorguları için Azure Cosmos DB for MongoDB verilerini dizine ekleme (önizleme)

MongoDB dizin oluşturucu (önizleme) için Azure Cosmos DB, MongoDB için Azure Cosmos DB içeriği içeri aktarır ve Azure Yapay Zeka Arama içinde aranabilir hale getirir.

Bu makale, Cosmos DB'ye özgü bilgilerle dizin oluşturucu oluşturma makalesini tamamlar. Rest API'lerini kullanarak tüm dizin oluşturucular için ortak olan üç parçalı bir iş akışını gösterir: veri kaynağı oluşturma, dizin oluşturma, dizin oluşturucu oluşturma. Dizin Oluşturucu Oluştur isteğini gönderdiğinizde veri ayıklama gerçekleşir.

Terminoloji kafa karıştırıcı olabileceği için Azure Cosmos DB dizin oluşturma ve Azure Yapay Zeka Arama dizin oluşturma farklı işlemler olduğunu belirtmek gerekir. Azure Yapay Zeka Arama'de dizin oluşturma, arama hizmetinizde bir arama dizini oluşturur ve yükler.

Önkoşullar

• Dizin oluşturucu önizleme kayıt formunu doldurun. Kayıt otomatik olarak onaylanır.

• Azure Cosmos DB hesabı, veritabanı, koleksiyon ve belgeler. Daha düşük gecikme süresi için hem Azure Yapay Zeka Arama hem de Azure Cosmos DB için aynı bölgeyi kullanın ve bant genişliği ücretlerinden kaçının.

• Azure Cosmos DB koleksiyonundaki otomatik dizin oluşturma ilkesiTutarlı olarak ayarlanır. Bu ayar varsayılan yapılandırmadır. Gecikmeli dizin oluşturma önerilmez ve eksik verilere neden olabilir.

• Okuma izinleri. "Tam erişim" bağlantı dizesi, içeriğe erişim sağlayan bir anahtar içerir, ancak Azure rolleri kullanıyorsanız, arama hizmeti yönetilen kimliği'nin Cosmos DB Hesap Okuyucu Rolü izinlerine sahip olduğundan emin olun.

• Veri kaynağını, dizini ve dizin oluşturucuyu oluşturmak için bir REST istemcisi .

Sınırlama

Bu özelliğin sınırlamaları şunlardır:

• Veri kümesini belirtmek için özel sorgular desteklenmez.

• Sütun adı _ts rezerv edilmiş bir kelimedir. Bu alana ihtiyacınız varsa, dizin doldurmaya yönelik alternatif çözümleri göz önünde bulundurun.

• MongoDB özniteliği $ref ayrılmış bir sözcükdür. MongoDB koleksiyonunuzda buna ihtiyacınız varsa, dizin doldurmaya yönelik alternatif çözümleri göz önünde bulundurun.

Bu bağlayıcıya alternatif olarak, senaryonuzda bu gereksinimlerden herhangi biri varsa Push API/SDK kullanabilir veya havuz olarak Azure Yapay Zeka Arama dizini ile Azure Data Factory göz önünde bulundurabilirsiniz.

Veri kaynağını tanımlama

Veri kaynağı tanımı, verilerdeki değişiklikleri tanımlamak için dizine eklenecek verileri, kimlik bilgilerini ve ilkeleri belirtir. Veri kaynağı, birden çok dizin oluşturucu tarafından kullanılabilmesi için bağımsız bir kaynak olarak tanımlanır.

Bu çağrı için, MongoDB API'sini kullanarak bağlanan bir veri kaynağı oluşturmak için bir önizleme REST API sürümü belirtin. 2020-06-30-preview veya daha sonraki bir sürümünü kullanabilirsiniz. En son önizleme REST API'sini öneririz.

1. Tanımını ayarlamak için bir veri kaynağı oluşturun veya güncelleştirin:

   POST https://[service name].search.windows.net/datasources?api-version=2026-08-01-preview
   Content-Type: application/json
   api-key: [Search service admin key]
   {
     "name": "[my-cosmosdb-mongodb-ds]",
     "type": "cosmosdb",
     "credentials": {
       "connectionString": "AccountEndpoint=https://[cosmos-account-name].documents.azure.com;AccountKey=[cosmos-account-key];Database=[cosmos-database-name];ApiKind=MongoDb;"
     },
     "container": {
       "name": "[cosmos-db-collection]"
     },
     "dataChangeDetectionPolicy": {
       "@odata.type": "#Microsoft.Azure.Search.HighWaterMarkChangeDetectionPolicy",
       "highWaterMarkColumnName": "_ts"
     },
     "dataDeletionDetectionPolicy": null,
     "encryptionKey": null,
     "identity": null
   }
   

2. "type" değerini (gerekli) olarak "cosmosdb" ayarlayın.

3. Kimlik bilgilerini bir bağlantı dizesi olarak ayarlayın. Sonraki bölümde desteklenen biçimler açıklanmaktadır.

4. "kapsayıcıyı koleksiyona ayarlayın." "name" özelliği gereklidir ve dizine eklenecek veritabanı koleksiyonunun kimliğini belirtir. Azure Cosmos DB'nin MongoDB sürümünde "sorgular" desteklenmemektedir.

5. Veriler geçiciyse ve dizin oluşturucunun sonraki çalıştırmalarda yalnızca yeni ve güncelleştirilmiş öğeleri almasını istiyorsanız "dataChangeDetectionPolicy" değerini ayarlayın.

6. Kaynak öğe silindiğinde arama belgelerini bir arama dizininden kaldırmak istiyorsanız "dataDeletionDetectionPolicy" değerini ayarlayın.

Desteklenen kimlik bilgileri ve bağlantı dizeleri

Dizin oluşturucular aşağıdaki bağlantıları kullanarak bir koleksiyona bağlanabilir. MongoDB API'yi hedefleyen bağlantılar için bağlantı dizesine "ApiKind" eklemeyi unutmayın.

Uç nokta URL'sinde bağlantı noktası numaralarından kaçının. Bağlantı noktası numarasını eklerseniz bağlantı başarısız olur.

Dizine arama alanları ekleme

Arama dizininde, kaynak JSON belgelerini veya özel sorgu projeksiyonunuzun çıkışını kabul etmek için alanlar ekleyin. Arama dizini şemasının kaynak verilerle uyumlu olduğundan emin olun. Azure Cosmos DB içeriğindeki arama dizini şemanız, veri kaynağınızdaki Azure Cosmos DB öğeleri ile uyumlu olmalıdır.

1. Verileri depolayan arama alanlarını tanımlamak için bir dizin oluşturun veya güncelleştirin:

   POST https://[service name].search.windows.net/indexes?api-version=2026-08-01-preview
   Content-Type: application/json
   api-key: [Search service admin key]
   
   {
       "name": "mysearchindex",
       "fields": [{
           "name": "doc_id",
           "type": "Edm.String",
           "key": true,
           "retrievable": true,
           "searchable": false
       }, {
           "name": "description",
           "type": "Edm.String",
           "filterable": false,
           "searchable": true,
           "sortable": false,
           "facetable": false,
           "suggestions": true
       }]
   }
   

2. Belge anahtar alan oluştur ("key": true). MongoDB koleksiyonunu temel alan bir arama dizini için, belge anahtarı "doc_id", "rid" veya benzersiz değerler içeren başka bir dize alanı olabilir. Alan adları ve veri türleri her iki tarafta da aynı olduğu sürece alan eşlemesi gerekmez.

   • "doc_id", nesne tanımlayıcısı için "_id" temsil eder. Dizinde bir "doc_id" alanı belirtirseniz, dizin oluşturucu bunu nesne tanımlayıcısının değerleriyle doldurur.

   • "rid", Azure Cosmos DB bir sistem özelliğidir. Dizinde bir "rid" alanı belirtirseniz, dizin oluşturucu bunu "rid" özelliğinin base64 kodlanmış değeriyle doldurur.

   • Diğer alanlarda, arama alanınız koleksiyonda tanımlanan adla aynı adı taşımalıdır.

3. Daha fazla aranabilir içerik için ek alanlar oluşturun. Ayrıntılar için bkz. Dizin oluşturma .

Veri türlerini eşleme

MongoDB dizin oluşturucusu için Azure Cosmos DB yapılandırma ve çalıştırma

Dizin ve veri kaynağı oluşturulduktan sonra dizin oluşturucuyu oluşturmaya hazır olursunuz. Dizin oluşturucu yapılandırması, çalışma zamanı davranışlarını denetleen girişleri, parametreleri ve özellikleri belirtir.

1. Dizin oluşturucuya bir ad verip veri kaynağına ve hedef dizine başvurarak dizin oluşturucu oluşturun veya güncelleştirin:

   POST https://[service name].search.windows.net/indexers?api-version=2026-08-01-preview
   Content-Type: application/json
   api-key: [search service admin key]
   {
       "name" : "[my-cosmosdb-indexer]",
       "dataSourceName" : "[my-cosmosdb-mongodb-ds]",
       "targetIndexName" : "[my-search-index]",
       "disabled": null,
       "schedule": null,
       "parameters": {
           "batchSize": null,
           "maxFailedItems": 0,
           "maxFailedItemsPerBatch": 0,
           "base64EncodeKeys": false,
           "configuration": {}
           },
       "fieldMappings": [],
       "encryptionKey": null
   }
   

2. Alan adında veya türünde farklılıklar varsa veya arama dizininde bir kaynak alanın birden çok sürümüne ihtiyacınız varsa alan eşlemelerini belirtin.

3. Diğer özellikler hakkında daha fazla bilgi için bkz. Dizin oluşturucu oluşturma .

Dizin oluşturucu oluşturulduğunda otomatik olarak çalışır. "disabled" ayarını true olarak ayarlayarak bunu önleyebilirsiniz. Dizin oluşturucu yürütmesini denetlemek için isteğe bağlı olarak bir dizin oluşturucu çalıştırın veya zamanlamaya yerleştirin.

Dizin oluşturucu durumunu kontrol etme

Dizin oluşturucu durumunu ve yürütme geçmişini izlemek için Dizin Oluşturucu Durumunu Al isteği gönderin:

GET https://myservice.search.windows.net/indexers/myindexer/status?api-version=2026-08-01-preview
  Content-Type: application/json  
  api-key: [admin key]

Yanıt, durumu ve işlenen öğe sayısını içerir. Aşağıdaki örneğe benzer görünmelidir:

    {
        "status":"running",
        "lastResult": {
            "status":"success",
            "errorMessage":null,
            "startTime":"2022-02-21T00:23:24.957Z",
            "endTime":"2022-02-21T00:36:47.752Z",
            "errors":[],
            "itemsProcessed":1599501,
            "itemsFailed":0,
            "initialTrackingState":null,
            "finalTrackingState":null
        },
        "executionHistory":
        [
            {
                "status":"success",
                "errorMessage":null,
                "startTime":"2022-02-21T00:23:24.957Z",
                "endTime":"2022-02-21T00:36:47.752Z",
                "errors":[],
                "itemsProcessed":1599501,
                "itemsFailed":0,
                "initialTrackingState":null,
                "finalTrackingState":null
            },
            ... earlier history items
        ]
    }

Yürütme geçmişi, en son tamamlanan yürütmelerin en son 50'sini içerir ve en son yürütme önce gelecek şekilde ters kronolojik sırada sıralanır.

Yeni ve değiştirilmiş belgelerin dizinini oluşturma

Dizin oluşturucu bir arama dizinini tam olarak doldurduktan sonra, sonraki dizin oluşturucu çalıştırmalarının veritabanınızdaki yalnızca yeni ve değiştirilmiş belgeleri artımlı olarak dizinlemesini isteyebilirsiniz.

Artımlı dizin oluşturmayı etkinleştirmek için veri kaynağı tanımınızda "dataChangeDetectionPolicy" özelliğini ayarlayın. Bu özellik, dizin oluşturucuya verilerinizde hangi değişiklik izleme mekanizmasının kullanıldığını bildirir.

Azure Cosmos DB dizin oluşturucular için desteklenen tek ilke, Azure Cosmos DB tarafından sağlanan HighWaterMarkChangeDetectionPolicy (zaman damgası) özelliğini kullanan _ts ilkesidir.

Aşağıdaki örnekte, değişiklik algılama ilkesine sahip bir veri kaynağı tanımı gösterilmektedir:

"dataChangeDetectionPolicy": {
    "@odata.type": "#Microsoft.Azure.Search.HighWaterMarkChangeDetectionPolicy",
    "highWaterMarkColumnName": "_ts"
},

Silinen belgelerin dizinini oluşturma

Satırlar koleksiyondan silindiğinde, normalde bu satırları da arama dizininden silmek istersiniz. Veri silme algılama ilkesinin amacı, silinen veri öğelerini verimli bir şekilde tanımlamaktır. Şu anda desteklenen tek ilke Soft Delete , veri kaynağı tanımında aşağıdaki gibi belirtilen ilkedir (silme işlemi bir tür bayrakla işaretlenir):

"dataDeletionDetectionPolicy": {
    "@odata.type" : "#Microsoft.Azure.Search.SoftDeleteColumnDeletionDetectionPolicy",
    "softDeleteColumnName" : "the property that specifies whether a document was deleted",
    "softDeleteMarkerValue" : "the value that identifies a document as deleted"
}

Özel sorgu kullanıyorsanız, softDeleteColumnName tarafından başvuruda bulunulan özelliğin sorgu tarafından yansıtıldığından emin olun.

Aşağıdaki örnek geçici silme ilkesine sahip bir veri kaynağı oluşturur:

POST https://[service name].search.windows.net/datasources?api-version=2026-08-01-preview
Content-Type: application/json
api-key: [Search service admin key]

{
    "name": "my-cosmosdb-mongodb-ds",
    "type": "cosmosdb",
    "credentials": {
        "connectionString": "AccountEndpoint=https://[cosmos-account-name].documents.azure.com;AccountKey=[cosmos-account-key];Database=[cosmos-database-name];ApiKind=MongoDb"
    },
    "container": { "name": "[my-cosmos-collection]" },
    "dataChangeDetectionPolicy": {
        "@odata.type": "#Microsoft.Azure.Search.HighWaterMarkChangeDetectionPolicy",
        "highWaterMarkColumnName": "_ts"
    },
    "dataDeletionDetectionPolicy": {
        "@odata.type": "#Microsoft.Azure.Search.SoftDeleteColumnDeletionDetectionPolicy",
        "softDeleteColumnName": "isDeleted",
        "softDeleteMarkerValue": "true"
    }
}

Sonraki adımlar

Artık dizin oluşturucuyu çalıştırmayı, durumu izlemeyi veya dizin oluşturucu yürütmeyi zamanlamayı denetleyebilirsiniz. Aşağıdaki makaleler, Azure Cosmos DB içerik çeken dizin oluşturucular için geçerlidir:

• Yönetilen kimlik kullanarak Azure Cosmos DB veritabanına dizin oluşturucu bağlantısı kurma
• Büyük veri kümelerini dizine ekleme
• Azure ağ güvenlik özellikleriyle korunan içeriğe Indexer erişimi