Data Sources - Get

Szolgáltatás:: Search Service

API-verzió:: 2026-04-01

Lekér egy adatforrás-definíciót.

GET {endpoint}/datasources('{dataSourceName}')?api-version=2026-04-01

URI-paraméterek

Név	In	Kötelező	Típus	Description
dataSourceName	path	True	string	Az adatforrás neve.
endpoint	path	True	string (uri)	A keresési szolgáltatás végpontjának URL-címe.
api-version	query	True	string minLength: 1	A művelethez használni kívánt API-verzió.

Kérelem fejléce

Név	Kötelező	Típus	Description
x-ms-client-request-id		string (uuid)	A kérés átlátszatlan, globálisan egyedi, ügyfél által generált sztringazonosítója.
Accept		Accept	Az Elfogadás fejléce.

Válaszok

Név	Típus	Description
200 OK	SearchIndexerDataSource	A kérés sikeres volt.
Other Status Codes	ErrorResponse	Váratlan hibaválasz.

Biztonság

api-key

Típus: apiKey
In: header

OAuth2Auth

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Hatókörök

Név	Description
https://search.azure.com/.default

Példák

SearchServiceGetDataSource

Mintakérelem

HTTP

GET https://exampleservice.search.windows.net/datasources('mydocdbdatasource')?api-version=2026-04-01

Mintaválasz

Állapotkód:: 200

