Veri Kaynağı Oluşturma (Azure AI Arama REST API'si)

Azure AI Search'te bir veri kaynağı dizin oluşturucularla birlikte kullanılır ve hedef dizinin isteğe bağlı veya zamanlanmış veri yenilemesi için bağlantı bilgilerini sağlar ve desteklenen Azure veri kaynaklarından veri çeker.

İstekte POST veya PUT kullanabilirsiniz. her ikisinde de, istek gövdesindeki JSON belgesi nesne tanımını sağlar.

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

Alternatif olarak PUT kullanabilir ve URI'de adı belirtebilirsiniz.

PUT https://[service name].search.windows.net/datasources/[data source name]?api-version=[api-version]
    Content-Type: application/json  
    api-key: [admin key]    

Tüm hizmet istekleri için HTTPS gereklidir. Nesne yoksa oluşturulur. Zaten varsa, yeni tanıma güncelleştirilir.

URI Parametreleri

İstek Üst Bilgileri

Aşağıdaki tabloda gerekli ve isteğe bağlı istek üst bilgileri açıklanmaktadır.

İstek Gövdesi

İsteğin gövdesi, veri kaynağının türünü, verileri okumak için kimlik bilgilerini ve düzenli aralıklarla zamanlanmış bir dizin oluşturucuyla kullanıldığında veri kaynağındaki değiştirilmiş veya silinmiş verileri verimli bir şekilde tanımlamak için kullanılan isteğe bağlı bir veri değişikliği algılama ve veri silme algılama ilkelerini içeren bir veri kaynağı tanımı içerir.

Aşağıdaki JSON, tanımın ana bölümlerinin üst düzey bir gösterimidir.

{   
    "name" : (optional on PUT; required on POST) "Name of the data source",  
    "description" : (optional) "Anything you want, or nothing at all",  
    "type" : (required) "Must be a supported data source",
    "credentials" : (required) { "connectionString" : "Connection string for your data source" },
    "container": {
        "name": "Name of the table, view, collection, or blob container you wish to index",
        "query": (optional) 
    },
    "dataChangeDetectionPolicy" : (optional) {See below for details },
    "dataDeletionDetectionPolicy" : (optional) {See below for details },
    "encryptionKey":(optional) { }
}  

İstek aşağıdaki özellikleri içerir:

Yanıt

Başarılı bir istek için: 201 Oluşturuldu.

Örnekler

Örnek: Değişiklik algılamalı Azure SQL (Yüksek Filigran Değişiklik Algılama İlkesi)

{   
    "name" : "asqldatasource",  
    "description" : "a description",  
    "type" : "azuresql",  
    "credentials" : { "connectionString" : "Server=tcp:....database.windows.net,1433;Database=...;User ID=...;Password=...;Trusted_Connection=False;Encrypt=True;Connection Timeout=30;" },  
    "container" : { "name" : "sometable" },  
    "dataChangeDetectionPolicy" : { "@odata.type" : "#Microsoft.Azure.Search.HighWaterMarkChangeDetectionPolicy", "highWaterMarkColumnName" : "RowVersion" }
}  

Örnek: Değişiklik algılama ile Azure SQL (SQL Tümleşik Değişiklik İzleme İlkesi)

{   
    "name" : "asqldatasource",  
    "description" : "a description",  
    "type" : "azuresql",  
    "credentials" : { "connectionString" : "Server=tcp:....database.windows.net,1433;Database=...;User ID=...;Password=...;Trusted_Connection=False;Encrypt=True;Connection Timeout=30;" },  
    "container" : { "name" : "sometable" },  
    "dataChangeDetectionPolicy" : { "@odata.type" : "#Microsoft.Azure.Search.SqlIntegratedChangeTrackingPolicy" }
}  

Örnek: Silme algılama ile değişiklik algılama ile Azure SQL

Silme algılama özelliklerinin ve softDeleteMarkerValueolduğunu softDeleteColumnName hatırlayın.

{   
    "name" : "asqldatasource",  
    "description" : "a description",  
    "type" : "azuresql",  
    "credentials" : { "connectionString" : "Server=tcp:....database.windows.net,1433;Database=...;User ID=...;Password=...;Trusted_Connection=False;Encrypt=True;Connection Timeout=30;" },  
    "container" : { "name" : "sometable" },   
    "dataDeletionDetectionPolicy" : { "@odata.type" : "#Microsoft.Azure.Search.SoftDeleteColumnDeletionDetectionPolicy", "softDeleteColumnName" : "IsDeleted", "softDeleteMarkerValue" : "true" }  
}  

Örnek: Yalnızca gerekli özelliklere sahip veri kaynağı

Veri kaynağını yalnızca bir kerelik veri kopyası için kullanmak istiyorsanız, değişiklik ve silme algılamayla ilgili isteğe bağlı özellikler atlanabilir:

{   
    "name" : "asqldatasource",  
    "description" : "anything you want, or nothing at all",  
    "type" : "azuresql",  
    "credentials" : { "connectionString" : "Server=tcp:....database.windows.net,1433;Database=...;User ID=...;Password=...;Trusted_Connection=False;Encrypt=True;Connection Timeout=30;" },  
    "container" : { "name" : "sometable" }  
}   

Örnek: Kimlik bilgilerini atlama

Veri kaynağını güncelleştirmek istiyorsanız kimlik bilgileri gerekli değildir. veya <redacted> değerleri <unchanged> bağlantı dizesi yerine kullanılabilir.

{
    "name" : "adatasource",
    "description": "a description",
    "type": "azuresql",
    "credentials": { "connectionString": "<unchanged>" },
    "container" : { "name": "sometable" }
}

Örnek: Şifreleme anahtarları

Şifreleme anahtarları, ek şifreleme için kullanılan müşteri tarafından yönetilen anahtarlardır. Daha fazla bilgi için bkz. Azure Key Vault'de müşteri tarafından yönetilen anahtarları kullanarak şifreleme.

{
    "name" : "adatasource",
    "description": "a description",
    "type": "azuresql",
    "credentials": { "connectionString": "<unchanged>" },
    "container" : { "name": "sometable" }
    "encryptionKey": (optional) { 
      "keyVaultKeyName": "Name of the Azure Key Vault key used for encryption",
      "keyVaultKeyVersion": "Version of the Azure Key Vault key",
      "keyVaultUri": "URI of Azure Key Vault, also referred to as DNS name, that provides the key. An example URI might be https://my-keyvault-name.vault.azure.net",
      "accessCredentials": (optional, only if not using managed system identity) {
        "applicationId": "Microsoft Entra ID application ID that was granted access permissions to your specified Azure Key Vault",
        "applicationSecret": "Authentication key of the registered application)"}
      }
}

Ayrıca bkz.

• Dizin Oluşturucu’ya genel bakış
• Dizin oluşturucu oluşturma
• Veri kaynakları galerisi