Menyalin data dari Square menggunakan Azure Data Factory atau Azure Synapse Analytics (Pratinjau)

BERLAKU UNTUK: Azure Data Factory Azure Synapse Analytics

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

Kemampuan yang didukung

Konektor Square ini didukung untuk kemampuan berikut:

① Runtime integrasi Azure ② Runtime integrasi yang dihost sendiri

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

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

Konektor mendukung versi Windows dalam artikel ini.

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 Square menggunakan UI

Gunakan langkah-langkah berikut untuk membuat layanan tertaut ke Square 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 Square dan pilih konektor Square.

   

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

   

Detail konfigurasi konektor

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

Properti layanan tertaut

Berikut ini properti yang didukung untuk layanan tertaut Square:

Square mendukung dua jenis token akses: pribadi dan OAuth.

• Token akses pribadi digunakan untuk mendapatkan akses API Connect tanpa batas ke sumber daya di akun Square Anda sendiri.

• Token akses OAuth digunakan untuk mendapatkan akses API Connect yang diautentikasi dan tercakup ke akun Square mana pun. Gunakan saat aplikasi Anda mengakses sumber daya di akun Square lain atas nama pemilik akun. Token akses OAuth juga dapat digunakan untuk mengakses sumber daya di akun Square Anda sendiri.

  Penting

  Untuk melakukan Uji koneksi di layanan tertaut, MERCHANT_PROFILE_READ diperlukan untuk mendapatkan token akses OAuth tercakup. Untuk izin mengakses tabel lain, lihat Referensi Izin OAuth Square.

Autentikasi melalui token akses pribadi hanya memerlukan accessToken, sementara autentikasi melalui OAuth memerlukan accessToken dan refreshToken. Pelajari cara mengambil token akses dari sini.

Contoh:

{
    "name": "SquareLinkedService",
    "properties": {
        "type": "Square",
        "typeProperties": {
            "connectionProperties": {
                "host": "<e.g. mystore.mysquare.com>", 
                "clientId": "<client ID>", 
                "clientSecret": {
                    "type": "SecureString",
                    "value": "<clientSecret>"
                }, 
                "accessToken": {
                    "type": "SecureString",
                    "value": "<access token>"
                }, 
                "refreshToken": {
                    "type": "SecureString",
                    "value": "<refresh 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 menyediakan daftar properti yang didukung oleh himpunan data Square.

Untuk menyalin data dari Square, atur properti type himpunan data ke SquareObject. Berikut adalah properti yang didukung:

Contoh

{
    "name": "SquareDataset",
    "properties": {
        "type": "SquareObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<Square 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 Square.

Square sebagai sumber

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

Contoh:

"activities":[
    {
        "name": "CopyFromSquare",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<Square input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "SquareSource",
                "query": "SELECT * FROM Business"
            },
            "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.