Data Sources - Create

Servizio:: Search Service

Versione API:: 2025-09-01

Crea una nuova origine dati.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
endpoint	path	True	string	URL dell'endpoint del servizio di ricerca.
api-version	query	True	string	Versione dell'API client.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
x-ms-client-request-id		string (uuid)	ID di rilevamento inviato con la richiesta di assistenza per il debug.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
container	True	SearchIndexerDataContainer	Contenitore di dati per l'origine dati.
credentials	True	DataSourceCredentials	Credenziali per l'origine dati.
name	True	string	Nome dell'origine dati.
type	True	SearchIndexerDataSourceType	Tipo di origine dati.
@odata.etag		string	ETag dell'origine dati.
dataChangeDetectionPolicy		DataChangeDetectionPolicy: HighWaterMarkChangeDetectionPolicy SqlIntegratedChangeTrackingPolicy	Criteri di rilevamento delle modifiche dei dati per l'origine dati.
dataDeletionDetectionPolicy		DataDeletionDetectionPolicy: SoftDeleteColumnDeletionDetectionPolicy	Criteri di rilevamento dell'eliminazione dei dati per l'origine dati.
description		string	Descrizione dell'origine dati.
encryptionKey		SearchResourceEncryptionKey	Descrizione di una chiave di crittografia creata in Azure Key Vault. Questa chiave viene usata per fornire un ulteriore livello di crittografia dei dati inattivi per la definizione dell'origine dati quando si desidera avere la certezza completa che nessuno, nemmeno Microsoft, possa decrittografare la definizione dell'origine dati. Una volta crittografata, la definizione dell'origine dati rimarrà sempre crittografata. Il servizio di ricerca ignorerà i tentativi di impostare questa proprietà su null. È possibile modificare questa proprietà in base alle esigenze se si desidera ruotare la chiave di crittografia; La definizione dell'origine dati non sarà interessata. La crittografia con chiavi gestite dal cliente non è disponibile per i servizi di ricerca gratuiti ed è disponibile solo per i servizi a pagamento creati a partire dal 1° gennaio 2019.

Risposte

Nome	Tipo	Descrizione
201 Created	SearchIndexerDataSource
Other Status Codes	ErrorResponse	Risposta di errore.

Esempio

SearchServiceCreateDataSource

Esempio di richiesta

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

Risposta di esempio

Codice di stato:: 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"
  }
}

Definizioni

Nome	Descrizione
AzureActiveDirectoryApplicationCredentials	Credenziali di un'applicazione registrata creata per il servizio di ricerca, usata per l'accesso autenticato alle chiavi di crittografia archiviate in Azure Key Vault.
DataSourceCredentials	Rappresenta le credenziali che possono essere utilizzate per connettersi a un'origine dati.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
HighWaterMarkChangeDetectionPolicy	Definisce un criterio di rilevamento delle modifiche dei dati che acquisisce le modifiche in base al valore di una colonna di limite massimo.
SearchIndexerDataContainer	Rappresenta le informazioni sull'entità (ad esempio la tabella SQL di Azure o la raccolta CosmosDB) che verrà indicizzata.
SearchIndexerDataSource	Rappresenta una definizione dell'origine dati, che può essere utilizzata per configurare un indicizzatore.
SearchIndexerDataSourceType	Definisce il tipo di un'origine dati.
SearchResourceEncryptionKey	Una chiave di crittografia gestita dal cliente in Azure Key Vault. Le chiavi create e gestite dall'utente possono essere utilizzate per crittografare o decrittografare i dati inattivi, ad esempio indici e mappe di sinonimi.
SoftDeleteColumnDeletionDetectionPolicy	Definisce un criterio di rilevamento dell'eliminazione dei dati che implementa una strategia di eliminazione temporanea. Determina se un elemento deve essere eliminato in base al valore di una colonna di "eliminazione temporanea" designata.
SqlIntegratedChangeTrackingPolicy	Definisce un criterio di rilevamento delle modifiche dei dati che acquisisce le modifiche usando la funzionalità di rilevamento delle modifiche integrata del database SQL di Azure.

AzureActiveDirectoryApplicationCredentials

Object

Credenziali di un'applicazione registrata creata per il servizio di ricerca, usata per l'accesso autenticato alle chiavi di crittografia archiviate in Azure Key Vault.

Nome	Tipo	Descrizione
applicationId	string	Un ID applicazione AAD a cui sono state concesse le autorizzazioni di accesso necessarie per Azure Key Vault che deve essere usato per crittografare i dati inattivi. L'ID applicazione non deve essere confuso con l'ID oggetto per l'applicazione AAD.
applicationSecret	string	Chiave di autenticazione dell'applicazione AAD specificata.

DataSourceCredentials

