Azure Data Factory veya Azure Synapse Analytics kullanarak QuickBooks Online'dan veri kopyalama

ŞUNLARA UYGULANIR: Azure Data Factory Azure Synapse Analytics

İpucu

Microsoft Fabric'daki Data Factory, daha basit bir mimariye, yerleşik yapay zekaya ve yeni özelliklere sahip yeni nesil Azure Data Factory. Veri tümleştirmeyi yeni kullanmaya başladıysanız Fabric Data Factory ile başlayın. Mevcut ADF iş yükleri veri bilimi, gerçek zamanlı analiz ve raporlama genelinde yeni özelliklere erişmek için Fabric yükseltebilir.

Fabric ücretsiz deneme başlatın.
Azure Data Factory'den Data Factory'ye Microsoft Fabric'te Upgrade yapın.

Bu makalede, QuickBooks Online'dan veri kopyalamak için Azure Data Factory veya Azure Synapse Analytics işlem hattında kopyalama etkinliğinin nasıl kullanılacağı özetlenmiştir. Kopyalama etkinliğiyle ilgili genel bakış makalesine dayanır.

Önemli

QuickBooks bağlayıcısı sürüm 1.0 kaldırma aşamasındadır. QuickBooks bağlayıcısını sürüm 1.0'dan 2.0'a yükseltmeniz önerilir.

Desteklenen özellikler

QuickBooks bağlayıcısı aşağıdaki özellikler için desteklenir:

Desteklenen özellikler	Kızılötesi
Kopyalama etkinliği (kaynak/-)	(1) (2)
Arama etkinliği	(1) (2)

(1) Azure tümleştirme çalışma zamanı (2) Yerel barındırılan tümleştirme çalışma zamanı

Kaynak veya havuz olarak desteklenen veri depolarının listesi için bkz . Desteklenen veri depoları.

Bağlayıcı QuickBooks OAuth 2.0 kimlik doğrulamasını destekler.

Başlarken

Kopyalama etkinliğini bir işlem hattıyla gerçekleştirmek için aşağıdaki araçlardan veya SDK'lardan birini kullanabilirsiniz:

Kullanıcı arabirimini kullanarak QuickBooks'a bağlı hizmet oluşturma

Azure portalında Azure Data Factory veya Azure Synapse çalışma alanınıza gidin.
Yönet sekmesine gidin, Bağlı hizmetler'i ve ardından Yeni'yi seçin.
- Azure Data Factory
- Azure Synapse
Azure Synapse için yeni bir bağlı hizmet oluşturmaya yönelik seçimlerin ekran görüntüsü
QuickBooks'u arayın ve ardından QuickBooks bağlayıcısını seçin.
Hizmet ayrıntılarını yapılandırın, bağlantıyı test edin ve yeni bağlı hizmeti oluşturun.

Bağlayıcı yapılandırma ayrıntıları

Özellikleri, QuickBooks bağlayıcısına özgü Data Factory varlıklarını tanımlamak için kullanırsınız.

Bağlı hizmet özellikleri

QuickBooks bağlayıcısı artık 2.0 sürümünü destekliyor. QuickBooks bağlayıcınızı sürüm 1.0'dan sürüm 2.0'a yükseltmek için bu makalenin devamında yer alan yordama bakın. Aşağıdaki bölümlerde iki sürümün özellik ayrıntıları açıklanmaktadır.

Sürüm 2.0

QuickBooks bağlı hizmeti, bağlayıcı sürüm 2.0 için aşağıdaki özellikleri destekler:

