Menyalin data dari Shopify menggunakan Azure Data Factory atau Synapse Analytics

Azure Data Factory Azure Synapse Analytics

Petunjuk

Data Factory di Microsoft Fabric adalah generasi Azure Data Factory berikutnya, dengan arsitektur yang lebih sederhana, AI bawaan, dan fitur baru. Jika Anda baru menggunakan integrasi data, mulailah dengan Fabric Data Factory. Beban kerja ADF yang ada dapat ditingkatkan ke Fabric untuk mengakses kemampuan baru di seluruh ilmu data, analitik real time, dan pelaporan.

• Mulai uji coba gratis Fabric.
• Mutakhirkan dari Azure Data Factory ke Data Factory di Microsoft Fabric

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

Penting

Konektor Shopify versi 1.0 berada pada tahap penghapusan. Anda disarankan untuk meningkatkan konektor Shopify dari versi 1.0 ke 2.0.

Kemampuan yang didukung

Konektor Shopify ini didukung untuk kemampuan berikut:

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

(1) Azure runtime integrasi (2) 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 article ini.

Properti kolom billing_on dihapus dari tabel Recurring_Application_Charges dan UsageCharge karena depreasi resmi kolom billing_on oleh Shopify.

Nota

Untuk versi 2.0, nama kolom mempertahankan struktur Shopify GraphQL, seperti data.customers.edges.node.createdAt. Untuk versi 1.0, nama kolom menggunakan nama yang disederhanakan, misalnya, Created_At.

Memulai

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

• Alat Salin Data
• Portal Azure
• .NET SDK
• Python SDK
• Azure PowerShell
• REST API
• templat Azure Resource Manager

Membuat layanan tertaut ke Shopify menggunakan UI

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

   

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 tertentu untuk konektor Shopify.

Properti layanan terhubung

Konektor Shopify sekarang mendukung versi 2.0. Lihat bagian ini untuk meningkatkan versi konektor Shopify Anda dari versi 1.0. Untuk detail properti, lihat bagian yang sesuai.

• Versi 2.0
• versi 1.0

Versi 2.0

Layanan tertaut Shopify mendukung properti berikut saat menerapkan versi 2.0:

Properti	Deskripsi	Wajib
jenis	Properti jenis harus diatur ke: Shopify	Ya
versi	Versi yang Anda tentukan. Nilainya adalah 2.0.	Ya
host	Titik akhir server Shopify. (yaitu mystore.myshopify.com)	Ya
accessToken	Token akses API yang dapat digunakan untuk mengakses data Shopify. Token tidak kedaluwarsa jika mode offline. Tandai bidang ini sebagai SecureString untuk menyimpannya dengan aman, atau referensi rahasia yang disimpan di Azure Key Vault.	Ya

Contoh:

{
    "name": "ShopifyLinkedService",
    "properties": {
        "type": "Shopify",
        "version": "2.0",
        "typeProperties": {
            "host" : "mystore.myshopify.com",
            "accessToken": {
                 "type": "SecureString",
                 "value": "<accessToken>"
            }
        }
    }
}

Versi 1.0

Layanan tertaut Shopify mendukung properti berikut saat menerapkan versi 1.0:

Properti	Deskripsi	Wajib
jenis	Properti jenis harus diatur ke: Shopify	Ya
host	Titik akhir server Shopify. (yaitu mystore.myshopify.com)	Ya
accessToken	Token akses API yang dapat digunakan untuk mengakses data Shopify. Token tidak kedaluwarsa jika mode offline. Tandai bidang ini sebagai SecureString untuk menyimpannya dengan aman, atau referensi rahasia yang disimpan di Azure Key Vault.	Ya
gunakanEndpointTerenkripsi	Menentukan apakah titik akhir sumber data dienkripsi menggunakan HTTPS. Nilai defaultnya adalah true.	Tidak
useHostVerification	Menentukan apakah mewajibkan nama host di sertifikat server agar sesuai dengan nama host server saat menyambungkan melalui TLS. Nilai defaultnya adalah true.	Tidak
usePeerVerification	Menentukan apakah akan memverifikasi identitas server ketika menyambungkan melalui TLS. Nilai defaultnya adalah true.	Tidak

Contoh:

{
    "name": "ShopifyLinkedService",
    "properties": {
        "type": "Shopify",
        "typeProperties": {
            "host" : "mystore.myshopify.com",
            "accessToken": {
                 "type": "SecureString",
                 "value": "<accessToken>"
            }
        }
    }
}

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 Shopify.

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