Object

Rappresenta le credenziali che possono essere utilizzate per connettersi a un'origine dati.

Nome	Tipo	Descrizione
connectionString	string	Stringa di connessione per l'origine dati. Per Azure SQL, Azure Blob, ADLS Gen 2 e Azure Table, si tratta della stringa di connessione o dell'ID risorsa se si usa l'identità gestita. Per CosmosDB si tratta di una stringa di connessione formattata che specifica ApiKind o l'ID risorsa per l'identità gestita. Per i file Onelake, la stringa di connessione è il GUID dell'area di lavoro o il nome di dominio completo dell'area di lavoro. Onelake supporta solo le connessioni di identità gestite. Impostare su `<unchanged>` (con parentesi) se non si desidera aggiornare la stringa di connessione. Impostare su `<redacted>` se si desidera rimuovere il valore della stringa di connessione dall'origine dati.

ErrorAdditionalInfo

Object

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Object

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Object

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

HighWaterMarkChangeDetectionPolicy

Object

Definisce un criterio di rilevamento delle modifiche dei dati che acquisisce le modifiche in base al valore di una colonna di limite massimo.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Azure.Search.HighWaterMarkChangeDetectionPolicy	Frammento di URI che specifica il tipo di criterio di rilevamento delle modifiche dei dati.
highWaterMarkColumnName	string	Il nome della colonna dell'alta marea.

SearchIndexerDataContainer

Object

Rappresenta le informazioni sull'entità (ad esempio la tabella SQL di Azure o la raccolta CosmosDB) che verrà indicizzata.

Nome	Tipo	Descrizione
name	string	Nome della tabella o della vista (per l'origine dati SQL di Azure), della raccolta (per l'origine dati CosmosDB), del contenitore (per le origini dati BLOB di Azure e ADLS Gen 2), della tabella di Azure (per l'origine dati della tabella di Azure) o del lakehouse (per l'origine dati Onelake) che verrà indicizzata.
query	string	Query applicata al contenitore di dati. Per CosmosDB, la query dell'origine dati può appiattire e filtrare i dati. Per Azure Blob e ADLS Gen 2, la query può filtrare in base alle cartelle. Per la query della tabella di Azure è possibile filtrare in base ai dati della riga. Per la query Onelake è possibile filtrare per cartella o collegamento. Non supportato dalle origini dati SQL di Azure.

SearchIndexerDataSource

Object

Rappresenta una definizione dell'origine dati, che può essere utilizzata per configurare un indicizzatore.

Nome	Tipo	Descrizione
@odata.etag	string	ETag dell'origine dati.
container	SearchIndexerDataContainer	Contenitore di dati per l'origine dati.
credentials	DataSourceCredentials	Credenziali per l'origine dati.
dataChangeDetectionPolicy	DataChangeDetectionPolicy: HighWaterMarkChangeDetectionPolicy SqlIntegratedChangeTrackingPolicy	Criteri di rilevamento delle modifiche dei dati per l'origine dati.
dataDeletionDetectionPolicy	DataDeletionDetectionPolicy: SoftDeleteColumnDeletionDetectionPolicy	Criteri di rilevamento dell'eliminazione dei dati per l'origine dati.
description	string	Descrizione dell'origine dati.
encryptionKey	SearchResourceEncryptionKey	Descrizione di una chiave di crittografia creata in Azure Key Vault. Questa chiave viene usata per fornire un ulteriore livello di crittografia dei dati inattivi per la definizione dell'origine dati quando si desidera avere la certezza completa che nessuno, nemmeno Microsoft, possa decrittografare la definizione dell'origine dati. Una volta crittografata, la definizione dell'origine dati rimarrà sempre crittografata. Il servizio di ricerca ignorerà i tentativi di impostare questa proprietà su null. È possibile modificare questa proprietà in base alle esigenze se si desidera ruotare la chiave di crittografia; La definizione dell'origine dati non sarà interessata. La crittografia con chiavi gestite dal cliente non è disponibile per i servizi di ricerca gratuiti ed è disponibile solo per i servizi a pagamento creati a partire dal 1° gennaio 2019.
name	string	Nome dell'origine dati.
type	SearchIndexerDataSourceType	Tipo di origine dati.

SearchIndexerDataSourceType

Enumerazione

Definisce il tipo di un'origine dati.