Özellik	Açıklama	Gerekli
`type`	Bağlı hizmetin türü. olarak ayarlanmalıdır `QuickBooks`.	Yes
`version`	Belirttiğiniz sürüm. Bu durumda değer `2.0` olur.	Yes
`endpoint`	QuickBooks Online sunucusunun uç noktası. Bu durumda değer `quickbooks.api.intuit.com` olur.	Yes
`companyId`	Yetkilendirmek için QuickBooks şirketinin şirket kimliği. Şirket kimliğini bulma hakkında bilgi için QuickBooks Online yardım konusuna bakın.	Yes
`consumerKey`	OAuth 2.0 kimlik doğrulaması için QuickBooks Online uygulamanızın istemci kimliği. Daha fazla bilgi edinin.	Yes
`consumerSecret`	OAuth 2.0 kimlik doğrulaması için QuickBooks Online uygulamanızın istemci sırrı. Bu alanı güvenli bir şekilde depolamak için olarak işaretleyin veya Azure Key Vault içinde saklanan bir gizli diziye başvurun.	Yes
`refreshToken`	QuickBooks uygulamasıyla ilişkili OAuth 2.0 yenileme belirteci. Daha fazla bilgi edinin. Bu alanı güvenli bir şekilde depolamak için olarak işaretleyin veya Azure Key Vault içinde saklanan bir gizli diziye başvurun. Yenileme belirtecinin süresi 180 gün sonra dolduğundan müşterilerin bunu düzenli olarak güncelleştirmeleri gerekir.	Yes

İşte bir örnek:

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

Sürüm 1.0

QuickBooks bağlı hizmeti, bağlayıcı sürüm 1.0 için aşağıdaki özellikleri destekler:

Özellik	Açıklama	Gerekli
`type`	Bağlı hizmetin türü. olarak ayarlanmalıdır `QuickBooks`.	Yes
`connectionProperties`	QuickBooks'a nasıl bağlanılacağını tanımlayan bir özellik grubu.	Yes
altında `connectionProperties`:
`endpoint`	QuickBooks Online sunucusunun uç noktası. Bu durumda değer `quickbooks.api.intuit.com` olur.	Yes
`companyId`	Yetkilendirmek için QuickBooks şirketinin şirket kimliği. Şirket kimliğini bulma hakkında bilgi için QuickBooks Online yardım konusuna bakın.	Yes
`consumerKey`	OAuth 2.0 kimlik doğrulaması için QuickBooks Online uygulamanızın istemci kimliği. Daha fazla bilgi edinin.	Yes
`consumerSecret`	OAuth 2.0 kimlik doğrulaması için QuickBooks Online uygulamanızın istemci sırrı. Bu alanı güvenli bir şekilde depolamak için olarak işaretleyin veya Azure Key Vault içinde saklanan bir gizli diziye başvurun.	Yes
`refreshToken`	QuickBooks uygulamasıyla ilişkili OAuth 2.0 yenileme belirteci. Daha fazla bilgi edinin. Bu alanı güvenli bir şekilde depolamak için olarak işaretleyin veya Azure Key Vault içinde saklanan bir gizli diziye başvurun. Yenileme belirtecinin süresi 180 gün sonra dolduğundan müşterilerin bunu düzenli olarak güncelleştirmeleri gerekir.	Yes
`useEncryptedEndpoints`	Veri kaynağı uç noktalarının HTTPS aracılığıyla şifrelenip şifrelenmediğini belirtir. Varsayılan değer şudur: `true`.	Hayır

İşte bir örnek:

{
    "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
            }
        }
    }
}

Bağlı hizmet için yenileme belirteçlerini işleme

Bağlı bir hizmette QuickBooks Online bağlayıcısını kullandığınızda, QuickBooks'tan OAuth 2.0 yenileme belirteçlerini doğru bir şekilde yönetmek önemlidir.

Bağlı hizmet, yeni erişim belirteçleri almak için bir yenileme belirteci kullanır. Ancak QuickBooks Online, yenileme belirtecini düzenli aralıklarla güncelleştirir. Bu eylem önceki belirteci geçersiz kilir.

Bağlı hizmet Azure Key Vault'da yenileme belirtecini otomatik olarak güncelleştirmez, bu nedenle kesintisiz bağlantı sağlamak için yenileme belirtecinin güncelleştirilmesini yönetmeniz gerekir. Aksi takdirde, yenileme belirtecinin süresi dolduktan sonra kimlik doğrulaması hatalarıyla karşılaşabilirsiniz.

Yenileme belirteçlerinin süresinin dolabilmesi için QuickBooks Online ilkesini temel alarak Azure Key Vault yenileme belirtecini el ile güncelleştirebilirsiniz. Bir diğer yaklaşım, yeni bir yenileme belirtecini kontrol ederek Azure Key Vault'u güncelleyen zamanlanmış bir görev veya Azure işlevi kullanarak güncellemeleri otomatikleştirmektir.

