Indexers - Create

Referens

Tjänst:: Search Service

API-version:: 2024-05-01-preview

Skapar en ny indexerare.

POST {endpoint}/indexers?api-version=2024-05-01-preview

URI-parametrar

Name	I	Obligatorisk	Typ	Description
endpoint	path	True	string	Slutpunkts-URL:en för söktjänsten.
api-version	query	True	string	Klient-API-version.

Begärandehuvud

Name	Obligatorisk	Typ	Description
x-ms-client-request-id		string uuid	Spårnings-ID:t som skickas med begäran för att hjälpa till med felsökning.

Begärandetext

Name	Obligatorisk	Typ	Description
dataSourceName	True	string	Namnet på den datakälla som indexeraren läser data från.
name	True	string	Namnet på indexeraren.
targetIndexName	True	string	Namnet på indexet som indexeraren skriver data till.
@odata.etag		string	ETag för indexeraren.
cache		SearchIndexerCache	Lägger till cachelagring i en berikningspipeline för att möjliggöra stegvisa ändringssteg utan att behöva återskapa indexet varje gång.
description		string	Beskrivningen av indexeraren.
disabled		boolean	Ett värde som anger om indexeraren är inaktiverad. Standardvärdet är false.
encryptionKey		SearchResourceEncryptionKey	En beskrivning av en krypteringsnyckel som du skapar i Azure Key Vault. Den här nyckeln används för att tillhandahålla ytterligare kryptering i vila för indexerarens definition (samt körningsstatus för indexeraren) när du vill ha fullständig säkerhet för att ingen, inte ens Microsoft, kan dekryptera dem. När du har krypterat indexerarens definition förblir den alltid krypterad. Söktjänsten ignorerar försök att ange den här egenskapen till null. Du kan ändra den här egenskapen efter behov om du vill rotera krypteringsnyckeln. Indexerarens definition (och körningsstatus för indexeraren) påverkas inte. Kryptering med kundhanterade nycklar är inte tillgängligt för kostnadsfria söktjänster och är endast tillgängligt för betaltjänster som skapats den 1 januari 2019 eller senare.
fieldMappings		FieldMapping[]	Definierar mappningar mellan fält i datakällan och motsvarande målfält i indexet.
outputFieldMappings		FieldMapping[]	Mappningar av utdatafält tillämpas efter berikning och omedelbart före indexering.
parameters		IndexingParameters	Parametrar för indexeringskörning.
schedule		IndexingSchedule	Schemat för den här indexeraren.
skillsetName		string	Namnet på den kompetensuppsättning som körs med den här indexeraren.

Svar

Name	Typ	Description
201 Created	SearchIndexer
Other Status Codes	ErrorResponse	Felsvar.

Exempel

SearchServiceCreateIndexer

Exempelbegäran

HTTP

POST https://myservice.search.windows.net/indexers?api-version=2024-05-01-preview

{
  "name": "myindexer",
  "description": "a cool indexer",
  "dataSourceName": "mydatasource",
  "targetIndexName": "orders",
  "schedule": {
    "interval": "PT1H",
    "startTime": "2015-01-01T00:00:00Z"
  },
  "parameters": {
    "maxFailedItems": 10,
    "maxFailedItemsPerBatch": 5
  },
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": "<applicationSecret>"
    }
  }
}

Exempelsvar

Statuskod:: 201

{
  "name": "myindexer",
  "description": "a cool indexer",
  "dataSourceName": "mydatasource",
  "targetIndexName": "orders",
  "schedule": {
    "interval": "PT1H",
    "startTime": "2015-01-01T00:00:00Z"
  },
  "parameters": {
    "maxFailedItems": 10,
    "maxFailedItemsPerBatch": 5
  },
  "fieldMappings": [],
  "disabled": false,
  "encryptionKey": {
    "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
    "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
    "keyVaultUri": "https://myKeyVault.vault.azure.net",
    "accessCredentials": {
      "applicationId": "00000000-0000-0000-0000-000000000000",
      "applicationSecret": null
    }
  }
}

Definitioner

