Menyalin data dari QuickBooks Online 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 database QuickBooks Online. 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.

Kemampuan yang didukung

Konektor QuickBooks 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 QuickBooks OAuth 2.0.

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

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

   

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

Properti layanan tertaut

Properti berikut ini didukung untuk layanan tertaut QuickBooks:

Properti	Deskripsi	Wajib
jenis	Properti jenis harus diatur ke: QuickBooks	Ya
connectionProperties	Sekelompok properti yang menentukan cara menyambungkan ke QuickBooks.	Ya
Di bawah connectionProperties:
titik akhir	Titik akhir server QuickBooks Online. (yaitu, quickbooks.api.intuit.com)	Ya
companyId	ID perusahaan dari perusahaan QuickBooks untuk mengotorisasi. Untuk informasi tentang cara menemukan ID perusahaan, lihat Bagaimana cara menemukan ID Perusahaan saya.	Ya
consumerKey	ID klien aplikasi QuickBooks Online Anda untuk autentikasi OAuth 2.0. Pelajari selengkapnya dari sini.	Ya
consumerSecret	Rahasia klien aplikasi QuickBooks Online Anda untuk autentikasi OAuth 2.0. Tandai bidang ini sebagai SecureString untuk menyimpannya dengan aman, atau mereferensikan rahasia yang disimpan di Azure Key Vault.	Ya
refreshToken	Token refresh OAuth 2.0 yang terkait dengan aplikasi QuickBooks. Pelajari selengkapnya dari sini. Token refresh catatan akan kedaluwarsa setelah 180 hari. Pelanggan perlu memperbarui token refresh secara teratur. 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

Contoh:

{
    "name": "QuickBooksLinkedService",
    "properties": {
        "type": "QuickBooks",
        "typeProperties": {
            "connectionProperties": {
                "endpoint": "quickbooks.api.intuit.com",
                "companyId": "<company id>",
                "consumerKey": "<consumer key>", 
                "consumerSecret": {
                     "type": "SecureString",
                     "value": "<clientSecret>"
            	},
                "refreshToken": {
                     "type": "SecureString",
                     "value": "<refresh token>"
            	},
                "useEncryptedEndpoints": true
            }
        }
    }
}

Menangani token refresh untuk layanan tertaut

Saat Anda menggunakan konektor QuickBooks Online dalam layanan tertaut, penting untuk mengelola token refresh OAuth 2.0 dari QuickBooks dengan benar. Layanan tertaut menggunakan token refresh untuk mendapatkan token akses baru. Namun, QuickBooks Online secara berkala memperbarui token refresh, membatalkan token sebelumnya. Layanan tertaut tidak secara otomatis memperbarui token refresh di Azure Key Vault, jadi Anda perlu mengelola pembaruan token refresh untuk memastikan konektivitas yang tidak terganggu. Jika tidak, Anda mungkin mengalami kegagalan autentikasi setelah token refresh kedaluwarsa.

Anda dapat memperbarui token refresh secara manual di Azure Key Vault berdasarkan kebijakan kedaluwarsa token refresh QuickBooks Online. Tetapi pendekatan lain adalah mengotomatiskan pembaruan dengan tugas terjadwal atau Azure Function yang memeriksa token refresh baru dan memperbaruinya di Azure Key Vault.

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

Untuk menyalin data dari QuickBooks Online, atur properti jenis himpunan data ke QuickBooksObject. Berikut adalah properti yang didukung:

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

Contoh

{
    "name": "QuickBooksDataset",
    "properties": {
        "type": "QuickBooksObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<QuickBooks 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 QuickBooks.

QuickBooks sebagai sumber

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

Properti	Deskripsi	Wajib
jenis	Properti jenis sumber aktivitas penyalinan harus diatur ke: QuickBooksSource	Ya
pertanyaan	Gunakan kueri SQL kustom untuk membaca data. Misalnya: "SELECT * FROM "Bill" WHERE Id = '123'".	Tidak (jika "tableName" di himpunan data ditentukan)

Contoh:

"activities":[
    {
        "name": "CopyFromQuickBooks",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<QuickBooks input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "QuickBooksSource",
                "query": "SELECT * FROM \"Bill\" WHERE Id = '123' "
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Menyalin data dari Quickbooks Desktop

Aktivitas Salin di layanan tidak dapat menyalin data langsung dari Quickbooks Desktop. Untuk menyalin data dari Quickbooks Desktop, ekspor data Quickbooks Anda ke file comma-separated-values (CSV) lalu unggah file ke Azure Blob Storage. Dari sana, Anda dapat menggunakan layanan untuk menyalin data ke sink pilihan Anda.

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.