Veri kümesi özellikleri

Veri kümelerini tanımlamaya yönelik kullanılabilir bölümlerin ve özelliklerin tam listesi için bkz. Azure Data Factory ve Azure Synapse Analytics Datasets.

QuickBooks Online'dan veri kopyalamak için veri kümesinin type özelliğini olarak QuickBooksObjectayarlayın. QuickBooks veri kümesi aşağıdaki özellikleri destekler:

Özellik	Açıklama	Gerekli
`type`	Veri kümesinin türü. olarak ayarlanmalıdır `QuickBooksObject`.	Yes
`tableName`	Tablonun adı.	Hayır (etkinlik kaynağında belirtilmişse `query` )

İşte bir örnek:

{
    "name": "QuickBooksDataset",
    "properties": {
        "type": "QuickBooksObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<QuickBooks linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Bağlayıcı sürüm 2.0 aşağıdaki QuickBooks tablolarını destekler:

Firma
Takıl -abilir
Attachable_AttachableRef
Eklenebilir_EklenebilirReferans_ÖzelAlan
Fatura
FaturaÖdeme_Hattı
BillPayment_Line_LinkedTxn
Fatura_Hesap_Temelli_Gider_Satırı
Fatura Kalemi Bazlı Gider Satırı
Bill_LinkedTxn
Fatura_Ödeme
Bill_TxnTaxDetail_TaxLine
Bütçe
Bütçe Detayı
Class
CompanyCurrency_CustomField
ŞirketBilgisi_AdDeğer
Şirket_Para Birimi
Şirket_Bilgisi
Kredi Kartı Ödemesi
CreditMemo_CustomField
KrediNotu_Açıklama_Satır
KrediNotu_İndirim_Satırı
KrediNotu_Grup_Bireysel_Öğe_Satır
CreditMemo_Group_Item_Line
KrediNotu_Satış_Ürün_Satır
KrediNotu_AraToplam_Satır
CreditMemo_TxnTaxDetail_TaxLine
Kredi Notu
Müşteri
MüşteriTipi
Departman
Depozito
Mevduat_ÖzelAlan
Mevduat_Hattı
Kayıt_Hat_ÖzelAlan
Mevduat_Bağlantılı_İşlem_Detayı
Mevduat_Bağlantılı_İşlem_Satırı
Mevduat_İşlemVergiDetayı_VergiSatırı
Çalışan
Tahmin
Estimate_CustomField
Tahmin_Açıklama_Satırı
Tahmin_İndirim_Satırı
Tahmin_Grup_Bireysel_Madde_Satır
Tahmin_Grup_Öğe_Satırı
Estimate_LinkedTxn
Tahmin_Satış_Ürün_Satır
Tahmin_Ara_Toplam_Satırı
Estimate_TxnTaxDetail_TaxLine
Invoice
Invoice_CustomField
Fatura_Açıklama_Satırı
Fatura_İndirim_Satırı
Fatura_Grubu_Bireysel_Öğe_Satırı
Fatura_Grup_Öğe_Satırı
Fatura_Bağlıİşlem
Fatura_Satış_Öğe_Satır
Fatura_Ara Toplam_Satır
Fatura_İşlemVergiDetay_VergiSatırı
Ürün
JournalCode_CustomField
GünlükKaydı_Açıklama_Satırı
GünlükGirdisi_Satır
JournalEntry_TxnTaxDetail_TaxLine
Journal_Code
Günlük_Girişi
Ödeme
Ödeme_Satırı
Ödeme_Satırı_Bağlıİşlem
Ödeme Yöntemi
Preferences
Tercihler_SatışFormuTercihleri_ÖzelAlan
Preferences_OtherPrefs_NameValue
Tercihler_SatıcıVeSatınAlmaTercihleri_PÖÖzelAlan
Satın Al
Satın Alma_Hesap_Temelli_Gider_Satırı
Satın Alıma Dayalı Gider Kalemi
Satın Alma_İşlemVergiDetayı_VergiSatırı
Satın Alma Siparişi
SiparişEmri_ÖzelAlan
SatınAlmaEmri_HesabaDayalı_Masraf_Hattı
SatınAlmaSiparişi_ÜrünBazlı_GiderSatırı
SiparişEmri_Bağlıİşlem
SatınAlmaEmri_İşlemVergiDetayı_VergiSatırı
Yinelenen İşlem
Yinelenen İşlem Satırları
İadeMakbuzu_ÖzelAlan
İadeMakbuzu_Açıklama_Çizgisi
İadeAlındısı_İndirim_Satırı
İadeFişi_Grup_Bireysel_Urun_Satır
İadeMakbuzu_Grup_Öğe_Satır
İadeMakbuzu_Satış_Kalem_Satırı
RefundReceipt_Subtotal_Line
RefundReceipt_TxnTaxDetail_TaxLine
İade Makbuzu
Masraf İadesi
ReimburseCharge_Line
SatışFişi_ÖzelAlan
SatışFaturası_Açıklama_Satırı
SatışFişi_İndirim_Satırı
SatışMakbuzu_Grup_Bireysel_Öğe_Satırı
SatışFişi_Grup_Öğe_Satır
SatışMakbuzu_Satış_Öğe_Satır
SatışMakbuzu_AraToplam_Satırı
SalesReceipt_TxnTaxDetail_TaxLine
Satış_Fişi
VergiSınıflandırması
VergiKodu_AlımVergiOranıListesi_VergiOranıDetay
TaxCode_SalesTaxRateList_TaxRateDetail
Vergi Kurumu
Vergi Kodu
Vergi_Oranı
Süre
Zaman_Aktivitesi
Aktarma
Satıcı
Tedarikçi Kredisi_Hesap Bazlı Gider Satırı
Satıcı Kredisi_Eşya Bazlı_Masraf Hattı
Satıcı Kredisi

Kopyalama etkinliği özellikleri

Etkinlikleri tanımlamak için kullanılabilen bölümlerin ve özelliklerin tam listesi için bkz. Azure Data Factory ve Azure Synapse Analytics'te Pipelines ve etkinlikler. Bu bölümde, QuickBooks kaynağının desteklediği özelliklerin listesi sağlanır.

Kaynak olarak QuickBooks

QuickBooks Online'dan veri kopyalamak için kopyalama etkinliğindeki kaynak türünü olarak QuickBooksSourceayarlayın. QuickBooks veri kümesi kopyalama etkinliğinin source bölümünde aşağıdaki özellikleri destekler:

Özellik	Açıklama	Gerekli
`type`	Kopyalama etkinliği kaynağının türü. olarak ayarlanmalıdır `QuickBooksSource`.	Yes
`query`	Verileri okumak için özel SQL sorgusunu kullanın. QuickBooks bağlayıcısının 2.0 sürümü için sınırlamaları olan yalnızca QuickBooks yerel sorgusunu kullanabilirsiniz. Daha fazla bilgi için Intuit Geliştirici sitesindeki Sorgu işlemleri ve söz dizimi bölümüne bakın. QuickBooks bağlayıcısının 1.0 sürümü için SQL-92 sorgusunu kullanabilirsiniz. Örneğin: `"SELECT * FROM "Bill" WHERE Id = '123'"`.	Hayır (veri kümesinde belirtilmişse `tableName` )

İşte bir örnek:

"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>"
            }
        }
    }
]

