ADP データをMySQL にレプリケーションするPowerShell スクリプト

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

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

Connect to ADP by specifying the following properties:

• SSLClientCert: Set this to the certificate provided during registration.
• SSLClientCertPassword: Set this to the password of the certificate.
• UseUAT: The connector makes requests to the production environment by default. If using a developer account, set UseUAT = true.
• RowScanDepth: The maximum number of rows to scan for the custom fields columns available in the table. The default value will be set to 100. Setting a high value may decrease performance.

The connector uses OAuth to authenticate with ADP. OAuth requires the authenticating user to interact with ADP using the browser. For more information, refer to the OAuth section in the Help documentation.

ADP データの取得

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

   Install-Module ADPCmdlets

2. ADP への接続:

   $adp = Connect-ADP -OAuthClientId $OAuthClientId -OAuthClientSecret $OAuthClientSecret -SSLClientCert $SSLClientCert -SSLClientCertPassword $SSLClientCertPassword

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

   $data = Select-ADP -Connection $adp -Table "Workers"

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

   $data = Invoke-ADP -Connection $adp -Query 'SELECT * FROM Workers WHERE AssociateOID = @AssociateOID' -Params @{'@AssociateOID'='G3349PZGBADQY8H8'}

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

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

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

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

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

Notes

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

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

• 別のPowerShell モジュールで、ADP を別のデータベースに複製する場合、Select-ADP cmdlet のデータから、カラム、接続およびテーブルを除外する方がいいでしょう。これらのデータは、CData cmdlet からデータを移動する際にのみ必要なものだからです。:

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