Menyalin data ke indeks Pencarian Azure AI menggunakan Azure Data Factory atau Synapse Analytics

BERLAKU UNTUK: Azure Data Factory Azure Synapse Analytics

Artikel ini menguraikan cara menggunakan Aktivitas Salin di alur Azure Data Factory atau Synapse Analytics untuk menyalin data ke indeks Pencarian Azure AI. Artikel tersebut dibuat berdasarkan artikel gambaran umum aktivitas salin yang menyajikan gambaran umum aktivitas salin.

Kemampuan yang didukung

Konektor Azure AI Search ini didukung untuk kemampuan berikut:

① Runtime integrasi Azure ② Runtime integrasi yang dihost sendiri

Anda juga dapat menyalin data dari penyimpanan data sumber yang didukung ke indeks pencarian. Untuk daftar penyimpanan data yang didukung sebagai sumber/sink oleh aktivitas salin, lihat tabel Penyimpanan data yang didukung.

Memulai

Untuk melakukan aktivitas Salin dengan alur, Anda dapat menggunakan salah satu alat atau SDK berikut:

• Alat Penyalinan Data
• Portal Microsoft Azure
• SDK .NET
• SDK Python
• Azure PowerShell
• REST API
• Templat Azure Resource Manager

Membuat layanan tertaut ke Azure Search menggunakan UI

Gunakan langkah-langkah berikut untuk membuat layanan tertaut ke Azure Search di UI portal Azure.

1. Telusuri ke tab Kelola di ruang kerja Azure Data Factory atau Synapse Anda dan pilih Layanan Tertaut, lalu klik Baru:

   • Azure Data Factory
   • Azure Synapse

   

2. Cari dan pilih konektor Azure Search.

   

3. Konfigurasikan detail layanan, uji koneksi, dan buat layanan tertaut baru.

   

Detail konfigurasi konektor

Bagian berikut ini menyediakan detail tentang properti yang digunakan untuk menentukan entitas Data Factory khusus untuk konektor Azure AI Search.

Properti layanan tertaut

Properti berikut ini didukung untuk layanan tertaut Azure AI Search:

Contoh:

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

Properti himpunan data

Untuk daftar lengkap bagian dan properti yang tersedia untuk menentukan himpunan data, lihat artikel himpunan data. Bagian ini menyediakan daftar properti yang didukung oleh himpunan data Azure AI Search.

Untuk menyalin data ke Azure AI Search, properti berikut ini didukung:

Contoh:

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

Properti aktivitas salin

Untuk daftar lengkap bagian dan properti yang tersedia untuk menentukan aktivitas, lihat artikel Alur. Bagian ini menyediakan daftar properti yang didukung oleh sumber Pencarian Azure AI.

Pencarian Azure AI sebagai sink

Untuk menyalin data ke Azure AI Search, atur jenis sumber dalam aktivitas salin ke AzureSearchIndexSink. Berikut adalah properti yang didukung di bagian sink aktivitas salin:

Properti WriteBehavior

AzureSearchSink upsert saat menulis data. Dengan kata lain, saat menulis dokumen, jika kunci dokumen sudah ada di indeks pencarian, Azure AI Search memperbarui dokumen yang ada daripada melemparkan pengecualian konflik.

AzureSearchSink menyediakan dua perilaku upsert berikut (dengan menggunakan AzureSearch SDK):

• Gabungkan: gabungkan semua kolom di dokumen baru dengan yang sudah ada. Untuk kolom dengan nilai kosong di dokumen baru, nilai dalam yang sudah ada dipertahankan.
• Unggah: Dokumen baru menggantikan dokumen yang sudah ada. Untuk kolom yang tidak ditentukan dalam dokumen baru, nilai diatur ke null apakah ada nilai bukan nol di dokumen yang ada atau tidak.

Perilaku default adalah Gabungkan.

Properti WriteBatchSize

Azure AI layanan Pencarian mendukung penulisan dokumen sebagai batch. Batch dapat berisi 1 hingga 1.000 Tindakan. Tindakan menangani satu dokumen untuk melakukan operasi unggah/gabungkan.

Contoh:

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

Dukungan jenis data

Tabel berikut menentukan apakah jenis data Pencarian Azure AI didukung atau tidak.

Saat ini jenis data lainnya misalnya ComplexType tidak didukung. Untuk daftar lengkap jenis data yang didukung Azure AI Search, lihat Jenis data yang didukung (Pencarian Azure AI).

Konten terkait

Untuk daftar penyimpanan data yang didukung sebagai sumber dan sink oleh aktivitas salin, lihat penyimpanan data yang didukung.