Name	Description
AzureActiveDirectoryApplicationCredentials	Autentiseringsuppgifter för ett registrerat program som skapats för din söktjänst och som används för autentiserad åtkomst till krypteringsnycklarna som lagras i Azure Key Vault.
BlobIndexerDataToExtract	Anger vilka data som ska extraheras från Azure Blob Storage och talar om för indexeraren vilka data som ska extraheras från bildinnehåll när "imageAction" är inställt på ett annat värde än "none". Detta gäller inbäddat bildinnehåll i ett .PDF eller annat program, eller bildfiler som .jpg och .png, i Azure-blobar.
BlobIndexerImageAction	Avgör hur inbäddade avbildningar och bildfiler ska bearbetas i Azure Blob Storage. Om du anger "imageAction"-konfigurationen till något annat värde än "none" krävs att en kompetensuppsättning också är kopplad till indexeraren.
BlobIndexerParsingMode	Representerar parsningsläget för indexering från en Azure-blobdatakälla.
BlobIndexerPDFTextRotationAlgorithm	Avgör algoritmen för textextrahering från PDF-filer i Azure Blob Storage.
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Felsvar
FieldMapping	Definierar en mappning mellan ett fält i en datakälla och ett målfält i ett index.
FieldMappingFunction	Representerar en funktion som transformerar ett värde från en datakälla före indexering.
IndexerExecutionEnvironment	Anger i vilken miljö indexeraren ska köras.
IndexingParameters	Representerar parametrar för indexeringskörning.
IndexingParametersConfiguration	En ordlista med indexeringsspecifika konfigurationsegenskaper. Varje namn är namnet på en specifik egenskap. Varje värde måste vara av en primitiv typ.
IndexingSchedule	Representerar ett schema för indexeringskörning.
SearchIndexer	Representerar en indexerare.
SearchIndexerCache
SearchIndexerDataNoneIdentity	Rensar identitetsegenskapen för en datakälla.
SearchIndexerDataUserAssignedIdentity	Anger identiteten för en datakälla som ska användas.
SearchResourceEncryptionKey	En kundhanterad krypteringsnyckel i Azure Key Vault. Nycklar som du skapar och hanterar kan användas för att kryptera eller dekryptera vilande data, till exempel index och synonymmappningar.

AzureActiveDirectoryApplicationCredentials

Autentiseringsuppgifter för ett registrerat program som skapats för din söktjänst och som används för autentiserad åtkomst till krypteringsnycklarna som lagras i Azure Key Vault.

Name	Typ	Description
applicationId	string	Ett AAD-program-ID som har beviljats nödvändiga åtkomstbehörigheter till Azure-Key Vault som ska användas vid kryptering av vilande data. Program-ID:t ska inte förväxlas med objekt-ID:t för ditt AAD-program.
applicationSecret	string	Autentiseringsnyckeln för det angivna AAD-programmet.

BlobIndexerDataToExtract

Anger vilka data som ska extraheras från Azure Blob Storage och talar om för indexeraren vilka data som ska extraheras från bildinnehåll när "imageAction" är inställt på ett annat värde än "none". Detta gäller inbäddat bildinnehåll i ett .PDF eller annat program, eller bildfiler som .jpg och .png, i Azure-blobar.

Name	Typ	Description
allMetadata	string	Extraherar metadata som tillhandahålls av Azure Blob Storage-undersystemet och innehållstypens specifika metadata (till exempel metadata som är unika för bara .png filer indexeras).
contentAndMetadata	string	Extraherar alla metadata och textinnehåll från varje blob.
storageMetadata	string	Indexerar bara standardblobegenskaperna och användardefinierade metadata.

BlobIndexerImageAction

Avgör hur inbäddade avbildningar och bildfiler ska bearbetas i Azure Blob Storage. Om du anger "imageAction"-konfigurationen till något annat värde än "none" krävs att en kompetensuppsättning också är kopplad till indexeraren.

Name	Typ	Description
generateNormalizedImagePerPage	string	Extraherar text från bilder (till exempel ordet "STOP" från en trafikstoppskylt) och bäddar in den i innehållsfältet, men behandlar PDF-filer på olika sätt eftersom varje sida återges som en bild och normaliseras därefter, i stället för att extrahera inbäddade bilder. Icke-PDF-filtyper behandlas på samma sätt som om "generateNormalizedImages" angavs.
generateNormalizedImages	string	Extraherar text från bilder (till exempel ordet "STOP" från en trafikstoppskylt) och bäddar in den i innehållsfältet. Den här åtgärden kräver att "dataToExtract" är inställt på "contentAndMetadata". En normaliserad bild refererar till ytterligare bearbetning som resulterar i enhetlig bildutdata, storlek och roterad för att främja konsekvent återgivning när du inkluderar bilder i visuella sökresultat. Den här informationen genereras för varje bild när du använder det här alternativet.
none	string	Ignorerar inbäddade bilder eller bildfiler i datauppsättningen. Det här är standardinställningen.

