Data Sources - Create Or Update

Szolgáltatás:: Search Service

API-verzió:: 2025-09-01

Létrehoz egy új adatforrást, vagy frissít egy adatforrást, ha már létezik.

PUT {endpoint}/datasources('{dataSourceName}')?api-version=2025-09-01

URI-paraméterek

Name	In	Kötelező	Típus	Description
dataSourceName	path	True	string	A létrehozni vagy frissíteni kívánt adatforrás neve.
endpoint	path	True	string	A keresési szolgáltatás végpontjának URL-címe.
api-version	query	True	string	Ügyfél API-verziója.

Kérelem fejléce

Name	Kötelező	Típus	Description
x-ms-client-request-id		string (uuid)	A hibakeresési kérelemmel küldött nyomkövetési azonosító.
If-Match		string	Meghatározza a If-Match feltételt. A művelet csak akkor lesz végrehajtva, ha a kiszolgálón lévő ETag megegyezik ezzel az értékkel.
If-None-Match		string	Meghatározza az If-None-Match feltételt. A művelet csak akkor lesz végrehajtva, ha a kiszolgálón lévő ETag nem egyezik meg ezzel az értékkel.
Prefer	True	string	HTTP PUT-kérések esetén arra utasítja a szolgáltatást, hogy sikeres esetben adja vissza a létrehozott/frissített erőforrást.

Kérelem törzse

Name	Kötelező	Típus	Description
container	True	SearchIndexerDataContainer	Az adatforrás adattárolója.
credentials	True	DataSourceCredentials	Az adatforrás hitelesítő adatai.
name	True	string	Az adatforrás neve.
type	True	SearchIndexerDataSourceType	Az adatforrás típusa.
@odata.etag		string	Az adatforrás ETagje.
dataChangeDetectionPolicy		DataChangeDetectionPolicy: HighWaterMarkChangeDetectionPolicy SqlIntegratedChangeTrackingPolicy	Az adatforrás adatváltozás-észlelési szabályzata.
dataDeletionDetectionPolicy		DataDeletionDetectionPolicy: SoftDeleteColumnDeletionDetectionPolicy	Az adatforrás adattörlés-észlelési szabályzata.
description		string	Az adatforrás leírása.
encryptionKey		SearchResourceEncryptionKey	A Azure Key Vault létrehozott titkosítási kulcs leírása. Ez a kulcs az adatforrás-definíció további titkosítási szintjének biztosítására szolgál, ha teljes körű biztosítékot szeretne arra, hogy senki, még a Microsoft sem tudja visszafejteni az adatforrás definícióját. Miután titkosította az adatforrás definícióját, az mindig titkosítva marad. A keresési szolgáltatás figyelmen kívül hagyja a tulajdonság null értékre állítására tett kísérleteket. Ezt a tulajdonságot szükség szerint módosíthatja, ha el szeretné forgatni a titkosítási kulcsot; Az adatforrás definícióját ez nem érinti. Az ügyfél által felügyelt kulcsokkal való titkosítás nem érhető el az ingyenes keresési szolgáltatásokhoz, és csak a 2019. január 1-jén vagy azt követően létrehozott fizetős szolgáltatásokhoz érhető el.

Válaszok

Name	Típus	Description
200 OK	SearchIndexerDataSource
201 Created	SearchIndexerDataSource
Other Status Codes	ErrorResponse	Hibaválasz.

Példák

SearchServiceCreateOrUpdateDataSource

Mintakérelem

HTTP

PUT https://stableexampleservice.search.windows.net/datasources('tempdatasource')?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"
}

Mintaválasz

Állapotkód:: 200

{
  "@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"
  }
}

Állapotkód:: 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"
  }
}

Definíciók

