Menyalin data dari Square menggunakan Azure Data Factory atau Azure Synapse Analytics (Pratinjau)
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!
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.
Penting
Konektor ini saat ini dalam Pratinjau. Anda dapat mencobanya dan memberi kami umpan balik. Jika Anda ingin mengambil dependensi pada konektor pratinjau dalam solusi Anda, harap hubungi dukungan Azure.
Catatan
Saat ini, konektor ini tidak mendukung akun kotak pasir.
Kemampuan yang didukung
Konektor Square 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.
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.
Telusuri ke tab Kelola di ruang kerja Azure Data Factory atau Synapse Anda dan pilih Layanan Tertaut, lalu klik Baru:
Cari Square dan pilih konektor Square.
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:
Properti | Deskripsi | Wajib |
---|---|---|
jenis | Properti type harus diatur ke: Square | Ya |
connectionProperties | Grup properti yang menentukan cara tersambung ke Square. | Ya |
Di bawah connectionProperties : |
||
tuan rumah | URL instans Square. (yaitu mystore.mysquare.com) | Ya |
clientId | ID klien yang terkait dengan aplikasi Square Anda. | Ya |
clientSecret | Rahasia klien yang terkait dengan aplikasi Square Anda. Tandai bidang ini sebagai SecureString untuk menyimpannya dengan aman, atau mereferensikan rahasia yang disimpan di Azure Key Vault. | Ya |
accessToken | Token akses yang diperoleh dari Square. Memberikan akses terbatas ke akun Square dengan meminta pengguna yang diautentikasi untuk izin eksplisit. Token akses OAuth kedaluwarsa 30 hari setelah diterbitkan, tetapi token refresh tidak kedaluwarsa. Token akses dapat disegarkan dengan token refresh. Tandai bidang ini sebagai SecureString untuk menyimpannya dengan aman, atau mereferensikan rahasia yang disimpan di Azure Key Vault. |
Ya |
refreshToken | Token refresh yang diperoleh dari Square. Digunakan untuk mendapatkan token akses baru ketika token akses saat ini kedaluwarsa. Tandai bidang ini sebagai SecureString untuk menyimpannya dengan securelyFactory, atau referensi rahasia yang disimpan di Azure Key Vault. |
No |
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 |
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:
Properti | Deskripsi | Wajib |
---|---|---|
jenis | Properti type himpunan data harus diatur ke: SquareObject | Ya |
tableName | Nama tabel. | Tidak (jika "kueri" di sumber aktivitas ditentukan) |
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:
Properti | Deskripsi | Wajib |
---|---|---|
jenis | Properti type dari sumber aktivitas salin harus diatur ke: SquareSource | Ya |
pertanyaan | Gunakan kueri SQL kustom untuk membaca data. Misalnya: "SELECT * FROM Business" . |
Tidak (jika "tableName" di himpunan data ditentukan) |
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.