BlobIndexerParsingMode

Representerar parsningsläget för indexering från en Azure-blobdatakälla.

Name	Typ	Description
default	string	Ange till standard för normal filbearbetning.
delimitedText	string	Ange till avgränsadText när blobar är vanliga CSV-filer.
json	string	Ange till json för att extrahera strukturerat innehåll från JSON-filer.
jsonArray	string	Ange till jsonArray för att extrahera enskilda element i en JSON-matris som separata dokument.
jsonLines	string	Ange till jsonLines för att extrahera enskilda JSON-entiteter, avgränsade med en ny rad, som separata dokument.
text	string	Ange till text för att förbättra indexeringsprestanda för oformaterade textfiler i Blob Storage.

BlobIndexerPDFTextRotationAlgorithm

Avgör algoritmen för textextrahering från PDF-filer i Azure Blob Storage.

Name	Typ	Description
detectAngles	string	Kan ge bättre och mer läsbar textextrahering från PDF-filer som har roterad text i dem. Observera att prestandahastigheten kan påverkas i liten grad när den här parametern används. Den här parametern gäller endast PDF-filer och endast pdf-filer med inbäddad text. Om den roterade texten visas i en inbäddad bild i PDF-filen gäller inte den här parametern.
none	string	Utnyttjar normal textextrahering. Det här är standardinställningen.

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Den ytterligare informationen.
type	string	Ytterligare informationstyp.

ErrorDetail

Felinformationen.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorResponse

Felsvar

Name	Typ	Description
error	ErrorDetail	Felobjektet.

FieldMapping

Definierar en mappning mellan ett fält i en datakälla och ett målfält i ett index.

Name	Typ	Description
mappingFunction	FieldMappingFunction	En funktion som ska tillämpas på varje källfältvärde före indexering.
sourceFieldName	string	Namnet på fältet i datakällan.
targetFieldName	string	Namnet på målfältet i indexet. Samma som källfältnamnet som standard.

FieldMappingFunction

Representerar en funktion som transformerar ett värde från en datakälla före indexering.

Name	Typ	Description
name	string	Namnet på fältmappningsfunktionen.
parameters	object	En ordlista med parameternamn/värdepar som ska skickas till funktionen. Varje värde måste vara av en primitiv typ.

IndexerExecutionEnvironment

Anger i vilken miljö indexeraren ska köras.

Name	Typ	Description
private	string	Anger att indexeraren ska köras med miljön som etablerats specifikt för söktjänsten. Detta bör endast anges som körningsmiljö om indexeraren behöver komma åt resurser på ett säkert sätt via delade privata länkresurser.
standard	string	Anger att söktjänsten kan avgöra var indexeraren ska köras. Det här är standardmiljön när inget har angetts och är det rekommenderade värdet.

IndexingParameters

Representerar parametrar för indexeringskörning.

Name	Typ	Standardvärde	Description
batchSize	integer		Antalet objekt som läss från datakällan och indexeras som en enda batch för att förbättra prestandan. Standardvärdet beror på datakälltypen.
configuration	IndexingParametersConfiguration		En ordlista med indexeringsspecifika konfigurationsegenskaper. Varje namn är namnet på en specifik egenskap. Varje värde måste vara av en primitiv typ.
maxFailedItems	integer	0	Det maximala antalet objekt som inte kan indexeras för att indexeringskörningen fortfarande ska anses vara lyckad. -1 betyder ingen gräns. Standardvärdet är 0.
maxFailedItemsPerBatch	integer	0	Det maximala antalet objekt i en enda batch som kan misslyckas med indexeringen för att batchen fortfarande ska anses vara lyckad. -1 betyder ingen gräns. Standardvärdet är 0.

IndexingParametersConfiguration

En ordlista med indexeringsspecifika konfigurationsegenskaper. Varje namn är namnet på en specifik egenskap. Varje värde måste vara av en primitiv typ.

