Data Sources - Create

Hizmet:: Search Service

API Sürümü:: 2025-09-01

Yeni bir veri kaynağı oluşturur.

POST {endpoint}/datasources?api-version=2025-09-01

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
endpoint	path	True	string	Arama hizmetinin uç nokta URL'si.
api-version	query	True	string	İstemci Api Sürümü.

İstek Başlığı

Name	Gerekli	Tür	Description
x-ms-client-request-id		string (uuid)	Hata ayıklamaya yardımcı olmak için istekle birlikte gönderilen izleme kimliği.

İstek Gövdesi

Name	Gerekli	Tür	Description
container	True	SearchIndexerDataContainer	Veri kaynağı için veri kapsayıcısı.
credentials	True	DataSourceCredentials	Veri kaynağı için kimlik bilgileri.
name	True	string	Veri kaynağının adı.
type	True	SearchIndexerDataSourceType	Veri kaynağının türü.
@odata.etag		string	Veri kaynağının ETag'i.
dataChangeDetectionPolicy		DataChangeDetectionPolicy: HighWaterMarkChangeDetectionPolicy SqlIntegratedChangeTrackingPolicy	Veri kaynağı için veri değişikliği algılama ilkesi.
dataDeletionDetectionPolicy		DataDeletionDetectionPolicy: SoftDeleteColumnDeletionDetectionPolicy	Veri kaynağı için veri silme algılama ilkesi.
description		string	Veri kaynağının açıklaması.
encryptionKey		SearchResourceEncryptionKey	Azure Key Vault'ta oluşturduğunuz bir şifreleme anahtarının açıklaması. Bu anahtar, hiç kimsenin, hatta Microsoft'un bile veri kaynağı tanımınızın şifresini çözemeyeceğinden tam olarak emin olmak istediğinizde, veri kaynağı tanımınız için ek bir bekleyen şifreleme düzeyi sağlamak için kullanılır. Veri kaynağı tanımınızı şifreledikten sonra, her zaman şifreli kalacaktır. Arama hizmeti, bu özelliği null olarak ayarlama girişimlerini yoksayar. Şifreleme anahtarınızı döndürmek istiyorsanız bu özelliği gerektiği gibi değiştirebilirsiniz; Veri kaynağı tanımınız etkilenmez. Müşteri tarafından yönetilen anahtarlarla şifreleme, ücretsiz arama hizmetleri için kullanılamaz ve yalnızca 1 Ocak 2019'da veya sonrasında oluşturulan ücretli hizmetler için kullanılabilir.

Yanıtlar

Name	Tür	Description
201 Created	SearchIndexerDataSource
Other Status Codes	ErrorResponse	Hata yanıtı.

Örnekler

SearchServiceCreateDataSource

Örnek isteği

HTTP

POST https://stableexampleservice.search.windows.net/datasources?api-version=2025-09-01


{
  "name": "tempdatasource",
  "description": "My Azure Blob data source.",
  "type": "azureblob",
  "credentials": {
    "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net "
  },
  "container": {
    "name": "doc-extraction-skillset",
    "query": "E2E_Dsat"
  },
  "dataChangeDetectionPolicy": {
    "highWaterMarkColumnName": "metadata_storage_last_modified",
    "@odata.type": "#Microsoft.Azure.Search.HighWaterMarkChangeDetectionPolicy"
  },
  "dataDeletionDetectionPolicy": {
    "softDeleteColumnName": "isDeleted",
    "softDeleteMarkerValue": "true",
    "@odata.type": "#Microsoft.Azure.Search.SoftDeleteColumnDeletionDetectionPolicy"
  },
  "@odata.etag": "0x1234568AE7E58A1"
}

Örnek yanıt

Durum kodu:: 201

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "tempdatasource",
  "description": "My Azure Blob data source.",
  "type": "azureblob",
  "credentials": {
    "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net "
  },
  "container": {
    "name": "doc-extraction-skillset",
    "query": "E2E_Dsat"
  },
  "dataChangeDetectionPolicy": {
    "@odata.type": "#Microsoft.Azure.Search.HighWaterMarkChangeDetectionPolicy",
    "highWaterMarkColumnName": "metadata_storage_last_modified"
  },
  "dataDeletionDetectionPolicy": {
    "@odata.type": "#Microsoft.Azure.Search.SoftDeleteColumnDeletionDetectionPolicy",
    "softDeleteColumnName": "isDeleted",
    "softDeleteMarkerValue": "true"
  }
}

Tanımlar

