Bagikan melalui

Salin data dari Zoho menggunakan Azure Data Factory atau Synapse Analytics (Pratinjau)

  • Artikel

BERLAKU UNTUK: Azure Data Factory Azure Synapse Analytics

Tip

Cobalah Data Factory di Microsoft Fabric, solusi analitik all-in-one untuk perusahaan. Microsoft Fabric mencakup semuanya mulai dari pergerakan data hingga ilmu data, analitik real time, kecerdasan bisnis, dan pelaporan. Pelajari cara memulai uji coba baru secara gratis!

Penting

Konektor ini berada di tahap Akhir Dukungan. Anda disarankan untuk bermigrasi ke konektor ODBC dengan menginstal driver.

Artikel ini menguraikan cara menggunakan Tindakan Menyalin di Azure Data Factory atau alur Synapse Analytics untuk menyalin data dari Zoho. Artikel tersebut dibuat berdasarkan artikel gambaran umum aktivitas salin yang menyajikan gambaran umum aktivitas salin.

Kemampuan yang didukung

Konektor Zoho ini didukung untuk kemampuan berikut:

Kemampuan yang didukung IR
Aktivitas penyalinan (sumber/-) (1) (2)
Aktivitas pencarian (1) (2)

① Runtime integrasi Azure ② Runtime integrasi yang dihost sendiri

Untuk daftar penyimpanan data yang didukung sebagai sumber/sink, lihat tabel Penyimpanan data yang didukung.

Konektor ini mendukung autentikasi token akses Xero dan autentikasi OAuth 2.0.

Layanan ini menyediakan driver bawaan untuk mengaktifkan konektivitas, oleh karena itu Anda tidak perlu memasang driver apa pun secara manual menggunakan konektor ini.

Memulai

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

Membuat layanan tertaut ke Zoho menggunakan UI

Gunakan langkah-langkah berikut untuk membuat layanan tertaut ke Zoho 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:

  2. Cari Zoho dan pilih konektor Zoho.

    Pilih konektor Zoho.

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

    Mengonfigurasi layanan tertaut ke Zoho.

Detail konfigurasi konektor

Bagian berikut ini memberikan detail tentang properti yang digunakan untuk menentukan entitas Data Factory khusus untuk konektor Zoho.

Properti layanan tertaut

Properti berikut ini didukung untuk layanan tertaut Zoho:

Properti Deskripsi Wajib
jenis Jenis properti harus diatur ke: Zoho Ya
connectionProperties Grup properti yang menentukan cara tersambung ke Zoho. Ya
Di bawah connectionProperties:
titik akhir Titik akhir server Zoho (crm.zoho.com/crm/private). Ya
authenticationType Nilai yang diizinkan adalah OAuth_2.0 dan Access Token. Ya
clientId ID klien yang terkait dengan aplikasi Zoho Anda. Ya untuk autentikasi OAuth 2.0
clientSecret Klien yang terkait dengan aplikasi Zoho Anda. Tandai bidang ini sebagai SecureString untuk menyimpannya dengan aman, atau mereferensikan rahasia yang disimpan di Azure Key Vault. Ya untuk autentikasi OAuth 2.0
refreshToken Token refresh OAuth 2.0 yang terkait dengan aplikasi Zoho Anda, digunakan untuk me-refresh token akses saat kedaluwarsa. Token refresh tidak akan pernah kedaluwarsa. Untuk mendapatkan token refresh, Anda harus meminta access_type offline, pelajari lebih lanjut dari artikel ini.
Tandai bidang ini sebagai SecureString untuk menyimpannya dengan aman, atau mereferensikan rahasia yang disimpan di Azure Key Vault.		 Ya untuk autentikasi OAuth 2.0
accessToken Token akses untuk autentikasi Zoho. Tandai bidang ini sebagai SecureString untuk menyimpannya dengan aman, atau mereferensikan rahasia yang disimpan di Azure Key Vault. Ya
useEncryptedEndpoints Menentukan apakah titik akhir sumber data dienkripsi menggunakan HTTPS. Nilai defaultnya adalah true. No
useHostVerification Menentukan apakah mewajibkan nama host di sertifikat server agar sesuai dengan nama host server saat menyambungkan melalui TLS. Nilai defaultnya adalah true. No
usePeerVerification Menentukan apakah akan memverifikasi identitas server ketika menyambungkan melalui TLS. Nilai defaultnya adalah true. No

Contoh: autentikasi OAuth 2.0

{
    "name": "ZohoLinkedService",
    "properties": {
        "type": "Zoho",
        "typeProperties": {
            "connectionProperties": { 
                "authenticationType":"OAuth_2.0", 
                "endpoint": "crm.zoho.com/crm/private", 
                "clientId": "<client ID>", 
                "clientSecret": {
                    "type": "SecureString",
                    "value": "<client secret>"
                },
                "accessToken": {
                    "type": "SecureString",
                    "value": "<access token>"
                }, 
                "refreshToken": {
                    "type": "SecureString",
                    "value": "<refresh token>"
                }, 
                "useEncryptedEndpoints": true,
                "useHostVerification": true, 
                "usePeerVerification": true
            }
        }
    }
}

Contoh: autentikasi token akses

{
    "name": "ZohoLinkedService",
    "properties": {
        "type": "Zoho",
        "typeProperties": {
            "connectionProperties": { 
                "authenticationType":"Access Token", 
                "endpoint": "crm.zoho.com/crm/private", 
                "accessToken": {
                    "type": "SecureString",
                    "value": "<access token>"
                }, 
                "useEncryptedEndpoints": true, 
                "useHostVerification": true, 
                "usePeerVerification": true
            }
        }
    }
}

Properti himpunan data

Untuk daftar lengkap bagian dan properti yang tersedia untuk menentukan himpunan data, lihat artikel himpunan data. Bagian ini memberikan daftar properti yang didukung oleh himpunan data Zoho.

Untuk menyalin data dari Zoho, atur properti jenis himpunan data ke ZohoObject. Berikut adalah properti yang didukung:

Properti Deskripsi Wajib
jenis Properti jenis himpunan data harus diatur ke: ZohoObject Ya
tableName Nama tabel. Tidak (jika "kueri" di sumber aktivitas ditentukan)

Contoh

{
    "name": "ZohoDataset",
    "properties": {
        "type": "ZohoObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<Zoho linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Properti aktivitas salin

Untuk daftar lengkap bagian dan properti yang tersedia untuk menentukan aktivitas, lihat artikel Alur. Bagian ini memberikan daftar properti yang didukung oleh sumber Zoho.

Zoho sebagai sumber

Untuk menyalin data dari Zoho, atur jenis sumber dalam aktivitas penyalinan ke ZohoSource. Berikut ini properti yang didukung di bagian sumber aktivitas salin:

Properti Deskripsi Wajib
jenis Properti jenis sumber aktivitas penyalinan harus diatur ke: ZohoSource Ya
pertanyaan Gunakan kueri SQL kustom untuk membaca data. Misalnya: "SELECT * FROM Accounts". Tidak (jika "tableName" di himpunan data ditentukan)

Contoh:

"activities":[
    {
        "name": "CopyFromZoho",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<Zoho input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "ZohoSource",
                "query": "SELECT * FROM Accounts"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Properti aktivitas pencarian

Untuk mempelajari detail tentang properti, lihat Aktivitas pencarian.

Konten terkait

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