Properti	Deskripsi	Wajib
jenis	Jenis properti himpunan data harus diatur ke: ShopifyObject	Ya
tableName	Nama tabel. Untuk versi 2.0, nama tabel mempertahankan struktur Shopify GraphQL, misalnya customers. Untuk versi 1.0, nama tabel menggunakan nama yang disederhanakan dengan awalan, misalnya, "Shopify"."Customers".	Tidak (jika "kueri" di sumber aktivitas spesifik)

Nota

kolom tag tidak dapat dibaca saat Anda menentukan tableName dalam himpunan data. Untuk membaca kolom ini, gunakan query.

Contoh

{
    "name": "ShopifyDataset",
    "properties": {
        "type": "ShopifyObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<Shopify linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Properti Aktivitas Salin

Untuk daftar lengkap bagian dan properti yang tersedia untuk menentukan aktivitas, lihat artikel Pipelines. Bagian ini menyediakan daftar properti yang didukung oleh sumber Shopify.

Shopify sebagai sumber

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

Properti	Deskripsi	Wajib
jenis	Properti tipe dari sumber aktivitas penyalinan harus diatur ke: ShopifySource	Ya
kueri	Untuk versi 2.0, gunakan kueri GraphQL untuk membaca data. Untuk mempelajari selengkapnya tentang kueri ini, lihat artikel ini. Perhatikan bahwa penomoran halaman hanya didukung untuk tabel luar, dan setiap rekaman dalam tabel luar dapat menyertakan hingga 250 rekaman tabel dalam. Selain itu, penomoran halaman tidak didukung untuk tabel berlapis. Untuk versi 1.0, gunakan kueri SQL kustom untuk membaca data. Misalnya: "SELECT * FROM "Products" WHERE Product_Id = '123'".	Tidak (jika "tableName" dalam dataset ditentukan)

Contoh:

"activities":[
    {
        "name": "CopyFromShopify",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<Shopify input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "ShopifySource"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Pemetaan jenis data untuk Shopify

Saat Anda menyalin data dari Shopify, pemetaan berikut berlaku dari jenis data Shopify ke jenis data internal yang digunakan oleh layanan. Untuk memahami bagaimana aktivitas penyalinan memetakan skema sumber dan jenis data ke tujuan, lihat Pemetaan skema dan jenis data.

Jenis data Shopify	Jenis data layanan sementara (untuk versi 2.0)	Jenis data layanan sementara (untuk versi 1.0)
Boolean	Boolean	Boolean
Int	Int	Int
UnsignedInt64	UInt64	UInt64
Decimal	Decimal	Decimal
Mengapung	Double	Double
String	String	String
Tanggal	Tanggal	Tanggal
DateTime	DateTime	DateTime
ID	String	String
URL	String	String
Kode Negara	String	String
Jenis data kustom lainnya	String	String

Properti aktivitas pencarian Lookup

Untuk mempelajari detail tentang properti, lihat Aktivitas pencarian.

Siklus hidup dan peningkatan konektor Shopify

Tabel berikut ini memperlihatkan tahap rilis dan log perubahan untuk berbagai versi konektor Shopify.

Versi	Tahap rilis	Riwayat Perubahan
Versi 1.0	Removed	Tidak dapat diterapkan.
Versi 2.0	Ketersediaan Umum	• Nama tabel dan kolom mempertahankan struktur Shopify GraphQL. • Hanya mendukung kueri GraphQL. • useEncryptedEndpoints, useHostVerification, usePeerVerification tidak didukung dalam layanan tertaut.

Tingkatkan konektor Shopify dari versi 1.0 ke versi 2.0

1. Di halaman Edit layanan tertaut, pilih 2.0 untuk versi. Untuk informasi selengkapnya, lihat properti layanan tertaut versi 2.0.
2. Untuk versi 2.0, perhatikan bahwa nama tabel dan kolom mempertahankan struktur Shopify GraphQL.
3. Jika Anda menggunakan kueri SQL di sumber aktivitas salin atau aktivitas pencarian yang mengacu pada layanan tertaut versi 1.0, Anda perlu mengonversinya ke kueri GraphQL. Untuk mempelajari selengkapnya tentang kueri ini, lihat artikel ini

Konten terkait

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