Name	Description
AzureActiveDirectoryApplicationCredentials	Arama hizmetiniz için oluşturulan ve Azure Key Vault'ta depolanan şifreleme anahtarlarına kimliği doğrulanmış erişim için kullanılan kayıtlı bir uygulamanın kimlik bilgileri.
DataSourceCredentials	Bir veri kaynağına bağlanmak için kullanılabilecek kimlik bilgilerini temsil eder.
ErrorAdditionalInfo	Kaynak yönetimi hatası ek bilgileri.
ErrorDetail	Hata ayrıntısı.
ErrorResponse	Hata yanıtı
HighWaterMarkChangeDetectionPolicy	Yüksek su işareti sütununun değerine dayalı olarak değişiklikleri yakalayan bir veri değişikliği algılama ilkesi tanımlar.
SearchIndexerDataContainer	Dizine alınacak varlık (Azure SQL tablosu veya CosmosDB koleksiyonu gibi) hakkındaki bilgileri temsil eder.
SearchIndexerDataSource	Dizin oluşturucuyu yapılandırmak için kullanılabilecek bir veri kaynağı tanımını temsil eder.
SearchIndexerDataSourceType	Bir veri kaynağının türünü tanımlar.
SearchResourceEncryptionKey	Azure Key Vault'ta müşteri tarafından yönetilen bir şifreleme anahtarı. Oluşturduğunuz ve yönettiğiniz anahtarlar, dizinler ve eş anlamlı eşlemeler gibi bekleyen verileri şifrelemek veya şifresini çözmek için kullanılabilir.
SoftDeleteColumnDeletionDetectionPolicy	Geçici silme stratejisi uygulayan bir veri silme algılama ilkesi tanımlar. Belirlenen 'geçici silme' sütununun değerine bağlı olarak bir öğenin silinmesi gerekip gerekmediğini belirler.
SqlIntegratedChangeTrackingPolicy	Azure SQL Veritabanı'nın Tümleşik Değişiklik İzleme özelliğini kullanarak değişiklikleri yakalayan bir veri değişikliği algılama ilkesi tanımlar.

AzureActiveDirectoryApplicationCredentials

Object

Arama hizmetiniz için oluşturulan ve Azure Key Vault'ta depolanan şifreleme anahtarlarına kimliği doğrulanmış erişim için kullanılan kayıtlı bir uygulamanın kimlik bilgileri.

Name	Tür	Description
applicationId	string	Bekleyen verilerinizi şifrelerken kullanılacak Azure Key Vault için gerekli erişim izinleri verilmiş bir AAD Uygulama Kimliği. Uygulama Kimliği, AAD Uygulamanızın Nesne Kimliği ile karıştırılmamalıdır.
applicationSecret	string	Belirtilen AAD uygulamasının kimlik doğrulama anahtarı.

DataSourceCredentials

Object

Bir veri kaynağına bağlanmak için kullanılabilecek kimlik bilgilerini temsil eder.

Name	Tür	Description
connectionString	string	Veri kaynağı için bağlantı dizesi. Azure SQL, Azure Blob, ADLS Gen 2 ve Azure Tablosu için bu, yönetilen kimlik kullanılıyorsa bağlantı dizesi veya kaynak kimliği olacaktır. CosmosDB için bu, yönetilen kimlik için ApiKind veya kaynak kimliğini belirten biçimlendirilmiş bir bağlantı dizesi olacaktır. Onelake dosyaları için bağlantı dizesi çalışma alanı guid'i veya çalışma alanı FQDN'si olabilir; Onelake yalnızca yönetilen kimlik bağlantılarını destekler. Bağlantı dizesinin güncelleştirilmesini istemiyorsanız (köşeli parantezlerle) olarak `<unchanged>` ayarlayın. Veri kaynağından bağlantı dizesi değerini kaldırmak istiyorsanız olarak `<redacted>` ayarlayın.

ErrorAdditionalInfo

Object

Kaynak yönetimi hatası ek bilgileri.

Name	Tür	Description
info	object	Ek bilgiler.
type	string	Ek bilgi türü.

ErrorDetail

Object

Hata ayrıntısı.

Name	Tür	Description
additionalInfo	ErrorAdditionalInfo[]	Hata ek bilgileri.
code	string	Hata kodu.
details	ErrorDetail[]	Hata ayrıntıları.
message	string	Hata iletisi.
target	string	Hata hedefi.

ErrorResponse

Object

Hata yanıtı

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.

HighWaterMarkChangeDetectionPolicy

Object

Yüksek su işareti sütununun değerine dayalı olarak değişiklikleri yakalayan bir veri değişikliği algılama ilkesi tanımlar.