Name	Description
AzureActiveDirectoryApplicationCredentials	A keresési szolgáltatáshoz létrehozott regisztrált alkalmazás hitelesítő adatai, amelyek a Azure Key Vault tárolt titkosítási kulcsokhoz való hitelesített hozzáféréshez használatosak.
DataSourceCredentials	Az adatforráshoz való csatlakozáshoz használható hitelesítő adatokat jelöli.
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorDetail	A hiba részletei.
ErrorResponse	Hibaválasz
HighWaterMarkChangeDetectionPolicy	Adatváltozás-észlelési szabályzatot határoz meg, amely a magas vízjel oszlop értéke alapján rögzíti a módosításokat.
SearchIndexerDataContainer	Az indexelni kívánt entitás (például Azure SQL-tábla vagy CosmosDB-gyűjtemény) adatait jelöli.
SearchIndexerDataSource	Egy adatforrás-definíciót jelöl, amely indexelő konfigurálására használható.
SearchIndexerDataSourceType	Meghatározza az adatforrás típusát.
SearchResourceEncryptionKey	Ügyfél által felügyelt titkosítási kulcs az Azure Key Vaultban. A létrehozott és kezelt kulcsok az inaktív adatok, például az indexek és a szinonimatérképek titkosítására vagy visszafejtésére használhatók.
SoftDeleteColumnDeletionDetectionPolicy	Adattörlés-észlelési szabályzatot határoz meg, amely helyreállítható törlési stratégiát valósít meg. Meghatározza, hogy egy elemet törölni kell-e egy kijelölt "helyreállítható törlés" oszlop értéke alapján.
SqlIntegratedChangeTrackingPolicy	Meghatároz egy adatváltozás-észlelési szabályzatot, amely rögzíti a módosításokat a Azure SQL Database integrált változáskövetési funkciójával.

AzureActiveDirectoryApplicationCredentials

Tárgy

A keresési szolgáltatáshoz létrehozott regisztrált alkalmazás hitelesítő adatai, amelyek a Azure Key Vault tárolt titkosítási kulcsokhoz való hitelesített hozzáféréshez használatosak.

Name	Típus	Description
applicationId	string	Egy AAD-alkalmazásazonosító, amely megkapta a szükséges hozzáférési engedélyeket az Azure Key Vaulthoz, amelyet az inaktív adatok titkosításához kell használni. Az alkalmazásazonosító nem tévesztendő össze az AAD-alkalmazás objektumazonosítójával.
applicationSecret	string	A megadott AAD-alkalmazás hitelesítési kulcsa.

DataSourceCredentials

Tárgy

Az adatforráshoz való csatlakozáshoz használható hitelesítő adatokat jelöli.

Name	Típus	Description
connectionString	string	Az adatforrás kapcsolati sztringje. Az Azure SQL, az Azure Blob, az ADLS Gen 2 és az Azure Table esetében felügyelt identitás használata esetén ez a kapcsolati sztring vagy erőforrás-azonosító lenne. A CosmosDB esetében ez egy formázott kapcsolati sztring, amely megadja az ApiKind-et vagy a felügyelt identitás erőforrás-azonosítóját. Onelake-fájlok esetén a kapcsolati sztring a munkaterület GUID azonosítója vagy a munkaterület teljes tartományneve lenne; A Onelake csak a felügyelt identitáskapcsolatokat támogatja. Állítsa a következőre: `<unchanged>` (szögletes zárójelekkel), ha nem szeretné frissíteni a kapcsolati sztringet. Állítsa a következőre `<redacted>` , ha el szeretné távolítani a kapcsolati sztring értékét az adatforrásból.

ErrorAdditionalInfo

Tárgy

Az erőforrás-kezelési hiba további információi.

Name	Típus	Description
info	object	A további információk.
type	string	A további információtípus.

ErrorDetail

Tárgy

A hiba részletei.

Name	Típus	Description
additionalInfo	ErrorAdditionalInfo[]	A hiba további információi.
code	string	A hibakód.
details	ErrorDetail[]	A hiba részletei.
message	string	A hibaüzenet.
target	string	A hibacél.

ErrorResponse

Tárgy

Hibaválasz

Name	Típus	Description
error	ErrorDetail	A hibaobjektum.

HighWaterMarkChangeDetectionPolicy

Tárgy

Adatváltozás-észlelési szabályzatot határoz meg, amely a magas vízjel oszlop értéke alapján rögzíti a módosításokat.