Name	Typ	Standardvärde	Description
allowSkillsetToReadFileData	boolean	False	Om det är sant skapar en sökväg //document//file_data som är ett objekt som representerar de ursprungliga fildata som laddats ned från blobdatakällan. På så sätt kan du skicka ursprungliga fildata till en anpassad färdighet för bearbetning i berikningspipelinen eller till färdigheten Extrahering av dokument.
dataToExtract	BlobIndexerDataToExtract	contentAndMetadata	Anger vilka data som ska extraheras från Azure Blob Storage och talar om för indexeraren vilka data som ska extraheras från bildinnehåll när "imageAction" är inställt på ett annat värde än "none". Detta gäller inbäddat bildinnehåll i ett .PDF eller annat program, eller bildfiler som .jpg och .png, i Azure-blobar.
delimitedTextDelimiter	string		För CSV-blobar anger den avgränsare med ett tecken som är slut för CSV-filer där varje rad startar ett nytt dokument (till exempel "\|").
delimitedTextHeaders	string		För CSV-blobar anger en kommaavgränsad lista med kolumnrubriker som är användbar för att mappa källfält till målfält i ett index.
documentRoot	string		För JSON-matriser, givet ett strukturerat eller halvstrukturerat dokument, kan du ange en sökväg till matrisen med den här egenskapen.
excludedFileNameExtensions	string		Kommaavgränsad lista över filnamnstillägg som ska ignoreras vid bearbetning från Azure Blob Storage. Du kan till exempel exkludera ".png, .mp4" för att hoppa över dessa filer under indexeringen.
executionEnvironment	IndexerExecutionEnvironment	standard	Anger i vilken miljö indexeraren ska köras.
failOnUnprocessableDocument	boolean	False	För Azure-blobar anger du false om du vill fortsätta indexeringen om ett dokument inte indexerar.
failOnUnsupportedContentType	boolean	False	För Azure-blobar anger du false om du vill fortsätta indexeringen när en innehållstyp som inte stöds påträffas och du inte känner till alla innehållstyper (filtillägg) i förväg.
firstLineContainsHeaders	boolean	True	För CSV-blobar anger att den första raden (icke-tom) för varje blob innehåller rubriker.
imageAction	BlobIndexerImageAction	none	Avgör hur inbäddade avbildningar och bildfiler ska bearbetas i Azure Blob Storage. Om du anger "imageAction"-konfigurationen till något annat värde än "none" krävs att en kompetensuppsättning också är kopplad till indexeraren.
indexStorageMetadataOnlyForOversizedDocuments	boolean	False	För Azure-blobar anger du den här egenskapen till true för att fortfarande indexeras lagringsmetadata för blobinnehåll som är för stort för att bearbetas. Överdimensionerade blobbar behandlas som fel som standard. Begränsningar för blobstorlek finns i https://docs.microsoft.com/azure/search/search-limits-quotas-capacity.
indexedFileNameExtensions	string		Kommaavgränsad lista över filnamnstillägg som ska väljas vid bearbetning från Azure Blob Storage. Du kan till exempel fokusera indexeringen på specifika programfiler ".docx, .pptx, .msg" för att specifikt inkludera dessa filtyper.
parsingMode	BlobIndexerParsingMode	default	Representerar parsningsläget för indexering från en Azure-blobdatakälla.
pdfTextRotationAlgorithm	BlobIndexerPDFTextRotationAlgorithm	none	Avgör algoritmen för textextrahering från PDF-filer i Azure Blob Storage.
queryTimeout	string	00:05:00	Ökar tidsgränsen utöver standardvärdet på 5 minuter för Azure SQL databasdatakällor, som anges i formatet "hh:mm:ss".

IndexingSchedule

Representerar ett schema för indexeringskörning.

Name	Typ	Description
interval	string	Tidsintervallet mellan indexerarens körningar.
startTime	string	Den tid då en indexerare ska börja köras.

SearchIndexer

Representerar en indexerare.

Name	Typ	Standardvärde	Description
@odata.etag	string		ETag för indexeraren.
cache	SearchIndexerCache		Lägger till cachelagring i en berikningspipeline för att möjliggöra stegvisa ändringssteg utan att behöva återskapa indexet varje gång.
dataSourceName	string		Namnet på den datakälla som indexeraren läser data från.
description	string		Beskrivningen av indexeraren.
disabled	boolean	False	Ett värde som anger om indexeraren är inaktiverad. Standardvärdet är false.
encryptionKey	SearchResourceEncryptionKey		En beskrivning av en krypteringsnyckel som du skapar i Azure Key Vault. Den här nyckeln används för att tillhandahålla ytterligare kryptering i vila för indexerarens definition (samt körningsstatus för indexeraren) när du vill ha fullständig säkerhet för att ingen, inte ens Microsoft, kan dekryptera dem. När du har krypterat indexerarens definition förblir den alltid krypterad. Söktjänsten ignorerar försök att ange den här egenskapen till null. Du kan ändra den här egenskapen efter behov om du vill rotera krypteringsnyckeln. Indexerarens definition (och körningsstatus för indexeraren) påverkas inte. Kryptering med kundhanterade nycklar är inte tillgängligt för kostnadsfria söktjänster och är endast tillgängligt för betaltjänster som skapats den 1 januari 2019 eller senare.
fieldMappings	FieldMapping[]		Definierar mappningar mellan fält i datakällan och motsvarande målfält i indexet.
name	string		Namnet på indexeraren.
outputFieldMappings	FieldMapping[]		Mappningar av utdatafält tillämpas efter berikning och omedelbart före indexering.
parameters	IndexingParameters		Parametrar för indexeringskörning.
schedule	IndexingSchedule		Schemat för den här indexeraren.
skillsetName	string		Namnet på den kompetensuppsättning som körs med den här indexeraren.
targetIndexName	string		Namnet på indexet som indexeraren skriver data till.

SearchIndexerCache

Name	Typ	Description
enableReprocessing	boolean	Anger om inkrementell ombearbetning är aktiverat.
identity	SearchIndexerDataIdentity: SearchIndexerDataNoneIdentity SearchIndexerDataUserAssignedIdentity	Den användartilldelade hanterade identiteten som används för anslutningar till berikningscacheminnet. Om anslutningssträng anger en identitet (ResourceId) och den inte har angetts används den systemtilldelade hanterade identiteten. Vid uppdateringar av indexeraren, om identiteten är ospecificerad, förblir värdet oförändrat. Om värdet är "none" rensas värdet för den här egenskapen.
storageConnectionString	string	Anslutningssträng till lagringskontot där cachedata ska sparas.

SearchIndexerDataNoneIdentity

Rensar identitetsegenskapen för en datakälla.

Name	Typ	Description
@odata.type	string: #Microsoft.Azure.Search.DataNoneIdentity	Ett URI-fragment som anger typen av identitet.

SearchIndexerDataUserAssignedIdentity

Anger identiteten för en datakälla som ska användas.

Name	Typ	Description
@odata.type	string: #Microsoft.Azure.Search.DataUserAssignedIdentity	Ett URI-fragment som anger typen av identitet.
userAssignedIdentity	string	Det fullständigt kvalificerade Azure-resurs-ID:t för en användartilldelad hanterad identitet, vanligtvis i formatet "/subscriptions/12345678-1234-1234-1234-1234567890ab/resourceGroups/rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId" som borde ha tilldelats söktjänsten.

SearchResourceEncryptionKey

En kundhanterad krypteringsnyckel i Azure Key Vault. Nycklar som du skapar och hanterar kan användas för att kryptera eller dekryptera vilande data, till exempel index och synonymmappningar.

Name	Typ	Description
accessCredentials	AzureActiveDirectoryApplicationCredentials	Valfria Azure Active Directory-autentiseringsuppgifter som används för att komma åt din Azure-Key Vault. Krävs inte om du använder hanterad identitet i stället.
identity	SearchIndexerDataIdentity: SearchIndexerDataNoneIdentity SearchIndexerDataUserAssignedIdentity	En explicit hanterad identitet som ska användas för den här krypteringsnyckeln. Om det inte anges och egenskapen för autentiseringsuppgifter för åtkomst är null används den systemtilldelade hanterade identiteten. Om den explicita identiteten är ospecificerad vid uppdatering av resursen förblir den oförändrad. Om "ingen" anges rensas värdet för den här egenskapen.
keyVaultKeyName	string	Namnet på din Azure Key Vault nyckel som ska användas för att kryptera vilande data.
keyVaultKeyVersion	string	Versionen av din Azure Key Vault-nyckel som ska användas för att kryptera dina vilande data.
keyVaultUri	string	URI:n för din Azure-Key Vault, även kallad DNS-namn, som innehåller nyckeln som ska användas för att kryptera vilande data. Ett exempel på en URI kan vara `https://my-keyvault-name.vault.azure.net`.

Dela via