Etkinlikleri tanımlamaya yönelik kullanılabilir bölümler ve özelliklerin tam listesi için bkz. Azure Data Factory ve Azure Synapse Analytics içindeki Pipelineler ve etkinlikler.

QuickBooks Desktop'tan veri kopyalama

Hizmetteki kopyalama etkinliği verileri doğrudan QuickBooks Desktop'tan kopyalayamaz. QuickBooks Desktop'tan veri kopyalamak için QuickBooks verilerinizi virgülle ayrılmış değerler (CSV) dosyasına aktarın ve dosyayı Azure Blob Depolama'a yükleyin. Buradan hizmeti kullanarak verileri istediğiniz havuza kopyalayabilirsiniz.

Quickbook'lar için veri türü eşlemesi

QuickBooks'tan veri kopyaladığınızda, QuickBooks veri türlerinden hizmetin kullandığı iç veri türlerine aşağıdaki eşlemeler uygulanır. Kopyalama etkinliğinin kaynak şemayı ve veri türünü havuza nasıl eşlediğini öğrenmek için bkz. Kopyalama etkinliğinde şema ve veri türü eşlemesi.

QuickBooks veri türü	Ara hizmet veri türü (sürüm 2.0 için)	Ara hizmet veri türü (sürüm 1.0 için)
`String`	`string`	`string`
`Boolean`	`bool`	`bool`
`DateTime`	`datetime`	`datetime`
`Decimal`	`decimal (15,2)`	`decimal (15, 2)`
`Enum`	`string`	`string`
`Date`	`datetime`	`datetime`
`BigDecimal`	`decimal (15,2)`	`decimal (15, 2)`
`Integer`	`int`	`int`

