Powershell からの Zuora データ連携タスクを自動化

詳細情報をご希望ですか?

無償トライアル:

ダウンロードへ

製品の詳細情報へ:

Zuora ADO.NET Provider

Zuora データに連携する.NET アプリケーションを素早く、簡単に開発できる便利なドライバー。



PowerShell から Zuora に簡単に接続する方法をお探しですか? CData ADO.NET Provider for Zuora は、PowerShell スクリプトの優位性を使い、シンプルで簡単に使えるADO.NET インターフェース を提供します。PowerShell スクリプトで、ADO.NET オブジェクトを使って簡単にZuora に接続して、同期、自動化、ダウンロードなどが可能!



CData ADO.NET Provider for Zuora は、ADO.NET 標準インターフェースへ統合し、PowerShell のような. NET アプリケーションからZuora API へのデータ連携を可能にします。このプロバイダーは、Zuora の認証および相互作用を簡単にします。このチュートリアルでは、PowerShell から直接SQL クエリを実行するための、いくつかの一般的なADO.NET オブジェクトの使い方を説明します。

クエリの実行

次の3つのステップに従って create、read、update、およびdelete (CRUD) のデータ連携コマンドを PowerShell からリアルタイムZuora に実行:

  1. プロバイダーのアセンブリをロード:

    [Reflection.Assembly]::LoadFile("C:\Program Files\CData\CData ADO.NET Provider for Zuora\lib\System.Data.CData.Zuora.dll")
  2. Zuora に接続:

    Zuora uses the OAuth standard to authenticate users. See the online Help documentation for a full OAuth authentication guide.

    Configuring Tenant property

    In order to create a valid connection with the provider you need to choose one of the Tenant values (USProduction by default) which matches your account configuration. The following is a list with the available options:

    • USProduction: Requests sent to https://rest.zuora.com.
    • USAPISandbox: Requests sent to https://rest.apisandbox.zuora.com"
    • USPerformanceTest: Requests sent to https://rest.pt1.zuora.com"
    • EUProduction: Requests sent to https://rest.eu.zuora.com"
    • EUSandbox: Requests sent to https://rest.sandbox.eu.zuora.com"

    Selecting a Zuora Service

    Two Zuora services are available: Data Query and AQuA API. By default ZuoraService is set to AQuADataExport.

    DataQuery

    The Data Query feature enables you to export data from your Zuora tenant by performing asynchronous, read-only SQL queries. We recommend to use this service for quick lightweight SQL queries.

    Limitations
    • The maximum number of input records per table after filters have been applied: 1,000,000
    • The maximum number of output records: 100,000
    • The maximum number of simultaneous queries submitted for execution per tenant: 5
    • The maximum number of queued queries submitted for execution after reaching the limitation of simultaneous queries per tenant: 10
    • The maximum processing time for each query in hours: 1
    • The maximum size of memory allocated to each query in GB: 2
    • The maximum number of indices when using Index Join, in other words, the maximum number of records being returned by the left table based on the unique value used in the WHERE clause when using Index Join: 20,000

    AQuADataExport

    AQuA API export is designed to export all the records for all the objects ( tables ). AQuA query jobs have the following limitations:

    Limitations
    • If a query in an AQuA job is executed longer than 8 hours, this job will be killed automatically.
    • The killed AQuA job can be retried three times before returned as failed.

    $constr = "OAuthClientID=MyOAuthClientId;OAuthClientSecret=MyOAuthClientSecret;Tenant=USProduction;ZuoraService=DataQuery;" $conn= New-Object System.Data.CData.Zuora.ZuoraConnection($constr) $conn.Open()
  3. ZuoraDataAdapter のインスタンスを生成してSQL クエリを実行し、結果を出力:

    $sql="SELECT Id, BillingCity from Invoices" $da= New-Object System.Data.CData.Zuora.ZuoraDataAdapter($sql, $conn) $dt= New-Object System.Data.DataTable $da.Fill($dt) $dt.Rows | foreach { Write-Host $_.id $_.billingcity }

Zuora データの更新

$cmd = New-Object System.Data.CData.ZuoraCommand("UPDATE Invoices SET BillingState='CA' WHERE Id = @myId", $conn) $cmd.Parameters.Add(new System.Data.CData.ZuoraParameter("myId","10456255-0015501366")) $cmd.ExecuteNonQuery()

Zuora へのデータの挿入

$cmd = New-Object System.Data.CData.ZuoraCommand("UPDATE Invoices SET BillingState='CA' WHERE Id = @myId", $conn) $cmd.Parameters.Add(new System.Data.CData.ZuoraParameter("myId","10456255-0015501366")) $cmd.ExecuteNonQuery()

Zuora データの削除

$cmd = New-Object System.Data.CData.ZuoraCommand("UPDATE Invoices SET BillingState='CA' WHERE Id = @myId", $conn) $cmd.Parameters.Add(new System.Data.CData.ZuoraParameter("myId","10456255-0015501366")) $cmd.ExecuteNonQuery()