Name	Tür	Description
@odata.type	string: #Microsoft.Azure.Search.HighWaterMarkChangeDetectionPolicy	Veri değişikliği algılama ilkesinin türünü belirten bir URI parçası.
highWaterMarkColumnName	string	Yüksek su işareti sütununun adı.

SearchIndexerDataContainer

Object

Dizine alınacak varlık (Azure SQL tablosu veya CosmosDB koleksiyonu gibi) hakkındaki bilgileri temsil eder.

Name	Tür	Description
name	string	Dizine alınacak tablonun veya görünümün adı (Azure SQL veri kaynağı için), koleksiyon (CosmosDB veri kaynağı için), kapsayıcı (Azure Blob ve ADLS Gen 2 veri kaynakları için), Azure Tablosu (Azure Tablosu veri kaynağı için) veya göl evi (Onelake veri kaynağı için).
query	string	Bu veri kapsayıcısına uygulanan bir sorgu. CosmosDB için veri kaynağı sorgusu verileri düzleştirebilir ve filtreleyebilir. Azure Blob ve ADLS Gen 2 için sorgu klasörlere göre filtreleyebilir. Azure Tablosu sorgusu için satır verilerine göre filtreleyebilir. Onelake sorgusu için klasöre veya kısayola göre filtreleyebilir. Azure SQL veri kaynakları tarafından desteklenmez.

SearchIndexerDataSource

Object

Dizin oluşturucuyu yapılandırmak için kullanılabilecek bir veri kaynağı tanımını temsil eder.

Name	Tür	Description
@odata.etag	string	Veri kaynağının ETag'i.
container	SearchIndexerDataContainer	Veri kaynağı için veri kapsayıcısı.
credentials	DataSourceCredentials	Veri kaynağı için kimlik bilgileri.
dataChangeDetectionPolicy	DataChangeDetectionPolicy: HighWaterMarkChangeDetectionPolicy SqlIntegratedChangeTrackingPolicy	Veri kaynağı için veri değişikliği algılama ilkesi.
dataDeletionDetectionPolicy	DataDeletionDetectionPolicy: SoftDeleteColumnDeletionDetectionPolicy	Veri kaynağı için veri silme algılama ilkesi.
description	string	Veri kaynağının açıklaması.
encryptionKey	SearchResourceEncryptionKey	Azure Key Vault'ta oluşturduğunuz bir şifreleme anahtarının açıklaması. Bu anahtar, hiç kimsenin, hatta Microsoft'un bile veri kaynağı tanımınızın şifresini çözemeyeceğinden tam olarak emin olmak istediğinizde, veri kaynağı tanımınız için ek bir bekleyen şifreleme düzeyi sağlamak için kullanılır. Veri kaynağı tanımınızı şifreledikten sonra, her zaman şifreli kalacaktır. Arama hizmeti, bu özelliği null olarak ayarlama girişimlerini yoksayar. Şifreleme anahtarınızı döndürmek istiyorsanız bu özelliği gerektiği gibi değiştirebilirsiniz; Veri kaynağı tanımınız etkilenmez. Müşteri tarafından yönetilen anahtarlarla şifreleme, ücretsiz arama hizmetleri için kullanılamaz ve yalnızca 1 Ocak 2019'da veya sonrasında oluşturulan ücretli hizmetler için kullanılabilir.
name	string	Veri kaynağının adı.
type	SearchIndexerDataSourceType	Veri kaynağının türü.

SearchIndexerDataSourceType

Listeleme

Bir veri kaynağının türünü tanımlar.

