Adatok másolása Azure AI Search-indexbe az Azure Data Factory vagy a Synapse Analytics használatával

A következőkre vonatkozik: Azure Data Factory Azure Synapse Analytics

Ez a cikk azt ismerteti, hogyan másolhat adatokat az Azure AI Search-indexbe az Azure Data Factory vagy a Synapse Analytics-folyamat másolási tevékenységével. A másolási tevékenység áttekintési cikkére épül, amely a másolási tevékenység általános áttekintését mutatja be.

Támogatott képességek

Ez az Azure AI Search-összekötő a következő képességeket támogatja:

(1) Azure-integrációs modul (2) Saját üzemeltetésű integrációs modul

Bármilyen támogatott forrásadattárból másolhat adatokat a keresési indexbe. A másolási tevékenység által forrásként/fogadóként támogatott adattárak listáját a Támogatott adattárak táblában találja.

Első lépések

A Copy tevékenység folyamattal való végrehajtásához használja az alábbi eszközök vagy SDK-k egyikét:

• Az Adatok másolása eszköz
• Az Azure Portal
• A .NET SDK
• A Python SDK
• Azure PowerShell
• A REST API
• Az Azure Resource Manager-sablon

Társított szolgáltatás létrehozása az Azure Search szolgáltatáshoz felhasználói felületen

Az alábbi lépésekkel létrehozhat egy társított szolgáltatást az Azure Search szolgáltatáshoz az Azure Portal felhasználói felületén.

1. Keresse meg az Azure Data Factory vagy a Synapse-munkaterület Kezelés lapját, és válassza a Társított szolgáltatások lehetőséget, majd kattintson az Új gombra:

   • Azure Data Factory
   • Azure Synapse

   

2. Keressen rá a keresésre, és válassza ki az Azure Search-összekötőt.

   

3. Konfigurálja a szolgáltatás részleteit, tesztelje a kapcsolatot, és hozza létre az új társított szolgáltatást.

   

Az összekötő konfigurációjának részletei

Az alábbi szakaszok az Azure AI Search-összekötőre jellemző Data Factory-entitások meghatározásához használt tulajdonságok részleteit ismertetik.

Társított szolgáltatás tulajdonságai

Az Azure AI Search társított szolgáltatásához a következő tulajdonságok támogatottak:

Példa:

{
    "name": "AzureSearchLinkedService",
    "properties": {
        "type": "AzureSearch",
        "typeProperties": {
            "url": "https://<service>.search.windows.net",
            "key": {
                "type": "SecureString",
                "value": "<AdminKey>"
            }
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Adathalmaz tulajdonságai

Az adathalmazok meghatározásához elérhető szakaszok és tulajdonságok teljes listáját az adathalmazokról szóló cikkben találja. Ez a szakasz az Azure AI Search-adatkészlet által támogatott tulajdonságok listáját tartalmazza.

Az adatok Azure AI Searchbe való másolásához a következő tulajdonságok támogatottak:

Példa:

{
    "name": "AzureSearchIndexDataset",
    "properties": {
        "type": "AzureSearchIndex",
        "typeProperties" : {
            "indexName": "products"
        },
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<Azure AI Search linked service name>",
            "type": "LinkedServiceReference"
        }
   }
}

Másolási tevékenység tulajdonságai

A tevékenységek meghatározásához elérhető szakaszok és tulajdonságok teljes listáját a Folyamatok című cikkben találja. Ez a szakasz az Azure AI Search-forrás által támogatott tulajdonságok listáját tartalmazza.

Azure AI Search fogadóként

Az adatok Azure AI Searchbe való másolásához állítsa be a másolási tevékenység forrástípusát az AzureSearchIndexSinkre. A másolási tevékenység fogadó szakasza a következő tulajdonságokat támogatja:

WriteBehavior tulajdonság

AzureSearchSink upserts adatok írásakor. Más szóval egy dokumentum írásakor, ha a dokumentumkulcs már létezik a keresési indexben, az Azure AI Search az ütközési kivétel helyett frissíti a meglévő dokumentumot.

Az AzureSearchSink a következő két upsert viselkedést biztosítja (az AzureSearch SDK használatával):

• Egyesítés: egyesítse az új dokumentum összes oszlopát a meglévővel. Az új dokumentumban null értékű oszlopok esetén a meglévő érték megmarad.
• Feltöltés: Az új dokumentum lecseréli a meglévőt. Az új dokumentumban nem megadott oszlopok esetében az érték null értékre van állítva, függetlenül attól, hogy a meglévő dokumentumban van-e nem null érték.

Az alapértelmezett viselkedés az Egyesítés.

WriteBatchSize tulajdonság

Az Azure AI Search szolgáltatás támogatja a dokumentumok kötegként való írását. A kötegek 1–1000 műveletet tartalmazhatnak. Egy művelet egy dokumentumot kezel a feltöltési/egyesítési művelet végrehajtásához.

Példa:

"activities":[
    {
        "name": "CopyToAzureSearch",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<Azure AI Search output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "<source type>"
            },
            "sink": {
                "type": "AzureSearchIndexSink",
                "writeBehavior": "Merge"
            }
        }
    }
]

Adattípus támogatása

Az alábbi táblázat azt határozza meg, hogy támogatott-e az Azure AI Search adattípusa.

Jelenleg más adattípusok, például a ComplexType nem támogatottak. Az Azure AI Search által támogatott adattípusok teljes listáját a Támogatott adattípusok (Azure AI Search) című témakörben találja.

Kapcsolódó tartalom

A másolási tevékenység által forrásként és fogadóként támogatott adattárak listáját a támogatott adattárakban találja.