Indexers - Create Or Update
Erstellt einen neuen Indexer oder aktualisiert einen Indexer, wenn er bereits vorhanden ist.
PUT {endpoint}/indexers('{indexerName}')?api-version=2024-11-01-preview
PUT {endpoint}/indexers('{indexerName}')?api-version=2024-11-01-preview&ignoreResetRequirements={ignoreResetRequirements}&disableCacheReprocessingChangeDetection={disableCacheReprocessingChangeDetection}
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
endpoint
|
path | True |
string |
Die Endpunkt-URL des Suchdiensts. |
indexer
|
path | True |
string |
Der Name des zu erstellenden oder aktualisierenden Indexers. |
api-version
|
query | True |
string |
Client-API-Version. |
disable
|
query |
boolean |
Deaktiviert die Erkennung von Änderungen im Cache. |
|
ignore
|
query |
boolean |
Ignoriert die Anforderungen für die Cachezurücksetzung. |
Anforderungsheader
Name | Erforderlich | Typ | Beschreibung |
---|---|---|---|
x-ms-client-request-id |
string uuid |
Die Tracking-ID, die mit der Anforderung gesendet wurde, um beim Debuggen zu helfen. |
|
If-Match |
string |
Definiert die If-Match Bedingung. Der Vorgang wird nur ausgeführt, wenn das ETag auf dem Server mit diesem Wert übereinstimmt. |
|
If-None-Match |
string |
Definiert die If-None-Match-Bedingung. Der Vorgang wird nur ausgeführt, wenn das ETag auf dem Server nicht mit diesem Wert übereinstimmt. |
|
Prefer | True |
string |
Für HTTP PUT-Anforderungen weist der Dienst an, die erstellte/aktualisierte Ressource bei Erfolg zurückzugeben. |
Anforderungstext
Name | Erforderlich | Typ | Beschreibung |
---|---|---|---|
dataSourceName | True |
string |
Der Name der Datenquelle, aus der dieser Indexer Daten liest. |
name | True |
string |
Der Name des Indexers. |
targetIndexName | True |
string |
Der Name des Indexes, in den dieser Indexer Daten schreibt. |
@odata.etag |
string |
Das ETag des Indexers. |
|
cache |
Fügt eine Zwischenspeicherung zu einer Anreicherungspipeline hinzu, um inkrementelle Änderungsschritte zu ermöglichen, ohne den Index jedes Mal neu erstellen zu müssen. |
||
description |
string |
Die Beschreibung des Indexers. |
|
disabled |
boolean |
Ein Wert, der angibt, ob der Indexer deaktiviert ist. Der Standardwert ist "false". |
|
encryptionKey |
Eine Beschreibung eines Verschlüsselungsschlüssels, den Sie in Azure Key Vault erstellen. Dieser Schlüssel wird verwendet, um eine zusätzliche Stufe der verschlüsselungsinternen Verschlüsselung für Ihre Indexerdefinition (sowie den Indexerausführungsstatus) bereitzustellen, wenn Sie vollständige Sicherheit wünschen, dass niemand, nicht einmal Microsoft, sie entschlüsseln kann. Nachdem Sie Ihre Indexerdefinition verschlüsselt haben, bleibt sie immer verschlüsselt. Der Suchdienst ignoriert Versuche, diese Eigenschaft auf NULL festzulegen. Sie können diese Eigenschaft nach Bedarf ändern, wenn Sie den Verschlüsselungsschlüssel drehen möchten. Ihre Indexerdefinition (und der Indexerausführungsstatus) sind davon unberührt. Verschlüsselung mit vom Kunden verwalteten Schlüsseln steht nicht für kostenlose Suchdienste zur Verfügung und ist nur für kostenpflichtige Dienste verfügbar, die am oder nach dem 1. Januar 2019 erstellt wurden. |
||
fieldMappings |
Definiert Zuordnungen zwischen Feldern in der Datenquelle und entsprechenden Zielfeldern im Index. |
||
outputFieldMappings |
Ausgabefeldzuordnungen werden nach Anreicherung und unmittelbar vor der Indizierung angewendet. |
||
parameters |
Parameter für die Indizierungsausführung. |
||
schedule |
Der Zeitplan für diesen Indexer. |
||
skillsetName |
string |
Der Name des mit diesem Indexer ausgeführten Skillsets. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK | ||
201 Created | ||
Other Status Codes |
Fehlerantwort. |
Beispiele
SearchServiceCreateOrUpdateIndexer
Beispielanforderung
PUT https://previewexampleservice.search.windows.net/indexers('myindexer')?api-version=2024-11-01-preview&ignoreResetRequirements=&disableCacheReprocessingChangeDetection=
{
"name": "myindexer",
"description": "Description of the indexer",
"dataSourceName": "mydocdbdatasource",
"skillsetName": "myskillset",
"targetIndexName": "preview-test",
"schedule": {
"interval": "P1D"
},
"parameters": {
"maxFailedItems": 10,
"maxFailedItemsPerBatch": 5,
"configuration": {
"parsingMode": "markdown",
"markdownParsingSubmode": "oneToOne"
}
},
"fieldMappings": [],
"outputFieldMappings": [],
"disabled": false,
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
}
}
Beispiel für eine Antwort
{
"@odata.etag": "0x1234568AE7E58A1",
"name": "myindexer",
"description": "Description of the indexer",
"dataSourceName": "mydocdbdatasource",
"skillsetName": "myskillset",
"targetIndexName": "preview-test",
"disabled": false,
"schedule": {
"interval": "P1D",
"startTime": "2024-06-06T00:01:50.265Z"
},
"parameters": {
"maxFailedItems": 10,
"maxFailedItemsPerBatch": 5,
"configuration": {
"parsingMode": "markdown",
"markdownParsingSubmode": "oneToOne"
}
},
"fieldMappings": [],
"outputFieldMappings": [],
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
}
}
{
"@odata.etag": "0x1234568AE7E58A1",
"name": "myindexer",
"description": "Description of the indexer",
"dataSourceName": "mydocdbdatasource",
"skillsetName": "myskillset",
"targetIndexName": "preview-test",
"disabled": false,
"schedule": {
"interval": "P1D",
"startTime": "2024-06-06T00:01:50.265Z"
},
"parameters": {
"maxFailedItems": 10,
"maxFailedItemsPerBatch": 5,
"configuration": {
"parsingMode": "markdown",
"markdownParsingSubmode": "oneToOne"
}
},
"fieldMappings": [],
"outputFieldMappings": [],
"encryptionKey": {
"keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
"keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
"keyVaultUri": "https://myKeyVault.vault.azure.net",
"accessCredentials": {
"applicationId": "00000000-0000-0000-0000-000000000000",
"applicationSecret": "<applicationSecret>"
}
}
}
Definitionen
Name | Beschreibung |
---|---|
Azure |
Anmeldeinformationen einer registrierten Anwendung, die für Ihren Suchdienst erstellt wurde und für authentifizierten Zugriff auf die im Azure Key Vault gespeicherten Verschlüsselungsschlüssel verwendet wird. |
Blob |
Gibt die Daten an, die aus Azure Blob Storage extrahiert werden sollen, und teilt dem Indexer mit, welche Daten aus Bildinhalten extrahiert werden sollen, wenn "imageAction" auf einen anderen Wert als "none" festgelegt ist. Dies gilt für eingebettete Bildinhalte in einer .PDF oder einer anderen Anwendung oder Bilddateien wie .jpg und .pngin Azure-Blobs. |
Blob |
Bestimmt, wie eingebettete Bilder und Bilddateien im Azure Blob Storage verarbeitet werden. Wenn Sie die "imageAction"-Konfiguration auf einen anderen Wert als "none" festlegen, muss auch ein Skillset an diesen Indexer angefügt werden. |
Blob |
Stellt den Analysemodus für die Indizierung aus einer Azure-Blob-Datenquelle dar. |
Blob |
Bestimmt den Algorithmus für die Textextraktion aus PDF-Dateien im Azure Blob Storage. |
Error |
Der Ressourcenverwaltungsfehler zusätzliche Informationen. |
Error |
Das Fehlerdetails. |
Error |
Fehlerantwort |
Field |
Definiert eine Zuordnung zwischen einem Feld in einer Datenquelle und einem Zielfeld in einem Index. |
Field |
Stellt eine Funktion dar, die einen Wert aus einer Datenquelle vor der Indizierung transformiert. |
Indexer |
Gibt die Umgebung an, in der der Indexer ausgeführt werden soll. |
Indexing |
Stellt Parameter für die Indizierungsausführung dar. |
Indexing |
Ein Wörterbuch mit indexerspezifischen Konfigurationseigenschaften. Jeder Name ist der Name einer bestimmten Eigenschaft. Jeder Wert muss einen Grundtyp aufweisen. |
Indexing |
Stellt einen Zeitplan für die Indizierungsausführung dar. |
Markdown |
Gibt die maximale Headertiefe an, die beim Gruppieren von Markdowninhalten berücksichtigt wird. Der Standardwert ist |
Markdown |
Gibt den Untermodus an, der bestimmt, ob eine Markdowndatei in genau ein Suchdokument oder mehrere Suchdokumente analysiert wird. Der Standardwert ist |
Search |
Stellt einen Indexer dar. |
Search |
|
Search |
Löscht die Identitätseigenschaft einer Datenquelle. |
Search |
Gibt die Identität für eine zu verwendende Datenquelle an. |
Search |
Ein vom Kunden verwalteter Verschlüsselungsschlüssel im Azure Key Vault. Schlüssel, die Sie erstellen und verwalten, können zum Verschlüsseln oder Entschlüsseln ruhender Daten verwendet werden, z. B. Indizes und Synonymzuordnungen. |
AzureActiveDirectoryApplicationCredentials
Anmeldeinformationen einer registrierten Anwendung, die für Ihren Suchdienst erstellt wurde und für authentifizierten Zugriff auf die im Azure Key Vault gespeicherten Verschlüsselungsschlüssel verwendet wird.
Name | Typ | Beschreibung |
---|---|---|
applicationId |
string |
Eine AAD-Anwendungs-ID, die die erforderlichen Zugriffsberechtigungen für den Azure Key Vault erteilt hat, die beim Verschlüsseln Ihrer ruhenden Daten verwendet werden sollen. Die Anwendungs-ID sollte nicht mit der Objekt-ID für Ihre AAD-Anwendung verwechselt werden. |
applicationSecret |
string |
Der Authentifizierungsschlüssel der angegebenen AAD-Anwendung. |
BlobIndexerDataToExtract
Gibt die Daten an, die aus Azure Blob Storage extrahiert werden sollen, und teilt dem Indexer mit, welche Daten aus Bildinhalten extrahiert werden sollen, wenn "imageAction" auf einen anderen Wert als "none" festgelegt ist. Dies gilt für eingebettete Bildinhalte in einer .PDF oder einer anderen Anwendung oder Bilddateien wie .jpg und .pngin Azure-Blobs.
Name | Typ | Beschreibung |
---|---|---|
allMetadata |
string |
Extrahiert Metadaten, die vom Azure Blob Storage-Subsystem bereitgestellt werden, und die inhaltstypspezifischen Metadaten (z. B. Metadaten, die nur für .png Dateien indiziert sind). |
contentAndMetadata |
string |
Extrahiert alle Metadaten und Textinhalte aus jedem Blob. |
storageMetadata |
string |
Indiziert nur die Standard-BLOB-Eigenschaften und vom Benutzer angegebenen Metadaten. |
BlobIndexerImageAction
Bestimmt, wie eingebettete Bilder und Bilddateien im Azure Blob Storage verarbeitet werden. Wenn Sie die "imageAction"-Konfiguration auf einen anderen Wert als "none" festlegen, muss auch ein Skillset an diesen Indexer angefügt werden.
Name | Typ | Beschreibung |
---|---|---|
generateNormalizedImagePerPage |
string |
Extrahiert Text aus Bildern (z. B. das Wort "STOP" aus einem Verkehrsstoppzeichen), und bettet ihn in das Inhaltsfeld ein, behandelt jedoch PDF-Dateien anders, da jede Seite als Bild gerendert und entsprechend normalisiert wird, anstatt eingebettete Bilder zu extrahieren. Nicht-PDF-Dateitypen werden so behandelt, als ob "generateNormalizedImages" festgelegt wurde. |
generateNormalizedImages |
string |
Extrahiert Text aus Bildern (z. B. das Wort "STOP" aus einem Ampelzeichen), und bettet ihn in das Inhaltsfeld ein. Diese Aktion erfordert, dass "dataToExtract" auf "contentAndMetadata" festgelegt ist. Ein normalisiertes Bild bezieht sich auf eine zusätzliche Verarbeitung, die zu einer einheitlichen Bildausgabe, größe und gedreht wird, um ein einheitliches Rendering zu fördern, wenn Sie Bilder in visuelle Suchergebnisse einschließen. Diese Informationen werden für jedes Bild generiert, wenn Sie diese Option verwenden. |
none |
string |
Ignoriert eingebettete Bilder oder Bilddateien im Dataset. Dies ist die Standardeinstellung. |
BlobIndexerParsingMode
Stellt den Analysemodus für die Indizierung aus einer Azure-Blob-Datenquelle dar.
Name | Typ | Beschreibung |
---|---|---|
default |
string |
Standardeinstellung für die normale Dateiverarbeitung. |
delimitedText |
string |
Legen Sie diese Eigenschaft auf "delimitedText" fest, wenn Blobs einfache CSV-Dateien sind. |
json |
string |
Legen Sie auf json fest, um strukturierte Inhalte aus JSON-Dateien zu extrahieren. |
jsonArray |
string |
Legen Sie "jsonArray" fest, um einzelne Elemente eines JSON-Arrays als separate Dokumente zu extrahieren. |
jsonLines |
string |
Legen Sie auf jsonLines fest, um einzelne JSON-Entitäten zu extrahieren, getrennt durch eine neue Zeile, als separate Dokumente. |
markdown |
string |
Legen Sie den Markierungsmodus fest, um Inhalte aus Markdowndateien zu extrahieren. |
text |
string |
Legen Sie diesen Wert auf Text fest, um die Indizierungsleistung für Nur-Text-Dateien im BLOB-Speicher zu verbessern. |
BlobIndexerPDFTextRotationAlgorithm
Bestimmt den Algorithmus für die Textextraktion aus PDF-Dateien im Azure Blob Storage.
Name | Typ | Beschreibung |
---|---|---|
detectAngles |
string |
Kann eine bessere und besser lesbare Textextraktion aus PDF-Dateien erzeugen, die Text darin gedreht haben. Beachten Sie, dass sich bei verwendung dieses Parameters möglicherweise eine geringe Leistungsgeschwindigkeit auswirkt. Dieser Parameter gilt nur für PDF-Dateien und nur für PDF-Dateien mit eingebetteten Text. Wenn der gedrehte Text in einem eingebetteten Bild in der PDF-Datei angezeigt wird, gilt dieser Parameter nicht. |
none |
string |
Nutzt die normale Textextraktion. Dies ist die Standardeinstellung. |
ErrorAdditionalInfo
Der Ressourcenverwaltungsfehler zusätzliche Informationen.
Name | Typ | Beschreibung |
---|---|---|
info |
object |
Die zusätzlichen Informationen. |
type |
string |
Der zusätzliche Informationstyp. |
ErrorDetail
Das Fehlerdetails.
Name | Typ | Beschreibung |
---|---|---|
additionalInfo |
Die zusätzlichen Informationen des Fehlers. |
|
code |
string |
Der Fehlercode. |
details |
Die Fehlerdetails. |
|
message |
string |
Die Fehlermeldung. |
target |
string |
Das Fehlerziel. |
ErrorResponse
Fehlerantwort
Name | Typ | Beschreibung |
---|---|---|
error |
Das Fehlerobjekt. |
FieldMapping
Definiert eine Zuordnung zwischen einem Feld in einer Datenquelle und einem Zielfeld in einem Index.
Name | Typ | Beschreibung |
---|---|---|
mappingFunction |
Eine Funktion, die vor der Indizierung auf jeden Quellfeldwert angewendet werden soll. |
|
sourceFieldName |
string |
Der Name des Felds in der Datenquelle. |
targetFieldName |
string |
Der Name des Zielfelds im Index. Identisch mit dem Quellfeldnamen standardmäßig. |
FieldMappingFunction
Stellt eine Funktion dar, die einen Wert aus einer Datenquelle vor der Indizierung transformiert.
Name | Typ | Beschreibung |
---|---|---|
name |
string |
Der Name der Feldzuordnungsfunktion. |
parameters |
object |
Ein Wörterbuch mit Parameternamen-Wert-Paaren, die an die Funktion übergeben werden sollen. Jeder Wert muss einen Grundtyp aufweisen. |
IndexerExecutionEnvironment
Gibt die Umgebung an, in der der Indexer ausgeführt werden soll.
Name | Typ | Beschreibung |
---|---|---|
private |
string |
Gibt an, dass der Indexer mit der Umgebung ausgeführt werden soll, die speziell für den Suchdienst bereitgestellt wird. Dies sollte nur als Ausführungsumgebung angegeben werden, wenn der Indexer sicher über freigegebene private Linkressourcen auf Ressourcen zugreifen muss. |
standard |
string |
Gibt an, dass der Suchdienst bestimmen kann, wo der Indexer ausgeführt werden soll. Dies ist die Standardumgebung, wenn nichts angegeben wird und der empfohlene Wert ist. |
IndexingParameters
Stellt Parameter für die Indizierungsausführung dar.
Name | Typ | Standardwert | Beschreibung |
---|---|---|---|
batchSize |
integer |
Die Anzahl der Elemente, die aus der Datenquelle gelesen und als einzelner Batch indiziert werden, um die Leistung zu verbessern. Der Standardwert hängt vom Datenquellentyp ab. |
|
configuration |
Ein Wörterbuch mit indexerspezifischen Konfigurationseigenschaften. Jeder Name ist der Name einer bestimmten Eigenschaft. Jeder Wert muss einen Grundtyp aufweisen. |
||
maxFailedItems |
integer |
0 |
Die maximale Anzahl von Elementen, bei denen die Indizierung für die Indizierungsausführung fehlschlägt, wird weiterhin als erfolgreich angesehen. -1 bedeutet keine Grenze. Der Standardwert ist 0. |
maxFailedItemsPerBatch |
integer |
0 |
Die maximale Anzahl von Elementen in einem einzelnen Batch, bei denen die Indizierung für den Batch nicht erfolgreich sein kann. -1 bedeutet keine Grenze. Der Standardwert ist 0. |
IndexingParametersConfiguration
Ein Wörterbuch mit indexerspezifischen Konfigurationseigenschaften. Jeder Name ist der Name einer bestimmten Eigenschaft. Jeder Wert muss einen Grundtyp aufweisen.
Name | Typ | Standardwert | Beschreibung |
---|---|---|---|
allowSkillsetToReadFileData |
boolean |
False |
Bei "true" wird ein Pfad //document//file_data erstellt, bei dem es sich um ein Objekt handelt, das die ursprünglichen Dateidaten darstellt, die aus der BLOB-Datenquelle heruntergeladen wurden. Auf diese Weise können Sie die ursprünglichen Dateidaten an eine benutzerdefinierte Fähigkeit zur Verarbeitung innerhalb der Anreicherungspipeline oder an die Dokumentextraktion-Fähigkeit übergeben. |
dataToExtract | contentAndMetadata |
Gibt die Daten an, die aus Azure Blob Storage extrahiert werden sollen, und teilt dem Indexer mit, welche Daten aus Bildinhalten extrahiert werden sollen, wenn "imageAction" auf einen anderen Wert als "none" festgelegt ist. Dies gilt für eingebettete Bildinhalte in einer .PDF oder einer anderen Anwendung oder Bilddateien wie .jpg und .pngin Azure-Blobs. |
|
delimitedTextDelimiter |
string |
Gibt für CSV-Blobs das Zeilenendetrennzeichen für CSV-Dateien an, bei denen jede Zeile ein neues Dokument beginnt (z. B. "|"). |
|
delimitedTextHeaders |
string |
Gibt für CSV-Blobs eine durch Trennzeichen getrennte Liste von Spaltenüberschriften an, die zum Zuordnen von Quellfeldern zu Zielfeldern in einem Index hilfreich sind. |
|
documentRoot |
string |
Bei JSON-Arrays können Sie bei einem strukturierten oder halbstrukturierten Dokument mithilfe dieser Eigenschaft einen Pfad zu dem Array angeben. |
|
excludedFileNameExtensions |
string |
Durch Trennzeichen getrennte Liste der Dateinamenerweiterungen, die beim Verarbeiten von Azure Blob Storage ignoriert werden sollen. Beispielsweise könnten Sie ".png, .mp4" ausschließen, um diese Dateien während der Indizierung zu überspringen. |
|
executionEnvironment | standard |
Gibt die Umgebung an, in der der Indexer ausgeführt werden soll. |
|
failOnUnprocessableDocument |
boolean |
False |
Legen Sie für Azure-Blobs auf "false" fest, wenn Sie die Indizierung fortsetzen möchten, wenn ein Dokument die Indizierung fehlschlägt. |
failOnUnsupportedContentType |
boolean |
False |
Legen Sie für Azure-Blobs den Wert "false" fest, wenn Sie die Indizierung fortsetzen möchten, wenn ein nicht unterstützter Inhaltstyp auftritt, und Sie wissen nicht alle Inhaltstypen (Dateierweiterungen) im Voraus. |
firstLineContainsHeaders |
boolean |
True |
Gibt für CSV-Blobs an, dass die erste (nicht leere) Zeile jedes BLOB Header enthält. |
imageAction | none |
Bestimmt, wie eingebettete Bilder und Bilddateien im Azure Blob Storage verarbeitet werden. Wenn Sie die "imageAction"-Konfiguration auf einen anderen Wert als "none" festlegen, muss auch ein Skillset an diesen Indexer angefügt werden. |
|
indexStorageMetadataOnlyForOversizedDocuments |
boolean |
False |
Legen Sie für Azure-Blobs diese Eigenschaft auf "true" fest, um weiterhin Speichermetadaten für BLOB-Inhalte zu indizieren, die zu groß zum Verarbeiten sind. Überdimensionierte Blobs werden standardmäßig als Fehler behandelt. Grenzwerte für blob-Größe finden Sie unter https://learn.microsoft.com/azure/search/search-limits-quotas-capacity. |
indexedFileNameExtensions |
string |
Durch Trennzeichen getrennte Liste der Dateinamenerweiterungen, die beim Verarbeiten aus Azure Blob Storage ausgewählt werden sollen. Beispielsweise könnten Sie sich auf die Indizierung bestimmter Anwendungsdateien ".docx, .pptx, .msg" konzentrieren, um diese Dateitypen speziell einzuschließen. |
|
markdownHeaderDepth | h6 |
Gibt die maximale Headertiefe an, die beim Gruppieren von Markdowninhalten berücksichtigt wird. Der Standardwert ist |
|
markdownParsingSubmode | oneToMany |
Gibt den Untermodus an, der bestimmt, ob eine Markdowndatei in genau ein Suchdokument oder mehrere Suchdokumente analysiert wird. Der Standardwert ist |
|
parsingMode | default |
Stellt den Analysemodus für die Indizierung aus einer Azure-Blob-Datenquelle dar. |
|
pdfTextRotationAlgorithm | none |
Bestimmt den Algorithmus für die Textextraktion aus PDF-Dateien im Azure Blob Storage. |
|
queryTimeout |
string |
00:05:00 |
Erhöht das Timeout über die 5-Minuten-Standardeinstellung für Azure SQL-Datenbankdatenquellen, die im Format "hh:mm:ss" angegeben sind. |
IndexingSchedule
Stellt einen Zeitplan für die Indizierungsausführung dar.
Name | Typ | Beschreibung |
---|---|---|
interval |
string |
Das Zeitintervall zwischen Indizierungsausführungen. |
startTime |
string |
Die Zeit, zu der ein Indexer ausgeführt werden soll. |
MarkdownHeaderDepth
Gibt die maximale Headertiefe an, die beim Gruppieren von Markdowninhalten berücksichtigt wird. Der Standardwert ist h6
.
Name | Typ | Beschreibung |
---|---|---|
h1 |
string |
Gibt an, dass Kopfzeilen bis zu einer Ebene von h1 beim Gruppieren von Markdowninhalten berücksichtigt werden. |
h2 |
string |
Gibt an, dass Kopfzeilen bis zu einer Ebene von h2 beim Gruppieren von Markdowninhalten berücksichtigt werden. |
h3 |
string |
Gibt an, dass Kopfzeilen bis zu einer Ebene von h3 beim Gruppieren von Markdowninhalten berücksichtigt werden. |
h4 |
string |
Gibt an, dass Kopfzeilen bis zu einer Ebene von h4 beim Gruppieren von Markdowninhalten berücksichtigt werden. |
h5 |
string |
Gibt an, dass Kopfzeilen bis zu einer Ebene von h5 beim Gruppieren von Markdowninhalten berücksichtigt werden. |
h6 |
string |
Gibt an, dass Kopfzeilen bis zu einer Ebene von h6 beim Gruppieren von Markdowninhalten berücksichtigt werden. Dies ist die Standardeinstellung. |
MarkdownParsingSubmode
Gibt den Untermodus an, der bestimmt, ob eine Markdowndatei in genau ein Suchdokument oder mehrere Suchdokumente analysiert wird. Der Standardwert ist oneToMany
.
Name | Typ | Beschreibung |
---|---|---|
oneToMany |
string |
Gibt an, dass jeder Abschnitt der Markdowndatei (bis zu einer angegebenen Tiefe) in einzelne Suchdokumente analysiert wird. Dies kann zu einer einzelnen Markdowndatei führen, die mehrere Suchdokumente erzeugt. Dies ist der Standarduntermodus. |
oneToOne |
string |
Gibt an, dass jede Markdowndatei in ein einzelnes Suchdokument analysiert wird. |
SearchIndexer
Stellt einen Indexer dar.
Name | Typ | Standardwert | Beschreibung |
---|---|---|---|
@odata.etag |
string |
Das ETag des Indexers. |
|
cache |
Fügt eine Zwischenspeicherung zu einer Anreicherungspipeline hinzu, um inkrementelle Änderungsschritte zu ermöglichen, ohne den Index jedes Mal neu erstellen zu müssen. |
||
dataSourceName |
string |
Der Name der Datenquelle, aus der dieser Indexer Daten liest. |
|
description |
string |
Die Beschreibung des Indexers. |
|
disabled |
boolean |
False |
Ein Wert, der angibt, ob der Indexer deaktiviert ist. Der Standardwert ist "false". |
encryptionKey |
Eine Beschreibung eines Verschlüsselungsschlüssels, den Sie in Azure Key Vault erstellen. Dieser Schlüssel wird verwendet, um eine zusätzliche Stufe der verschlüsselungsinternen Verschlüsselung für Ihre Indexerdefinition (sowie den Indexerausführungsstatus) bereitzustellen, wenn Sie vollständige Sicherheit wünschen, dass niemand, nicht einmal Microsoft, sie entschlüsseln kann. Nachdem Sie Ihre Indexerdefinition verschlüsselt haben, bleibt sie immer verschlüsselt. Der Suchdienst ignoriert Versuche, diese Eigenschaft auf NULL festzulegen. Sie können diese Eigenschaft nach Bedarf ändern, wenn Sie den Verschlüsselungsschlüssel drehen möchten. Ihre Indexerdefinition (und der Indexerausführungsstatus) sind davon unberührt. Verschlüsselung mit vom Kunden verwalteten Schlüsseln steht nicht für kostenlose Suchdienste zur Verfügung und ist nur für kostenpflichtige Dienste verfügbar, die am oder nach dem 1. Januar 2019 erstellt wurden. |
||
fieldMappings |
Definiert Zuordnungen zwischen Feldern in der Datenquelle und entsprechenden Zielfeldern im Index. |
||
name |
string |
Der Name des Indexers. |
|
outputFieldMappings |
Ausgabefeldzuordnungen werden nach Anreicherung und unmittelbar vor der Indizierung angewendet. |
||
parameters |
Parameter für die Indizierungsausführung. |
||
schedule |
Der Zeitplan für diesen Indexer. |
||
skillsetName |
string |
Der Name des mit diesem Indexer ausgeführten Skillsets. |
|
targetIndexName |
string |
Der Name des Indexes, in den dieser Indexer Daten schreibt. |
SearchIndexerCache
Name | Typ | Beschreibung |
---|---|---|
enableReprocessing |
boolean |
Gibt an, ob die inkrementelle Neuverarbeitung aktiviert ist. |
identity | SearchIndexerDataIdentity: |
Die vom Benutzer zugewiesene verwaltete Identität, die für Verbindungen mit dem Anreicherungscache verwendet wird. Wenn die Verbindungszeichenfolge eine Identität (ResourceId) angibt und sie nicht angegeben ist, wird die vom System zugewiesene verwaltete Identität verwendet. Bei Aktualisierungen des Indexers bleibt der Wert unverändert, wenn die Identität nicht angegeben ist. Wenn dieser Wert auf "none" festgelegt ist, wird der Wert dieser Eigenschaft gelöscht. |
storageConnectionString |
string |
Die Verbindungszeichenfolge mit dem Speicherkonto, in dem die Cachedaten gespeichert werden. |
SearchIndexerDataNoneIdentity
Löscht die Identitätseigenschaft einer Datenquelle.
Name | Typ | Beschreibung |
---|---|---|
@odata.type |
string:
#Microsoft. |
Ein URI-Fragment, das den Identitätstyp angibt. |
SearchIndexerDataUserAssignedIdentity
Gibt die Identität für eine zu verwendende Datenquelle an.
Name | Typ | Beschreibung |
---|---|---|
@odata.type |
string:
#Microsoft. |
Ein URI-Fragment, das den Identitätstyp angibt. |
userAssignedIdentity |
string |
Die vollqualifizierte Azure-Ressourcen-ID einer vom Benutzer zugewiesenen verwalteten Identität in der Regel im Format "/subscriptions/12345678-1234-1234-1234-1234567890ab/resourceGroups/rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId", die dem Suchdienst zugewiesen werden sollen. |
SearchResourceEncryptionKey
Ein vom Kunden verwalteter Verschlüsselungsschlüssel im Azure Key Vault. Schlüssel, die Sie erstellen und verwalten, können zum Verschlüsseln oder Entschlüsseln ruhender Daten verwendet werden, z. B. Indizes und Synonymzuordnungen.
Name | Typ | Beschreibung |
---|---|---|
accessCredentials |
Optionale Azure Active Directory-Anmeldeinformationen, die für den Zugriff auf Ihren Azure Key Vault verwendet werden. Ist nicht erforderlich, wenn stattdessen verwaltete Identität verwendet wird. |
|
identity | SearchIndexerDataIdentity: |
Eine explizite verwaltete Identität, die für diesen Verschlüsselungsschlüssel verwendet werden soll. Wenn diese Eigenschaft nicht angegeben ist und die Eigenschaft für Zugriffsanmeldeinformationen null ist, wird die vom System zugewiesene verwaltete Identität verwendet. Wenn die explizite Identität nicht angegeben ist, bleibt die Aktualisierung der Ressource unverändert. Wenn "none" angegeben wird, wird der Wert dieser Eigenschaft gelöscht. |
keyVaultKeyName |
string |
Der Name Ihres Azure Key Vault-Schlüssels, der zum Verschlüsseln Ihrer ruhenden Daten verwendet werden soll. |
keyVaultKeyVersion |
string |
Die Version Ihres Azure Key Vault-Schlüssels, der zum Verschlüsseln Ihrer ruhenden Daten verwendet werden soll. |
keyVaultUri |
string |
Der URI Ihres Azure Key Vault, auch als DNS-Name bezeichnet, der den Schlüssel enthält, der zum Verschlüsseln Ihrer ruhenden Daten verwendet werden soll. Ein Beispiel-URI kann |