Değer	Description
azuresql	Kimlik bilgileri standart bir SQL bağlantı dizesi veya SQL kaynağının ResourceId'si olabilen bir Azure SQL veri kaynağının tanımı. Kapsayıcı özelliği, dizine alınacak tabloya veya görünüme başvurur. Sorgu parametresi bu veri kaynağı için desteklenmiyor.
cosmosdb	Kimlik bilgileri, anahtar tabanlı bağlantı için AccountEndpoint, AccountKey ve Database ayrıntılarını veya anahtarsız bağlantı için ResourceID ve ApiKind ayrıntılarını içeren biçimlendirilmiş bir bağlantı dizesi olabilen bir CosmosDB veri kaynağının tanımı. Kapsayıcı özelliği, dizine alınacak cosmosdb koleksiyonuna başvurur ve isteğe bağlı sorgu özelliği, koleksiyondaki bir SQL sorgusuna başvurur.
azureblob	Kimlik bilgileri depolama bağlantı dizesi veya depolama hesabının ResourceId'si olabilen bir Azure Blob veri kaynağının tanımı. Kapsayıcı özelliği, dizine alınacak blob kapsayıcısını ifade eder ve isteğe bağlı sorgu özelliği, kapsayıcıdaki belirli bir alt klasöre başvurur.
azuretable	Kimlik bilgileri tablo bağlantı dizesi veya depolama hesabının ResourceId'si olabilen bir Azure Tablosu veri kaynağının tanımı. Kapsayıcı özelliği, dizine alınacak blob kapsayıcısını ifade eder ve isteğe bağlı sorgu özelliği satırları filtrelemek için kullanılabilir.
mysql	Kimlik bilgileri standart ADO.NET biçimlendirilmiş bir SQL bağlantı dizesi veya SQL kaynağının ResourceId'si olabilen bir Azure SQL veri kaynağının tanımı. Kapsayıcı özelliği, dizine alınacak tabloya veya görünüme başvurur. Sorgu parametresi bu veri kaynağı için desteklenmiyor.
adlsgen2	Kimlik bilgileri depolama bağlantı dizesi veya depolama hesabının ResourceId'si olabilen bir Azure ADLS Gen 2 veri kaynağının tanımı. Kapsayıcı özelliği, dizine alınacak blob kapsayıcısını ifade eder ve isteğe bağlı sorgu özelliği, kapsayıcıdaki belirli bir alt klasöre başvurur.
onelake	Kimlik bilgileri Doku çalışma alanı GUID'si veya çalışma alanı FQDN'si olabilen bir Microsoft Fabric Onelake veri kaynağının tanımı. Kapsayıcı özelliği göl evi GUID'sine, isteğe bağlı sorgu özelliği ise göl evindeki klasörlere veya kısayollara başvurur.

SearchResourceEncryptionKey

Object

Azure Key Vault'ta müşteri tarafından yönetilen bir şifreleme anahtarı. Oluşturduğunuz ve yönettiğiniz anahtarlar, dizinler ve eş anlamlı eşlemeler gibi bekleyen verileri şifrelemek veya şifresini çözmek için kullanılabilir.

Name	Tür	Description
accessCredentials	AzureActiveDirectoryApplicationCredentials	Azure Key Vault erişmek için kullanılan isteğe bağlı Azure Active Directory kimlik bilgileri. Bunun yerine yönetilen kimlik kullanılıyorsa gerekli değildir.
keyVaultKeyName	string	Bekleyen verilerinizi şifrelemek için kullanılacak Azure Key Vault anahtarınızın adı.
keyVaultKeyVersion	string	Bekleyen verilerinizi şifrelemek için kullanılacak Azure Key Vault anahtarınızın sürümü.
keyVaultUri	string	DNS adı olarak da adlandırılan Azure Key Vault URI'si, bekleyen verilerinizi şifrelemek için kullanılacak anahtarı içerir. Örnek bir URI olabilir `https://my-keyvault-name.vault.azure.net`.

SoftDeleteColumnDeletionDetectionPolicy

Object

Geçici silme stratejisi uygulayan bir veri silme algılama ilkesi tanımlar. Belirlenen 'geçici silme' sütununun değerine bağlı olarak bir öğenin silinmesi gerekip gerekmediğini belirler.

Name	Tür	Description
@odata.type	string: #Microsoft.Azure.Search.SoftDeleteColumnDeletionDetectionPolicy	Veri silme algılama ilkesinin türünü belirten bir URI parçası.
softDeleteColumnName	string	Geçici silme algılaması için kullanılacak sütunun adı.
softDeleteMarkerValue	string	Bir öğeyi silinmiş olarak tanımlayan işaretçi değeri.

SqlIntegratedChangeTrackingPolicy

Object

Azure SQL Veritabanı'nın Tümleşik Değişiklik İzleme özelliğini kullanarak değişiklikleri yakalayan bir veri değişikliği algılama ilkesi tanımlar.

Name	Tür	Description
@odata.type	string: #Microsoft.Azure.Search.SqlIntegratedChangeTrackingPolicy	Veri değişikliği algılama ilkesinin türünü belirten bir URI parçası.

Aracılığıyla paylaş

Data Sources - Create

URI Parametreleri

İstek Başlığı

İstek Gövdesi

Yanıtlar

Örnekler

SearchServiceCreateDataSource

Örnek isteği

Örnek yanıt

Tanımlar

AzureActiveDirectoryApplicationCredentials

DataSourceCredentials

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

HighWaterMarkChangeDetectionPolicy

SearchIndexerDataContainer

SearchIndexerDataSource

SearchIndexerDataSourceType

SearchResourceEncryptionKey

SoftDeleteColumnDeletionDetectionPolicy

SqlIntegratedChangeTrackingPolicy