Arama etkinliği özellikleri

Arama etkinliğinin özellikleri hakkında ayrıntılı bilgi için bkz. Azure Data Factory ve Azure Synapse Analytics'te Arama etkinliği.

Quickbooks bağlayıcısı yaşam döngüsü ve yükseltmesi

Aşağıdaki tabloda QuickBooks bağlayıcısının sürümleriyle ilgili bilgiler özetlenmektedir:

Sürüm	Yayın aşaması	Değişiklik Kaydı
1.0	Removed	Uygulanamaz.
2.0	Genel kullanılabilirlik	QuickBooks yerel sorgusu, sınırlamalarla desteklenir. `GROUP BY` yan tümceler, `JOIN` yan tümceler ve toplama işlevleri (`Avg`, `Max`, `Sum`) desteklenmez. Daha fazla bilgi için Intuit Geliştirici sitesindeki Sorgu işlemleri ve söz dizimi bölümüne bakın. SQL-92 sorgusu desteklenmez. `useEncryptedEndpoints` özelliği desteklenmiyor. Belirli Quickbooks tablosunu destekleyin. Desteklenen tablo listesi için Veri kümesi özellikleri'ne gidin.

Quickbooks bağlayıcısını sürüm 1.0'dan sürüm 2.0'a yükseltme

Azure portalında Azure Data Factory veya Azure Synapse çalışma alanınıza gidin.
Yönet sekmesine gidin, Bağlı hizmetler'i ve ardından bağlı hizmet için Düzenle'yi seçin.
Bağlı hizmeti düzenle bölmesinde sürüm için 2.0'ı seçin. Daha fazla bilgi için bu makalenin önceki bölümlerinde yer alan 2.0 sürümüne ilişkin bağlı hizmet özelliklerine bakın.
Kopyalama etkinliği kaynağında veya sürüm 1.0 bağlı hizmetine başvuran arama etkinliğinde bir SQL sorgusu kullanıyorsanız, bunu QuickBooks yerel sorgusuna dönüştürmeniz gerekir. Bu makalenin önceki bölümlerinde yer alan Kopyalama etkinliği properties ve Intuit Developer sitesindeki Query işlemleri ve söz dizimi yerel sorgu hakkında daha fazla bilgi edinin.
Sürüm 2.0'ın belirli Quickbooks tablolarını desteklediğini unutmayın. Desteklenen tablo listesi için Veri kümesi özellikleri'ne gidin.

Kopyalama etkinliğinin kaynak ve havuz olarak desteklediği veri depolarının listesi için bkz . Desteklenen veri depoları ve biçimleri.

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Last updated on 2026-04-07

Azure Data Factory veya Azure Synapse Analytics kullanarak QuickBooks Online'dan veri kopyalama

Desteklenen özellikler

Başlarken

Kullanıcı arabirimini kullanarak QuickBooks'a bağlı hizmet oluşturma

Bağlayıcı yapılandırma ayrıntıları

Bağlı hizmet özellikleri

Sürüm 2.0

Sürüm 1.0

Bağlı hizmet için yenileme belirteçlerini işleme

Veri kümesi özellikleri

Kopyalama etkinliği özellikleri

Kaynak olarak QuickBooks

QuickBooks Desktop'tan veri kopyalama

Quickbook'lar için veri türü eşlemesi

Arama etkinliği özellikleri

Quickbooks bağlayıcısı yaşam döngüsü ve yükseltmesi

Quickbooks bağlayıcısını sürüm 1.0'dan sürüm 2.0'a yükseltme

İlgili içerik

Geri Bildirim

Ek kaynaklar