Valore	Descrizione
azuresql	Definizione di un'origine dati SQL di Azure le cui credenziali possono essere una stringa di connessione SQL standard o il ResourceId della risorsa SQL. La proprietà container fa riferimento alla tabella o alla vista da indicizzare. Il parametro di query non è supportato per questa origine dati.
cosmosdb	Definizione di un'origine dati CosmosDB le cui credenziali possono essere una stringa di connessione formattata contenente i dettagli per AccountEndpoint, AccountKey e Database per una connessione basata su chiave o i dettagli per ResourceID e ApiKind per la connessione senza chiave. La proprietà container fa riferimento alla raccolta cosmosdb da indicizzare e la proprietà query facoltativa fa riferimento a una query SQL sulla raccolta.
azureblob	Definizione di un'origine dati BLOB di Azure le cui credenziali possono essere una stringa di connessione di archiviazione o il ResourceId dell'account di archiviazione. La proprietà container fa riferimento al contenitore BLOB da indicizzare e la proprietà query facoltativa fa riferimento a una sottocartella specifica nel contenitore.
azuretable	Definizione di un'origine dati della tabella di Azure le cui credenziali possono essere una stringa di connessione alla tabella o il ResourceId dell'account di archiviazione. La proprietà container fa riferimento al contenitore BLOB da indicizzare e la proprietà query facoltativa può essere usata per filtrare le righe.
mysql	Definizione di un'origine dati SQL di Azure le cui credenziali possono essere una stringa di connessione SQL formattata standard ADO.NET o il ResourceId della risorsa SQL. La proprietà container fa riferimento alla tabella o alla vista da indicizzare. Il parametro di query non è supportato per questa origine dati.
adlsgen2	Definizione di un'origine dati Azure ADLS Gen 2 le cui credenziali possono essere una stringa di connessione di archiviazione o il ResourceId dell'account di archiviazione. La proprietà container fa riferimento al contenitore BLOB da indicizzare e la proprietà query facoltativa fa riferimento a una sottocartella specifica nel contenitore.
onelake	Definizione di un'origine dati Microsoft Fabric Onelake le cui credenziali possono essere il GUID dell'area di lavoro Fabric o un FQDN dell'area di lavoro. La proprietà container fa riferimento al GUID lakehouse e la proprietà query facoltativa fa riferimento a cartelle o collegamenti nel lakehouse.

SearchResourceEncryptionKey

Object

Una chiave di crittografia gestita dal cliente in Azure Key Vault. Le chiavi create e gestite dall'utente possono essere utilizzate per crittografare o decrittografare i dati inattivi, ad esempio indici e mappe di sinonimi.

Nome	Tipo	Descrizione
accessCredentials	AzureActiveDirectoryApplicationCredentials	Credenziali facoltative di Azure Active Directory usate per l'accesso ad Azure Key Vault. Non necessario se si usa l'identità gestita.
keyVaultKeyName	string	Nome della chiave di Azure Key Vault da usare per crittografare i dati inattivi.
keyVaultKeyVersion	string	Versione della chiave di Azure Key Vault da usare per crittografare i dati inattivi.
keyVaultUri	string	URI dell'insieme di credenziali delle chiavi di Azure, noto anche come nome DNS, che contiene la chiave da usare per crittografare i dati inattivi. Un URI di esempio potrebbe essere `https://my-keyvault-name.vault.azure.net`.

SoftDeleteColumnDeletionDetectionPolicy

Object

Definisce un criterio di rilevamento dell'eliminazione dei dati che implementa una strategia di eliminazione temporanea. Determina se un elemento deve essere eliminato in base al valore di una colonna di "eliminazione temporanea" designata.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Azure.Search.SoftDeleteColumnDeletionDetectionPolicy	Frammento di URI che specifica il tipo di criterio di rilevamento dell'eliminazione dei dati.
softDeleteColumnName	string	Nome della colonna da utilizzare per il rilevamento dell'eliminazione temporanea.
softDeleteMarkerValue	string	Il valore dell'indicatore che identifica un elemento come eliminato.

SqlIntegratedChangeTrackingPolicy

Object

Definisce un criterio di rilevamento delle modifiche dei dati che acquisisce le modifiche usando la funzionalità di rilevamento delle modifiche integrata del database SQL di Azure.

Nome	Tipo	Descrizione
@odata.type	string: #Microsoft.Azure.Search.SqlIntegratedChangeTrackingPolicy	Frammento di URI che specifica il tipo di criterio di rilevamento delle modifiche dei dati.

Condividi tramite

Data Sources - Create

Parametri dell'URI

Intestazione della richiesta

Corpo della richiesta

Risposte

Esempio

SearchServiceCreateDataSource

Esempio di richiesta

Risposta di esempio

Definizioni

AzureActiveDirectoryApplicationCredentials

DataSourceCredentials

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

HighWaterMarkChangeDetectionPolicy

SearchIndexerDataContainer

SearchIndexerDataSource

SearchIndexerDataSourceType

SearchResourceEncryptionKey

SoftDeleteColumnDeletionDetectionPolicy

SqlIntegratedChangeTrackingPolicy