Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Hinweis
Foundry IQ (Azure KI-Suche) bietet direkte Indizierungs- und Abfrage-APIs zusammen mit Wissensquellen- und Knowledge Base-APIs auf höherer Ebene für den verwalteten Abruf. Verwenden Sie das Azure Portal, REST-APIs oder Azure SDKs, um diese Funktionen zu konfigurieren, oder verbinden Sie Agents mit Wissensdatenbanken im Microsoft Foundry-Portal.
Die Azure Cosmos DB für NoSQL Indexer importiert Inhalte aus Azure Cosmos DB für NoSQL und macht sie in Foundry IQ (Azure KI-Suche) durchsuchbar.
Dieser Artikel ergänzt den Artikel Erstellen von Indexern mit Informationen, die Cosmos DB-spezifisch sind. Er verwendet das Azure-Portal und REST-APIs, um einen dreiteiligen Workflow zu veranschaulichen, der allen Indexern gemeinsam ist: Erstellen einer Datenquelle, Erstellen eines Indexes und Erstellen eines Indexers. Die Datenextraktion erfolgt, wenn Sie die Anforderung für die Indexererstellung übermitteln.
Da die Terminologie verwirrend sein kann, sollte beachtet werden, dass Azure Cosmos DB-Indizierung und Foundry IQ-Indizierung verschiedene Vorgänge sind. Die Indizierung in Foundry IQ erstellt und lädt einen Suchindex für Ihren Foundry IQ Service.
Voraussetzungen
Ein Azure Cosmos DB-Konto, eine Datenbank, einen Container und Elemente. Verwenden Sie dieselbe Region sowohl für Foundry IQ als auch für Azure Cosmos DB für niedrigere Latenz und um Bandbreitengebühren zu vermeiden.
Eine auf Konsistent festgelegte automatische Indizierungsrichtlinie für die Azure Cosmos DB-Sammlung. Dies ist die Standardkonfiguration. Verzögerte Indizierung wird nicht empfohlen und kann zu fehlenden Daten führen.
Leseberechtigungen. Ein "Vollzugriff" Verbindungszeichenfolge enthält einen Schlüssel, der Zugriff auf den Inhalt gewährt, aber wenn Sie Identitäten (Microsoft Entra ID) verwenden, stellen Sie sicher, dass die verwaltete Identität des Foundry IQ-Diensts sowohl als Cosmos DB-Kontoleserrolle als auch als integrierte Rolle des Cosmos DB-Datenlesers zugewiesen ist.
Um die Beispiele in diesem Artikel durchzuarbeiten, benötigen Sie das Azure-Portal oder einen REST-Client. Wenn Sie das Azure-Portal verwenden, stellen Sie sicher, dass der Zugriff auf alle öffentlichen Netzwerke aktiviert ist. Andere Ansätze zum Erstellen eines Cosmos DB-Indexers beinhalten Azure SDKs.
Mit Beispieldaten testen
Halten Sie sich an diese Anweisungen, um zu Testzwecken einen Container und eine Datenbank in Cosmos DB zu erstellen.
Laden Sie HotelsData_toCosmosDB.json von GitHub herunter, um einen Container in Cosmos DB zu erstellen, der eine Teilmenge des Beispiel-Hotels-Datasets enthält.
Melden Sie sich beim Azure-Portal an, und erstellen Sie ein Konto, eine Datenbank und einen Container in Cosmos DB.
Wählen Sie in Cosmos DB Data Explorer aus, und geben Sie für den neuen Container die folgenden Werte an.
Eigentum Wert Datenbank Neu erstellen Datenbank-ID Hotels-Datenbank Durchsatz zwischen Containern freigeben Nicht auswählen Container-ID Hotels Partitionsschlüssel /HotelId Containerdurchsatz (Autoskalierung) Automatische Skalierung Container maximale RU/s 1.000 Erweitern Sie im Daten-Explorerhotelsdb und Hotels, und wählen Sie dann "Elemente" aus.
Wählen Sie Element hochladen und dann die Datei HotelsData_toCosmosDB.json aus, die Sie von GitHub heruntergeladen haben.
Klicken Sie mit der rechten Maustaste auf Elemente, und wählen Sie Neue SQL-Abfrage aus. Die Standardabfrage ist
SELECT * FROM c.Wählen Sie Abfrage ausführen aus, um die Abfrage auszuführen, und sehen Sie sich die Ergebnisse an. Sie sollten über 50 Hoteldokumente verfügen.
Sie verfügen nun über einen Container und können jetzt das Azure-Portal, den REST-Client oder ein Azure SDK verwenden, um Ihre Daten zu indizieren.
Das Feld „Beschreibung“ enthält den ausführlichsten Inhalt. Sie sollten dieses Feld für Volltextsuche und optionale Vektorabfragen verwenden.
Verwenden des Azure-Portals
Sie können den Importdaten-Assistenten verwenden, um die Indizierung aus einer SQL-Datenbanktabelle oder -Ansicht zu automatisieren.
Wählen Sie unter Mit Daten verbinden als Datenquellentyp Azure Cosmos DB oder NoSQL-Konto aus, oder vergewissern Sie sich, dass der entsprechende Datenquellentyp bereits festgelegt ist.
Der Datenquellenname bezieht sich auf das Datenquellenverbindungsobjekt in Foundry IQ. Der Name der Datenquelle wird automatisch mit einem benutzerdefinierten Präfix generiert, das Sie am Ende des Assistentenworkflows angeben.
Geben Sie den Namen und die Sammlung der Datenbank an. Die Abfrage ist optional. Es ist nützlich, wenn Sie über hierarchische Daten verfügen und einen bestimmten Slice importieren möchten.
Geben Sie eine Authentifizierungsmethode an, entweder eine verwaltete Identität oder einen integrierten API-Schlüssel. Wenn Sie keine Verbindung mit verwalteter Identität angeben, verwendet das Azure-Portal den Schlüssel.
Wenn Sie Foundry IQ für die Verwendung einer verwalteten Identität konfigurieren und eine Rollenzuweisung für Cosmos DB erstellen, die Cosmos DB Account Reader und Cosmos DB Integrierte Datenleserberechtigungen für die Identität erteilt, kann Ihr Indexer mithilfe von Microsoft Entra ID und Rollen eine Verbindung mit Cosmos DB herstellen.
Sie können Optionen für die Änderungs- und Löschnachverfolgung angeben.
Die Änderungserkennung wird standardmäßig über ein
_tsFeld (Zeitstempel) unterstützt. Wenn Sie Inhalte mithilfe des unter Mit Beispieldaten testen beschriebenen Ansatz hochladen, wird die Sammlung mit dem Feld_tserstellt.Die Löscherkennung erfordert, dass Sie ein bereits vorhandenes Feld auf oberster Ebene in der Auflistung haben, das als Soft delete-Flag verwendet werden kann. Es sollte sich um ein boolesches Feld handeln. (Sie können es z. B. „IsDeleted“ nennen.) Geben Sie als Wert für das vorläufige Löschen
truean. Fügen Sie im Suchindex ein entsprechendes Suchfeld namens IsDeleted hinzu, dass auf abrufbar und filterbar festgelegt ist.Fahren Sie mit den verbleibenden Schritten fort, um den Assistenten abzuschließen:
Verwenden der REST-APIs
In diesem Abschnitt werden die REST-API-Aufrufe veranschaulicht, die eine Datenquelle, einen Index und einen Indexer erstellen.
Definieren der Datenquelle
Die Datenquellendefinition gibt die zu indizierenden Daten, die Anmeldeinformationen und die Richtlinien für die Identifizierung von Datenänderungen an. Eine Datenquelle ist eine unabhängige Ressource, welche von mehreren Indexern verwendet werden kann.
Eine Datenquelle erstellen oder aktualisieren, um ihre Definition festzulegen:
POST https://[service name].search.windows.net/datasources?api-version=2026-10-01 Content-Type: application/json api-key: [Search service admin key] { "name": "[my-cosmosdb-ds]", "type": "cosmosdb", "credentials": { "connectionString": "AccountEndpoint=https://[cosmos-account-name].documents.azure.com;AccountKey=[cosmos-account-key];Database=[cosmos-database-name]" }, "container": { "name": "[my-cosmos-db-collection]", "query": null }, "dataChangeDetectionPolicy": { "@odata.type": "#Microsoft.Azure.Search.HighWaterMarkChangeDetectionPolicy", "highWaterMarkColumnName": "_ts" }, "dataDeletionDetectionPolicy": null, "encryptionKey": null, "identity": null }Legen Sie "type" auf
"cosmosdb"fest (erforderlich). Wenn Sie eine ältere Such-API-Version als 2017-11-11 verwenden, lautet die Syntax für „type“"documentdb". Verwenden Sie andernfalls für 2019-05-06 und höher"cosmosdb".Legen Sie „credentials“ auf eine Verbindungszeichenfolge fest. Im nächsten Abschnitt werden die unterstützten Formate beschrieben.
Legen Sie „container“ auf die Auflistung fest. Die Eigenschaft „name“ ist erforderlich und gibt die ID der zu indizierenden Datenbanksammlung an. Die Eigenschaft „query“ ist optional. Verwenden Sie es, um ein beliebiges JSON-Dokument zu verflachen in ein flaches Schema, das Foundry IQ indizieren kann.
Legen Sie "dataChangeDetectionPolicy" fest, wenn Daten veränderlich sind und der Indexer nur die neuen und aktualisierten Elemente bei nachfolgenden Ausführungen aufnehmen soll.
Legen Sie "dataDeletionDetectionPolicy" fest, wenn Sie Suchdokumente aus einem Suchindex entfernen möchten, wenn das Quellelement gelöscht wird.
Unterstützte Anmeldeinformationen und Verbindungszeichenfolgen
Indexer können mithilfe der folgenden Verbindungen eine Verbindung mit einer Sammlung herstellen.
Vermeiden Sie Portnummern in der Endpunkt-URL. Wenn Sie die Portnummer einschließen, tritt beim Herstellen der Verbindung ein Fehler auf.
| Vollzugriff-Verbindungszeichenfolge |
|---|
{ "connectionString" : "AccountEndpoint=https://<Cosmos DB account name>.documents.azure.com;AccountKey=<Cosmos DB auth key>;Database=<Cosmos DB database id>" } |
| Sie können die Verbindungszeichenfolge über die Azure Cosmos DB-Kontoseite im Azure-Portal abrufen, indem Sie im linken Bereich Schlüssel auswählen. Stellen Sie sicher, dass Sie eine vollständige Verbindungszeichenfolge und nicht nur einen Schlüssel auswählen. |
| (Moderner Ansatz) Verbindungszeichenfolge für verwaltete Identitäten für NoSQL-Konten |
|---|
{ "connectionString" : "ResourceId=/subscriptions/<your subscription ID>/resourceGroups/<your resource group name>/providers/Microsoft.DocumentDB/databaseAccounts/<your cosmos db account name>/;(ApiKind=[api-kind];)/(IdentityAuthType=AccessToken)" } |
| Diese Verbindungszeichenfolge, die nur für Azure Cosmos DB für NoSQL-Konten unterstützt wird, stellt sicher, dass der Foundry IQ-Dienst beim Versuch, auf Daten aus Cosmos DB zuzugreifen, niemals Kontoschlüssel verwendet (auch nicht im Hintergrund). Dieser Ansatz wird empfohlen, da er auch dann funktioniert, wenn das NoSQL Konto Kontoschlüssel deaktiviert hat. Weitere Informationen finden Sie unter Einrichten einer Indexerverbindung mit einer Azure Cosmos DB Datenbank mithilfe einer verwalteten Identität. |
| (Verwalteter Ansatz) Verbindungszeichenfolge für verwaltete Identitäten |
|---|
{ "connectionString" : "ResourceId=/subscriptions/<your subscription ID>/resourceGroups/<your resource group name>/providers/Microsoft.DocumentDB/databaseAccounts/<your cosmos db account name>/;(ApiKind=[api-kind];)/(IdentityAuthType=AccountKey)" } |
Diese Verbindungszeichenfolge erfordert keine direkte Angabe eines Kontoschlüssels, aber der Foundry IQ-Dienst verwendet die verwaltete Identität, um die Kontoschlüssel im Hintergrund abzurufen. Obwohl dieser Ansatz für alle Cosmos DB-Kontotypen unterstützt wird, wird er für den NoSQL Kontotyp nicht empfohlen. Eine solche Verbindungszeichenfolge funktioniert nicht, wenn Kontoschlüssel für das Cosmos DB-Konto deaktiviert sind. Wenn die IdentityAuthType Eigenschaft nicht angegeben wird, ruft der Foundry IQ-Dienst standardmäßig den Kontoschlüssel weiterhin im Hintergrund ab. Bei Verbindungen, die auf die SQL-API abzielen, können Sie ApiKind in der Verbindungszeichenfolge weglassen. Weitere Informationen zu ApiKind und IdentityAuthType finden Sie unter Einrichten einer Indexerverbindung mit einer Azure Cosmos DB-Datenbank mithilfe einer verwalteten Identität. |
Verwenden von Abfragen zum Formen indizierter Daten
In der Eigenschaft „query“ unter „container“ können Sie eine SQL-Abfrage angeben, um geschachtelte Eigenschaften oder Arrays zu vereinfachen, JSON-Eigenschaften zu projizieren und die zu indizierenden Daten zu filtern.
Beispieldokument:
{
"userId": 10001,
"contact": {
"firstName": "andy",
"lastName": "hoh"
},
"company": "microsoft",
"tags": ["azure", "cosmosdb", "search"]
}
Abfrage zur Filterung:
SELECT * FROM c WHERE c.company = "microsoft" and c._ts >= @HighWaterMark ORDER BY c._ts
Vereinfachen der Abfrage:
SELECT c.id, c.userId, c.contact.firstName, c.contact.lastName, c.company, c._ts FROM c WHERE c._ts >= @HighWaterMark ORDER BY c._ts
Abfrage zur Projektion:
SELECT VALUE { "id":c.id, "Name":c.contact.firstName, "Company":c.company, "_ts":c._ts } FROM c WHERE c._ts >= @HighWaterMark ORDER BY c._ts
Abfrage zum Vereinfachen eines Arrays:
SELECT c.id, c.userId, tag, c._ts FROM c JOIN tag IN c.tags WHERE c._ts >= @HighWaterMark ORDER BY c._ts
Nicht unterstützte Abfragen (DISTINCT und GROUP BY)
Abfragen mit dem Schlüsselwort DISTINCT oder der GROUP BY-Klausel werden nicht unterstützt. Foundry IQ basiert auf der SQL-Abfrage-Paginierung , um die Ergebnisse der Abfrage vollständig aufzählen zu können. Weder das Schlüsselwort DISTINCT noch die GROUP BY-Klausel sind mit den Fortsetzungstoken kompatibel, die zum Paginieren der Ergebnisse verwendet werden.
Beispiele für nicht unterstützte Abfragen:
SELECT DISTINCT c.id, c.userId, c._ts FROM c WHERE c._ts >= @HighWaterMark ORDER BY c._ts
SELECT DISTINCT VALUE c.name FROM c ORDER BY c.name
SELECT TOP 4 COUNT(1) AS foodGroupCount, f.foodGroup FROM Food f GROUP BY f.foodGroup
Obwohl Azure Cosmos DB eine Problemumgehung zur Unterstützung der SQL-Abfrage paginierung mit dem DISTINCT-Schlüsselwort mithilfe der ORDER BY-Klausel aufweist, ist sie nicht mit Foundry IQ kompatibel. Die Abfrage gibt einen einzelnen JSON-Wert zurück, während Foundry IQ ein JSON-Objekt erwartet.
-- The following query returns a single JSON value and isn't supported by Azure AI Search
SELECT DISTINCT VALUE c.name FROM c ORDER BY c.name
Hinzufügen von Suchfeldern zu einem Index
Fügen Sie in einem Suchindex Felder hinzu, um die JSON-Quelldokumente oder die Ausgabe Ihrer benutzerdefinierten Abfrageprojektion zu akzeptieren. Stellen Sie sicher, dass das Suchindexschema mit den Quelldaten kompatibel ist. Für Inhalte in Azure Cosmos DB muss Ihr Suchindexschema den Azure Cosmos DB-Elementen in Ihrer Datenquelle entsprechen.
Erstellen oder aktualisieren Sie einen Index, um Suchfelder zu definieren, die Daten speichern:
POST https://[service name].search.windows.net/indexes?api-version=2026-10-01 Content-Type: application/json api-key: [Search service admin key] { "name": "mysearchindex", "fields": [{ "name": "rid", "type": "Edm.String", "key": true, "searchable": false }, { "name": "description", "type": "Edm.String", "filterable": false, "searchable": true, "sortable": false, "facetable": false, "suggestions": true } ] }Erstellen Sie ein Dokumentschlüsselfeld („key“: true). Bei partitionierten Auflistungen ist der Standarddokumentschlüssel die Azure Cosmos DB
_rid-Eigenschaft, die Foundry IQ automatisch inridumbenennt, da Feldnamen nicht mit einem Unterstrich beginnen können. Außerdem enthalten Azure Cosmos DB_ridWerte Zeichen, die in Foundry IQ-Schlüsseln ungültig sind. Deshalb sind die_rid-Werte Base64-codiert.Erstellen Sie weitere Felder für mehr durchsuchbare Inhalte. Weitere Informationen finden Sie unter Erstellen eines Suchindex in Azure Cognitive Search.
Zuordnen von Datentypen
| JSON-Datentypen | Foundry IQ-Feldtypen |
|---|---|
| Bool | Edm.Boolean, Edm.String |
| Zahlen, die wie Ganzzahlen aussehen | Edm.Int32, Edm.Int64, Edm.String |
| Zahlen, die wie Gleitkommas aussehen | Edm.Double, Edm.String |
| String | Edm.String |
| Arrays primitiver Typen, z. B ["a", "b", "c"] | Collection(Edm.String) |
| Zeichenfolgen, die wie Datumsangaben aussehen | Edm.DateTimeOffset, Edm.String |
| GeoJSON-Objekte z. B. { "type": "Point", "coordinates": [long, lat] } | Edm.GeographyPoint |
| Andere JSON-Objekte | N/A |
Konfigurieren und Ausführen des Azure Cosmos DB for NoSQL-Indexers
Nach der Erstellung von Index und Datenquelle können Sie den Indexer erstellen. Die Indexerkonfiguration gibt die Eingaben, Parameter und Eigenschaften an, die das Laufzeitverhalten steuern.
Erstellen oder aktualisieren Sie einen Indexer , indem Sie ihm einen Namen geben und auf die Datenquelle und den Zielindex verweisen:
POST https://[service name].search.windows.net/indexers?api-version=2026-10-01 Content-Type: application/json api-key: [search service admin key] { "name" : "[my-cosmosdb-indexer]", "dataSourceName" : "[my-cosmosdb-ds]", "targetIndexName" : "[my-search-index]", "disabled": null, "schedule": null, "parameters": { "batchSize": null, "maxFailedItems": 0, "maxFailedItemsPerBatch": 0, "base64EncodeKeys": false, "configuration": {} }, "fieldMappings": [], "encryptionKey": null }Geben Sie Feldzuordnungen an, wenn Es Unterschiede im Feldnamen oder Typ gibt oder wenn Sie mehrere Versionen eines Quellfelds im Suchindex benötigen.
Weitere Informationen zu anderen Eigenschaften finden Sie unter Erstellen von Indexern in Azure Cognitive Search.
Ein Indexer wird automatisch ausgeführt, wenn er erstellt wird. Sie können dies verhindern, indem Sie „disabled“ (Deaktiviert) auf „true“ festlegen. Um die Ausführung des Indexers zu steuern, führen Sie einen Indexer nach Bedarf aus, oder legen Sie für ihn einen Zeitplan fest.
Überprüfen des Indexerstatus
Um den Indexerstatus und den Ausführungsverlauf zu überwachen, überprüfen Sie den Ausführungsverlauf des Indexers im Azure-Portal, oder senden Sie eine API-Anforderung zum Abrufen des Indexerstatus.
Öffnen Sie auf der Seite „Foundry IQ Service“ Search management>Indexers.
Wählen Sie einen Indexer aus, um auf den Konfigurations- und Ausführungsverlauf zuzugreifen.
Wählen Sie einen bestimmten Indexerauftrag aus, um Details, Warnungen und Fehler anzuzeigen.
Der Ausführungsverlauf enthält bis zu 50 der zuletzt abgeschlossenen Ausführungen. Diese sind in umgekehrter chronologischer Reihenfolge sortiert, sodass die neueste Ausführung als Erstes aufgelistet wird.
Indizieren neuer und geänderter Dokumente
Wenn ein Indexer einen Suchindex vollständig aufgefüllt hat, sollen bei nachfolgenden Indexerausführungen möglicherweise nur die neuen und geänderten Dokumente in Ihrer Datenbank inkrementell indiziert werden.
Um die inkrementelle Indizierung zu aktivieren, legen Sie die Eigenschaft „dataChangeDetectionPolicy“ in Ihrer Datenquellendefinition fest. Diese Eigenschaft teilt dem Indexer mit, welcher Mechanismus für die Änderungsnachverfolgung für Ihre Daten verwendet wird.
Für Azure Cosmos DB-Indexer wird nur die Richtlinie HighWaterMarkChangeDetectionPolicy unterstützt, bei der die von Azure Cosmos DB bereitgestellte Eigenschaft _ts (Zeitstempel) verwendet wird.
Das folgende Beispiel zeigt eine Datenquellendefinition mit einer Änderungserkennungsrichtlinie:
"dataChangeDetectionPolicy": {
"@odata.type": "#Microsoft.Azure.Search.HighWaterMarkChangeDetectionPolicy",
"highWaterMarkColumnName": "_ts"
},
Hinweis
Wenn Sie einem Feld in Ihrer Azure Cosmos DB einen null Wert zuweisen, kann der Foundry IQ-Indexer nicht zwischen null und einem fehlenden Feldwert unterscheiden. Wenn ein Feld im Index leer ist, wird es daher nicht durch einen null Wert ersetzt, auch wenn diese Änderung in Ihrer Datenbank vorgenommen wurde.
Inkrementelle Indizierung und benutzerdefinierte Abfragen
Wenn Sie eine benutzerdefinierte Abfrage zum Abrufen von Dokumenten verwenden, stellen Sie sicher, dass die Abfrage die Ergebnisse nach der Spalte _ts sortiert. Dies ermöglicht regelmäßige Checkpoints, die Foundry IQ verwendet, um beim Auftreten von Fehlern inkrementelle Fortschritte zu ermöglichen.
In einigen Fällen, selbst wenn Ihre Abfrage eine ORDER BY [collection alias]._ts Klausel enthält, kann Foundry IQ möglicherweise nicht davon ableiten, dass die Abfrage von der _ts. Sie können Foundry IQ mitteilen, dass die Ergebnisse sortiert werden, indem Sie die assumeOrderByHighWaterMarkColumn Konfigurationseigenschaft festlegen.
Um diesen Hinweis anzugeben, erstellen oder aktualisieren Sie Ihre Indexerdefinition wie folgt:
{
... other indexer definition properties
"parameters" : {
"configuration" : { "assumeOrderByHighWaterMarkColumn" : true } }
}
Indizieren von gelöschten Dokumenten
Wenn Zeilen aus der Quelltabelle gelöscht werden, möchten Sie diese Zeilen in der Regel auch aus dem Suchindex löschen. Die Richtlinie zum Erkennen von Datenlöschungen dient einer effizienten Identifizierung gelöschter Datenelemente. Zurzeit ist Soft Delete die einzige unterstützte Richtlinie (die Löschung wird durch ein bestimmtes Kennzeichen markiert), die in der Datenquellendefinition folgendermaßen festgelegt wird:
"dataDeletionDetectionPolicy": {
"@odata.type" : "#Microsoft.Azure.Search.SoftDeleteColumnDeletionDetectionPolicy",
"softDeleteColumnName" : "the property that specifies whether a document was deleted",
"softDeleteMarkerValue" : "the value that identifies a document as deleted"
}
Wenn Sie eine benutzerdefinierte Abfrage verwenden, stellen Sie sicher, dass die Eigenschaft, auf die softDeleteColumnName verweist, von der Abfrage projiziert wird.
softDeleteColumnName muss ein Feld auf oberster Ebene im Index sein. Das Verwenden von geschachtelten Feldern innerhalb komplexer Datentypen als softDeleteColumnName wird nicht unterstützt.
Im folgenden Beispiel wird eine Datenquelle mit einer Richtlinie zum vorläufigen Löschen erstellt:
POST https://[service name].search.windows.net/datasources?api-version=2026-10-01
Content-Type: application/json
api-key: [Search service admin key]
{
"name": "[my-cosmosdb-ds]",
"type": "cosmosdb",
"credentials": {
"connectionString": "AccountEndpoint=https://[cosmos-account-name].documents.azure.com;AccountKey=[cosmos-account-key];Database=[cosmos-database-name]"
},
"container": { "name": "[my-cosmos-collection]" },
"dataChangeDetectionPolicy": {
"@odata.type": "#Microsoft.Azure.Search.HighWaterMarkChangeDetectionPolicy",
"highWaterMarkColumnName": "_ts"
},
"dataDeletionDetectionPolicy": {
"@odata.type": "#Microsoft.Azure.Search.SoftDeleteColumnDeletionDetectionPolicy",
"softDeleteColumnName": "isDeleted",
"softDeleteMarkerValue": "true"
}
}
Verwenden von .NET
Für Daten, auf die über das SQL-API-Protokoll zugegriffen wird, können Sie das .NET SDK verwenden, um mit Indexern zu automatisieren. Es wird empfohlen, dass Sie den vorherige Abschnitt zur REST-API genau lesen, um die Konzepte, den Workflow und die Anforderungen zu verstehen. Sie können sich anschließend auf die folgende .NET-API-Referenzdokumentation beziehen, um einen JSON-Indexer in verwalteten Code zu implementieren:
- azure.search.documents.indexes.models.searchindexerdatasourceconnection
- azure.search.documents.indexes.models.searchindexerdatasourcetype
- azure.search.documents.indexes.models.searchindex
- azure.search.documents.indexes.models.searchindexer
Nächste Schritte
Sie können nun kontrollieren, wie Sie den Indexer ausführen, den Status überwachen oder die Ausführung des Indexers planen. Die folgenden Artikel gelten für Indexer, die Inhalte mithilfe von Pull Requests aus Azure Cosmos DB übertragen: