PCA Sales データをPowerShell でMySQL にレプリケーションする方法

こんにちは！ドライバー周りのヘルプドキュメントを担当している古川です。

CData Cmdlets for PCASales を使えば、PowerShell からPCA Sales データ データにリアルタイムで連携できます。データ同期などのタスクの連携にぴったりの製品です。 本記事では、PowerShell からCData Cmdlets for PCASales およびCData Cmdlets for MySQL を使って、同期スクリプトを作成して実行します。

まずは、PowerShell でPCA Sales への接続を行います。レプリケーションは4つのステップがあります。

PCA クラウド商魂・商管DX では、OAuth 2 認証標準を使います。

ユーザー資格情報の接続プロパティを設定せずに接続できます。接続に最小限必要な接続プロパティは、次のとおりです。

• InitiateOAuth：GETANDREFRESH に設定。InitiateOAuth を使って、OAuth 交換や、手動での接続文字列のアクセストークン設定の繰り返しを避けられます。
• OAuthClientId：アプリケーション設定のクライアントId に設定。
• OAuthClientSecret：アプリケーション設定のクライアントシークレットに設定。
• CallbackURL：アプリケーション設定のリダイレクトURL に設定。
• ApiVersion：接続するPCA API Server バージョンを設定。
• DefaultDataArea：接続するデータ領域を設定。
• DataCenter：接続するサーバーのDataCenter 名を設定。
• ProductCode：PCA 製品コード名を設定。

接続すると、CData 製品はデフォルトブラウザでPCA Accounting OAuth エンドポイントを開きます。ログインして、CData 製品にアクセス許可を与えます。CData 製品がOAuth プロセスを完了します。

ヘッドレスマシンの認証など、他のOAuth 認証フローについては、ヘルプドキュメントの「OAuth 認証の使用」を参照してください。

PCA Sales データの取得

1. モジュールのインストール:

   Install-Module PCASalesCmdlets

2. PCA Sales への接続:

   $pcasales = Connect-PCASales -OAuthClientId $OAuthClientId -OAuthClientSecret $OAuthClientSecret -CallbackURL $CallbackURL -ProductCode $ProductCode -ApiVersion $ApiVersion -DataCenter $DataCenter -DefaultDataArea $DefaultDataArea

3. 取得ターゲットのリソースの取得:

   $data = Select-PCASales -Connection $pcasales -Table "MasterSms"

   Invoke-PCASales cmdlet を使って、SQL-92 クエリを使用することもできます:

   $data = Invoke-PCASales -Connection $pcasales -Query 'SELECT * FROM MasterSms WHERE SyohinMei = @SyohinMei' -Params @{'@SyohinMei'='Syohin'}

4. 戻り値からカラム名のリストを保存します。

   $columns = ($data | Get-Member -MemberType NoteProperty | Select-Object -Property Name).Name

PCA Sales データをMySQL データベースにレプリケーション

カラム名を指定できるようにして、データをMySQL データベースにレプリケーションします。

1. モジュールのインストール:

   Install-Module MySQLCmdlets

2. MySQL DB に、MySQL Server 名、ユーザー、パスワード、レプリケーション先のデータベース名を指定して、接続します:

   $mysql = Connect-MySQL -User $User -Password $Password -Database $Database -Server $Server -Port $Port

3. PCA Sales、保存された値、そしてAdd-MySQL Cmdlet を使って、MySQL にデータを1レコードずつ挿入します。この例では、MySQL 側のテーブルは、PCA Sales のリソース（MasterSms）と同じテーブル名を持っている必要があります。

   $data | % { $row = $_ $values = @() $columns | % { $col = $_ $values += $row.$($col) } Add-MySQL -Connection $mysql -Table "MasterSms" -Columns $columns -Values $values }

次回以降のレプリケーションをシンプルに実現

• 一度PowerShell でPCA Sales とMySQL に接続したら、次からは1行のコマンドでレプリケーションを実施できます:

  Select-PCASales -Connection $pcasales -Table "MasterSms" | % { $row = $_ $values = @() $columns | % { $col = $_ $values += $row.$($col) } Add-MySQL -Connection $mysql -Table "MasterSms" -Columns $columns -Values $values }

• 別のPowerShell モジュールで、PCA Sales を別のデータベースに複製する場合、Select-PCASales cmdlet のデータから、カラム、接続およびテーブルを除外しておきましょう。これらのデータはデータ移動のときだけ必要となるためです。

  $columns = ($data | Get-Member -MemberType NoteProperty | Select-Object -Property Name).Name | ? {$_ -NotIn @('Columns','Connection','Table')}

おわりに

これで、PCA Sales データをMySQL に複製できました。分析、BI などでPCA Sales データをMySQL から使うことができるようになります。