{
  "@odata.etag": "0x1234568AE7E58A1",
  "name": "mydocdbdatasource",
  "description": "My Azure Adls Gen2 data source with ACLs.",
  "type": "adlsgen2",
  "credentials": {
    "connectionString": "DefaultEndpointsProtocol=https;AccountName=myAccountName;AccountKey=myAccountKey;EndpointSuffix=core.windows.net "
  },
  "container": {
    "name": "adls-gen2-doc-extraction-acl",
    "query": "folder_has_final_acl"
  },
  "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

Név	Description
Accept	Az Elfogadás fejléce.
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorDetail	A hiba részletei.
ErrorResponse	Az Összes Azure Resource Manager API gyakori hibaválasza a sikertelen műveletek hibaadatainak visszaadásához. (Ez az OData hibaválasz formátumát is követi.)
HighWaterMarkChangeDetectionPolicy	Olyan adatváltozás-észlelési szabályzatot definiál, amely egy magas vízjeloszlop értéke alapján rögzíti a változásokat.
NativeBlobSoftDeleteDeletionDetectionPolicy	Definiál egy adattörlési észlelési szabályzatot, amely az Azure Blob Storage natív helyreállítható törlési funkcióját használja a törlésészleléshez.
SearchIndexerDataContainer	Az indexelendő entitásra (például az Azure SQL-táblára vagy a CosmosDB-gyűjteményre) vonatkozó információkat jelöli.
SearchIndexerDataNoneIdentity	Törli az adatforrás identitástulajdonságát.
SearchIndexerDataSource	Az indexelő konfigurálásához használható adatforrásdefiníciót jelöli.
SearchIndexerDataSourceType	Meghatározza az adatforrás típusát.
SearchIndexerDataUserAssignedIdentity	Megadja a használni kívánt adatforrás identitásá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	Olyan adattörlési észlelési szabályzatot definiál, amely helyreállítható törlési stratégiát implementál. 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	Olyan adatváltozás-észlelési szabályzatot határoz meg, amely az Azure SQL Database integrált változáskövetési funkciójával rögzíti a változásokat.

Accept

Felsorolás

Az Elfogadás fejléce.

Érték	Description
application/json;odata.metadata=minimal

ErrorAdditionalInfo

Tárgy

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

Név	Típus	Description
info		A további információk.
type	string	A további információtípus.

ErrorDetail

Tárgy

A hiba részletei.

Név	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 hiba célpontja.

ErrorResponse

Tárgy

Az Összes Azure Resource Manager API gyakori hibaválasza a sikertelen műveletek hibaadatainak visszaadásához. (Ez az OData hibaválasz formátumát is követi.)

Név	Típus	Description
error	ErrorDetail	A hibaobjektum.

HighWaterMarkChangeDetectionPolicy

Tárgy

Olyan adatváltozás-észlelési szabályzatot definiál, amely egy magas vízjeloszlop értéke alapján rögzíti a változásokat.

Név	Típus	Description
@odata.type	string: #Microsoft.Azure.Search.HighWaterMarkChangeDetectionPolicy	A származtatott típusok diszkriminatív.
highWaterMarkColumnName	string	A magas vízjel oszlop neve.

NativeBlobSoftDeleteDeletionDetectionPolicy

Tárgy

Definiál egy adattörlési észlelési szabályzatot, amely az Azure Blob Storage natív helyreállítható törlési funkcióját használja a törlésészleléshez.

Név	Típus	Description
@odata.type	string: #Microsoft.Azure.Search.NativeBlobSoftDeleteDeletionDetectionPolicy	A származtatott típusok diszkriminatív.

SearchIndexerDataContainer

Tárgy

Az indexelendő entitásra (például az Azure SQL-táblára vagy a CosmosDB-gyűjteményre) vonatkozó információkat jelöli.

Név	Típus	Description
name	string	Az indexelni kívánt tábla vagy nézet (Azure SQL-adatforrás) vagy gyűjtemény (CosmosDB-adatforrás) neve.
query	string	Az adattárolóra alkalmazott lekérdezés. A paraméter szintaxisa és jelentése adatforrás-specifikus. Az Azure SQL-adatforrások nem támogatják.

SearchIndexerDataNoneIdentity

Tárgy

Törli az adatforrás identitástulajdonságát.

Név	Típus	Description
@odata.type	string: #Microsoft.Azure.Search.DataNoneIdentity	Az identitás típusát meghatározó URI-töredék.

SearchIndexerDataSource

Tárgy

Az indexelő konfigurálásához használható adatforrásdefiníciót jelöli.

Név	Típus	Description
@odata.etag	string	Az adatforrás ETagje.
container	SearchIndexerDataContainer	Az adatforrás adattárolója.
credentials.connectionString	string	Az adatforrás kapcsolati sztringje. Á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.
dataChangeDetectionPolicy	DataChangeDetectionPolicy: HighWaterMarkChangeDetectionPolicy SqlIntegratedChangeTrackingPolicy	Az adatforrás adatváltozás-észlelési szabályzata.
dataDeletionDetectionPolicy	DataDeletionDetectionPolicy: NativeBlobSoftDeleteDeletionDetectionPolicy SoftDeleteColumnDeletionDetectionPolicy	Az adatforrás adattörlési észlelési szabályzata.
description	string	Az adatforrás leírása.
encryptionKey	SearchResourceEncryptionKey	Az Azure Key Vaultban 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ásdefiníció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. Szükség szerint módosíthatja ezt a tulajdonságot, ha el szeretné forgatni a titkosítási kulcsot; Az adatforrás definíciója nem lesz hatással. Az ügyfél által felügyelt kulcsokkal rendelkező 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.
identity	SearchIndexerDataIdentity: SearchIndexerDataNoneIdentity SearchIndexerDataUserAssignedIdentity	Az adatforráshoz használandó explicit felügyelt identitás. Ha nincs megadva, és a kapcsolati sztring felügyelt identitás, a rendszer a rendszer által hozzárendelt felügyelt identitást használja. Ha nincs megadva, az érték változatlan marad. Ha nincs megadva, a tulajdonság értéke törlődik.
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	Egy Azure SQL-adatforrást jelöl.
cosmosdb	CosmosDB-adatforrást jelöl.
azureblob	Egy Azure Blob-adatforrást jelöl.
azuretable	Egy Azure Table-adatforrást jelöl.
mysql	MySql-adatforrást jelöl.
adlsgen2	ADLS Gen2 adatforrást jelöl.
onelake	Egy Microsoft Fabric OneLake-adatforrást jelöl.
sharepoint	SharePoint-adatforrást jelöl.

SearchIndexerDataUserAssignedIdentity

Tárgy

Megadja a használni kívánt adatforrás identitását.

Név	Típus	Description
@odata.type	string: #Microsoft.Azure.Search.DataUserAssignedIdentity	Az identitás típusát meghatározó URI-töredék.
userAssignedIdentity	string	A felhasználó által hozzárendelt felügyelt identitás teljes Azure-erőforrás-azonosítója általában "/subscriptions/12345678-1234-1234-1234-1234-1234567890ab/resourceGroups/rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId" formában található, amelyet hozzá kellett volna rendelni a keresési szolgáltatáshoz.

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.

Név	Típus	Description
accessCredentials.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.
accessCredentials.applicationSecret	string	A megadott AAD-alkalmazás hitelesítési kulcsa.
identity	SearchIndexerDataIdentity: SearchIndexerDataNoneIdentity SearchIndexerDataUserAssignedIdentity	Explicit felügyelt identitás ehhez a titkosítási kulcshoz. Ha nincs megadva, és a hozzáférési hitelesítő adatok tulajdonság null értékű, akkor a rendszer a rendszer által hozzárendelt felügyelt identitást használja. Az erőforrás frissítésekor, ha az explicit identitás nincs meghatározva, az változatlan marad. Ha nincs megadva, a tulajdonság értéke törlődik.
keyVaultKeyName	string	A inaktív adatok titkosításához használandó Azure Key Vault-kulcs neve.
keyVaultKeyVersion	string	Az Azure Key Vault-kulcs inaktív adatok titkosításához használandó verziója.
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álandó kulcsot. Példa URI lehet `https://my-keyvault-name.vault.azure.net`.

SoftDeleteColumnDeletionDetectionPolicy

Tárgy

Olyan adattörlési észlelési szabályzatot definiál, amely helyreállítható törlési stratégiát implementál. Meghatározza, hogy egy elemet törölni kell-e egy kijelölt "helyreállítható törlés" oszlop értéke alapján.

Név	Típus	Description
@odata.type	string: #Microsoft.Azure.Search.SoftDeleteColumnDeletionDetectionPolicy	A származtatott típusok diszkriminatív.
softDeleteColumnName	string	A helyreállítható törlés észleléséhez használandó oszlop neve.
softDeleteMarkerValue	string	Az elemeket töröltként azonosító jelölőérték.

SqlIntegratedChangeTrackingPolicy

Tárgy

Olyan adatváltozás-észlelési szabályzatot határoz meg, amely az Azure SQL Database integrált változáskövetési funkciójával rögzíti a változásokat.

Név	Típus	Description
@odata.type	string: #Microsoft.Azure.Search.SqlIntegratedChangeTrackingPolicy	A származtatott típusok diszkriminatív.