Name	Típus	Description
@odata.type	string: #Microsoft.Azure.Search.HighWaterMarkChangeDetectionPolicy	Az adatváltozás-észlelési szabályzat típusát meghatározó URI-töredék.
highWaterMarkColumnName	string	A magas vízjel oszlop neve.

SearchIndexerDataContainer

Tárgy

Az indexelni kívánt entitás (például Azure SQL-tábla vagy CosmosDB-gyűjtemény) adatait jelöli.

Name	Típus	Description
name	string	Az indexelni kívánt tábla vagy nézet neve (Azure SQL-adatforrás esetén), gyűjtemény (CosmosDB-adatforrás esetén), tároló (Azure Blob és ADLS Gen 2 adatforrások esetén), Azure Table (Azure Table-adatforrás esetén) vagy lakehouse (Onelake-adatforrás esetén).
query	string	Az adattárolóra alkalmazott lekérdezés. A CosmosDB adatforrás lekérdezése simíthatja és szűrheti az adatokat. Az Azure Blob és az ADLS Gen 2 lekérdezés mappák szerint szűrhet. Az Azure Table-lekérdezés soradatok alapján szűrhet. A Onelake esetében a lekérdezés mappa vagy parancsikon szerint szűrhet. Az Azure SQL-adatforrások nem támogatják.

SearchIndexerDataSource

Tárgy

Egy adatforrás-definíciót jelöl, amely indexelő konfigurálására használható.

Name	Típus	Description
@odata.etag	string	Az adatforrás ETagje.
container	SearchIndexerDataContainer	Az adatforrás adattárolója.
credentials	DataSourceCredentials	Az adatforrás hitelesítő adatai.
dataChangeDetectionPolicy	DataChangeDetectionPolicy: HighWaterMarkChangeDetectionPolicy SqlIntegratedChangeTrackingPolicy	Az adatforrás adatváltozás-észlelési szabályzata.
dataDeletionDetectionPolicy	DataDeletionDetectionPolicy: SoftDeleteColumnDeletionDetectionPolicy	Az adatforrás adattörlés-észlelési szabályzata.
description	string	Az adatforrás leírása.
encryptionKey	SearchResourceEncryptionKey	A Azure Key Vault létrehozott titkosítási kulcs leírása. Ez a kulcs az adatforrás-definíció további titkosítási szintjének biztosítására szolgál, ha teljes körű biztosítékot szeretne arra, hogy senki, még a Microsoft sem tudja visszafejteni az adatforrás definícióját. Miután titkosította az adatforrás definícióját, az mindig titkosítva marad. A keresési szolgáltatás figyelmen kívül hagyja a tulajdonság null értékre állítására tett kísérleteket. Ezt a tulajdonságot szükség szerint módosíthatja, ha el szeretné forgatni a titkosítási kulcsot; Az adatforrás definícióját ez nem érinti. Az ügyfél által felügyelt kulcsokkal való titkosítás nem érhető el az ingyenes keresési szolgáltatásokhoz, és csak a 2019. január 1-jén vagy azt követően létrehozott fizetős szolgáltatásokhoz érhető el.
name	string	Az adatforrás neve.
type	SearchIndexerDataSourceType	Az adatforrás típusa.

SearchIndexerDataSourceType

Felsorolás

Meghatározza az adatforrás típusát.

