Azure Data Factory veya Synapse Analytics kullanarak QuickBooks Online'dan veri kopyalama (Önizleme)

UYGULANANLAR: Azure Data Factory Azure Synapse Analytics

İpucu

Kuruluşlar için hepsi bir arada analiz çözümü olan Microsoft Fabric'te Data Factory'yi deneyin. Microsoft Fabric , veri taşımadan veri bilimine, gerçek zamanlı analize, iş zekasına ve raporlamaya kadar her şeyi kapsar. Yeni bir deneme sürümünü ücretsiz olarak başlatmayı öğrenin!

Bu makalede, QuickBooks Online'dan veri kopyalamak için Azure Data Factory veya Synapse Analytics işlem hattında Kopyalama Etkinliğinin nasıl kullanılacağı açıklanmaktadır. Kopyalama etkinliğine genel bir genel bakış sunan kopyalama etkinliğine genel bakış makalesini oluşturur.

Önemli

Bu bağlayıcı şu anda önizleme aşamasındadır. Bunu deneyebilir ve bize geri bildirim gönderebilirsiniz. Çözümünüzde bir önizleme bağlayıcısı bağımlılığı olmasını istiyorsanız lütfen Azure desteğine başvurun.

Desteklenen özellikler

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

Desteklenen özellikler	IR
Kopyalama etkinliği (kaynak/-)	(1) (2)
Arama etkinliği	(1) (2)

(1) Azure tümleştirme çalışma zamanı (2) Şirket içinde barındırılan tümleştirme çalışma zamanı

Kaynak/havuz olarak desteklenen veri depolarının listesi için Desteklenen veri depoları tablosuna bakın.

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

Başlarken

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

• Veri Kopyalama aracı
• Azure portal
• .NET SDK'sı
• Python SDK'sı
• Azure PowerShell
• The REST API
• Azure Resource Manager şablonu

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

Azure portalı kullanıcı arabiriminde QuickBooks'a bağlı bir hizmet oluşturmak için aşağıdaki adımları kullanın.

1. Azure Data Factory veya Synapse çalışma alanınızda Yönet sekmesine göz atın ve Bağlı Hizmetler'i seçin, ardından Yeni'ye tıklayın:

   Azure Data Factory

   

   Azure Synapse

   

2. QuickBooks'u arayın ve QuickBooks bağlayıcısını seçin.

   

3. 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ı

Aşağıdaki bölümlerde, QuickBooks bağlayıcısına özgü Data Factory varlıklarını tanımlamak için kullanılan özelliklerle ilgili ayrıntılar sağlanır.

Bağlı hizmet özellikleri

QuickBooks bağlı hizmeti için aşağıdaki özellikler desteklenir:

Özellik	Açıklama	Gerekli
Tür	Tür özelliği şu şekilde ayarlanmalıdır: QuickBooks	Yes
connectionProperties	QuickBooks'a bağlanmayı tanımlayan bir özellik grubu.	Yes
altında connectionProperties:
endpoint	QuickBooks Online sunucusunun uç noktası. (yani, quickbooks.api.intuit.com)	Yes
companyId	Yetkilendirmek için QuickBooks şirketinin şirket kimliği. Şirket kimliğini bulma hakkında bilgi için bkz. Nasıl yaparım? Şirket Kimliğimi bulma.	Yes
consumerKey	OAuth 2.0 kimlik doğrulaması için QuickBooks Online uygulamanızın istemci kimliği. Buradan daha fazla bilgi edinin.	Yes
consumerSecret	OAuth 2.0 kimlik doğrulaması için QuickBooks Online uygulamanızın istemci gizli dizisi. Güvenli bir şekilde depolamak için bu alanı SecureString olarak işaretleyin veya Azure Key Vault'ta depolanan bir gizli diziye başvurun.	Yes
refreshToken	QuickBooks uygulamasıyla ilişkili OAuth 2.0 yenileme belirteci. Buradan daha fazla bilgi edinin. Not yenileme belirtecinin süresi 180 gün sonra dolar. Müşterinin yenileme belirtecini düzenli olarak güncelleştirmesi gerekir. Güvenli bir şekilde depolamak için bu alanı SecureString olarak işaretleyin veya Azure Key Vault'ta depolanan bir gizli diziye başvurun.	Yes
useEncryptedEndpoints	Veri kaynağı uç noktalarının HTTPS kullanılarak şifrelenip şifrelenmediğini belirtir. Varsayılan değer doğru'dur.	Hayır

Ö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ştirerek öncekini geçersiz kılın. Bağlı hizmet, Azure Key Vault'taki 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 dolduğunda kimlik doğrulaması hatalarıyla karşılaşabilirsiniz.

QuickBooks Online'ın yenileme belirteci süre sonu ilkesine göre Azure Key Vault'ta yenileme belirtecini el ile güncelleştirebilirsiniz. Ancak bir diğer yaklaşım da yeni yenileme belirtecini denetleden ve Azure Key Vault'ta güncelleştiren zamanlanmış bir görev veya Azure İşlevi ile güncelleştirmeleri otomatikleştirmektir.

Veri kümesi özellikleri

Veri kümelerini tanımlamak için kullanılabilen bölümlerin ve özelliklerin tam listesi için veri kümeleri makalesine bakın. Bu bölümde, QuickBooks veri kümesi tarafından desteklenen özelliklerin listesi sağlanır.

QuickBooks Online'dan veri kopyalamak için veri kümesinin tür özelliğini QuickBooksObject olarak ayarlayın. Aşağıdaki özellikler desteklenir:

Özellik	Açıklama	Gerekli
Tür	Veri kümesinin type özelliği şu şekilde ayarlanmalıdır: QuickBooksObject	Yes
tableName	Tablonun adı.	Hayır (etkinlik kaynağında "sorgu" belirtilirse)

Örnek

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

Kopyalama etkinliğinin özellikleri

Etkinlikleri tanımlamak için kullanılabilen bölümlerin ve özelliklerin tam listesi için İşlem hatları makalesine bakın. Bu bölümde, QuickBooks kaynağı tarafından desteklenen özelliklerin listesi sağlanır.

Kaynak olarak QuickBooks

QuickBooks Online'dan veri kopyalamak için kopyalama etkinliğindeki kaynak türünü QuickBooksSource olarak ayarlayın. Kopyalama etkinliği kaynağı bölümünde aşağıdaki özellikler desteklenir:

Özellik	Açıklama	Gerekli
Tür	Kopyalama etkinliği kaynağının type özelliği şu şekilde ayarlanmalıdır: QuickBooksSource	Yes
query	Verileri okumak için özel SQL sorgusunu kullanın. Örneğin: "SELECT * FROM "Bill" WHERE Id = '123'".	Hayır (veri kümesinde "tableName" belirtilirse)

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

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.

Arama etkinliği özellikleri

Özellikler hakkında ayrıntılı bilgi edinmek için Arama etkinliği'ne bakın.

İlgili içerik

Kopyalama etkinliği tarafından kaynak ve havuz olarak desteklenen veri depolarının listesi için bkz . desteklenen veri depoları.