Érték	Description
azuresql	Olyan Azure SQL-adatforrás definíciója, amelynek hitelesítő adatai lehetnek szabványos SQL-kapcsolati sztring vagy az SQL-erőforrás ResourceId-je. A tároló tulajdonság az indexelni kívánt táblára vagy nézetre hivatkozik. A lekérdezési paraméter nem támogatott ehhez az adatforráshoz.
cosmosdb	Olyan CosmosDB-adatforrás definíciója, amelynek hitelesítő adatai lehetnek egy formázott kapcsolati sztring, amely tartalmazza az AccountEndpoint, az AccountKey és az Database adatait egy kulcsalapú kapcsolathoz, vagy a ResourceID és az ApiKind adatait kulcs nélküli kapcsolathoz. A tároló tulajdonság az indexelni kívánt cosmosdb gyűjteményre hivatkozik, a választható lekérdezési tulajdonság pedig a gyűjtemény SQL-lekérdezésére hivatkozik.
azureblob	Olyan Azure Blob-adatforrás definíciója, amelynek hitelesítő adatai lehetnek tárolási kapcsolati sztring vagy a tárfiók ResourceId-je. A tároló tulajdonság az indexelni kívánt blobtárolóra, a választható lekérdezési tulajdonság pedig a tároló egy adott almappájára hivatkozik.
azuretable	Olyan Azure Table-adatforrás definíciója, amelynek hitelesítő adatai lehetnek táblakapcsolati sztring vagy a tárfiók ResourceId-je. A tároló tulajdonság az indexelni kívánt blobtárolóra hivatkozik, és a választható lekérdezési tulajdonság a sorok szűrésére használható.
mysql	Olyan Azure SQL-adatforrás definíciója, amelynek hitelesítő adatai lehetnek szabványos ADO.NET formázott SQL-kapcsolati sztring vagy az SQL-erőforrás ResourceId-je. A tároló tulajdonság az indexelni kívánt táblára vagy nézetre hivatkozik. A lekérdezési paraméter nem támogatott ehhez az adatforráshoz.
adlsgen2	Olyan Azure ADLS Gen 2 adatforrás definíciója, amelynek hitelesítő adatai lehetnek tárolási kapcsolati sztring vagy a tárfiók ResourceId-je. A tároló tulajdonság az indexelni kívánt blobtárolóra, a választható lekérdezési tulajdonság pedig a tároló egy adott almappájára hivatkozik.
onelake	Olyan Microsoft Fabric Onelake-adatforrás definíciója, amelynek hitelesítő adatai lehetnek a háló-munkaterület GUID azonosítója vagy a munkaterület teljes tartományneve. A tároló tulajdonság a lakehouse GUID azonosítójára, a választható lekérdezési tulajdonság pedig a lakehouse mappáira vagy parancsikonjaira hivatkozik.

SearchResourceEncryptionKey

Tárgy

Ügyfél által felügyelt titkosítási kulcs az Azure Key Vaultban. A létrehozott és kezelt kulcsok az inaktív adatok, például az indexek és a szinonimatérképek titkosítására vagy visszafejtésére használhatók.

Name	Típus	Description
accessCredentials	AzureActiveDirectoryApplicationCredentials	A Azure Key Vault eléréséhez használt opcionális Azure Active Directory hitelesítő adatok. Nem szükséges, ha felügyelt identitást használ.
keyVaultKeyName	string	Az inaktív adatok titkosításához használt Azure Key Vault kulcs neve.
keyVaultKeyVersion	string	Az Azure Key Vault kulcs verziója, amely az inaktív adatok titkosításához használható.
keyVaultUri	string	Az Azure Key Vault URI-ja, más néven DNS-név, amely tartalmazza az inaktív adatok titkosításához használt kulcsot. Példa lehet az URI-ra `https://my-keyvault-name.vault.azure.net`.

SoftDeleteColumnDeletionDetectionPolicy

Tárgy

Adattörlés-észlelési szabályzatot határoz meg, amely helyreállítható törlési stratégiát valósít meg. Meghatározza, hogy egy elemet törölni kell-e egy kijelölt "helyreállítható törlés" oszlop értéke alapján.

Name	Típus	Description
@odata.type	string: #Microsoft.Azure.Search.SoftDeleteColumnDeletionDetectionPolicy	Az adattörlés-észlelési szabályzat típusát meghatározó URI-töredék.
softDeleteColumnName	string	A helyreállítható törlés észleléséhez használt oszlop neve.
softDeleteMarkerValue	string	Az elemet töröltként azonosító jelölőérték.

SqlIntegratedChangeTrackingPolicy

Tárgy

Meghatároz egy adatváltozás-észlelési szabályzatot, amely rögzíti a módosításokat a Azure SQL Database integrált változáskövetési funkciójával.

Name	Típus	Description
@odata.type	string: #Microsoft.Azure.Search.SqlIntegratedChangeTrackingPolicy	Az adatváltozás-észlelési szabályzat típusát meghatározó URI-töredék.